dsh-hud

English | 简体中文

DeepSeek Harness（dsh）web 的 HUD 状态面板插件。 输入框工具行一键按钮，右侧浮层面板展示：

• Git —— 分支、ahead/behind、未暂存 / 已暂存 / 未跟踪文件（分组可折叠）、每文件 +N/-N 摘要、点击文件展开 diff 全文、最近 5 条提交
• MCP —— 已挂载的 MCP 服务器（从 mcp____ 工具名推导）
• Skills —— 当前 agent 可用的技能列表
• 官方信息聚合 —— 当前模型 + reasoning effort、plan 状态、token 用量（输入 / 输出 / 缓存命中率）、会话统计（轮数、步数、LLM 与工具耗时、解码 tok/s、上下文占用 %）

按钮还带未提交文件数角标，不打开面板也能一眼看出项目有没有待提交改动。

平台支持

平台	状态
macOS	✅ 开发环境，全功能实测
Windows / Linux	⚠️ 未实测；架构上预期可用，见 docs/install.md

环境要求

• DSH web（npx @deepseek-ai/dsh web 启动）
• PATH 里有 git 命令行
• 不需要额外装 shell：DSH 的 shell 服务在所有平台上都以 bash -c 执行（Windows 为 Git Bash），DSH 能跑，本插件就跟着能跑

安装

本仓库是官方 bundle 插件格式（根 package.json 的 dsh.bundle + dsh.client）， 经官方 profile 管理一行安装：

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

装完重启 dsh web（bundle 层在启动时合成，热更新无效）。

需要 pnpm（dsh plugin 是 pnpm 转发器）：未安装用 npm i -g pnpm，主版本需与 profile 现有 store 一致。没有 dsh plugin 命令的环境可用手动兜底 （~/.dsh/cordis.patch.yml 里文件路径 + 包名双 entry 挂载），见 docs/install.md。bundle 安装与手动挂载二选一，不要同时用。

使用

点输入框工具行的 按钮。面板贴右侧展开（默认 240px），拖左边缘把手调整宽度 （200–480px，localStorage 记忆）。带计数徽标的小节标题可点击折叠/展开。数据每 30 秒 自动刷新（面板关闭时只轮询轻量的 git 角标数据）。