书阁

消息与规则

第1章 · 笔记 1

笔记 1

- 证据:35/35 双向用例 PASS 含实案原句命中;t_3368df26 全量 19 条回归无翻车;两处判据(adapter.py/send_group_msg.py)常量区 sha256 逐字一致(4a633e6f…)+10 正则 pattern diff 空+行为探针 35 用例双跑一致;dry-run 实测命中补前置真艾特原文零改写、反例零变化。

- 改动:~/.hermes/scripts/send_group_msg.py、/Users/mac/AI/hermes-agent-main/plugins/platforms/feishu/adapter.py(同文判据+补齐 1 行注释漂移)、补丁登记 plugins__platforms__feishu__adapter_py.patch 重生成 1091 行+manifest post_md5 刷 f3e1c4b4…、验证脚本 t_c42b1e26_verify_plain_at_window.py;备份 4 份 ~/.hermes/backups/*-t_c42b1e26;gateway 重载请求 r1792421265358-95050 已登记(空窗执行)。

- 异常:线上 gateway 进程 22:14:59 启动早于判据 mtime 22:46:25,重载完成前 adapter 侧仍旧判据(send_group_msg 旁路即时生效);行动词词表未扩充(范围最小化),「重写/补充/说明」等仍不命中(漏报≠合规已声明)|阿普

- 清单 parity 巡检 FAIL 修复:cron_count 自愈化 + computer-use 落点迁移(t_1995eb4f,2026-10-19)

- 结论:做完——两 FAIL 根因修复:① computer-use 台账判 shared 未落地(10-18 22:39 归档批与 22:33 台账快照时差)→ mv 迁全局 + --sync 刷 observed,5 profile 可见性实测无损;② cron_count 时序竞态(sync 30 分钟窗口内 cron 增删即误报)→ check_cron_count 自愈化(检出漂移调 sync_cron_count.py 写回再复核),并修 sync_cron_count.py STATE_FILE 幂等短路盲区(页面脱钩永不修)。

- 证据:pitfall_map_placement_guard --check 静默 RC=0;listing_parity_inspect.py 24 对象全 PASS RC=0;注入漂移 117→116 自愈实测写回 2 处 PASS;--selftest 4/4;cron 10b7d46f374b 复位 last_status=ok / failure_streak=0。

- 改动:~/.hermes/skills/autonomous-ai-agents/computer-use(apu 私有层迁入,原 .archive 本地定制版 v2.0.0 留档)、check_listing_parity.py(check_cron_count 自愈化+_cron_overview_drift)、sync_cron_count.py(删 STATE_FILE 幂等短路)、Cron 作业全览.md 概览行 2 处→117、pitfall_map_placement_ledger.json observed 刷 global;备份 ~/.hermes/backups/check_listing_parity.py.bak-20261019-215700~cron-count-selfheal、sync_cron_count.py.bak-20261019-220007~statefile-idempotent-blindspot。

- 异常:4 个 profile 的 computer-use 9-26 同 md5 纯副本(v2.1.0)留原位未动(跨 profile 写入需批准);paoying 的 computer-use 为 disabled 既定收窄非缺陷;.archive 本地定制版 v2.0.0 与全局 v2.1.0 同题异构留档备查。已登记 external_findings。

- 2026-10-19 t_671f03b5 重启打断治理遗留面收口:结论=做完——Part1 对账 15 个未登记 M 文件(口径校准:报告 16 实为 15+1 stale 死条目),9 个登记 local_pending(8 全量+turn_preflight_gate 残余基线=补丁10后态)/6 个不登记(5 应用器 100% 覆盖+补丁12 明文排除),manifest 74→83→清理死条目→+run_shutdown 登记=83 条,升级全链路 worktree 模拟 15/15 还原一致、apply_pending 多次复跑 83 全 skip 退出码 0;附带治本=补丁10 apply_p2p3_v2.py 目标树硬编码 .uptest 修复(HERMES_SRC 参数化+restore_patches.sh 调用钉 PKG_ROOT,防升级恢复打错树假成功);Part2 打断告警升级为带动作+责任指向看板卡(cron_error_watchdog v2.6 create_interrupt_cards,assignee=default 乾婆,选建卡不选真艾特理由入 docstring),run_shutdown 群知会静默化+超限并入卡,同 run 可见信号 2→1 张卡、幂等三层;证据=交付报告 t_671f03b5_重启打断遗留面收口.md(VERIFY 2 组真跑核对)、mock 单元 PASS、AST 静默断言、15/15 md5 对照;改动=local_pending 10 个 patch+manifest、apply_p2p3_v2.py、restore_patches.sh、cron_error_watchdog.py v2.6、run_shutdown.py(备份 4 份落 ~/.hermes/backups/)、知识库同步(踩坑记录 2 条、脚本系统.md v2.6 条目、技术调研报告索引);异常=3 个应用器锚点漂移+5 旧条目 R-0917-39 次序失败记 external_findings|阿普

- 2026-10-19 t_9b18c7f2 技能体积闸门额度口径修正:结论=做完——skill_size_gate.py 额度口径改为「本周期已建卡=全状态(含 done / archived)」,同周复跑稳定「本轮可建 0 / 本轮建 0」不再因卡完成释放额度多建(t_c4f62f78 验收缺陷治本);附带修正:建卡失败提示过滤 exposure 噪音行取真因、子上下文被拒直接标注 fail-closed+kanban_create 补建姿势,_is_delegated_context() == "1" 恒 False 判定改为 truthiness 对齐守卫真源;证据=dry-run 全状态计数 10 张=独立 SQL 逐张对拍、正式跑前后 tasks 4274 张零变化、沙箱失败提示实测可判定、CLI fallback --archived 计数一致 10;改动=脚本 5 处(备份 ~/.hermes/backups/skill_size_gate.py.bak-20261019-185525~7a0ed5f113-t_9b18c7f2,pyc 清理、444 回锁)+旧口径引用面同批同步 4 技能(gate-guard-design/mechanism-effect-verification/acceptance-return-coordination/qianpo-weekly-audit)+脚本系统.md 口径行+踩坑记录新增条目;异常=CLI「CLI exposure failed: could not publish launcher」噪音行属 hermes 框架层未修记 external_findings|阿普

- 2026-10-19 t_9cedf7e8 补跑修正端到端复测与测试job恢复:结论=做完——t_b999a085 判据 2 收口:打断真杀分支命中(SIGTERM 落在探针启动后约 20s,脚本剩余约 100s > drain 30s),被打断 run(TS 20261019-183133)零 produce 正面证明 + watchdog 补跑恰 1 份(produce_20261019-183411.txt)+ 第二次 watchdog 零新增幂等 → 同一被打断运行合计 1 份产出、双份执行消除实证;现场恢复先行(restore 后 135s starts.log 零新增)并收尾 4 测试 job 全 enabled=False;证据=/Users/mac/.hermes/kanban/deliverables/t_9cedf7e8_端到端复测与收尾.md(VERIFY 5 条真跑全对);改动=知识固化两项:c 项 completed+disabled recurring job 四入口互踢死锁规避写入 scheduled-task-creation-practices、macOS pgrep -f 超长 cmdline 截断坑写入踩坑记录 v0.21.5(备份 ~/.hermes/backups/ 两份 t_9cedf7e8);异常=SIGTERM 顺带打断生产 job ebbf09215b46(每日知识提取·泡影)watchdog 自动补跑已闭环(last_status=ok)|阿普

- 2026-10-19 t_0d529a1c kanban_create 工具 schema 补 reasoning_effort/temperature 参数槽:结论=做完——t_67aad3dc 真治本落地:KANBAN_CREATE_SCHEMA 增 reasoning_effort(string,值域 none/minimal/low/medium/high/xhigh/max/ultra 对齐 kanban_db.normalize_reasoning_effort 真源)+ temperature(number 0.0-2.0)两参数槽,handler temperature 显式走 kb.normalize_temperature 校验(原 _opt_float 裸转换);沙箱一次建成 reasoning=high+temperature=0.4 落库一致、反面越界/非法档位双拒、真库 4274 零污染;补丁登记闭环(kanban_tools.py 刷 post_md5=711c3331、kanban_tools_schemas.py 新登记,apply_pending 74 条全跳过、指纹零过期);回流落地=乾婆日志 cron 76a0c4c8cde7 prompt 建链约束放宽为「工具/CLI 任一单路径」(禁止混用/补救重建硬约束保留,t_67aad3dc VERIFY 断言短语在位,备份 jobs.json.bak-20261019-t_0d529a1c-prompt-relax);异常=无(登记面差集 15 个历史遗留未登记文件属他人域记 external_findings)|阿普

- 2026-10-19 t_c4f62f78 乾婆管理角色边界周度审计 W43:结论=做完——审计窗口 2026-10-12~10-19:全局技能真实变更 104(管理域 26 / 技术 78;剔除机械批次 31 + 归档 8 + .versions 2)、子代理 24(矛盾 0 / 重叠-合理 8 组)、mnemosyne working +269 / episodic +207 全 sleep_consolidation / 固化比 76.9% 健康;体积闸门本轮建卡 3 张(t_4f31d4b6 podcast-material-hunter 46,756 / t_234176ef acceptance-verification-patterns 45,880 / t_ff8ca973 hermes-profile-model-config 44,743;worker 内 CLI 全败→kanban_create 补建→复跑核实已建 3/可建 0/失败 0/去重跳过 3);核心发现=分流后回涨循环坐实(acceptance-room-blocked-task-flow 7 天 19,138→34,265 +79.0%、acceptance-verification-patterns 19,085→45,880 二次回 P1),写入侧体积自检是否落地留 decisions_pending;证据=/Users/mac/.hermes/kanban/deliverables/t_c4f62f78_乾婆管理角色周度审计_W43.html;异常=无|阿普

- 2026-10-19 t_9a9a9501 存量自毁写法批量改造(K=8+旧路径随批):结论=做完——8 处教「cron remove 自毁/自取消/换新删旧」的教学口径(cron-job-audit:347-356 / noagent-cron-failure-monitoring:100-110、438 / kanban-orchestrator notification-and-subscribe:83、90 / cron-script-no-redundancy:509 / dead-end-alert-closure:250 / acceptance-room-blocked-task-flow 补搜watchdog:20)统一改为 pause 退役+状态文件自判,禁 cron remove 自毁(口径真源 promise-closure-watchdog,fence 丢投递机理 t_47c97719);cron-error-watchdog-pattern.md:124 旧路径 hermes_cli.main 改 /usr/local/bin/hermes 并注记手工终端 vs 脚本内 venv 两口径(关键配置参考.md:151 铁律对齐);复跑全库 K=0(活文件 28 行逐条判定全为禁令/历史/警示/手册/正常运维),VERIFY 4 组真跑 0/0/6/28;顺带消除 t_e4b731ac §五 规则冲突(cron-script-no-redundancy:509 归档即 remove vs 裁定 b 保留 job,现口径 pause 保留记录=裁定 b 同向);备份 8 份落 ~/.hermes/backups/|阿普

- 2026-10-19 t_ec319c16 语言扫闸门未消费自动补跑分流:结论=做完——检出「语言聚焦扫闸门未消费」后的动作从「转人工踢乾婆」升级为「自动补跑首扫 + 按退出码分流」:rc=0 零命中或基线全闭合自动放行不建卡、rc=1 有未闭合条目自动建轻量处置卡给豆蔻(幂等键防重复,正文只含稿件/基线/留档/处置命令,原地改稿非重写)后放行、rc=2 超时(600s 上限)执行异常建卡失败一律维持转人工 fail-closed,漏跑不再退回整篇重写(Day63/64 执行率 0/3、每漏一张 TTS 顺延约 2 小时的代价消除);证据=四路径实测全过(rc=0 clean5 零命中放行不建卡/rc=1 沙箱建卡 t_35e81cc4 后放行进 L2/rc=2 ghost 稿转人工/无挂点不触发补跑)+单元级超时 2s 定性转人工、逃生口 LANG_SCAN_AUTOPATCH=off 留痕、幂等重跑命中 t_6081f49e 不重建、delegated context 建卡失败 fail-closed 分支实测;改动=acceptance_l1_l2.py 新增 language_scan_auto_recovery 与轻量处置卡生成(约 190 行,备份 ~/.hermes/backups/acceptance_l1_l2.py.bak-20261019-145802)、auto_accept.py 注释同步,闸门 language_scan_gate.py 零改动;异常=首扫族③⑤ LLM 判定波动(同稿两次结果不同,极简稿也会被抓边缘条目),rc=1 为常态路径属闸门既有特性记 external_findings;worker 环境 CLI 建卡被安全设计拒绝属预期边界(主通道 cron sweep 无此标记)|阿普

- Mac 15:15 wdog 僵死重启(iBoot async abort 新形态)+ panic_monitor 台账解析修复(2026-10-19)

- 结论:已修——重启定性 = 硬件看门狗复位(系统僵死约 10 分钟,15:04:32 最后心跳→15:15:42 boot),SOCD panicString=iBoot async abort(非存储控制器断言族,全序列首次形态);干活的 worker t_ec319c16 被带死

- 判据核对:ANS2 类 30 天计数维持 5 次(10-08/10-12×2/10-16×2,本次不入计数);判据②未触发(Boot failure count:1 非 >1、无 fsck);判据③新变种成立但间隔未缩短

- 监控修复:panic_monitor.py LEDGER_FILE→候选列表(台账已外移 references)+ 否定式极性 + 秒级容忍;实测事件 15 条、计数 5、判据块正常

- 异常:「技能正文瘦身移动台账→下游解析器未同步」是通用风险(改文档须盘点解析方)

- 改动:~/.hermes/scripts/panic_monitor.py(备份 ~/.hermes/backups/panic_monitor.py.bak-20261019-163015~b4665346e3);台账 mac-kernel-panic-forensics/references/incident-ledger-and-reviews.md 追加 10-19 行;看板评论 t_ec319c16 #8849 已更正

- 2026-10-19 t_67aad3dc 乾婆日志 cron 同分钟双触发根因排查:结论=「调度层双触发」证伪(每天仅 1 次 Running job、单会话),真相=同会话 Step 3 建链双路径返工(kanban_create 工具建③缺 reasoning_effort→归档→CLI 重建带全 max,10-18/10-19 各一对同 body 双卡、下游双份执行),已修 prompt 建链单一路径;证据=agent.log 9125/25112 两天各 1 次调度、四卡 reasoning_effort 对比(归档对缺失/执行对 max)、沙箱单路径一次建成 reasoning=max 单卡无双建、旧参数名 --reasoning-effort 实测 unrecognized arguments、真库 4264 零污染;改动=jobs.json 76a0c4c8cde7 prompt Step 3 两处(单一 CLI 路径 + --reasoning 参数名修正 + 禁止补救重建),产出语义与调度时点未动;异常=无(kanban_create 工具 schema 补参转延展卡,涉及框架代码另做)|阿普

- log-2026-07(2026-07 全部)

- log-2026-08(2026-08-01 ~ 08-30)

- log-2026-09(2026-09-01 ~ 09-30)

- log-2026-10(2026-10-01 ~ 10-25)

description: 知识库唯一规范 — 核心原则、页面设计、信息生命周期治理(状态机/正文分区/高频页前置/豁免/单一真相源/判定三选一/技能侧历史处理原则)、元数据矩阵 v1(L1/L2/L3 字段/tags 白名单 17 词/maintenance↔freshness_days 映射/source 枚举)、Frontmatter、目录结构

# 元数据矩阵 v1 权威源,自身示范:常规 active 页默认 weekly

赫尔墨斯代理系统管理与播客制作 — 涵盖系统架构、子代理分工、播客全流程(佛学播客/专业前沿日报/赫尔墨斯内参)、运维经验、踩坑记录。(乾婆脱口秀 2026-08-12 暂停)

来源:《知识库融入工作流计划》§1(projects/知识库融入工作流计划.md)。本项目一切设计以此为准,知识库所有内容遵守。

1. 真相唯一:每类数据只在产生处存在一次,其余地方一律引用

2. 指针非副本:引用用路径/链接,不复制内容(复制=双份维护+不一致风险)

3. 派生自动:汇总/索引类视图由脚本从真相源生成,人只做校对,不做手写同步

4. 原生写入:产生数据的环节直接把数据写进唯一家,不产生第二份

验证问题(每次设计时问自己):这份数据现在有几个家?超过 1 个就是设计缺陷。

补充判断(2026-08-23 正生):页面结构健康与数据家数同样重要——一页职责单一、大小可控、结构清晰是「单一事实源」的前提;内容杂乱的页面要拆分,不因「能用」而容忍。

来源:《知识库融入工作流计划》§3 模块 F(projects/知识库融入工作流计划.md)。防止未来再长成杂页。

- 页面职责单一:一页只承担一个职责(一个主题/一个数据类),页面标题能完整描述其内容。职责混杂的页面必须拆分,不因「能用」而容忍

- 体积上限:单页建议 ≤ 30KB(约 600 行);持续日增型页面(报告流水/日志类)超过 50KB(约 1000 行)必须拆分。例外(2026-08-27 正生拍板 t_c9d8fdae):log.md 阈值 100KB——日均约 20 条/+12.7~25.7KB,50KB 下归档频率会升至每 2-3 天一次,提至 100KB 回落每周左右;wiki_guardian.py STREAMING_DOC_THRESHOLDS_KB["log.md"]=100 已按此配置,其余流水文档仍 50KB。例外二(2026-09-20 乾婆裁定 t_f0454b17,D1/D3):concepts/需求池.md 阈值 100KB,且不再走体积告警——需求池体积约 86% 由活跃条目(未解决/处理中)决定,归档只下沉已处理行,50KB 在数学上不可能达标(归档 7 条后实测仍 54685B)⇒ 破阈后成常态告警、退化「狼来了」。故 100KB 定档(与 log.md 同档,避免「例外」扩散)只作达标判据(wiki_log_archive.py / painpool.py archive --threshold 默认值),巡检告警改判活跃需求条数 ≥ 120(取数口 painpool.py count-active,阈值常量 wiki_guardian.py ACTIVE_REQ_COUNT_THRESHOLD,已从 STREAMING_DOC_THRESHOLDS_KB 移出)——体积 ∝ 条数,条数才指向可行动作「该消化了」,同一现象只留一条报警。需求池无保留期概念:归档按状态列筛选(filter_mode=status),profile 不设 default_days,--days 对需求池不生效(实测传与不传归档结果逐字节相同)2026-09-13 t_0ac4530c 补充:阈值是硬目标——wiki_log_archive.py 归档后若仍 ≥ 阈值,会按日期自动继续下沉(体积兜底,详见 知识库运维体系 T9 节),因此「超阈」不再必然指向人工拆分

3. 被多个独立场景引用/查询的内容(拆出独立页便于指针引用)

在全书阁中搜索