前言¶
在 Codex 或 DeepSeek Harness（DSH）里做长周期开发时，写到一半换模型或换客户端，往往不能只复制最后一段助手回复。你还要让另一端知道：原始需求有没有被中途改过、项目里哪些约束已经口头确认、代码仓库当前分支与未提交改动是什么、上一轮接力做到哪一步。手写文档或脚本可以完成这些事，但整理成本高，也容易在转述总结时丢掉用户原话。
下面介绍 dsh-handshake（DSH 中的 DSH-Handshake 任务接力 插件）。它把「准备交接资料 → 核对 → 在目标端确认执行」放进同一套操作流程，当前仅支持 Codex ↔ DeepSeek Harness，不是通用的多模型聊天迁移工具。
这是什么¶
dsh-handshake 是装在 DSH 里的工作流类插件，维护者为 zhangyong0010。包名 @local/dsh-handshake，当前发布版本 v0.1.0，许可证 MIT。简介对应 README：在 Codex 与 DeepSeek Harness 之间交接任务，并携带原始需求、共享项目规则与工作区检查信息。
插件不转移登录信息、额度或权限，也不支持 ChatGPT 普通聊天、Claude、Cursor 等其他客户端。它不会让不同模型自动具备相同能力，也不保证接收端在语义上理解一致。
核心功能¶
Handshake 围绕「同一本地项目、多次往返」设计，能力以 README 与仓库说明为准。
交接资料里包含什么¶
| 换端时需要带走的内容 | 插件如何处理 |
|---|---|
| 用户中途补充、修改过的要求 | 保存完整用户正文和来源；提示词过长时标记为预览，并保留可读取的完整文件 |
| 两端共同遵守的目标和约束 | 在详情中维护「项目共识」：目标、确认约束、决策、验收标准与补充背景；自动提取的线索单独标记 |
| 当前代码与未提交改动 | 准备交接时记录分支、HEAD、diff 与文件摘要；启动前再检查；有变化需重新准备并再次确认 |
| 多次往返 | 同一项目复用接力卡，每次准备保留独立资料版本，并关联实际来源与目标会话 |
看板与项目识别¶
- 顶部绿色区域展示已创建的接力任务。
- 下方左侧紫色列为 Codex 来源，右侧蓝色列为 DSH 来源；同一项目的多个主会话聚合成一张候选卡，操作指向最近活动的主会话。
- 项目按真实目录与持久身份识别，符号链接会归一；同名无关目录不合并。搬迁目录需显式绑定，避免同名项目交错。
整理与执行边界¶
- 整理资料不调用来源模型；来源端已无法继续时，仍可读取本地会话记录准备交接。
- 原始会话不改写。交接副本、项目共识、运行日志与逐轮资料保存在本机
~/.dsh-handshake/。 - 常见凭据形式会在交接副本中脱敏；自动脱敏有边界，确认执行前仍应自行检查交给目标模型的内容。
- 资料核对回执绑定文件摘要、资料版本与代码基线；不证明模型已正确理解，也不代表任务通过验收。
- v0.1.0 不包含额度查询或额度计量功能；插件没有独立的分析遥测或资料上传服务。
安装与启用¶
v0.1.0 文档记载的本机桌面验证环境为 macOS、DSH 0.2.2-rc.1、Codex 桌面 App。需要能读取两个客户端的本地会话记录，并访问同一个本地项目目录。Windows、Linux 以及远程/跨机器接力尚未验证。
插件以当前 DSH 进程权限运行，安装前应查看源码与 MIT 许可证，并确认本机数据边界（~/.dsh-handshake/）是否符合你的安全要求。
从 DSH 插件页添加 GitHub 插件¶
在 DSH 的插件页选择添加 GitHub 插件，填写：
github:zhangyong0010/dsh-handshake
使用预打包安装包¶
也可使用 GitHub Release 提供的预打包文件（README 中的「最新安装包」链接）。包内为可直接加载的 JavaScript，无安装期脚本或构建步骤。
安装后启用 DSH-Handshake 任务接力；若界面仍有缓存，完整退出并重启 DSH。
可选配置¶
Codex 优先使用桌面 App 内置执行程序。其他安装位置可通过插件配置的 codexBinary 指定。
典型用法¶
README 中的操作流程如下，可先对照看板熟悉界面，再按项目创建接力。
- 在接力看板找到项目，点击 创建接力任务。这一步只整理资料，不启动模型。
- 查看目标端与交接资料，需要时编辑「项目共识」，然后 确认执行。
- 本轮结束后检查实际改动与测试。需要换回来时，在同一张卡上继续接力。
看板会区分来源、方向、执行状态与资料核对状态；结束后进入待验收。若工作区或项目共识相对上次确认已变化，应重新准备并再次确认，而不是直接沿用旧资料。
更细的交接字段与格式见仓库文档 交接格式（docs/handoff.md）。
适用场景与注意¶
适合：在 Codex 桌面 App 与 DSH 之间，对同一本地仓库做多日、多轮需求变更的开发任务；需要保留用户原文、可编辑的项目共识，以及交接前后的代码基线核对。
不适合或需谨慎：指望一键迁移到其他聊天产品；跨机器接力；在未经文档验证的系统上当作生产默认方案。
开发与回归方面，仓库使用 Node.js 24 或更新版本，无需安装项目依赖即可跑测试：
npm test
README 说明测试套件含 38 项隔离回归（双向创建与执行接口、多轮往返、重复点击、失败重试、代码漂移、项目身份、原始要求、脱敏、资料回执等），使用临时 HOME 与模拟接收端，不读取真实用户会话、不启动真实模型。内部适配依赖 DSH 控制器与 Codex 本地会话格式，上游更新可能需要调整。
结尾¶
dsh-handshake 把长任务换端时容易遗漏的原始要求、项目共识与工作区状态，收进 DSH 内的接力看板与确认流程，减少只靠复制最后一段总结带来的信息损失。若你正在 macOS 上用 DSH 0.2.2-rc.1 与 Codex 桌面 App 做同一仓库的交替开发，可按上文安装命令添加插件，再按「创建接力任务 → 核对 → 确认执行」走通一轮。
- 社区目录页：https://www.skillhub.cn/plugins/zhangyong0010/dsh-handshake
- 源码与 README：https://github.com/zhangyong0010/dsh-handshake
