dsh-git-dashboard

DeepSeek Harness（dsh）的仓外只读 Git 工作区看板。安装到 web profile 后，会话头部显示分支与变更摘要，可展开查看文件列表、分支比较，并对小改动做 unified diff 预览。

功能

• 会话头部入口：当前分支 / detached HEAD、变更文件数
• 看板：已暂存 / 未暂存 / 未跟踪 / 冲突计数，文件级 +N/−M（相对 HEAD；未跟踪按全新增计入）
• 同一文件可同时标记「已暂存」与「未暂存」
• 点击文件：相对 HEAD 的小 diff 预览（含未跟踪）；过大 / 二进制 / 冲突则说明原因
• 分支比较：选择基准分支，查看 ahead/behind 与文件摘要
• loopback 且 Host 允许时：「在文件夹中打开」

默认上限：单文件预览变更合计 ≤ 500 行，diff stdout ≤ 256 KiB（可配置）。

要求

• Node ^22.19 || >=24（与 dsh 一致）
• 可用的 dsh 与本机 git
• web profile（默认 ~/.dsh/profiles/web，或 $DSH_HOME/profiles/web）

安装

不必 clone 本仓库。 在 web profile 里 pnpm add 安装即可；发布包内已带 lib/ 构建产物，profile 直接加载，无需本地编译。

clone 仅用于阅读源码、提 issue 或自行 fork 开发；与「给 dsh 装插件」无关。

在 web profile 目录安装本包：

cd ~/.dsh/profiles/web
pnpm add github:Sombrer0-1/dsh-git-dashboard

SSH：

pnpm add git+ssh://[email protected]:Sombrer0-1/dsh-git-dashboard.git

固定版本（推荐）：

pnpm add github:Sombrer0-1/dsh-git-dashboard#v0.1.0

在 profile 的 package.json 中，把 dsh-git-dashboard 写入 dsh.profile.bundles，排在 @deepseek-ai/dsh-base（及已有 web bundle）之后：

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-git-dashboard"
      ]
    }
  }
}

安装后若 Host 报找不到 @deepseek-ai/dsh-typert-protocol 等包，在本包目录执行一次依赖链接（先成功跑过 dsh web，以便 profiles 的 node_modules 已就绪）：

cd ~/.dsh/profiles/web/node_modules/dsh-git-dashboard
node scripts/link-runtime-deps.mjs

link-runtime-deps.mjs 把 Host 侧 peer 链到 $DSH_HOME/profiles/node_modules：Windows 创建目录 junction（mklink /J），macOS / Linux 创建目录符号链接。仅当 Node 从插件真实路径解析依赖、走不到 profile 的 node_modules 时才需要（常见于 pnpm add 指向 git 仓库或 link: 路径）。

验证并重启：

dsh --profile web --dump-config

输出中应有 # == dsh-git-dashboard。然后重启 dsh web。

卸载：从 dsh.profile.bundles 去掉包名，再 pnpm remove dsh-git-dashboard。

配置

cordis.patch.yml 默认值（可在 profile 覆盖同名插件 config）：

| 字段 | 默认 | 含义 | |---|---|---| | command | git | Git 可执行文件 | | timeoutMs | 2000 | 单次 git 命令超时 | | maxStatusBytes | 1048576 | git status stdout 上限 | | maxNumstatBytes | 524288 | numstat stdout 上限 | | maxFiles | 100 | 列表最多文件数 | | maxBranches | 100 | 分支列表上限 | | maxDiffBytes | 262144 | 单文件 diff 预览字节上限 | | maxDiffChangedLines | 500 | 单文件预览变更行（增+删）上限 |

安全说明

• Remote 使用 Gateway 现有 trusted-host，不另做 loopback-only。
• 会向已授权客户端暴露仓库名、分支名、路径与行数统计；小 diff 预览会传输该文件的 unified diff（受上限约束）。
• 建议在 loopback 使用；若 LAN trusted host 可连，请自行评估暴露面。

仓库内容

Git 仓库含源码与文档；pnpm add 装进 profile 的 npm 包按 package.json#files 发布，不含 src/、tests/、docs/（运行时只读 lib/）。

| 路径 | 说明 | |---|---| | lib/ | 构建产物；安装后 profile 加载这里 | | cordis.patch.yml | 插入插件行 | | scripts/link-runtime-deps.mjs | 按需链接 Host peer（见安装节） | | src/ | 源码（仅 git 仓库；npm 包不含） | | tests/ | 单测（仅 git 仓库） | | docs/ | 截图与设计草案（仅 git 仓库） |

License

MIT