Absorption Debugging Patterns
来源:2026-07-12/13 调试 #119 #138 #100 吸收管线全链路 适用:当吸收结果不符合预期(rejected 太多、产出太少、Step5/6 没触发)
调试检查清单
1. 吸收被 reject 了?检查覆盖度判断
症状:文章明明有价值,但 error_msg = "REJECTED: 无可内化内容"
根因:吸收器看到 SKILL.md 里有相关描述 → 判「已覆盖」→ reject
检查:
# 看被 reject 的原因
sqlite3 circle.db "SELECT error_msg FROM learn_queue WHERE id=N;"
修复:确认 _run_absorb prompt 和 learn-and-build skill 都有「文档≠实现」规则。特征:提到打分表(总分≤4 必须吸)。
2. 吸收跑了但 Step 5+6 没触发?
症状:learn_queue.status=applied 但 learning_results 没有 apply_audit 记录
根因:_on_absorb_done 中 cleanup(Path.unlink())在 _verify_and_apply() 之前执行,result_file 被删后 Path.exists() 返回 False
检查:
grep -A5 "Cleanup" app.py | grep -B2 "_verify_and_apply"
# 正确:_verify_and_apply 在 cleanup 之前
# 错误:cleanup 在 _verify_and_apply 之前
3. hermes 子进程报 unrecognized arguments?
症状:job log 里 hermes: error: unrecognized arguments: X
根因:-s skill1 skill2(空格分隔)→ hermes CLI 不认第二个参数
修复:改为 -s skill1,skill2(逗号分隔)
检查:
grep '"-s"' app.py | grep -v ','
# 如果出现 `"-s", "skill1", "skill2"` → 有 bug
# 正确格式:`"-s", "skill1,skill2"`
4. Flask 重启后 pycache 报 Permission denied?
症状:rm: cannot remove '__pycache__/xxx.pyc': Permission denied
根因:之前的 Flask 进程以 root 运行(via su),pyc 文件 owner=root,termux 用户删不掉
修复:
su -c "rm -rf /data/data/com.termux/files/home/wechat-viewer/__pycache__"
5. 端口 5000 暴露了?
改端口需要更新的文件(共 6 个):
wechat-viewer/app.py—app.run(port=...)+ 内部127.0.0.1:5000引用.hermes/scripts/learn-executor.sh.hermes/scripts/learn-pipeline-trigger.sh.hermes/scripts/wechat-viewer-watchdog.sh—FLASK_PORT=.hermes/skills/wechat-group-digest/scripts/scan_articles.py—API = "http://...".hermes/wechat_reply/wechat_reply_orchestrator.py— prompt 中的 URL
#138 三次吸收全记录
文章:「从模型到Harness:WorkBuddy如何把Agent做成可用产品」score=9
| 尝试 | 结果 | 原因 | 修复措施 |
|---|---|---|---|
| 第1次 | 4知识点吸1个,3个rejected | 看到 SKILL.md 有 ETCLOVG 七层表→判「已实现」 | — |
| 第2次 | 全部 rejected | prompt 没更新,仍是旧逻辑 | 同步更新 _run_absorb prompt |
| 第3次 | ✅ 全部吸收 | 加「文档≠实现」打分表 + L1/L2/L3 分层 | 永久修复 |
关键教训:
- 分类器把方法论标为
memory(应标reference),导致吸收 prompt 按「存关键事实」走,没尝试 patch skill - 吸收器只能做 L1(skill patch + memory add),L2-L3 的 gap 应标「部分吸收」传给 Step 6
- 同一篇文章多次吸收可以产生增量(第一次保守,后面更激进),但需人工触发
#1313 重试:reference 类型 Step 5 指纹门恒 FAIL(WHERE×WHY 病理)
文章:/side 与 /fork 会话原语(learn_queue #1313,score=8,type=reference)
| 尝试 | 结果 | 原因 |
|---|---|---|
| 第1次 | Step5 FINGERPRINT_FAIL |
知识已真正 patch 进 hermes-agent/SKILL.md:3289,但指纹门仍判 FAIL |
| 第2次 | 同样 FAIL(attempt=2) | 未改指纹源,原样重跑同一路径 |
| 第3次 | ✅ | 摘要文件首 40 字与写入目标 SKILL.md 的句子逐字一致 → 短语回退可 grounded |
WHERE:app.py:_verify_and_apply 的 reference 指纹路径(L2904–3068)
WHY(病理):fingerprint_src = result_summary or outline or learn_content,而 result_summary = result_text[:500] = Step 4 报告正文,其首 30 字恒为报告表头 # 学习完成报告\n\n## 学习内容\n- 标题: …。该串结构上永不可能逐字出现在 SKILL.md —— 即 reference 的「主指纹」路径恒失效,唯一可达路径是 outline 短语回退(L2983–2989:取 outline 前 80 字每 20 字一段、strip 后 ≥10 字符者须为目标 SKILL.md 的子串)。
判别信号:error_msg 里 指纹 '# 学习完成报告' 开头 → 就是本病理,不是吸收内容失败。
可复用修法(下次同类 FAIL 直接用):
- 先确认知识是否已落盘(grep 目标 SKILL.md)——已落盘说明这是验证器契约问题,不是吸收失败,不要重复写 skill/memory;
- 让
.summary.md首行(首 40 字内、不含换行)与写进目标 SKILL.md 的句子逐字一致,使短语回退可 grounded(写真实内容,不伪造短语); - 动手前本地复现验证器逻辑做 pre-flight:
outline = summary[:500] + "\n\n" + plan[:500];[outline[i:i+20] for i in range(0,80,20)]每段 strip 后 ≥10 字符且为目标 SKILL.md 子串 → 至少 1 段命中即 PASS。
L3 gap(传 Step 6):把指纹源从「报告表头」改为「摘要/大纲首句」,或对 reference 类型直接以 outline 短语为主源。
#1319 复现:第二次同类失败 ⇒ 升级为类级病理(并修正上文修法的落点)
文章:过程驾驭的系统复杂性天花板(learn_queue #1319,score=8,type=reference,target=new:process-vs-object-complexity-agent-engineering)
| 尝试 | 结果 | 原因 |
|---|---|---|
| 第1次 | Step5 FINGERPRINT_FAIL |
skill meta/process-vs-object-complexity-agent-engineering(84 行)+ memory process-object-complexity-orthogonality-2026 均已真正落盘,指纹门仍 FAIL |
| 第2次(本轮) | ✅ 预期 PASS | 摘要首行改为 memory.json 条目里的逐字句子;本地 pre-flight 复现该分支 → 3/4 短语命中 |
新增实测证据(修正上文 #1313 修法的落点):reference 的 skill 侧短语回退同样恒失效——app.py L2992–2996 的 skill_files = rglob(f"*/{target}/SKILL.md") 用的是带前缀的原始 target(_verify_and_apply(item_id, ltype, target) 传的是 item["learn_target"],即 new:xxx),*/new:xxx/SKILL.md 永不匹配(实测 skill_files=0)。
⇒ reference 类型唯一可达的 grounding 通道只有 memory.json 短语回退(L3016–3029)。据此,上文修法第 2 步的落点应改为:让 .summary.md 首行(首 20 字内无换行、≥40 字)与 memory.json 条目里的句子逐字一致,而不是与 SKILL.md 的句子一致——SKILL.md 写得再对也 ground 不上。
pre-flight 复现脚本(已落盘为 skill 工具,勿再放 ~/tmp):
python3 ~/.hermes/skills/wechat/learn-and-build/scripts/gate_preflight_reference.py <content_file> --target new:xxx
逐行复刻 L2926–3029:算 fingerprint / 打印 raw-target 与去前缀的 skill 路径命中数 / 打印 4 个 20 字短语的命中情况,命中 ≥1 即 PASS。已做正反双向自测:#1319 真实摘要 → PASS(3/4 命中);故意未对齐摘要 → FAIL(exit=2),非橡皮图章。同类 FAIL 先改 summary 首行跑它,PASS 再收尾。
共性判据:error_msg 里指纹以 # 学习完成报告 开头 ⇒ 恒为本病理(验证器契约问题),先 grep 知识是否已落盘,不重复写 skill/memory。