用途:distill 用于把相关记忆合成为 wiki 页面。守护进程按自身节奏运行后台蒸馏周期,/distill 是用户显式触发的一次蒸馏。
主要能力:蒸馏把四种操作打包成一个流程——emerge(把新记忆聚类成新页面)、absorb(把孤立记忆归入已有页面,并为 2 个以上页面链接却无同名页面的主题提议新页面)、refresh(从源记忆重新生成过期页面,仅当用户未编辑过该页面;用户改过的页面保持锁定)、merge(合并守护进程全局审查标记的重复页面)。默认流程执行全部四种;rebuild 是破坏性可选操作,会覆盖单页的锁定。
使用方式:一次 POST 到守护进程,响应分为 pages_created/created_ids(守护进程自行合成的页面,仅当守护进程有 LLM 时)与 pending(守护进程未能完成的聚类,由代理在本次会话中合成并 POST 回 /api/pages)。裸 /distill 会从 cwd 推断目标(git 仓库根目录名,非 git 仓库则用 basename "$PWD");deep 表示全局;sequence rebuild <page-id> 调用 distill(target=<page-id>, force=true),执行前确认会清空编辑。也可 /distill <arg> 转发参数。随后调用 MCP 工具 distill(target="<scope>"),解析返回 JSON,对每个 pending 聚类先做连贯性检查(记忆共享实体但主题分散则跳过),再调用 create_page 或 update_page;对 stale_pages 中 user_edited 为 false 的页面用 get_page_sources 取源后 update_page,为 true 的列入冲突报告;orphan_topics 仅作为主题建议展示,不自动建页。最后输出简洁报告,并自动提交 ~/.origin/(git 缺失或非仓库时静默跳过)。
适用场景:用户说 distill、synthesize、重建某页;批量导入后强制一次以获得即时可见性;/distill rebuild <page-id> 用于清空自己编辑过的页面并让守护进程从当前源重新生成。
限制:琐碎或一次性交互不适用,后台调度器已覆盖周期刷新;单条记忆写入由守护进程的摄入后增强覆盖。代理合成的每个聚类计入本次会话 token,守护进程侧聚类消耗守护进程 LLM token。若产出页面少于预期,通常是聚类阈值所致,多数记忆缺少足够同类形成 3 条以上的聚类。