hooks 是怎么生效的：门的第二形态

kb hook install 往 Claude Code 的 ~/.claude/settings.json 写两条挂点；kb hook install --client codex 则写 Codex 的 ~/.codex/hooks.json（两者都会先备份 .bak；加 --project 改为项目级配置）：

{
  "hooks": {
    "UserPromptSubmit": [{ "hooks": [{ "type": "command",
      "command": "\"/path/to/node\" \"/path/to/cli.js\" hook prompt --vault \"/你的/vault\"" }] }],
    "SessionStart":     [{ "hooks": [{ "type": "command",
      "command": "\"/path/to/node\" \"/path/to/cli.js\" hook session --vault \"/你的/vault\"" }] }]
  }
}

• 幂等：命令串里带 kb-metabolism 标记，重装时先移除旧条目再写新的，不会越装越多；你自己的其他 hooks 原样保留。
• 可逆：kb hook uninstall 按标记精确移除；kb hook show 打印配置片段供手动粘贴。
• 三个绝对路径被固化：node 可执行文件、cli.js、vault 目录——见下文"坑"。

从你按下回车到模型开始思考之间，发生了这 8 步——全程毫秒级：

新会话（含 resume）第一时间注入一次 <kb-status>，内容三样：库概况（总数、L0 容量）、最近经门读过的 3 篇（按 kb_id 解析成当前路径——笔记移动过也指得到新家，给会话连续性），以及距上次消化超一周时的提醒（"请转告用户"）。库为空则沉默。

hooks 不只是便利功能——它是信号经济的一环。协议 v2 起，注入是第三档存活证据：

为什么注入配续命：摘要一眼够用的短笔记最有用，却恰恰因此永远不会被点开全文——v1 时代它们会被法医冤杀。为什么只有 30 天：注入是机器行为，效力必须低于人/agent 亲手读取与引用。为什么先收紧判准再给续命：判准不准，注入续命就是滥发免死金牌——顺序不能反。

纪律（刻在代码里）

• 永不打断：任何异常静默退出——知识库坏了也不能影响你提问。
• 宁沉默勿碰瓷：不够相关就零输出，不制造上下文噪音。
• 只走字面：毫秒级零费用，绝不为注入付 embedding 延迟。

坑（使用前想清楚）