webnovel-doctor

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Webnovel Doctor

目标

Objectives

只读诊断当前书项目：确认所处阶段应有的目录、文件、JSON、SQLite、RAG 配置、Python 依赖与 Dashboard 构建产物是否完整。

Read-only diagnosis of the current book project: Confirm whether the directories, files, JSON, SQLite, RAG configurations, Python dependencies, and Dashboard build artifacts required for the current phase are complete.

原则

Principles

只读诊断：不写项目文件、不自动修复、不安装依赖、不启动 Dashboard。
先
```
project-status
```
取短状态，再
```
doctor
```
做阶段感知检查。
统一用
```
python -X utf8
```
，避免中文路径编码问题。
缺失项按 runtime 推导的阶段解释影响与修复建议，不把 init 刚结束的项目按已写多章项目检查。

Read-only diagnosis: Do not write to project files, do not automatically fix issues, do not install dependencies, do not start the Dashboard.
First retrieve the short status with
```
project-status
```
, then perform phase-aware checks with
```
doctor
```
.
Use
```
python -X utf8
```
uniformly to avoid encoding issues with Chinese paths.
Explain the impact and repair suggestions for missing items based on the phase deduced by runtime; do not check a newly initialized project as if it were a project with multiple chapters written.

执行

Execution

准备路径：

bash

export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"
export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT:?}/scripts"

短状态：

bash

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" project-status --format summary

标准体检：

bash

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" doctor --format text

指定章节加

--chapter {chapter_num}

，深度体检加

--deep

。

Prepare paths:

bash

export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"
export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT:?}/scripts"

Short status:

bash

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" project-status --format summary

Standard health check:

bash

python -X utf8 "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" doctor --format text

Add

--chapter {chapter_num}

to specify a chapter, and

--deep

for in-depth health check.

输出方式

Output Method

汇报包含：当前

phase

与

target_chapter

、是否有 blocker、缺失或异常文件路径、RAG / Python / Dashboard 配置是否缺失、每个问题的影响和建议修复动作。

不执行真实修复，不展示或要求粘贴 API key。

The report includes: current

phase

and

target_chapter

, whether there are blockers, paths of missing or abnormal files, whether RAG / Python / Dashboard configurations are missing, and the impact and suggested repair actions for each issue.

Do not perform actual repairs, do not display or request API keys to be pasted.