在多設備環境下使用 DeepSeek Harness（DSH）時，會話進度、界面設置以及工作區裏的項目文件往往難以在換機時無縫銜接。dsh-chatsync 插件解決了這個問題，它通過用戶的 GitHub 私有倉庫來存儲這些狀態，實現跨設備的同步。
這是一個記憶類插件，由 dpskk2 維護，開源協議爲 MIT。它的核心價值在於將 DSH 的運行時狀態（包括會話、附件、設置和項目文件）納入版本控制，而不是僅僅保存在本地。
核心功能¶
該插件提供以下能力：
* 全量狀態同步：同步會話、附件、模型與界面設置，以及工作區裏的項目文件。
* 私有倉庫存儲：所有數據存儲在用戶自己的 GitHub 私有倉庫中，而非公共雲端服務。
安裝與啓用¶
在安裝之前，請確保環境滿足以下條件：
* DSH 版本不低於 0.1.5-rc.3
* 已安裝 Git
* 已安裝並配置 GitHub CLI
安裝插件¶
在終端中執行以下命令安裝插件（以 Web 端爲例）：
dsh plugin --profile web add @dpskk2/dsh-chatsync
登錄 GitHub¶
安裝完成後，需要使用 GitHub CLI 進行授權：
gh auth login --hostname github.com --git-protocol https --web
按提示完成瀏覽器授權，並在詢問是否讓 Git 使用此賬號時選擇 Yes。
配置與使用¶
安裝並登錄後，重啓 DSH，打開 設置 → 同步 進行配置。
第一步：連接同步倉庫¶
- 第一次使用：倉庫地址留空，保持「地址留空時自動創建或複用私有倉庫」勾選，分支保留
main。同步時會嘗試創建或複用賬號下的dsh-sync私有倉庫。 - 已有倉庫：填寫原電腦顯示的倉庫地址和分支。
點擊 保存連接，繼續第 2 步。
第二步：選擇同步內容和方式¶
默認同步會話、附件、設置和工作區裏的項目文件。如果只需要會話與設置，可以關閉 同步工作區文件。
首次使用建議保留 手動同步，點擊 保存選擇，繼續第 3 步。
第三步：在原電腦開始同步¶
點擊 立即同步，取回遠端數據並上傳本機改動。傳輸完成前保持 DSH 打開。確認設置頁顯示同步已完成且無失敗。
第四步：在新電腦取回並驗證¶
在新電腦上完成安裝與 GitHub 登錄後，重新啓動 DSH，在設置頁填寫原電腦的倉庫地址和分支，保存連接及同步內容選擇。
點擊 立即同步，確認原電腦的會話和選定的項目文件已出現。在換機後，仍需在本地配置模型 API 密鑰、安裝其他插件和項目依賴。
日常使用與注意事項¶
- 操作習慣：建議在開工前同步，收工後同步，確認成功後再換電腦。
- 自動同步：雙向驗證通過後，可在設置中開啓自動同步（默認每 5 分鐘同步一次）。
- 重要提醒：
- 新電腦配置：新電腦必須單獨配置 API 密鑰、插件和項目依賴，插件本身不會自動遷移這些本地環境配置。
- 數據備份：雖然插件會傳播刪除和修改，重要資料請另留備份。
- 敏感信息：專用憑據文件不會上傳，但聊天、附件或項目文件中的密鑰仍可能被同步，必要時需設置排除規則。
