dsh-plugin-git-inspect
v0.3.6 兼容性修复：适配 Harness 0.1.5-rc.2，并通过 0.1.1-rc.2 回归。修复旧 runtime 模块缺失问题；下方下载链接指向本次修复包。其他宿主版本请先验证兼容性。
简体中文 | English
面向 DeepSeek Harness 的只读 Git 检查插件。
[!NOTE]
这是独立的社区插件，不属于 DeepSeek Harness 官方发行版。
功能
插件向模型注册十个只读工具：
| 工具 | 作用 | 可选参数 |
|---|
git_status | 查看当前分支和工作区状态。 | 无 |
git_diff | 查看工作区 diff 或暂存区 diff。 | staged、path |
git_diff_stat | 以文件为单位查看 diff 摘要。 | staged、path |
git_log | 以紧凑的一行格式查看最近提交。 | maxCount、path |
git_show | 查看指定提交、标签或其他 revision。 | revision、path |
git_refs | 查看最近的本地分支、远程跟踪分支和标签。 | maxCount |
git_conflicts | 列出尚未解决的合并冲突文件。 | path |
git_blame | 查看指定文件一段行号范围的提交归属。 | path、startLine、lineCount |
git_stash_list | 查看最近的 stash，不创建或应用 stash。 | maxCount |
git_worktree_list | 以稳定格式查看已注册的 worktree。 | 无 |
工作目录优先取当前 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。
v0.3.6 已使用 DeepSeek Harness 0.1.2-rc.1 完成类型、测试、构建和打包验证，并保留 0.1.0-rc.5 至 rc.8、0.1.1-rc.1 至 rc.2 的兼容分支。
作为 bundle 安装
仓库根目录包含 cordis.patch.yml，并在 package.json 中声明了 dsh.bundle。在已经安装 Harness CLI 的环境中，可以将它加入 web profile：
dsh plugin --profile web add https://github.com/Wanbinyu/dsh-plugin-git-inspect/releases/download/v0.3.6/dsh-plugin-git-inspect-0.3.6.tgz
安装后重启 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 仍由宿主组合负责。
配置项
所有限制必须是正整数；默认数量不能大于对应的最大数量。
| 配置项 | 默认值 | 作用 |
|---|
timeoutMs | 30000 | 传递给 Harness 工具的最长执行时间。 |
maxOutputBytes | 200000 | stdout 捕获上限。 |
stderrMaxBytes | 16384 | stderr 捕获上限。 |
graceMs | 1000 | Git 子进程终止时的宽限时间。 |
defaultLogCount | 20 | 未传 git_log.maxCount 时的提交数量。 |
maxLogCount | 100 | git_log.maxCount 的最大值。 |
defaultBlameLineCount | 50 | 未传 git_blame.lineCount 时的行数。 |
maxBlameLineCount | 200 | git_blame.lineCount 的最大值。 |
工具调用示例
{"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
测试会创建临时 Git 仓库，并通过 Harness 的本地 subprocess provider 调用真实 git，覆盖分支状态、工作区和暂存区 diff、diff 摘要、revision、refs、冲突、blame、stash、worktree、路径过滤历史、输出限制、错误路径和 argv 安全性。verify 会执行类型检查、测试、构建和安装包内容检查；GitHub Actions 会在 Node.js 22 的 Ubuntu、Windows 与 macOS 环境中运行它。
项目边界
这是一个面向 Agent 工作流的只读检查层。写操作、远程同步、分支切换、worktree 管理和文件编辑均不在范围内，便于宿主组合单独制定审批策略。
链接
许可证
MIT，详见 LICENSE。
