第 03 模块 · 3 节

fork / clone 与导出分享

《Pi 基础入门》03 会话管理 · 本节时长 24 分钟

fork:从历史点开新会话

/fork 创建一个新的会话文件,从某条用户消息开始。

典型场景:你早期的某个思路挺不错,但当前会话已经走偏了。/fork 让你「回到那个出发点,开一条干净的新路」,而不污染当前会话。

  • 输出:新会话文件
  • 视图:用户消息选择器
  • 典型用途:从早期提示词开新会话

clone:继续前先复制

/clone 复制当前活跃分支成一个新会话文件。

典型场景:你马上要做一个可能搞乱现状的改动,先 clone 一份当前的「安全快照」,做坏了随时回退到克隆的那份继续。

  • 输出:新会话文件
  • 视图:当前活跃分支
  • 典型用途:继续前先复制当前工作
贯穿项目md-tools 时,加新功能前先用 /clone 给当前可用的版本做个备份,改坏了随时切回——这一招会让后续所有改动都更敢放手。
心态/tree/fork/clone 三招配合:tree 原地保留不同方案,fork 从历史点开新路,clone 冒险前先备份。三种都是「敢于尝试」的底气。

导出会话:/export

想把会话存成可分享的格式:

/export [file]

导出为 HTML(或 JSONL)。HTML 方便别人在浏览器里看。


分享会话:/share

更简单的方式:

/share

上传为私有 GitHub gist,生成一个可分享的 HTML 链接。很适合把一次排障过程发给同事看。

注意分享前想清楚:会话里可能含代码、路径甚至敏感信息。确认没有不该公开的内容再 share。

导入续接:/import

/import <file> 从一个 JSONL 文件导入并续接会话。适合别人分享给你一个 JSONL 后,你拿过来接着看。


落地练习:clone 一个安全备份

  1. 启动 pi,做一个你觉得「基本能跑」的任务
  2. /clone,确认生成了新会话文件
  3. 在新会话里,故意让 Pi 做一个破坏性改动
  4. /resume 切回那个克隆的「安全版本」,确认没受影响

怎么判断做对了?——你理解并实践了「冒险前先 clone 备份」,做坏了能切回克隆版继续。

卡住了怎么办? /clone 后找不到 → 去 /resume 列表里找最新那个。分不清 fork/clone → 记「fork 从历史点开新路、clone 复制当前做备份」。


常见坑:做破坏性改动前不备份

新手让 Pi 做大改动前,往往不做任何备份,结果改坏了只能干瞪眼。

正确习惯大改动前先 /clone,把当前可用的状态存一份。真改坏了,/resume 切回克隆版就行。这一招成本极低、收益极大,是敢让 AI 放手干活的关键底气。


小结

  1. /fork:从历史用户消息开新会话文件
  2. /clone:复制当前活跃分支做安全备份
  3. /export:导出为 HTML 或 JSONL
  4. /share:上传私有 gist,生成可分享链接
  5. /import:从 JSONL 导入续接
  6. 分享前先确认没有敏感信息

下一模块,我们做第一个实战项目,把前面学的串起来。