dsh-git-plugin

给 DeepSeek Harness（DSH）的 Git 工作流插件：补齐 DSH 相比 Claude Code / Codex 缺失的「程序员手感」——diff 感知、自动分支、规范提交、可恢复撤销。全部通过 ctx.subprocess seam 以纯 argv 调用 git，不经过 shell 层，每次运行都受字节与超时上限约束。

能力

命令（面向人 / 斜杠命令）

工具（面向模型 / 只读）

插件还会注入一段 system-prompt 指引，让模型主动用 git 工具查看状态、并遵循仓库的提交与分支规范。

仓库发现

当会话工作目录不是 git 仓库时，插件会：若其直接子目录里只有一个 git 仓库，自动使用它；有多个则列出让用户选择；一个都没有才报 not a git repository。这让它能在「项目集合」式的工作区根目录下正常工作。

安装

已发布到 npm（[email protected]），一条命令安装：

dsh plugin --profile <name> add dsh-git-plugin

本地 / 源码开发时也可用路径安装：

dsh plugin --profile <name> add /path/to/dsh-git-plugin

安装后，在 profile 的 cordis.patch.yml 里用 insert 声明启用：

- insert:
    - id: dsh-git-plugin
      name: dsh-git-plugin

需要配置时加上 config：

- insert:
    - id: dsh-git-plugin
      name: dsh-git-plugin
      config:
        preCommit: [npm, test]

配置

提交规范

/commit 默认提示 MAA 风格的提交信息，与本仓库约定一致：

<类型>(<可选作用域>): <中文主体>
feat / fix / docs / chore / style / refactor / test / perf

若仓库根目录存在 AGENTS.md / CLAUDE.md，模型会读取并遵循其中的自定义规范。

开发

• 分支工作流：所有开发在功能分支进行，稳定后才合并到 main。
• 分支命名：feat/xxx、fix/xxx、docs/xxx、chore/xxx。
• 提交消息：<类型>(<可选作用域>): <中文主体>。

本地校验与测试：

npm install
npm run check   # 语法校验
npm test        # 单元 + 真实 git 集成测试

集成测试会在临时目录里真正 git init / commit / stash，验证 /commit、/undo、/branch 与只读工具端到端可用。

Hook 与 CI

• 插件 pre-commit 钩子：通过 config.preCommit 配置一个 argv 命令，/commit 会在 git add 前运行它，失败即中止提交。

• 仓库 commit-msg 钩子：.githooks/commit-msg 强制 MAA 提交格式。启用：

  git config core.hooksPath .githooks
  

• CI：.github/workflows/ci.yml 在 push / PR 时跑 npm ci、node --check 和 node --test。

License

MIT