# 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-cov`
- `python webnovel-writer/scripts/run_behavior_evals.py --format json`
- `python -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.py`
- `python -X utf8 webnovel-writer/scripts/sync_plugin_version.py --check --expected-version 6.2.0`
- `python -X utf8 webnovel-writer/scripts/validate_plugin_package.py`
- `git diff --check`
