前言¶

DeepSeek Harness（DSH）是面向智能體開發的插件化環境。在開發流程中，Git 提交、推送與代碼檢查往往需要重複執行，且容易因環境配置差異導致失敗。dsh-git-push 插件將 Git 操作鏈路集成到 DSH 中，提供掃描倉庫、一鍵提交推送、代碼審計門禁以及 npm 發包安裝等能力，讓智能體可以直接調用工具完成代碼交付。

插件概覽¶

該插件由 EIGHTfs 維護，採用 MIT 許可證。

• 核心定位：DSH git 自動提交推送插件，支持掃描倉庫 + 一鍵 commit/push（工具 + HTTP API）。
• 主要功能：
  • Git 提交推送（帶審計門禁）
  • 代碼審計（22 個規則包，3 層結構）
  • npm 發包與安裝
  • 憑據管理（Token/SSH）
  • 賬號檢測與狀態
  • 獨立 CLI (git-sluice)
  • HTTP API 接口
  • AI 任務完成自動推送

快速開始¶

安裝並重啓 DSH 後，有三種方式可直接使用該插件。

1. AI 直接調用：插件已註冊工具 git_scan、code_audit、git_commit_push、git_account_check 等。在 DSH 會話中直接說人話即可，例如：「掃描我的倉庫」或「審計並提交 xx 倉庫」。
2. 獨立 CLI (git-sluice)：脫離 DSH 也能運行。

    # 校驗 GitHub 憑據
    git-sluice account-check
    # 掃描目錄下的倉庫
    git-sluice scan <目錄>
    # 全量審計倉庫
    git-sluice audit <倉庫> --full
    # 提交推送（自動過審計門禁）
    git-sluice commit <倉庫> -m "msg"

3. 側邊欄面板：通過界面進行賬號檢查、代碼審計規則配置、提交推送操作。

核心功能¶

提交推送（GitHub + npm）¶

插件提供完整的 Git 全鏈路自動化能力，並集成了 npm 生態操作。

• 憑據管理：支持 GitHub Token（保存至憑據目錄，權限 0600）與 SSH 公鑰管理。支持一鍵生成密鑰對。
• 自動判定 Remote：推送前自動選擇正確的 GitHub remote（優先 origin，支持 SSH 與 Token 雙通道）。
• 自動提交身份：智能體無需猜測提交身份。如果倉庫未配置，插件會自動使用登錄的 GitHub 賬號身份（如 登錄名@users.noreply.github.com）。
• 零改動安全：當工作區無改動或已同步時，調用不會報錯，返回 ok:true，狀態欄會明確提示。
• npm 能力：支持發包（默認 dry-run）、四段式安裝交互、賬號離線快照與在線校驗。

代碼審計¶

在提交前自動進行代碼審計，設置硬性門禁。

• 三層審計管線：L1 正則初篩 / L2 AST 數據流 / L3 運行時檢測。
• 規則體系：包含 22 個規則包、138 條規則。
• 門禁機制：推送前自動過審計門禁。blocker 級別規則會直接攔截提交。
• API 接口：提供 GET/POST /api/git-push/audit 接口，支持自定義聚合審計結果（按規則類型、嚴重級過濾）。

AI 任務完成自動推送¶

插件支持監聽 AI 回合結束，檢測回覆中的完成標記（默認 ✅任務完成），自動觸發 commit + push（複用審計門禁）。

技術細節¶

• HTTP API：插件暴露了多個 HTTP 接口，例如賬號檢測 /api/git-push/account-check 和審計 /api/git-push/audit，便於外部系統集成。
• 獨立腳本：插件包含 git-sluice CLI 和運行時檢測腳本，支持獨立運行。

注意事項¶

• 插件依賴 api.github.com。
• 憑據目錄權限爲 0600，確保安全性。
• 推送前會自動執行審計，請留意 blocker 警告。
• 插件以當前 DSH 進程權限運行，使用前請檢查源碼與許可證。

結語¶

dsh-git-push 將 Git 工作流標準化，降低了智能體開發中的環境配置成本。你可以通過下方鏈接查看插件詳情與源碼。

• GitHub 倉庫
• 插件目錄頁