三个工作台

按从便宜到贵的顺序跑：卡住单条大小 → 剪掉老历史 → 微压缩 → 只在读的时候折叠 → 最后才让模型自己写一份摘要。摘要是最后的手段，因为它一定会丢东西。

钩子（几乎不占上下文）→ 技能（占一点）→ 插件（占中等）→ MCP 外部工具（最占）。同一件事能用便宜的档位做，就别上贵的。

它自己有一份独立上下文，自己写自己的日志，干完只把一段摘要交回来。代价大约是 7 倍 token，换来主窗口干干净净。

写在记忆文件里的规矩，模型是大概率照做；真要卡死一件事，得靠权限规则。这条分得很清楚，别指望写一句话就能杜绝。

就是一堆你能看见、能改、能提交进 git 的 markdown 文件，用的时候扫一遍文件头，最多挑 5 个塞进去。

不做子 agent、不做 MCP、不做权限弹窗、不做计划模式、不做内置待办（作者说待办会把模型带偏）、不做后台 shell（要看进度就用 tmux）。

一个 TypeScript 文件就能加工具、加命令、加快捷键、换编辑器，甚至整个替换掉内置工具。扩展能把 pi 改装成 Claude Code 的样子——也能让你在等模型时打一局 Doom。

每条记录带 id 和 parentId，全在同一个文件里。你可以退回任意一句话原地开分支，来回切换，历史一条都不丢。

空闲 / 干活 / 压缩 / 摘要 / 重试。像换挡一样，重活必须在空闲档才准开始，正在跑的时候插队会被直接顶回来。这是防止状态写乱的硬规矩。

它自己不做权限系统，默认就以你的身份跑。要围栏，就把整个进程塞进容器、micro-VM 或沙箱里。

先套一个预设（网页版 / 无头版 / SDK 版），再叠一层层功能包，最后叠你自己的补丁文件。一条命令就能把最终组装出来的整棵树打印出来看。

任何进到模型眼前的东西，都得能从会话日志重新拼回来，运行时还会断言这一点。好处是永远能重放、能复现；代价是加个新功能就得先加一种日志事件。

文件系统和子进程共用同一个"执行世界"。把这个接头指向远程沙箱，shell、终端、语言服务会一起搬过去，不用为每个工具再改一遍。

加模型、加工具、加后台任务、加审批策略，各有各的挂点。文档直接给了一张"你要干什么 → 挂哪儿"的对照表。

官方自己在 README 里用大写字母写着：会有破坏兼容性的改动。