# Absorption Debugging Patterns > 来源:2026-07-12/13 调试 #119 #138 #100 吸收管线全链路 > 适用:当吸收结果不符合预期(rejected 太多、产出太少、Step5/6 没触发) ## 调试检查清单 ### 1. 吸收被 reject 了?检查覆盖度判断 **症状**:文章明明有价值,但 `error_msg = "REJECTED: 无可内化内容"` **根因**:吸收器看到 SKILL.md 里有相关描述 → 判「已覆盖」→ reject **检查**: ```bash # 看被 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 **检查**: ```bash 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`(逗号分隔) **检查**: ```bash 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 用户删不掉 **修复**: ```bash 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 分层 | 永久修复 | **关键教训**: 1. 分类器把方法论标为 `memory`(应标 `reference`),导致吸收 prompt 按「存关键事实」走,没尝试 patch skill 2. 吸收器只能做 L1(skill patch + memory add),L2-L3 的 gap 应标「部分吸收」传给 Step 6 3. 同一篇文章多次吸收可以产生增量(第一次保守,后面更激进),但需人工触发 ## #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 直接用)**: 1. 先确认知识是否**已落盘**(grep 目标 SKILL.md)——已落盘说明这是**验证器契约问题,不是吸收失败**,不要重复写 skill/memory; 2. 让 `.summary.md` **首行**(首 40 字内、不含换行)与写进目标 SKILL.md 的句子**逐字一致**,使短语回退可 grounded(写真实内容,不伪造短语); 3. 动手前本地复现验证器逻辑做 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 --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。