前言¶
在 DSH 的插件擴展方式中，社區插件可以補充本地工作流。@danglong0313/dsh-history-sync 解決的是一個比較具體的問題：把本機 Codex 與 Claude Code 中已經發生的歷史任務，以只讀鏡像的形式單向導入 DeepSeek Harness（DSH）。
它不是雙向同步工具，也不負責從 DSH 恢復 Codex 或 Claude 的模型、工具進程、審批、沙箱或運行狀態。
這是什麼¶
- 插件名：
@danglong0313/dsh-history-sync - 發佈方：
danglong0313 - 許可證：MIT
- 定位：把本機 Codex 與 Claude Code 的用戶/助手對話，單向、只讀鏡像到 DSH。
- 邊界：不寫回來源；不是雙向同步；不能無損恢復上游運行狀態。
核心能力¶
下面列出的都是插件已覈實的能力：
1、單向只讀導入 Codex 與 Claude Code 的用戶/助手對話，不寫回來源。
2、默認採用保守策略：默認預覽、默認不自動同步、默認只掃描最近 30 天。
3、可以在 設置 → 插件 → 插件配置 → History Sync 中直接配置和啓用自動同步。
4、自動按原工作目錄創建或複用 DSH Workspace，並在左側項目欄分組顯示。
5、使用內容指紋、追加水位和 generation 處理重複同步、增量追加及上游歷史重寫。
6、過濾 system/developer、reasoning、工具調用、審批、命令輸出和 Claude 控制標籤，避免把協議消息當作真實聊天。
安裝與啓用¶
以 desktop profile 爲例，先執行安裝命令，再查看當前 profile 的配置狀態：
dsh plugin --profile desktop add @danglong0313/dsh-history-sync@0.2.0
dsh --profile desktop --dump-config
第一條命令將插件安裝到 desktop profile，第二條命令用於查看該 profile 的配置狀態。
安裝後啓動 DSH，進入：
設置 → 插件 → 插件配置 → History Sync
這裏可以直接配置插件，並在需要時啓用自動同步。由於插件默認不自動同步，建議先完成預覽，確認導入範圍後再開啓實際導入或自動同步。
典型用法¶
在任意 DSH 任務中執行預覽：
/history-sync preview
確認範圍後，在 History Sync 配置卡中開啓“允許實際導入”，再執行：
/history-sync run
不帶參數的 /history-sync 等同於預覽。
如果後續希望插件自動處理新增歷史，可以在 History Sync 配置卡中啓用自動同步。自動同步默認關閉。
適用場景與注意¶
這個插件適合希望在 DSH 中查看已有 Codex 或 Claude Code 對話歷史的開發者。它的核心限制是：這是一份歷史鏡像，不是可恢復的上游運行環境。
啓用前需要注意以下幾點：
- 導入會在 DSH 持久化中產生第二份歷史副本。
- 原任務可能包含源碼、命令輸出、
.env內容、憑據或其他敏感信息。 - 刪除 Codex/Claude 原任務不會自動刪除 DSH 副本，反之亦然。
- v1 中
readOnly必須爲true；previewOnly爲true時拒絕實際導入。 - DSH 仍處於預發佈階段，Session 格式不保證跨預發佈版本兼容；已驗證 DSH 爲
0.1.0-rc.6。 - 插件以當前
dsh進程權限運行，安裝前應檢查源碼、依賴和 MIT 許可證。
結尾¶
@danglong0313/dsh-history-sync 的價值在於：在默認預覽、默認只讀、默認不自動同步的前提下，把本機 Codex 與 Claude Code 的歷史對話單向導入 DSH，並在項目欄中按原工作目錄分組顯示。
- GitHub：dsh-history-sync
- 目錄頁：已覈實資料未提供可用目錄頁，建議以 GitHub 倉庫爲準。
