DevViking-Persike/dsh-git-graph

dsh-git-graph

一个用于 DeepSeek Harness 的 Git 提交图视图：聊天输入框旁边的停靠按钮会以泳道图的形式打开历史记录——分支、合并、引用——以及工作树列表。智能体通过两个工具获得相同的拓扑结构。

安装

dsh plugin --profile web add github:DevViking-Persike/dsh-git-graph

重启 dsh。对话输入框旁边会出现一个 ⎇ grafo 按钮；输入仓库路径并按下它。只读工具会立即生效。

你会看到什么

- 提交泳道：每个提交都是彩色泳道上的一个点；第一父提交线笔直延伸，合并边在泳道之间弯曲。分支和标签标签位于其提交旁边；当前分支带有 。
- 工作树：图下方的条带列出每个工作树及其分支、[detached] 或 [bare] 状态。
- 深度：面板加载最新的 200 个提交；limit 配置可更改默认值。

工具

| 工具 | 功能 |
|---|---|
| git_graph | 以模型可推理的单行摘要形式呈现带泳道、父提交、引用和工作树的历史记录。 |
| git_worktree | 列出工作树及其分支。 |

配置

每个字段都是可选的。

| 字段 | 默认值 | 含义 |
|---|---|---|
| limit | 300 | 工具的历史深度以及路由默认值。 |
| route | /git-graph | 浏览器端获取的路径。 |

- id: dsh-git-graph
name: 'dsh-git-graph'
config:
limit: 500

工作原理

宿主端通过 harness 子进程接缝查询 git log --format（哈希、父提交、作者、时间戳、主题）、for-each-ref、symbolic-ref 和 worktree list --porcelain——固定 argv，不使用 shell——按从新到旧分配泳道，并将同一份 JSON 文档同时提供给模型工具和一个 HTTP 路由。浏览器端注册到 conversation.input.dock，并以 SVG 渲染图，无需构建步骤。

泳道分配遵循一条规则：先注册者赢得父提交的泳道。按从新到旧遍历时，每条泳道等待一个下一个提交；当两个子提交指向同一个父提交时，先处理的子提交占据父提交的泳道，另一个则弯入其中——这与常见提交图渲染器的行为相同，也正是使释放的泳道被复用而非无限增长的特性。

安全性

- 每次 git 调用都是通过子进程接缝的固定 argv；分支名对 git 而言是数据，绝不是标志或 shell 片段。
- HTTP 路由仅响应 GET，并在失败时引用 git 自身的诊断信息（例如 not a git repository）——绝不返回堆栈跟踪。
- 两个界面都是只读的：该插件列出历史记录和工作树；它从不提交、检出、创建或删除任何内容。
- 收集的输出按每次调用设有上限。

已知限制和推迟的工作

- 该面板需要手动输入仓库路径；它不会自动发现会话的当前工作目录，因为停靠组件目前没有会话作用域的路径。
- 历史深度有上限（limit，默认 300）；一个非常大的仓库只会显示其最新的切片，而不是全部内容。
- 引用装饰显示本地分支、标签和远程，但不将 HEAD 显示为独立标记，也不显示 stash 条目。
- 面板中没有工作树创建/移除操作；这些操作会改变机器状态，如果添加，将遵循 docker 插件的选择加入模式。
- 音频/视频模态在此无关；图是 SVG，数据是文本。

测试

node --test test/.test.js

23 个测试，无网络。数据测试针对一个真实的临时 git 仓库运行，包含真实的提交和真实的合并——手写的测试夹具可能与解析器一致，却与 git 不一致。客户端测试通过真实的模块加载器格式加载模块，并使用一个最小的 React 模拟实现。

许可证

MIT — 参见 LICENSE 和 NOTICE.md。