前言¶
DeepSeek Harness (DSH) 遵循“一切皆插件”的生態理念。在多臺機器上協同開發智能體時，同步技能、會話、設置和插件清單容易導致數據不一致。weibaohui/dsh-sync 旨在解決多機環境下的數據同步與衝突問題，提供一套完整的備份與恢復方案。
插件介紹¶
名稱：weibaohui/dsh-sync
核心功能：會話同步與衝突解決（apiproxy、token 內聯）
維護者：weibaohui
類別：記憶
許可證：MIT
Stars：7
該插件支持多機同步與多協議備份，涵蓋 Git、WebDAV 和本地文件夾。它允許同步四類內容：技能、會話、設置和插件清單。插件內置 AI 智能對齊與衝突解決機制，並提供本地優先快照與雲端恢復功能，同時具備私有倉庫校驗與 Token 隔離的安全機制。
核心功能¶
多協議備份¶
插件提供三種備份協議，每個協議對應一個頁籤和一個開關：
- Git 倉庫（默認開啓）：支持完整的分支 → PR → 合併流程，顯式衝突，支持 AI 語義合併。
- WebDAV（默認關閉）：兼容堅果雲、Nextcloud、Alist 等標準 WebDAV 服務。基於 SHA1 清單增量上傳，只傳變化文件。
- 本地文件夾（默認關閉）：支持
~等路徑。每次同步整目錄原子鏡像，中斷不留半截備份。
四類內容同步¶
每類內容可獨立開關並配置策略：
- 技能：默認開啓，策略=並集。新增都收，雙方改動交 AI 語義合併。
- 會話：默認關閉，策略=備份。寫入
backup/<實例ID>/，各機雲上獨立，本地永不被覆蓋。 - 設置：默認開啓，策略=備份。
- 插件清單：默認開啓，策略=備份。
AI 智能對齊與衝突解決¶
- 智能對齊：點「AI 智能對齊」，先自動回填遠端新增，再由 AI 對兩邊都改過的文件做語義合併，合併後自動推送。
- 解決衝突：出現衝突時設置頁出現「AI 解決衝突」按鈕，點擊後由系統自動推送與 PR 合併。
快照與恢復¶
- 本地優先快照：默認只落本機（
~/.dsh/dsh-sync/snapshots/），滾動保留 30 份。 - 通用上雲：勾選「上傳到雲端」才寫入所有已啓用的雲端協議。
- 恢復：本地直接恢復；本地沒有的按 Git → WebDAV → 本地文件夾 依次回退。
安全機制¶
- 私有倉庫校驗：支持 GitCode（默認）、GitHub、GitLab、Gitee 四個託管方。保存時判定公共倉庫一律拒絕保存。
- Token 隔離：AI 提示詞不含任何訪問令牌，憑據只寫不回讀，通過環境變量注入。
安裝與啓用¶
使用官方命令安裝插件：
dsh plugin --profile web add @weibaohui/dsh-sync -w
安裝完成後重啓 dsh web 即可生效。
典型用法¶
- 創建私有 Git 倉庫：在 GitCode（默認）、GitHub、GitLab 或 Gitee 創建一個私有倉庫。
- 配置託管方：打開 Web UI → 設置頁 → dsh-sync → Git 頁籤，點選託管方，填入倉庫地址與 access token。
- 切換託管方：支持 GitCode、GitHub、GitLab、Gitee 四個託管方。
- 使用 AI 對齊：日常修改後，點「AI 智能對齊」進行語義合併。
- 瀏覽與恢復：出現衝突時點擊「AI 解決衝突」。需從遠端恢復文件時，點「瀏覽遠端」→ 勾選文件 → 「預覽拉取」→ 「應用」。
注意事項¶
- 機密泄露風險：
settings.yaml等含機密時可能進入 AI 上下文（語義合併功能固有性質）。介意者請設置conflictMode=manual或關閉對應同步開關。 - Windows 路徑問題：Windows 下 Git Bash 路徑轉換問題，需注意環境變量配置。
- 設置持久化：設置持久化依賴宿主文檔或自持文件（
~/.dsh/dsh-sync/settings.）。 - 自建/未知主機：無法校驗倉庫私有性，保存前需用戶手動確認風險。
總結¶
weibaohui/dsh-sync 專注於解決 DSH 多機開發中的數據一致性問題。通過多協議備份、AI 輔助合併和安全的快照機制，它提供了一個可靠的同步方案。
