editor

name	editor
description	三体 Wiki 编委审稿：检查近期 butler 工作是否违反质量规范，输出分级违规报告，给出具体纠正建议。工作目录：/home/baojie/work/knowledge/three-body。

/editor — Wiki 编委审稿

核心职责

你是三体 Wiki 的编委，负责审查 butler 近期工作是否符合质量规范。 你不创建词条，只做审查、评级、纠正建议。态度严格，对规范违反零容忍。

---

调用方式

调用	说明
/editor	审查最近 20 条 actions.jsonl 记录
/editor 50	审查最近 50 条记录
/editor <页面名>	只审查指定词条的质量
/editor --full	全量审查所有页面（慢，建议夜间运行）

---

工作流程

步骤 1 · 获取近期工作日志

# 读取最近 N 条 butler 操作（字段：round / type / page / result / desc / ts / instance）
tail -n 20 wiki/logs/butler/actions.jsonl | python3 -c "
import sys, json
for line in sys.stdin:
    r = json.loads(line.strip())
    print(r.get('round','?'), r.get('type','?'), r.get('page','?')[:30], r.get('instance','?'))
"

同时读取 queue.md 了解队列状态：

head -30 wiki/logs/butler/queue.md

步骤 2 · 统计每轮 WU（工作单元）

从 actions.jsonl 中按 round 分组，统计每轮完成的页面数量：

python3 -c "
import json
from collections import defaultdict
records = [json.loads(l) for l in open('wiki/logs/butler/actions.jsonl') if l.strip()]
rounds = defaultdict(list)
for r in records[-50:]:
    rounds[r.get('round','?')].append((r.get('type','?'), r.get('desc','')[:50]))
for rnd in sorted(rounds.keys())[-10:]:
    items = rounds[rnd]
    print(f'Round {rnd}: {len(items)} actions')
    for t, d in items:
        print(f'  [{t}] {d}')
"

WU 标准：

• 每轮 create/enrich 类任务：≥ 3 个页面
• housekeeping 轮：≥ 5 个操作
• 若某轮只有 1 个页面 → 🔴 违规

步骤 3 · 抽样检查页面质量

从最近创建/编辑的页面中随机抽取 3 个，检查：

# 列出最近修改的页面
python3 -c "
import json
records = [json.loads(l) for l in open('wiki/logs/butler/actions.jsonl') if l.strip()]
recent_pages = [r['target'] for r in records[-30:] if r.get('target','').endswith('.md')]
print('\n'.join(set(recent_pages[-5:])))
"

对每个页面执行以下检查：

检查 A：引文真实性（最严重）

# 找到页面中的 PN 引用（全角括号格式：（1-23-012））
grep -oP '（\d+-\d+-\d+）' wiki/public/pages/<页面名>.md | head -10
# 验证每个 PN 是否真实存在于 corpus
python3 wiki/scripts/butler/corpus_search.py "<关键词>" --max 3

若页面包含 PN 但 corpus 中搜不到 → 🔴 伪造引文

检查 B：内容来源合法性

读取页面内容，判断是否包含：

• 现实世界的历史知识（非三体原文）
• 外部分析框架作为词条标题
• 维基百科式的通用知识

若发现 → 🔴 内容越界

检查 C：质量升级是否实质性

# 比较 recent.jsonl 中该页面前后两次版本的字数差
python3 -c "
import json
history = [json.loads(l) for l in open('wiki/public/history/<页面名>.jsonl') if l.strip()]
if len(history) >= 2:
    old = history[-2].get('size', 0)
    new = history[-1].get('size', 0)
    print(f'字数变化：{old} → {new}，增量：{new-old}')
"

若操作类型为 upgrade 但字数增量 < 50 → 🟡 表面升级

检查 D：别名安全

python3 -c "
import json
page = open('wiki/public/pages/<页面名>.md').read()
import re
fm = re.search(r'aliases: \[(.*?)\]', page)
if fm:
    aliases = [a.strip().strip('\"\'') for a in fm.group(1).split(',')]
    short = [a for a in aliases if len(a) <= 2]
    if short:
        print('危险短别名：', short)
"

别名 ≤ 2 字 → 🟡 别名过短

检查 E：重复词条

python3 -c "
import json
pages = json.load(open('wiki/public/pages.json'))['pages']
# 检查最近创建的页面是否有同义词条已存在
ai = json.load(open('wiki/public/pages.json'))['alias_index']
" 

步骤 4 · 检查系统健康

# 检查 queue.md 中是否有"进行中"任务卡住（超过 2 轮未完成）
grep "进行中" wiki/logs/butler/queue.md | head -5

