- name
- consistency-checker
- description
- 一致性检查器 - 检测小说章节中的一致性问题。当需要检查角色名称、特征、时间线、地点描述是否前后一致时使用。
Consistency Checker - 一致性检查器
Overview
读取角色档案和章节正文，自动检测一致性问题，包括角色名称不一致、特征矛盾、时间线混乱、地点描述矛盾等。
使用场景：
- 需要检查章节与角色档案的一致性
- 需要发现前后矛盾的描述
- 需要确保时间线连贯
- 需要在发布前进行一致性审核
检测项目
| 检测项 | 说明 |
|---|---|
| 角色名称 | 检测同一角色的不同称呼/译名 |
| 特征矛盾 | 检测与角色档案矛盾的描述（如眼睛颜色、年龄等） |
| 时间线 | 检测时间描述是否连贯（如"第二天"vs"三天后"） |
| 地点矛盾 | 检测地点描述是否前后一致 |
| 关系矛盾 | 检测角色关系是否与档案一致 |
CLI 使用
# 基本用法
python3 scripts/check_consistency.py --book-dir projects/my-novel --chapter chapters/chapter-01.md
# 输出报告到文件
python3 scripts/check_consistency.py \
--book-dir projects/my-novel \
--chapter chapters/chapter-01.md \
--output reports/chapter-01-consistency.md
# 简写
python3 scripts/check_consistency.py -d ./project -c chapter.md -o report.md参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
--book-dir / -d | ✅ | 小说项目目录路径 |
--chapter / -c | ✅ | 章节文件路径（相对于 book-dir） |
--output / -o | ❌ | 输出报告文件路径 |
项目目录结构
projects/my-novel/
├── characters/ # 角色档案（必需）
│ ├── 主角.yml
│ └── 配角.yml
├── chapters/ # 章节正文
│ └── chapter-01.md
└── reports/ # 检查报告输出
└── chapter-01-consistency.md角色档案格式 (characters/*.yml)
name: 林风
aliases:
- 林侦探
- 风哥
gender: 男
age: 35
features:
- 黑色短发
- 灰色眼睛
- 左眉疤痕
occupation: 私家侦探
relationships:
苏雨：咖啡馆老板娘，朋友
background: 前刑警输出报告格式
# 一致性检测报告
**章节**: chapters/chapter-01.md
**检测时间**: 2026-04-04 23:55:00
**问题数量**: 3
## 检测结果
| 检测项 | 状态 | 问题数 |
|--------|------|--------|
| 角色名称 | ⚠️ 警告 | 1 |
| 特征矛盾 | ✅ 通过 | 0 |
| 时间线 | ⚠️ 警告 | 1 |
| 地点矛盾 | ✅ 通过 | 0 |
| 关系矛盾 | ✅ 通过 | 0 |
## 问题详情
### 角色名称不一致
- "林峰" → 应为 "林风"（出现 2 次）
### 时间线混乱
- 第 5 段："第二天清晨"
- 第 12 段："三天后的夜晚"
- 建议：检查时间跨度是否合理
## 建议
1. 统一使用 "林风" 作为角色名称
2. 核实时间线是否连贯依赖
- Python 3.8+
- rich (终端渲染)
- PyYAML (配置文件解析)
安装依赖：
pip install -r scripts/requirements.txt与其他技能集成
与 novel-writer 集成
# 1. 生成章节正文
python3 ../novel-writer/scripts/write_chapter.py \
--book-dir projects/my-novel \
--chapter 1 \
--output chapters/chapter-01.md
# 2. 检查一致性
python3 scripts/check_consistency.py \
--book-dir projects/my-novel \
--chapter chapters/chapter-01.md \
--output reports/chapter-01-consistency.md与 quality-checker 集成
# 1. 质量检测
python3 ../quality-checker/scripts/check_quality.py \
--input chapters/chapter-01.md \
--output reports/chapter-01-quality.md
# 2. 一致性检查
python3 scripts/check_consistency.py \
--book-dir projects/my-novel \
--chapter chapters/chapter-01.md \
--output reports/chapter-01-consistency.md注意事项
- 角色档案目录（characters/）为必需
- 支持 UTF-8 和 GBK 编码
- 时间线检测基于关键词识别，可能不完全准确
- 建议每章完成后立即进行一致性检查