novel-reviewer

name	novel-reviewer
description	Use when user wants to check logic consistency, polish style, find plot holes, or review existing chapters. Triggers include "检查", "润色", "逻辑", "伏笔漏洞", "审查".

小说审查润色

编排 LoreChecker + Stylist + StyleDirector 审查流程。

触发条件

• "检查逻辑" / "逻辑检查"
• "润色" / "润色风格"
• "找伏笔漏洞" / "伏笔检查"
• "审查章节" / "审查"
• "风格问题"

工作流程

digraph review_flow {
    rankdir=TB;
    
    "审查请求" [shape=box];
    "审查范围?" [shape=diamond];
    "逻辑检查" [shape=box];
    "风格检查" [shape=box];
    "完整审查" [shape=box];
    "生成报告" [shape=box];
    "需要修改?" [shape=diamond];
    "自动润色" [shape=box];
    "完成" [shape=box style=filled fillcolor=lightgreen];
    
    "审查请求" -> "审查范围?";
    "审查范围?" -> "逻辑检查" [label="仅逻辑"];
    "审查范围?" -> "风格检查" [label="仅风格"];
    "审查范围?" -> "完整审查" [label="完整"];
    "逻辑检查" -> "生成报告";
    "风格检查" -> "生成报告";
    "完整审查" -> "生成报告";
    "生成报告" -> "需要修改?";
    "需要修改?" -> "自动润色" [label="是"];
    "需要修改?" -> "完成" [label="否"];
    "自动润色" -> "完成";
}

审查类型

1. 逻辑检查 (LoreChecker)

检查项目:
├── 时间线一致性
│   └── 事件顺序是否合理
├── 角色状态变异
│   ├── 获得物品 (acquire)
│   ├── 使用技能 (use)
│   ├── 移动位置 (move)
│   ├── 生命状态 (health)
│   └── 修炼境界 (realm)
├── 伏笔回收状态
│   ├── 待回收是否超期
│   └── 回收是否合理
└── 世界观规则
    └── 是否违反设定

可选：使用内置 ReviewerAgent（融合 InkOS 33维度审计）

from tools.agent import ReviewerAgent, AgentContext
from tools.llm import LLMClient, LLMConfig

config = LLMConfig.from_env()
client = LLMClient(config)
ctx = AgentContext(client, config.model, project_root)

reviewer = ReviewerAgent(ctx)
result = await reviewer.review(content, context, dimensions=[1,2,3,6,7,8])

ReviewerAgent 支持 33维度审计（从 InkOS 融合）：

维度	名称	维度	名称
1-9	逻辑类	20-23	AI痕迹类
10-19	质量类	24-37	高级审计类

逻辑检查示例

用户: 检查第五章的逻辑

AI: 🔍 逻辑检查：第五章

## 检查结果

### ✅ 通过项
- 时间线顺序正确
- 角色位置连续
- 伏笔引用有效

### ⚠️ 警告 (2)
1. **角色状态**: 张三在 ch_004 受伤，但 ch_005 直接战斗未说明恢复
   - 建议: 添加伤势恢复的描述

2. **世界观**: 档案馆需要凭证才能进入，但角色直接进入
   - 建议: 说明令牌来源或进入方式

### ❌ 错误 (0)
无严重逻辑错误

2. 风格检查 (Stylist)

检查项目:
├── AI 痕迹检测
│   ├── 40+ 中文 AI 套路词 (craft/ai_patterns.yaml)
│   ├── 段落等长变异系数检测 (融合 InkOS dim 20)
│   ├── 套话词密度检测 (融合 InkOS dim 21)
│   ├── 公式化转折词检测 (融合 InkOS dim 22)
│   └── 列表式结构检测 (融合 InkOS dim 23)
├── 声音一致性
│   └── 叙述者与角色声音融合
├── 信息倾倒
│   └── 过度密集的信息描述
├── 节奏分布
│   └── 段落长度变化
└── 对话风格
    └── 符合角色性格

AI 痕迹检测词库（部分，完整见 craft/ai_patterns.yaml）

禁用词:
- "仿佛" + 比喻
- "如同" + 比喻
- "心中涌起一股..."
- "眼神中闪过一丝..."
- "嘴角微微上扬"
- "轻轻地点了点头"
- "缓缓地吐出一口气"
- "不禁..."
- "不由得..."
- "下意识地..."

