dsh-plugin-git-inspect

简体中文 | English

面向 DeepSeek Harness 的只读 Git 检查插件。

[!NOTE] 这是独立的社区插件，不属于 DeepSeek Harness 官方发行版。

功能

插件向模型注册十个只读工具：

工作目录优先取当前 Harness 会话的 session.header.cwd；会话未提供目录时，回退到宿主进程的当前工作目录。

安全边界

• 不执行 shell。插件通过 Harness 的 subprocess 服务解析 git，并使用固定的 argv 启动进程。
• 用户传入的路径始终放在 Git 的 -- pathspec 分隔符之后，不经过 shell 展开。
• 关闭 pager、颜色、外部 diff、textconv、可选 Git 锁和终端交互提示，保证自动化输出稳定。
• 只提供检查操作，不提供 commit、push、reset、stash、切换分支或文件修改能力。
• 转发 Harness 的取消信号，并限制 stdout/stderr 的捕获大小。
• 输出达到上限时，结果会明确标记为截断。
• git_blame 默认最多返回 50 行，配置允许的上限为 200 行，避免整文件归属信息挤占上下文。

环境要求

• Windows、macOS 或 Linux，且宿主 PATH 中可以找到 git。
• Node.js >=22.19.0。
• Harness 组合需要提供：
  • @deepseek-ai/dsh-tools
  • @deepseek-ai/dsh-system-prompt
  • @deepseek-ai/dsh-subprocess
• 还需要一个 subprocess 实现，例如 @deepseek-ai/dsh-subprocess-local。

当前插件面向 Harness 0.1.0-rc.x 开发预览版本。

作为 bundle 安装

仓库根目录包含 cordis.patch.yml，并在 package.json 中声明了 dsh.bundle。在已经安装 Harness CLI 的环境中，可以将它加入 web profile：

dsh plugin --profile web add github:Wanbinyu/dsh-plugin-git-inspect

安装后重启 dsh。bundle 会自动插入 git-inspect 配置行，并安装插件运行时。也可以直接查看或修改 cordis.patch.yml。

手动安装

如果宿主项目需要自己控制组合层，也可以安装包后手动插入：

npm install github:Wanbinyu/dsh-plugin-git-inspect

在已经挂载 Harness 必需服务的 Cordis 组合中加入：

- id: git-inspect
  name: dsh-plugin-git-inspect
  config:
    timeoutMs: 30000
    maxOutputBytes: 200000
    stderrMaxBytes: 16384
    graceMs: 1000
    defaultLogCount: 20
    maxLogCount: 100
    defaultBlameLineCount: 50
    maxBlameLineCount: 200

仓库中的 examples/cordis.yml 提供了 overlay 示例。该示例不会自动安装 subprocess provider，provider 仍由宿主组合负责。

配置项

所有限制必须是正整数；默认数量不能大于对应的最大数量。

工具调用示例

{"name":"git_status","arguments":{}}

{"name":"git_diff","arguments":{"staged":true,"path":"src/index.ts"}}

{"name":"git_log","arguments":{"maxCount":10,"path":"src/index.ts"}}

{"name":"git_show","arguments":{"revision":"HEAD","path":"src/index.ts"}}

{"name":"git_conflicts","arguments":{}}

{"name":"git_blame","arguments":{"path":"src/index.ts","startLine":20,"lineCount":30}}

{"name":"git_stash_list","arguments":{"maxCount":10}}

{"name":"git_worktree_list","arguments":{}}

Git 返回非零退出码、目录不是仓库、路径为空、请求被取消或子进程异常终止时，插件会返回结构化工具错误，不会伪装成成功输出。

本地开发

git clone https://github.com/Wanbinyu/dsh-plugin-git-inspect.git
cd dsh-plugin-git-inspect
npm install
npm run verify
npm run build
npm pack --dry-run

测试会创建临时 Git 仓库，并通过 Harness 的本地 subprocess provider 调用真实 git，覆盖分支状态、工作区和暂存区 diff、diff 摘要、revision、refs、冲突、blame、stash、worktree、路径过滤历史、输出限制、错误路径和 argv 安全性。GitHub Actions 会在 Node.js 22 上执行类型检查、测试和打包检查。

项目边界

这是一个面向 Agent 工作流的只读检查层。写操作、远程同步、分支切换、worktree 管理和文件编辑均不在范围内，便于宿主组合单独制定审批策略。

链接

• DeepSeek Harness
• GitHub 仓库
• Issues
• English README

许可证

MIT，详见 LICENSE。