DeepSeek Harness（DSH）适合让多个 Agent 在不同 Worktree 中并行工作。但在终端里仅通过 git log 很难同时回答分支来源、WIP 对比以及 Agent 会话状态等问题。dsh-gitKraken 将这些信息整合进 DSH 原生的 Git Graph 标签页，提供可视化的历史图谱和安全的 Workbench。
该插件由维护者 nateEc 维护，开源协议为 MIT。
环境要求¶
需要 Node.js >= 22.19.0 和 DeepSeek Harness >= 0.1.1-rc.2。
安装¶
在目标 profile 中执行以下命令：
pnpm add '@nateec/dsh-gitkraken@github:nateEc/dsh-gitKraken#1b7cda88f3bba07e859a653d15d46b9db2238e14'
安装完成后，用你的 profile 固定版本重启 DSH，打开任意 Git 工作区的会话，顶部会出现 Git Graph 标签页。
核心功能¶
- Git Graph：提供多分支 DAG、分支/标签/远端引用、作者与变更统计、服务器端分页、Repository Sonar Minimap 以及缩放与跳转功能。
- Search & Filter：支持
message:、author:、file:、change:、commit:、@me等搜索过滤，支持大小写、正则、全词匹配和跨分页结果导航。 - Inspect & Compare：展示提交详情、历史文件 Diff、完整 Patch 和 Multi-diff，支持 Commit/Branch/WIP 任意两点对比。
- WIP & Commit：支持逐文件暂存/取消暂存、Stage All、Copy Patch、Commit Composer 以及创建与切换分支。
- Agent Workspaces：展示多 Worktree WIP、AgentTeams Kanban、Agent Activity、普通与子代理 DSH 会话状态及直达链接。
- Safe Workbench：提供 Stash、Undo Commit、Rebase 预览、恢复引用以及冲突的 ours/theirs 选择，支持 Continue/Abort。
- DSH Model Tools：使用当前 DSH 会话 Provider 生成 Review、Explain 与 Changelog，不读取或复制模型 API Key。
- Remote：支持 Fetch、仅快进 Pull、普通 Push；可选的 GitHub/GitLab Pull Request Provider 默认关闭。
典型用法¶
- 在 DSH 中打开一个真实 Git 仓库的会话。
- 切换到 Git Graph 标签页。
- 在 Graph 中搜索、筛选、选择提交或 WIP；在右侧 Inspector 中查看文件和 Diff。
- 切到 Agents 页面查看所有 Worktree、AgentTeams 任务与 DSH 会话。
- 切到 Workbench 执行批量暂存、Stash、模型审阅或带恢复点的历史操作。
搜索语法示例¶
message:fix timeout：搜索提交信息包含指定文本的提交。@me：搜索当前 Git 用户提交的内容。file:src/client：搜索改动过指定路径的提交。
安全与限制¶
该插件执行真实 Git 操作，安全约束属于产品功能，而非附注：
- 后端只接受 DSH 已注册工作区的真实路径，HTTP 接口只允许本机回环访问。
- Git 命令始终使用参数数组执行，不经过 shell 拼接。
- Pull 只允许 fast-forward；Push 不提供 force 模式。
- Undo Commit 仅在干净工作区执行 soft reset，文件变化会保留在暂存区。
- Rebase 要求工作区干净、当前分支非 detached，并在改写前创建恢复引用和精确确认。
- Stash 使用保留式 Apply，不自动 Pop；恢复操作不会执行 hard reset。
- 当前不提供 Discard、删除本地/远端分支、force push 或跳过 hooks。
- 没有遥测或自动更新逻辑。
- GitHub/GitLab Provider 默认关闭，私有仓库只读取插件专用的环境变量 Token，不会返回浏览器或复用 DSH 模型凭据。
项目仓库：https://github.com/nateEc/dsh-gitKraken
