← 返回列表
未验证
在侧边栏实时显示会话血量、资源余量与工作时长
尚未跑自动兼容性验证,可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/16 · 已提供中文文档
DeepSeek Harness 的游戏风格 HP / MP / TIME HUD。
综合分
27.6
GitHub 分
27.6
用户评分
—
★ Stars
1
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add yuanliangxiannan/dsh-hud该插件未发布到 npm,走 GitHub 源安装(pnpm 若拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑)
数据截至 2026/9/16(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-agent@deepseek-ai/dsh-client-connection@deepseek-ai/dsh-client-locale@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-primitives@deepseek-ai/dsh-client-ui-sidebar@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-compaction@deepseek-ai/dsh-credentials@deepseek-ai/dsh-host-apiproxy@deepseek-ai/dsh-llm-deepseek用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
dsh-hud 给 DeepSeek Harness 加一套游戏式 HP / MP / TIME 状态 HUD。 HP · 当前会话还能聊多少 MP · 当前 Provider 还能用多少 TIME · 当前工作区已经干了多久 直接嵌入 Harness 侧边栏,无需额外 Dashboard。 English 效果预览 dsh-hud-hero dsh-hud 直接运行在 DeepSeek Harness 侧边栏中。 安装 BigFish 用户 从 Releases 下载 dsh-hud-0.1.0.tgz,然后: dsh plugin --profile web add ./dsh-hud-0.1.0.tgz dsh plugin 会自动把 dsh-hud 加入 dsh.profile.bundles。完全退出并重启 BigFish 后生效。 原生 DeepSeek Harness 用户 dsh plugin add ./dsh-hud-0.1.0.tgz 从源码构建 npm install npm run build npm pack # 产出 dsh-hud-0.1.0.tgz HP · MP · TIME dsh-hud-status - HP — 当前 Session 剩余上下文容量,快见底时可以考虑 /compact - MP — 当前 Provider 剩余资源 - TIME — 当前 Workspace 跨 Session 累计的 Agent 工作时间 HP 看上下文,MP 看资源,TIME 看工作区累计时间。 Provider-aware MP dsh-hud-provider MP 会跟随当前实际使用的 Provider,而不是简单根据模型名称判断。 当前支持: DeepSeek Official → API Balance OpenCode Go → 5H / Weekly / Monthly quota OpenCode Go 的 HUD 主值使用当前最紧张的 quota window。 OpenCode Go 的 5H / Weekly / Monthly 配额详情。 56px Rail dsh-hud-rail Harness 侧边栏收窄后,HP / MP / TIME 会自动切换成 Mini HUD,不占用额外空间。 56px Rail 下仍然保留 HP / MP / TIME 状态。 详细功能 三个仪表 - HP — 数据来自 Harness 的 contextPressure projection(projectedTokens / contextWindow),HP% = clamp(100 × (1 − projectedTokens / contextWindow));颜色随容量分级:绿 → 黄绿 → 金 → 橙 → 红。 - MP — 判断依据是 Provider 路由(provider route),绝不是 model 名——同一个 model 名在不同 Provider 下会显示不同的资源。 - TIME — 以 turn/start → turn/end 为区间,对所有 session 做 interval union 去重(重叠区间不重复计数);进行中的 turn 计到当前时刻。 Provider-aware MP 细节 | Provider | 资源 | 数据源 | | --- | --- | --- | | DeepSeek Official(deepseek-official) | 账户余额(¥) | GET /user/balance | | OpenCode Go(opencode-go) | 5H / Weekly / Monthly quota | GET /zen/go/v1/usage | | 其它 | --(NO QUOTA DATA) | 无适配器 | - DeepSeek Official:MP 显示账户总余额(如 ¥10.73),进度条相对 mpMaxBalance(默认 50 CNY,超过则满格并显示真实金额)。 - OpenCode Go:每个窗口 remaining = clamp(100 − usagePercent);主 MP 值取 bottleneck:min(rolling, weekly, monthly),即最先可能耗尽的资源;主进度条同样使用 bottleneck。 HUD 折叠 / 展开 宽侧边栏的完整 HUD 可手动折叠成单个图标按钮(约 34px),再次点击恢复。 - 偏好保存在 localStorage,key 为 dsh-hud:collapsed。 - 默认展开;收起后刷新/重启仍保持;切换 Session / Workspace 不改变该偏好。 配置 可选 hud: 配置段,写入 $DSH_HOME/settings.yaml(有 schema 注册,缺省使用安全默认值): hud: mpMaxBalance: 50 # 余额折算为满格 MP 条的金额(CNY) balanceRefreshMinutes: 5 # Host 侧资源刷新间隔(分钟) 架构 标准 Host + Client 插件,无动态(creative-mode)机制,无 Harness 发行版补丁,无 node_modules 手术。 - Host(src/host/)— 插件入口 lib/host/index.js: - workspace 身份解析(session cwd → workspaceRegistry), - TIME 聚合(FIFO turn 配对 + interval union,5s TTL 缓存 + turn 边界失效), - 感知 provider 的资源适配器(deepseek-official 余额 + opencode-go 官方 usage endpoint),凭证在进程内通过 ctx.credentials 解析,绝不跨 RPC 传输, - 私有 JSON-RPC 通道 /dsh-hud(官方 Connection seam), - 可选 settings 配置(namespace hud)。 - Client(src/client/)— bundle lib/client.js: - 注册进 sidebar.footer.action(wide 行 + 56px rail 两种模式), - HP 来自框架 contextPressure projection mirror,跟随 session 切换并即时重绘, - MP/TIME 通过私有 RPC 通道;进行中的 turn 在本地 tick, - 可点击 popover 查看详情、手动刷新,以及官方 COMPACT 动作(ctx.compaction.compactNow)。 所有共享 wire 词汇在 src/shared/types.ts——纯 JSON,天然无密钥。 Build npm install npm run build # tsc (strict) host + esbuild client bundle → lib/ npm run typecheck # 仅 strict 类型检查 node scripts/verify-host.mjs # host 逻辑验证(真实历史测试可选,见下) 构建会从已安装的 BigFish 发行版解析 @deepseek-ai/ 类型声明;可用 DSH_TYPES_ROOT 覆盖位置。 verify-host.mjs 的真实历史聚合测试是可选的:设置 DSH_HOME(默认 ~/.dsh)与 DSH_HUD_VERIFY_WORKSPACE(要验证的 workspace 绝对路径)后才会执行;未设置时跳过该段,纯逻辑测试始终运行。 Compatibility - DeepSeek Harness / BigFish:@deepseek-ai/ 0.1.0-rc.6(见 package.json peerDependencies) - Node.js:≥ 20(构建使用 Node 22 验证) - 平台:Web profile(浏览器) Security Provider 的凭证只在 Harness Host 进程内通过 ctx.credentials.resolve() 解析: - 凭证以“环境变量名 / credential 引用”的形式出现,例如 DEEPSEEK_API_KEY、OPENCODE_GO_API_KEY;源码中绝无真实 Key / Token。 - 解析后的密钥值绝不进入: - Client bundle - RPC DTO - localStorage - README - 日志 - OpenCode Go 的凭证引用由 llm-pi-ai 配置的 apiKeyEnv 决定,dsh-hud 只复用该 Provider 已有的凭证,不要求重复填写。 Known Limitations - v0.1.0 仅内置两个资源适配器:DeepSeek Official 与 OpenCode Go;选择其它 Provider(GLM、OpenRouter、自定义 Provider 等)时 MP 显示 --。 - Rail 模式不显示数字,仅 mini 竖条 + tooltip。 - 无 EXP / 等级 / 成就 / 统计图 / 历史记录等扩展功能。 - HUD 折叠为纯手动操作,不做基于 Workspace 数量或 overflow 的自动判断。 License MIT
扫码进群