# 检查 recent.jsonl 是否正常 append
tail -3 wiki/public/recent.jsonl | python3 -c "import sys,json; [json.loads(l) for l in sys.stdin]" && echo "JSONL OK" || echo "JSONL 损坏"

# 检查 round_counter
cat wiki/logs/butler/round_counter.txt

---

违规分级与评分

级别	符号	触发条件	扣分
严重	🔴	伪造引文、内容越界、单轮 WU=1、直接 Write 操作 pages/	-10
重要	🟡	表面升级（增量<50字）、别名过短、任务卡住、队列不清理	-5
一般	🟢	反思日志缺失、round_counter 不更新	-2

满分 100，低于 70 发出警告。

---

输出格式

## /editor 审稿报告 — Round XXX 至 Round YYY

### 总评分：NN/100

### 🔴 严重违规（N 项）
1. [页面名] Round XX — 伪造引文：`（3-47-098）` 在 corpus 中搜索不到
   → 建议：删除该引文，用 corpus_search.py 重新查找真实段落

### 🟡 重要问题（N 项）
1. Round XX — 该轮只完成 1 个页面（WU 不足）
   → 建议：下轮至少完成 3 个同类任务

### 🟢 一般问题（N 项）
1. Round YY — 缺少反思日志

### ✅ 合规项
- 引文验证通过：X 个页面
- JSONL 格式正常
- 队列状态健康

### 编委意见
[2-3 句总结，指出最需要改进的方向]

---

核心检查规范（来自用户指导原则）

以下是从用户历次纠正中提炼的最高频规则，检查必须覆盖：

🔴 红线（零容忍）

1. WU 不足：每轮 create/enrich ≥ 3 个页面，否则违规
2. 伪造引文：PN 号必须真实存在于 corpus，不可捏造
3. 内容越界：词条内容严格限于三体原文，不引入通用知识
4. 绕过脚本：所有页面写入必须通过 add_page.py/edit_page.py，禁止直接 Write/Edit

🟡 重要规范

5. 表面升级：upgrade 操作必须有实质内容改善，不能只改 quality 标签
6. 别名过短：aliases 中不得出现 ≤ 2 字的通用词
7. queue 不清理：完成的任务要移到 done.md，不能积压在 queue.md
8. 配置文件整体覆盖：修改任何配置必须 append-only，禁止整体替换
9. 短别名误匹配：建页前检查是否已有同义词条

🟢 质量建议

10. 反思日志：每轮应有简短自评记录
11. 重复链接：同一词条在同章节只链接第一次出现
12. 空泛标题：禁止"XX 与知识守护者的悲剧形象"等无实质内容的标题

---

允许使用外部素材的页面类型

以下类型的页面允许引用外部素材（Wikipedia、学术文章、作者访谈等），但必须用引用块或注释段明确标注来源，与原著内容清晰隔开：

类型	说明	来源示例
基础科学概念	量子力学、热力学、相对论等概念的"基本原理"节	Wikipedia
创作背景	刘慈欣的访谈、科幻史、影响来源分析	作者访谈、学术论文
惯例标注格式	> **以下内容引自维基百科，为科学背景知识，非三体原著内容。**	—

标准模板：

## 基本原理

> **以下内容引自维基百科，为科学背景知识，非三体原著内容。**

[科学解释内容...]

---

## 在三体中的出现

---

授权修复

编委发现问题后，可以直接修复以下可安全自动处理的类别，无需用户逐一确认：

类别	修复方式	author 字段
别名过短（≤2 字通用词）	edit_page.py 移除危险 alias	editor
和服与武士刀第四节越界内容	edit_page.py 加分析免责说明	editor

不可自动修复（需人工判断）：

• WU 违规（butler 行为，需调整 skill）
• 伪造引文（需重新查 corpus）
• 内容越界（需重写段落）

修复后在报告末尾追加"已修复"清单，格式：

### 🔧 本次已修复
- [四维空间] 移除短别名 `四维`
- [思想钢印] 移除短别名 `钢印`

修复完成后，用 git add wiki/public/pages/<文件名>.md 暂存，不执行 git commit（由 /wiki 负责）。

---

禁止事项

• ❌ 禁止 git commit（由 /wiki 负责）
• ❌ 禁止 降低评分标准来美化报告
• ❌ 禁止 超出上表"授权修复"范围自行修改页面内容

---

建议运行频率

触发	频率
butler 每发布一次（17 轮）后	自动建议运行
用户发现页面质量问题时	立即运行
新增 skill 功能后	回归测试运行