Webnovel Writer 项目目录结构全解：一本书的 .story-system 与 .webnovel 各放什么

Webnovel Writer 项目目录结构全解一本书的 .story-system 与 .webnovel 各放什么【免费下载链接】webnovel-writer基于 Claude Code 的长篇网文辅助创作系统解决 AI 写作中的「遗忘」和「幻觉」问题支持 200 万字量级 连载创作。项目地址: https://gitcode.com/GitHub_Trending/we/webnovel-writer如果你在用 Webnovel Writer 这个基于 Claude Code 的长篇网文辅助创作系统支持 200 万字量级连载主打解决 AI 写作遗忘和幻觉初始化一本书后一定会在书项目根目录看到两个隐藏目录.story-system/和.webnovel/。很多新手的第一反应是——它们到底谁是真的能不能手动改这篇文章一次讲清.story-system/存合同与提交事实真源.webnovel/存状态、索引、摘要与备份只读视图谁该看谁、坏了查哪里看完这篇就够了。先认识一本书的完整骨架 执行/webnovel-init后书项目长这样project-root/ ├── .story-system/ # 合同、章节提交和事件审计事实真源 ├── .webnovel/ # 状态、索引、摘要、备份和长期记忆只读视图 ├── 正文/ # 章节正文 ├── 大纲/ # 总纲、卷纲、时间线和章纲 ├── 设定集/ # 世界观、角色、力量体系等设定 └── 审查报告/ # 章节审查报告六个目录分成三类类别目录一句话说明事实真源.story-system/动笔前的合同和写完后的提交都在这里只读视图.webnovel/从主链派生的状态、索引、摘要、备份创作内容正文/大纲/设定集/审查报告/作者直接阅读和修改的 Markdown记住一个核心原则.story-system/是主链真源.webnovel/*是它的投影read-model。这个定位写在架构文档 docs/architecture/overview.md 里也是全文的关键。.story-system/动笔前的合同与写完后的提交.story-system/是 Story System 的独立运行面v6.0.0 起的默认主链。它按合同优先 提交优先工作写之前先立合同写之后才入账提交。合同种子MASTER_SETTING.json 与 anti_patterns.json.story-system/MASTER_SETTING.json全书主设定合同是 Story System 健康预检preflight和doctor体检的必看项。init 完成、该文件存在项目才算进入可写作状态。.story-system/anti_patterns.json反模式配置告诉系统哪些写法是这本书要避开的坑。这两个文件在/webnovel-init完成 Story System 初始化时生成之后不建议手改——系统检测到手改会提示走正规流程而不是静默接受。运行时合同volumes/、chapters/、reviews/规划/webnovel-plan和写章/webnovel-write时系统会按章节生成三组合同文件路径模式作用volumes/volume_001.json卷合同这一卷的目标、节奏约束chapters/chapter_001.json章合同这一章必须达成什么、不能违背什么reviews/chapter_001.review.json审查合同本章的审查标准与结果这些合同是 Context Agent 生成写作任务书和 Reviewer 做六维审查的依据——所谓大纲即法律、设定即物理落地就是这些 JSON 在干活。提交链与事件审计commits/ 与 events/commits/chapter_001.commit.json一章写完并过审后新事实以CHAPTER_COMMIT的形式在此入账这是全书不可变的事实记录判断某章是 accepted 还是 rejected 就看这里。events/事件审计链记录章节事件、修订提案与覆写账本出问题时可以追溯这一条事实是哪一章、怎么改过来的。⚠️ 重点提醒commits/是受 Hook 保护的目录。webnovel-writer/hooks/guard_runtime_write.py 会直接阻断对.story-system/commits/的手写或绕过命令提示你必须走chapter-commit等 runtime 命令——目的是保证提交链的原子性不被手滑破坏。.webnovel/一切看得见摸得着的视图.webnovel/里没有一个事实源头它们全部由主链投影而来供查询、展示和恢复使用文件/目录用途state.json运行时状态快照初始化配置、进度、主角状态、伏笔线程等刻意保持精简5KBindex.db/vectors.db实体索引SQLite与向量检索库供/webnovel-query快速召回summaries/chapter_001.md章节摘要写长章后 AI记起前情的关键memory_scratchpad.json工作记忆暂存跨章的短期上下文projection_log.jsonl投影执行日志state/index/summary/memory/vector 哪一路没同步查它backups/archive/章节级备份与归档误操作后的救命稻草logs/run_last.log脱敏运行日志只有不可恢复故障时才需要翻tmp/审查、消歧等中间产物可安全清理一个小技巧当/webnovel-query查不到某个角色或伏笔时优先看projection_log.jsonl是哪条投影失败了再跑projections retry补跑——而不是去改state.json硬凑数据那也是被 Hook 保护的。两者如何协作一条单向数据流 .story-system/合同 → 写章 → CHAPTER_COMMITaccepted ├→ .webnovel/state.json ├→ index.db / vectors.db ├→ summaries/ memory_scratchpad.json └→ Dashboard 只读面板写之前story-system --persist落合同种子--emit-runtime-contracts生成本章运行时合同 写前校验写之后chapter-commit生成 accepted 提交再统一驱动 state、index、summary、memory、vector 五条投影。这个先合同、后提交、再投影的单向流正是 Webnovel Writer 能把 200 万字写崩的概率压到最低的原因文笔可以发挥但发生过的事实必须登记、过审、存档。完整链路说明见 docs/architecture/overview.md阶段判定规则见 docs/architecture/plugin-runtime-hardening-spec-2026-06-04.md。新手高频问题速答 ✅Q1我想手改 state.json 把某个角色状态改了行吗不建议。state.json是只读投影手改会被下次投影覆盖且被 Hook 阻断。正确姿势让正文事实先行写进章节通过chapter-commit入账。Q2init 刚跑完为什么没有commits/和summaries/正常。规划/写作之前不该有这些产物体检doctor/preflight对它们的缺失只会标记skip或info不是故障。Q3删掉.webnovel/会丢书吗不会丢事实。事实都在.story-system/的提交链里.webnovel/的索引和摘要可以从主链重建。真正不能丢的是.story-system/commits/和backups/。Q4怎么快速判断项目现在处于哪个阶段跑preflight或/webnovel-doctor有state.json 设定集但无MASTER_SETTING.json说明刚 init 完骨架MASTER_SETTING.json就位才说明 Story System 就绪可以进入 plan。写在最后一张表收尾你想知道看哪里这本书法律上允许发生什么.story-system/MASTER_SETTING.jsonchapters/章合同第 N 章到底写定了什么事实.story-system/commits/chapter_NNN.commit.json全书当前进度、进度快照.webnovel/state.json查角色/伏笔/关系/webnovel-query背后是index.db哪条投影坏了.webnovel/projection_log.jsonl可视化全貌/webnovel-dashboard理解了.story-system 管真源、.webnovel 管视图这一条主线Webnovel Writer 的所有命令和体检报告你都能看懂。接下来不妨打开你的书项目对照本文跑一遍preflight亲眼看看这两个目录在你项目里的样子。【免费下载链接】webnovel-writer基于 Claude Code 的长篇网文辅助创作系统解决 AI 写作中的「遗忘」和「幻觉」问题支持 200 万字量级 连载创作。项目地址: https://gitcode.com/GitHub_Trending/we/webnovel-writer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考