Example

让会话树发生分支

在 /tree、/fork 和 /clone 之间做出选择,并把会话看成一棵树:一条被放弃的分支从不被发送,也从不消失。

一个被存储的会话是一棵由 id 和 parentId 连接起来的条目树,而当前位置是叶子。/tree 在这棵树内部移动,/fork 从一条更早的提示词开始一个新会话,而 /clone 把活动分支复制进一个新会话。下面的轨迹是示意性的;它所引出的论断,是 branching.test.ts 在 1.0.4 上断言的那些,其中 /fork 和 /clone 在随附的二进制上运行。

选择命令

操作 结果 什么时候用
/tree 在当前的会话文件内移动 相关的备选方案属于彼此
/fork 从一条更早的用户提示词开始的新会话 这个备选方案变成独立的工作
/clone 新会话中对活动分支的副本 你想要当前状态的一份单独副本

一个小小的分支,用条目来说

这段共享历史在问题 B 被编辑之前是线性的。提交被编辑过的提示词会创建出一个兄弟节点——同一个父节点的两个子节点,一个会话文件。被放弃的分支没有被发送,也没有消失:

{"type":"session","version":3,"id":"sess-a1","timestamp":"2026-10-01T09:00:00.000Z"}
{"type":"message","id":"a-user","parentId":null,"timestamp":"2026-10-01T09:00:01.000Z","message":{"role":"user","content":"question A"}}
{"type":"message","id":"a-bot","parentId":"a-user","timestamp":"2026-10-01T09:00:02.000Z","message":{"role":"assistant","content":"answer A"}}
{"type":"message","id":"b-user","parentId":"a-bot","timestamp":"2026-10-01T09:00:03.000Z","message":{"role":"user","content":"question B"}}
{"type":"message","id":"b-bot","parentId":"b-user","timestamp":"2026-10-01T09:00:04.000Z","message":{"role":"assistant","content":"answer B"}}
{"type":"message","id":"b-edit","parentId":"a-bot","timestamp":"2026-10-01T09:00:05.000Z","message":{"role":"user","content":"question B, edited"}}
{"type":"branch_summary","id":"sum-1","parentId":"a-bot","timestamp":"2026-10-01T09:00:06.000Z","summary":"Summary of the abandoned path: asked B and C.","fromId":"b-bot"}

b-user 和 b-edit 挂在同一个父节点 a-bot 下。一次启用了摘要的导航写出了就在它们下面的那个 branch_summary 条目——这条轨迹把该测试的两次交互压缩进了一个文件。parentId 是你落到的地方,fromId 是你离开的那片叶子,被放弃的条目留在树里,而 getTree() 报告两条分支同处在它们共享的父节点之下。标签是书签:appendLabelChange 给一个条目加上一个 label,getTree() 显示它,而把该标签设为 undefined 会清除它。

/tree 对一次选中做什么

你选中 结果
一条用户消息 它的文本回到编辑器里;叶子移到该消息的父节点上
一条助手响应(或其他条目) Pi 在它之后以一个空编辑器继续

机制与局限

有文档记载: 条目树(id/parentId——共享的会话文件格式是第 27 章的声明)、/tree 的选中规则、标签,以及作为 RPC 命令的 get_fork_messages / fork / clone。已观察:branching.test.ts 带着 faux provider 运行测试骨架和随附的二进制——navigateTree 移动叶子,被编辑过的提示词在一个文件里造出兄弟节点,被放弃的分支不出现在请求中但出现在会话条目里,摘要条目的 fromId/parentId 指向正确的两端,getTree() 有两个子节点,而通过 RPC,一次 fork 启动一个新的会话文件,其 session 头带着 parentSession——它来自何处的唯一耐久记录——而 clone 复制活动分支。

这条轨迹是一幅画,不是一份转录记录:id 被缩短,字段被裁剪。一次 /fork 的新文件里没有它离开了什么的记录——那里不存在分支摘要——所以只有 /tree 能把被放弃路径的摘要交到你手里。本页展示的是一个模型周围的存储模型,而不是一个真实模型选择分支的过程。

完整源码与测试 。

Understand this example

Copy this prompt into your AI tool. No code runs here.

Apply this example

Copy this prompt into your AI tool. No code runs here.