Git 标签页 CnsMaple/dsh-plugin-git

dsh-plugin-git

给 DeepSeek Harness Web GUI 右侧边栏加的 Git 标签页 —— 工作区状态、多泳道提交图、历史记录，还有 VSCode 风格的词级 diff，全部只读，底层走本地 git 命令行。

它把自己注册成侧边栏里的 git 页面类型：从 ＋ 引导页打开，就在内置的 Files 标签页旁边。

功能

- 🌿 分支行 —— 当前分支（或 detached HEAD）、相对 upstream 的 ahead / behind、一键重新加载
- 📝 变更 —— 列出工作区 / 暂存区的每一处差异，带 porcelain 标记（M / A / D / R / 未跟踪）；点文件看 diff（未跟踪文件按全新增渲染）
- 🕸 提交图 —— 历史列表旁边内嵌 SVG 泳道图：分叉开新泳道，合并收拢泳道，支持泳道交叉，每条泳道一种颜色；翻页时连线跨页不断
- 🔍 词级 diff —— 标记引擎移植自 VSCode 的 DefaultLinesDiffComputer：对裁剪后的行做逐变更块字符 diff、边界分数位移、整词扩展、短相等段合并，还有那条横跨光标、标出对侧改动位置的竖条。配色跟随行底色（改动行浅底，具体改动的字符底色更深）
- ⇄ 布局切换 —— 在行内（上下）和并排（左右）两种 diff 渲染之间切换；并排模式把删除与新增配对，空单元格打上斜纹
- 🔒 设计上只读 —— Host 只跑 git status / log / show / diff，refs 和路径都做校验，绝不让它们伪装成命令行选项，每项输出还有字节上限

安装

推荐 —— 用 DSH 命令行直接从 GitHub 安装：

dsh plugin --profile web add github:CnsMaple/dsh-plugin-git

（--profile <name> 换成你实际启动的配置档，比如 --profile web。）

包以 bundle 形式发布（dsh.bundle.patch）：安装时会把它并入配置档的 dsh.profile.bundles，插件自带的 cordis.patch.yml 挂载两半 —— Host 的 workspaceGit Remote 服务和浏览器标签页。不用手动改补丁。

重启 harness，打开侧边栏的 ＋ 引导页，选 Git。

工作原理

插件自己管住数据链路两端，不碰任何核心代码：

- Host：一个 TypertRemoteService（workspaceGit）暴露 status / log / diff，按会话解析到该会话的工作区根目录
- 浏览器：标签页自己挂载对应的客户端贡献（remote.workspaceGit），所以插件能组合进任意配置档，核心装配层完全不知情

开发

pnpm install # see note below
npm run build # tsc + tsdown (Node half + browser bundle); lib/ is committed
npm test # vitest: diff marking, graph layout, porcelain parsing

devDependencies 和 pnpm-workspace.yaml 里的 overrides 把 link: 指向本地 DeepSeek Harness 检出目录（默认 D:/Code/ai/deepseek-harness），这样 @deepseek-ai/dsh-typert-protocol 的 declare module 扩展只针对单份副本编译。把路径改成你自己的检出目录——或者干脆跳过构建：使用方安装的是已提交的 lib/，根本不会碰到开发依赖。

lib/typert.host.js 和 src/remote.ts 是 Remote 契约的手工维护镜像——服务 API 变化时，记得同步改这两处。

许可证

MIT