用途
Webnovel Doctor 用于对网文项目做只读体检与诊断，对应命令为 /webnovel-doctor。其目标是确认当前书项目在所处阶段应有的目录、文件、JSON、SQLite、RAG 配置、Python 依赖与 Dashboard 构建产物是否完整。
主要能力
- 阶段感知检查：根据项目当前所处阶段判断应有哪些内容，避免用不匹配的阶段标准误判。
- 检查范围覆盖目录、文件、JSON、SQLite、RAG 配置、Python 依赖与 Dashboard 构建产物。
- 支持标准体检与深度体检（--deep），并可指定章节（--chapter {chapter_num}）。
- 输出当前 phase 与 target_chapter、是否存在 blocker、缺失或异常文件路径、RAG / Python / Dashboard 配置是否缺失，以及每个问题的影响和建议修复动作。
使用方式
准备路径：
export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}" export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT:?}/scripts"
获取短状态：
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" project-status --format summary
标准体检：
python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" doctor --format text
指定章节加 --chapter {chapter_num}，深度体检加 --deep。
原则与限制
- 只读诊断：不写项目文件、不自动修复、不安装依赖、不启动 Dashboard。
- 先 project-status 取短状态，再 doctor 做阶段感知检查。
- 统一用 python -X utf8，避免中文路径编码问题。
- 缺失项按 runtime 推导的阶段解释影响与修复建议，不把 init 刚结束的项目按已写多章项目检查。
- 不执行真实修复，不展示或要求粘贴 API key。
适用场景
适合在网文项目写作流程中，对项目完整性做只读核查，定位缺失或异常的文件与配置，并据此获得修复方向。