前言¶

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 仓库
• 插件目录页