dsh-plugin-git-inspect
用于 DeepSeek Harness 的只读 Git 检查工具
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Wanbinyu/dsh-plugin-git-inspect#3e7de5648dd3a8e804da7258991c7ddc47b2a01bPlugin Git Inspect 以 dsh-plugin-git-inspect 发布，当前版本为 0.3.6。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
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；会话未提供目录时，回退到宿主进程的当前工作目录。
git，并使用固定的 argv 启动进程。-- pathspec 分隔符之后，不经过 shell 展开。commit、push、reset、stash、切换分支或文件修改能力。git_blame 默认最多返回 50 行，配置允许的上限为 200 行，避免整文件归属信息挤占上下文。git。>=22.19.0。@deepseek-ai/dsh-tools@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-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 的兼容分支。
仓库根目录包含 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。