v6.2.0 - 写章结果更清楚,失败后更好恢复
发版范围
本次发布覆盖从 v6.1.0 到本发布提交的全部变化,不只是最后一次版本号提交。
给作者看的变化
- 命令结束后的结果更好读。初始化、规划、写章和审查会用统一最终报告说明:已完成、部分完成、需要你处理或未完成。
- 写章失败后更好恢复。重复执行同一条
/webnovel-write 章号时,系统会先检查哪些步骤已经可信完成,尽量从失败位置继续。 - 过程提示更少打扰。系统默认继续推进,只有创作方向、事实取舍、文件覆盖风险或审查阻断问题需要你裁决时才询问。
- 写章和审查的中间结果更稳。系统会更严格确认正文、审查结果、故事事实提取、章节提交和故事资料同步是否可信。
- 最小写章模式更安全。跳过完整审查时,会生成明确的跳过记录,不再伪装成完整审查已通过。
- 上下文读取更克制。多个 Skill 和 Agent 的提示词变轻,减少无关参考资料占用上下文,长流程更容易保持重点。
- 项目排查更清楚。不可恢复故障会提示脱敏日志路径,文档也补充了最终报告、断点恢复和运维说明。
是否需要改旧项目
不需要。已有书项目可以继续使用,不需要迁移 .story-system/、.webnovel/、正文、大纲或设定集。
适合谁升级
- 经常连续写多章,希望明确知道“这一章到底有没有写完”的作者。
- 遇到过写章中断、审查阻断、故事资料同步失败后不知道怎么恢复的用户。
- 使用长篇项目、依赖 Story System 记录事实和伏笔的作者。
已知影响
- 这版不会改名现有
/webnovel-*主命令。 - 这版不会放宽 blocking 审查、章节提交或故事资料同步的校验。
- 最终报告会隐藏内部 JSON 和长日志;需要排查时再看
.webnovel/logs/run_last.log。
给维护者
- 新增作者友好报告链路:
author_glossary.py、error_catalog.py、review_author_view.py、user_report.py。 - 新增写章恢复与日志能力:
run_ledger.py、run_logger.py。 - 新增统一 CLI 子命令:
user-report、run-ledger、run-log。 - 收紧 commit artifact、projection writer、write-gate、postcommit 和 review pipeline 的结构化边界。
- 轻量化 init、plan、write、review、query、learn、dashboard、doctor 等 Skill,以及 context/data/reviewer/deconstruction Agent。
- 补充 reference loading map、region-read 规则、上下文瘦身审计和 Claude Code 工具基线文档。
- 增加 prompt integrity、unit tests、behavior eval,覆盖 artifact ownership、minimal write、projection retry、blocking review、断点续跑和日志脱敏。
- 版本元数据同步到
6.2.0。 Plugin Release工作流改为推送到master后自动发版,并保留手动兜底入口。
验证
python -m pytest webnovel-writer/scripts/data_modules/tests/test_user_report.py webnovel-writer/scripts/data_modules/tests/test_run_ledger.py webnovel-writer/scripts/data_modules/tests/test_run_logger.py webnovel-writer/scripts/data_modules/tests/test_webnovel_unified_cli.py webnovel-writer/scripts/data_modules/tests/test_prompt_integrity.py -q --no-covpython webnovel-writer/scripts/run_behavior_evals.py --format jsonpython -m compileall -q webnovel-writer/scripts/data_modules/user_report.py webnovel-writer/scripts/data_modules/run_ledger.py webnovel-writer/scripts/data_modules/run_logger.py webnovel-writer/scripts/data_modules/webnovel.py webnovel-writer/scripts/run_behavior_evals.pypython -X utf8 webnovel-writer/scripts/sync_plugin_version.py --check --expected-version 6.2.0python -X utf8 webnovel-writer/scripts/validate_plugin_package.pygit diff --check