前言¶

在 DeepSeek Harness（dsh）Web 里跑智能体时，仓库有没有未提交改动、当前连了哪些 MCP、会话 token 用了多少，往往要切终端或翻日志。dsh-hud 把这类信息收进输入栏旁的一个浮动面板，点一下仪表盘图标即可查看，不必离开对话界面。

下面介绍这个由社区维护者 a903067276-rgb 开发的客户端插件：它是什么、能看什么、怎么装、怎么用，以及安装前需要注意的事项。

这是什么¶

dsh-hud 是面向 DeepSeek Harness Web 端的 HUD 状态面板插件。输入工具栏增加一个仪表盘按钮，点击后在右侧打开可拖拽宽度的浮动面板，集中展示 Git 状态、MCP 服务、Skills、官方用量与会话统计；按钮上还会显示未提交文件数量的实时角标。

项目托管于 GitHub（a903067276-rgb/dsh-hud），在 SkillHub 社区目录归类为「客户端」；当前 package.json 版本为 1.2.16，许可证 MIT。这是社区独立项目，非 DeepSeek 官方产品。

核心功能¶

面板内数据大致分为以下几块，均来自本地运行的 dsh 实例（余额除外，见下文）。

Git

• 分支名、ahead/behind、未暂存 / 已暂存 / 未跟踪文件（可折叠分组）
• 每个文件显示 +N/-N 摘要，点击可展开完整 diff
• 最近 5 条 commit

MCP

• 从工具名 mcp__<server>__<tool> 推导出的已连接 MCP 服务列表

Skills

• 当前 agent 可用的 skills 列表

官方用量与会话

• 当前模型与 reasoning effort、plan mode 状态
• Token 用量（input / output / cache-hit rate）
• 会话统计：turns、steps、LLM 与 tool 耗时、decode tok/s、context 使用百分比
• 按模型拆分的 token 桶（requests、input、cache、output），切换 flash/pro 后仍可同时看到

余额

• 通过宿主侧 GET /user/balance 拉取官方 DeepSeek 账户余额，使用 DEEPSEEK_API_KEY 凭证；密钥不离开宿主，不可用时显示 --

工具栏按钮在未打开面板时仍会对 Git 做轻量轮询，角标数字即未提交文件数。

安装与启用¶

本仓库是官方 bundle 插件（根目录 package.json 含 dsh.bundle 与 dsh.client），通过 profile 管理器安装：

dsh plugin --profile web add "github:a903067276-rgb/dsh-hud#main"

安装后需 重启 dsh web（bundle 层在启动时组装，HMR 不生效）。dsh plugin 会转发到 pnpm，因此需要 pnpm 在 PATH 中。

手动挂载备选路径见仓库 docs/install.md。官方 bundle 安装与手动挂载 二选一，不要同时使用。

版本兼容

旧版安装示例：

dsh plugin add github:a903067276-rgb/dsh-hud#v1.2.11

dsh plugin add github:a903067276-rgb/dsh-hud#rc6-compat

环境要求

• DSH Web >= 0.1.1-rc.1（例如 npx @deepseek-ai/dsh web）
• git CLI 在 PATH 中
• DSH 的 shell 服务在各平台通过 bash -c 执行命令（Windows 为 Git Bash），无需额外 shell

平台支持：macOS 已在开发环境完整测试；Linux 与 Windows 尚未充分测试，预期可用，细节见 docs/install.md#平台支持。

典型用法¶

1. 按上文命令安装并重启 dsh web。
2. 在输入工具栏找到 仪表盘（gauge）图标（遵循 DSH 官方 design tokens，随深色/浅色主题切换）。
3. 点击打开右侧浮动面板（默认宽 240px）；拖拽左边缘可在 200–480px 间调整，宽度记入 localStorage。
4. 带数量角标的分区标题可点击折叠/展开；数据每 30 秒自动刷新（面板关闭时仅 Git 角标继续轻量轮询）。

可选环境变量：在目录树极大、文件监视不可靠的机器上，可设 DSH_HUD_NO_WATCH=1 关闭文件监视，改由 30 秒轮询与手动/焦点刷新驱动更新。默认监视深度上限为 128。

架构简述¶

宿主（Node，lib/index.js）通过 webServer 注册 /api/dsh-hud 路由，在单次 bash -c 中执行 Git 命令；浏览器端（lib/client.js）在 input.left 座位挂载按钮、在 shell.overlay 座位挂载面板，二者通过模块级 store（useSyncExternalStore）共享状态。客户端为手写 window.__ModuleLoader__.load(...) bundle，无构建步骤、零运行时依赖。维护者细节见 docs/architecture.md。

设计取向是 只读、极简：不执行 git 写操作、不设独立配置页；若需要提交/推送 UI 或文件树，应选用其他 SCM 类插件，dsh-hud 仅作一眼可用的状态 HUD，可与它们并存。

适用场景与注意¶

适合在 DSH Web 里长时间对话、需要随时确认仓库脏文件、MCP 连接、token 与会话指标的智能体开发者。

安装前应知：

• 插件以当前 dsh 进程的权限运行，会执行本地 git 命令并读取 MCP/skills 投影；除官方余额 API 外无其他出站请求。
• 余额功能依赖宿主配置的 DEEPSEEK_API_KEY。
• 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；安装前建议自行查看源码与 MIT 许可证。

若你希望在 Web 对话界面内快速扫一眼项目与会话状态，而不打开终端或另开工具，dsh-hud 提供的是轻量只读 HUD，安装成本低、与 DSH「一切皆插件」的生态一致。

• 目录页：https://www.skillhub.cn/plugins/a903067276-rgb/dsh-hud
• GitHub：https://github.com/a903067276-rgb/dsh-hud