Webnovel Writer 备份与恢复指南backups 与 archive 目录怎么用【免费下载链接】webnovel-writer基于 Claude Code 的长篇网文辅助创作系统解决 AI 写作中的「遗忘」和「幻觉」问题支持 200 万字量级 连载创作。项目地址: https://gitcode.com/GitHub_Trending/we/webnovel-writer写长篇网文最怕的就是写废——第 150 章把第 30 章的设定写崩了想回滚却发现没有备份。Webnovel Writer为此内置了完整的备份与恢复体系每写完一章自动打备份点还能把长期不用的设定数据归档瘦身。本文带你快速看懂.webnovel/下的两个关键目录——backups/备份快照和archive/归档数据掌握回滚、对比、恢复的常用操作。一图看懂两个目录各管什么在书项目根目录由/webnovel-init创建下运行时数据都放在.webnovel/里其中与备份恢复直接相关的有两个project-root/ ├── .webnovel/ │ ├── state.json # 项目状态 │ ├── index.db # SQLite 索引 │ ├── backups/ # 自动备份章节快照 │ └── archive/ # 归档角色/伏笔/审查报告 ├── 正文/ ├── 大纲/ └── 设定集/完整目录说明见 docs/operations/operations.md一句话区分backups/是时间机器——按章节保存整本项目的快照用于回滚到任意一章archive/是仓库——把很久没用的设定数据移出去防止state.json无限膨胀随时可恢复。备份怎么用每章自动备份点自动备份写完一章备份点就有了/webnovel-write的最后一步Step 6会自动执行备份无需手动干预。备份逻辑在 webnovel-writer/scripts/backup_manager.py模式条件备份方式Git 模式默认项目已安装并初始化 Git每章一个 commit tag如ch0045本地降级模式Git 不可用在.webnovel/backups/生成snapshot_ch0045_时间戳/快照目录自动保留最近 10 个Git 模式的优势在于原子性state.json和所有正文.md文件同步回滚不会出现状态里是筑基期、正文里是金丹期的数据撕裂且 Git 只存增量差异200 万字的长篇项目也省空间。手动触发备份的等价命令python backup_manager.py --chapter 45 --chapter-title 迦南学院的考验5 个命令查看、回滚、对比、开分支所有恢复操作都在当前分支以前滚方式完成历史不会丢失操作命令说明列出所有备份python backup_manager.py --list显示全部chXXXX备份点及最近提交回滚到某章python backup_manager.py --rollback 30恢复第 30 章时状态的所有文件对比两章差异python backup_manager.py --diff 20 40文件变更统计 state.json 详细差异创建平行分支python backup_manager.py --create-branch 50 --branch-name alternative-ending从第 50 章分叉出平行世界结局指定项目根追加--project-root 路径工作区下有多本书时区分目标书 写崩了别慌先--diff找到问题从哪一章开始再--rollback回到最后一个好版本然后重新写那一章。归档怎么用state.json 自动瘦身归档策略三类数据自动进仓库长篇连载写到几百章后state.json会越来越臃肿。webnovel-writer/scripts/archive_manager.py 按以下规则把冷数据移入.webnovel/archive/数据类型归档条件归档文件次要角色超过50 章未出场核心角色不受影响archive/characters.json已回收伏笔状态为已回收且超过20 章archive/plot_threads.json旧审查报告超过50 章前archive/reviews.json触发时机满足其一即执行state.json文件大小超过1 MB当前章节数是10 的倍数每 10 章检查一次。3 个常用命令# 自动归档检查推荐在更新状态后执行--dry-run 可先预览 python archive_manager.py --auto-check --dry-run # 强制归档忽略触发条件 python archive_manager.py --force # 查看归档统计 python archive_manager.py --stats恢复归档角色归档 ≠ 删除。剧情需要某个退场角色重新登场时一条命令即可找回python archive_manager.py --restore-character 李雪执行后该角色状态自动从archived改回active并移出归档文件。backups 与 archive 的区别速查对比项backups/备份archive/归档目的防写崩随时回滚防膨胀保持状态轻量粒度整项目正文大纲设定集state单条数据角色/伏笔/报告生成时机每章写完后自动满足大小或章节阈值时恢复方式--rollback N一键回滚--restore-character 名字精确找回存储形式Git tag / 快照目录JSON 文件 两者互不冲突备份保证任何时间点都能回头归档保证跑 200 万字不卡壳。常见问题速答Q没有安装 Git 会影响备份吗不会。系统自动降级为本地快照模式在.webnovel/backups/下生成snapshot_chXXXX_时间戳/目录最多保留 10 个。建议尽早安装 Git 以获得完整的版本历史。Q回滚会丢掉之后的章节吗不会。回滚采用前滚式恢复——在当前分支创建一个新的恢复提交原历史完整保留可随时用git log查看。Q归档后写错了能反悔吗能。归档数据只是移出state.json文件还在archive/里恢复角色、查询伏笔原样都支持。延伸阅读备份管理器源码webnovel-writer/scripts/backup_manager.py归档管理器源码webnovel-writer/scripts/archive_manager.py写章流程与备份步骤webnovel-writer/skills/webnovel-write/SKILL.md目录结构与运维命令docs/operations/operations.md备份相关测试用例webnovel-writer/scripts/tests/test_backup_manager.py归档相关测试用例webnovel-writer/scripts/data_modules/tests/test_archive_manager.py【免费下载链接】webnovel-writer基于 Claude Code 的长篇网文辅助创作系统解决 AI 写作中的「遗忘」和「幻觉」问题支持 200 万字量级 连载创作。项目地址: https://gitcode.com/GitHub_Trending/we/webnovel-writer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考