迁移 Agent 会话但不带走工具历史

我想把一个完成到一半的编码任务从一个 Agent preset 迁移到另一个，同时不让新会话重新发现项目。

这是官方 DeepSeek Harness WebUI 中的实际效果：

源会话知道五个事实：端口 43179、SQLite、无 Redis、目标文件，以及下一步。Bridge 生成一份可审查的交接文档，在一个全新的 code preset 下打开会话，并让该会话复述这些事实。在用户确认之前不会开始执行。

有趣的部分不是 slash 命令本身，而是它所保留的边界。

preset 不仅仅是人格设定

一个 Agent preset 通常组合了 system prompt、工具、插件、权限和执行策略。一旦会话使用了该组合，其历史记录中就会包含工具调用及其结果，这些内容只在那个确切的环境下才有意义。

就地更改 preset 看起来很省事，但实际上会制造出歧义的历史：

• 工具调用可能引用新 preset 没有的工具；
• 相同的工具名现在可能有不同的语义；
• 旧的权限假设可能不再成立；
• 模型看到的是一份连续对话记录，但底层的可执行环境已经变了。

DeepSeek Harness 通过在会话启动后锁定 preset 来避免这个问题。这个约束很实用。更安全的迁移原语不是"解锁 preset"，而是"打开一个干净的目标会话，只携带仍然可操作的状态"。

历史记录是环境相关的。状态是可以迁移的。

迁移状态，而不是工具痕迹

Bridge 将源对话转换为一个五部分的契约：

Goal
Current state
Key decisions and conventions
Key files
Next step

这个 schema 有意做得平淡。它迫使交接文档在行动之前回答目标会话需要的问题：

• 我们在追求什么结果？
• 已经发生了什么？
• 哪些约束仍然有效？
• 哪些文件承载了工作？
• 下一个可执行的步骤是什么？

原始工具痕迹被省略了。过时的、被撤销的或已被替代的具体值也被省略了；只有当前有效的替代物仍然可操作。

最后这条规则来自一次真实的失败。早期的 prompt 同时保留了旧端口和它被替换的原因。摘要正确地将旧值标记为过时，但它仍然将字面数字暴露给了未来的上下文。这是后续模型可能误用的不必要表面积。发布门禁现在会检查过时值不会重新出现。

预览是协议的一部分

摘要化是概率性的，因此生成的交接文档不应该直接成为执行指令。

Bridge 将操作分为两个阶段：

/bridge code       # 生成并预览；不改变任何内容
/bridge code --go  # 根据审查后的预览创建目标

预览使数字、路径和负面约束在任何目标会话存在之前就可见。它也被写入一个文件，因此用户可以编辑它并执行那个确切版本：

/bridge code --go --file <reviewed-summary-path>

这不仅仅是一个更友好的确认对话框。它将一个不透明模型步骤转换为一个可人工检查的界面。端口、ID、文件路径和"不要引入 X"的约束值得这种处理方式，因为一个流利但略有错误的摘要往往比明显的失败更危险。

目标必须失败关闭

创建一个干净的目标是不够的。Agent 运行时可能有目标驱动器，在目标改变时立即调度工作。

安全的序列是：

1. 在请求的 preset 下创建一个空白目标。
2. 存储经过审查的交接文档。
3. 在发送 kickoff 之前暂停存储的目标。
4. 发送一个 prompt，要求目标复述当前状态。
5. 等待用户确认。

如果暂停步骤失败，Bridge 会在该路由可用时清除目标，取消目标会话，并且不发送 kickoff。部分准备好的迁移不得变成自主运行。

默认路径故意在第一个有用的工作之前花费一个目标轮次。对于更低延迟，--continue 将复述和第一个实际工作合并在同一个目标请求中：

/bridge code --go --continue

两条路径都暂停存储的目标。"Continue"改变的是请求形状，而不是启用后台循环。

图像需要单独的信息路径

图像历史记录不应该被当作普通摘要文本处理。

如果助手已经分析过一张图像，Bridge 会将相关的助手回复逐字复制到压缩的五部分摘要之外。摘要工作器无法重写该证据，且文本作为整体块被承认，而不是在描述中途被切断。

如果图像没有相关分析，它保持未解析状态。在具有持久附件恢复的主机上，Bridge 尝试移动原始附件并在 kickoff 之前保留源模型选择。支持图像的目标可以检查它；纯文本目标会收到明确的回退警告，而不是静默地假装图像已被理解。

此策略避免了两种糟糕的默认行为：

• 重新压缩现有视觉描述，直到细节漂移；
• 当权威文本已存在时，重新发送每张图像并支付视觉成本。

它还避免了隐藏的本地视觉模型。路由是可见的：要么重用保留的文本，要么选定的 VLM 接收未解析的图像。

成本是请求形状决策，不是通用百分比

安装 Bridge 不会为普通会话增加任何 prompt token。/bridge 由主机处理，只在请求迁移时才调用摘要工作器。

在固定的 12 单元发布验收中，默认确认路径始终使用两个目标请求来达到第一个实际工作。--continue 始终使用一个。该请求数差异是稳定的。

Token 百分比不稳定。在六对配对 fixture 中，确认路径的名义额外成本中位数为 +8.1%，但范围是 -47.9% 到 +206.7%。Preset system prompt、输出长度和缓存状态主导了各个总数。"Bridge 成本 X%"这一单一说法将是虚假精度。

因此，有用的产品选择是明确的：

• 当单独 accuracy checkpoint 值得一个请求时，选择默认路径；
• 当接受合并的确认+工作轮次时，选择 --continue。

发布门禁实际证明了什么

当前的文本迁移门禁涵盖六个冻结 fixture 和跨 minimal、standard 和 code preset 的 12 个目标会话：

三个源 fixture 包含 21 条用户消息并重用真实压缩输出。单独的视觉门禁使用五个人眼不可猜测的事实，仅在 PNG 中可见；逐字证据路径和未解析图像路径都恢复了 5/5 的事实。

这些是发布门禁，不是总体准确度估计。每个单元运行一次，套件是修复驱动的，视觉门禁涵盖一个 PNG fixture 和一个实验性 VLM 路由。仓库在头条数字旁边保留原始数据和局限性，而不是将它们变成通用可靠性声明。

尝试这个实现

dsh-plugin-bridge 是开源的，直接在官方 DeepSeek Harness WebUI 中工作。

dsh plugin --profile web add dsh-plugin-bridge
# restart dsh web once

/bridge --doctor
/bridge code
/bridge code --go

仓库包含完整的文本迁移报告、视觉迁移报告和原始评估产物。

该实现特定于 DeepSeek Harness。但该协议不是：打开一个干净的目标会话，携带一个有界限的状态契约，暴露它供审查，在部分设置时停止，并让目标在行动之前证明它所理解的内容。