Quality Checker - 章节质量检测器#

Overview#

分析章节正文，检测潜在质量问题并生成详细报告，包含评分（0-100 分）和具体改进建议。

使用场景：

• 需要评估章节质量
• 需要发现写作问题（字数不足、段落过长、对话比例异常等）
• 需要量化质量指标进行对比
• 需要在发布前进行质量把关

检测项目#

检测项说明阈值字数检测检查是否达到目标字数≥ 目标字数 80%段落长度检测过长段落（影响阅读节奏）≤ 200 字/段对话比例检测对话占比是否合理20%-60%标点滥用检测感叹号/问号过度使用≤ 10%重复用词检测高频重复词汇≤ 5 次/词

质量评分#

分数等级说明90-100优秀可直接发布80-89良好少量问题70-79中等需要修改60-69及格建议修改<60不合格需要大修

CLI 使用#

bash

# 基本用法
python3 scripts/check_quality.py --input chapters/chapter-01.md

# 指定目标字数
python3 scripts/check_quality.py \
  --input chapters/chapter-01.md \
  --word-count 3000

# 输出报告到文件
python3 scripts/check_quality.py \
  --input chapters/chapter-01.md \
  --output reports/chapter-01-quality.md

# 简写
python3 scripts/check_quality.py -i chapter.md -w 3000 -o report.md

参数说明#

参数必填说明--input / -i✅章节正文文件路径（Markdown）--word-count / -w❌目标字数（默认 3000）--output / -o❌输出报告文件路径

输出报告格式#

markdown

# 章节质量检测报告

**章节**: chapter-01.md
**检测时间**: 2026-04-04 23:50:00
**质量评分**: 85/100 (良好)

## 检测结果

| 检测项 | 状态 | 详情 |
|--------|------|------|
| 字数 | ✅ 通过 | 2850/3000 (95%) |
| 段落长度 | ⚠️ 警告 | 3 个段落超过 200 字 |
| 对话比例 | ✅ 通过 | 35% (正常范围 20%-60%) |
| 标点滥用 | ✅ 通过 | 感叹号占比 3% |
| 重复用词 | ⚠️ 警告 | "突然" 出现 8 次 |

## 问题详情

### 段落过长
- 第 3 段：256 字
- 第 7 段：234 字
- 第 12 段：218 字

### 重复用词
- "突然": 8 次
- "仿佛": 6 次
- "感觉": 5 次

## 改进建议

1. 拆分第 3、7、12 段，每段控制在 200 字以内
2. 减少"突然"的使用频率，尝试同义替换
3. 增加 150 字达到目标字数

依赖#

• Python 3.8+
• rich (终端渲染)

安装依赖：

bash

pip install -r scripts/requirements.txt

与其他技能集成#

与 novel-writer 集成#

bash

# 1. 生成章节正文
python3 ../novel-writer/scripts/write_chapter.py \
  --book-dir projects/my-novel \
  --chapter 1 \
  --outline outlines/chapter-1.md \
  --output chapters/chapter-01.md

# 2. 检测质量
python3 scripts/check_quality.py \
  --input chapters/chapter-01.md \
  --word-count 3000 \
  --output reports/chapter-01-quality.md

批量检测#

bash

# 检测全部章节
for chapter in chapters/chapter-*.md; do
    python3 scripts/check_quality.py \
        --input "$chapter" \
        --word-count 3000 \
        --output "reports/$(basename "$chapter" .md)-quality.md"
done

注意事项#

• 支持 UTF-8 和 GBK 编码的 Markdown 文件
• 质量评分仅供参考，具体标准可根据项目调整
• 对话检测基于引号识别，可能不完全准确
• 重复用词检测自动过滤常见虚词（的、了、是等）