让 OMP agent 主动维护自己的上下文，而不是等窗口耗尽后被动压缩。
omp-context 是由 KorenKrita 独立维护的第三方 OMP 插件。它让 agent 能够：
- 在任务、阶段和高风险操作前建立可恢复的语义锚点；
- 查看当前会话 spine、历史分支、checkpoint 与上下文占用；
- 把已经完成的过程折叠成可执行 handoff；
- 在安全时将累计 summary chain rebase 到更早的基底，重新获得浅层、低负载的 working set；
- 在 travel 后同步持久会话树、下一轮模型上下文与 live AgentSession。
长任务的问题不只是 token 数量。
即使每个阶段都做了局部摘要，summary 仍可能一层层堆在 active spine 上：
root → summary A → summary B → summary C → current work
这些历史 handoff 会持续占用上下文和注意力。omp-context 不把压缩当作单纯的 token 操作，而是按语义边界管理 working set：保留下一步真正需要的内容，把已完成过程移到可恢复的 archive。
| Tool | 作用 |
|---|---|
acm_checkpoint |
给会话节点建立唯一、可恢复的语义 checkpoint |
acm_timeline |
查看 active spine、checkpoint catalog、全文搜索、完整树和 summary depth |
acm_travel |
将一个 boundary 折叠为七槽 handoff，或把累计 summaries rebase 到最早安全基底 |
插件会通过 OMP 的公开 prompt hook 注入精简的 always-on CORE。复杂的 target selection、archive round trip 和异常恢复按需从 advanced Skill 加载，不会把整套 playbook 常驻在上下文里。
普通 fold 压缩一个局部阶段；rebase 处理长期累积的 summary depth。
agent 会在以下时机主动检查 rebase：
- 下一次 fold 会继续叠加 summary；
- 一个稳定 chain 或 subchain 已结束；
- 同一 session 即将开始新目标；
- context pressure 上升。
rebase 不等于强制跳到 root。agent 会从最早候选开始执行 cold start 检查：如果一个全新的 agent 只依赖当前 snapshot 和直接 evidence pointers 就能执行 NEXT，该基底才安全。root 是理想候选，不是默认答案。
Timeline 会提供事实证据：
- 当前 active summary depth；
- root structural candidate；
- 每个 checkpoint travel 后的 projected summary depth；
- usage、message count 与 branch topology。
Runtime 不会伪装成能判断语义完整性，也不会自动批准或执行 rebase。
omp install .omp install github:KorenKrita/omp-context/marketplace add KorenKrita/omp-context
/marketplace install omp-context@omp-context
安装后无需手动调用命令。Agent 会根据 CORE 在任务边界主动使用三个 ACM tools；你也可以直接要求它创建 checkpoint、查看 timeline 或恢复某个 archive。
每次操作都会返回可核对的结构事实：
- resolved target 与 entry ID；
- checkpoint aliases；
- branch summary leaf；
- backup checkpoint outcome；
- message、token、percentage-point 与 summary-depth delta；
- persistent context rebuild 和 live AgentSession sync 状态。
Checkpoint 名称在整棵会话树中大小写敏感且必须唯一；同一节点可以拥有多个 alias。异常 mutation 明确区分 not_applied、applied 和 indeterminate，避免把未知状态伪装成成功或失败。
- Travel 只改变 OMP 会话树和后续模型上下文。
- 它不会回滚文件、进程、浏览器、Git commit 或远端服务。
- 插件不会取消、替换或延迟 OMP 原生 compaction。
- 如果当前任务仍依赖不可压缩的中间推理，agent 会保留 working set 或接受 native compaction，而不是为了降低数字强行 rebase。
- Host 不支持 live synchronization 时，持久 branch 和公开 context rebuild 仍然保留；结果会给出明确恢复指引。
bun test
bun run typecheck
bun run verify:acm开发架构、host compatibility、Git hook、版本提升流程和维护契约见 AGENTS.md。
- pi-context — 原始项目 by ttttmr
- 让 AI 主动管理自己的上下文 — 设计思路
MIT License