风格检查示例

用户: 检查第五章的风格

AI: 🎨 风格检查：第五章

## 检查结果

### ❌ AI 痕迹 (3处)
1. 第12行: "嘴角微微上扬"
   - 替换建议: "笑了" 或 具体表情描写

2. 第45行: "心中涌起一股莫名的情绪"
   - 替换建议: 描述具体情绪或身体反应

3. 第78行: "眼神中闪过一丝复杂的神色"
   - 替换建议: 具体描述是什么神色

### ⚠️ 节奏问题 (1处)
- 第3-5段连续长段落（>200字）
- 建议: 插入短句或对话调节节奏

### ✅ 通过项
- 声音一致性良好
- 对话符合角色性格
- 无信息倾倒

## 风格评分
| 维度 | 分数 |
|------|------|
| AI 痕迹 | 75/100 |
| 声音一致性 | 90/100 |
| 节奏分布 | 85/100 |
| 综合评分 | 83/100 |

3. 完整审查报告

用户: 审查第五章

AI: 📋 完整审查报告：第五章

## 基本信息
- 章节: ch_005
- 字数: 3,521
- 审查时间: 2026-03-03 08:50

## 一、逻辑检查

| 类别 | 状态 | 数量 |
|------|------|------|
| 错误 | ❌ | 0 |
| 警告 | ⚠️ | 2 |
| 通过 | ✅ | 8 |

### 警告详情
1. [角色状态] 张三伤势未说明恢复
2. [世界观] 档案馆进入方式未说明

## 二、风格检查

| 维度 | 分数 | 状态 |
|------|------|------|
| AI 痕迹 | 75 | ⚠️ 需改进 |
| 声音一致性 | 90 | ✅ 良好 |
| 节奏分布 | 85 | ✅ 良好 |

### 需修改项
1. 第12行: "嘴角微微上扬" → 建议修改
2. 第45行: "心中涌起..." → 建议修改
3. 第78行: "眼神中闪过..." → 建议修改

## 三、伏笔检查

| 伏笔 ID | 状态 | 说明 |
|---------|------|------|
| ch_002_mystery_letter | ✅ 已回收 | 信件内容揭示 |

## 总结

**审查结果**: 需修改后通过

**建议操作**:
1. 修复 2 处逻辑警告
2. 修改 3 处 AI 痕迹
3. 调整 1 处节奏问题

**下一步**:
- 输入 "润色" 自动修复风格问题
- 或手动修改后重新审查

自动润色（基于已合成风格）

**说明**: 风格规则直接从 `composed.md` 读取，该文件已包含三层合成结果（craft/ + styles/ + novels/），无需重新组装。
用户: 润色第五章

AI: ✨ 风格润色中...

### 修改内容

**第12行**:
- 原文: 他嘴角微微上扬。
- 修改: 他笑了，眼角的皱纹舒展开来。

**第45行**:
- 原文: 他心中涌起一股莫名的情绪。
- 修改: 他握紧了拳头，指甲陷入掌心。

**第78行**:
- 原文: 她眼神中闪过一丝复杂的神色。
- 修改: 她垂下眼帘，睫毛在烛光中投下阴影。

### 润色统计
- 修改处: 3
- 新增字数: +15
- 删除字数: -12

✅ 润色完成，已更新 manuscript/arc_001/ch_005.md

文件访问

操作	路径
读取草稿	data/novels/{id}/data/manuscript/
读取合成风格	data/novels/{id}/data/style/composed.md
读取提取风格源	data/novels/{id}/data/sources/{source_id}/style/
读取角色设定	data/novels/{id}/src/characters/ + data/novels/{id}/data/characters/cards/
读取世界观	data/novels/{id}/src/world/ + data/novels/{id}/data/world/
写入润色	data/novels/{id}/data/manuscript/
审查记录	data/novels/{id}/data/manuscript/*_review.yaml

审查模式

模式	严格度	说明
宽松	低	仅报告错误，警告不阻塞
标准	中	报告错误和警告
严格	高	警告也阻塞通过

错误处理

错误	处理
文件不存在	提示先创建草稿
风格档案缺失	使用默认规则
润色失败	保留原文，报告失败原因

与其他 Skill 的关系

• novel-creator: 创作完成后触发审查
• novel-manager: 审查后更新伏笔状态