前言¶
在 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
