dsh-git-sync：DeepSeek Harness 的 Git 配置同步中心

前言¶

在使用 DeepSeek Harness（DSH）時，配置文件通常散落在本地的 ~/.dsh 目錄中。當需要在多臺機器之間同步這些配置，或者希望統一管理多個 AI 編碼工具（如 OpenCode、Cline、Roo Code 等）的設置時，手動複製文件不僅效率低下，還容易引發衝突。dsh-git-sync 旨在將 DSH 的配置目錄轉化爲一個 Git 倉庫，實現配置的實時或定時同步，並支持橋接其他 AI 工具的配置。

是什麼¶

這是 DeepSeek Harness 的 Git 配置同步中心插件。它由 Yiyang0659 維護，採用 MIT 許可證。該插件將 DSH 的配置變成 Git 倉庫，並提供多 AI 工具適配器，讓所有 AI 工具的設置都能同步到同一個 GitHub 私有倉庫中。

核心功能¶

實時同步：監聽配置倉庫的變化，在配置穩定後自動提交併推送到遠程。
每日調度器：支持每日定時同步，並在啓動時進行補齊運行。
衝突自愈：自動修復拉取時的衝突狀態，避免因未合併文件導致的拉取失敗。
多 Harness 適配器：支持 DeepSeek Harness 原生配置，以及 OpenCode、Cline、Roo Code、Kilo Code、Continue、goose、Agent Zero 等工具的配置橋接。
智能複製：拉取時僅寫入實際變更的文件，保護本地的新編輯。
網絡重試：在 fetch/pull/push 過程中遇到網絡錯誤時自動重試。
四狀態徽章：在會話頭部顯示同步狀態（已同步/待上傳/待拉取/分叉/衝突），並提供詳情面板。
側邊欄頁面：若安裝了 dsh-better-sidebar，可在側邊欄註冊 Git 同步中心頁面。
安全：自動將憑證文件加入 .gitignore，插件不直接觸碰 GitHub Token，而是調用本地 git 命令。
雙機準備：支持在兩臺機器上同步配置文件，實現配置共享。

安裝與啓用¶

在 ~/.dsh/profiles/web/package.json 的 dependencies 字段中添加依賴項，然後運行 pnpm install。

編輯 ~/.dsh/profiles/web/package.json，添加以下內容：

    {
      "dependencies": {
        "dsh-git-sync": "github:Yiyang0659/dsh-git-sync"
      }
    }

進入 ~/.dsh/profiles/web 目錄，執行安裝命令：

    pnpm install

重啓 DSH Web 服務：

    dsh web

典型用法¶

在 GitHub 上創建一個私有倉庫（例如 deepseek-harness-sync）。
進入 DSH 根目錄並初始化 Git 倉庫：

    cd ~/.dsh
    git init
    git branch -M main
    git remote add origin https://github.com/<你>/deepseek-harness-sync.git

進行一次 Git 認證（憑證會保存在操作系統的鑰匙串或憑據管理器中）：

    git config credential.helper osxkeychain

（Windows 系統可使用 manager）

重啓 DSH Web 後，打開會話頭部的徽章面板。
點擊“⬆️ 本地 ➔ Git”進行首次推送。
在“⚙️ 設置與適配器”中啓用實時同步、每日調度器，並開啓你使用的 AI 工具適配器。

適用場景與注意¶

該插件適合需要在多臺設備間保持配置一致的開發者，或希望統一管理多個 AI 編碼工具設置的用戶。

權限說明：每日調度器和實時監視器運行在 DSH 的服務器進程中，而非 Web 頁面中。
衝突處理：當兩臺機器同時編輯同一文件時，插件默認開啓 pullFirst 模式，會先拉取並變基遠程更改。
生態背景：DSH 生態強調“一切皆插件”，社區目錄（如 skillhub.cn）與 DeepSeek 官方無隸屬關係。

結語¶

dsh-git-sync 將 Git 的版本控制能力引入了本地 AI 工具配置管理，解決了多機協作和工具配置同步的痛點。通過本地 Git 調用而非直接操作 Token，它在保證同步能力的同時提供了較高的安全性。

目錄頁: https://www.skillhub.cn/plugins/Yiyang0659/dsh-git-sync
GitHub: https://github.com/Yiyang0659/dsh-git-sync