运行态状态栏 zexuanw958-svg/dsh-hud

◉ dsh-hud

DeepSeek Harness · Agent Runtime HUD

把 Codex / Claude Code 里「Agent 还在做什么、还剩多少上下文」这类运行态可见性，带到 DeepSeek Harness。

模型路由 · 上下文压力 · Token 用量 · 模型/工具耗时 · 后台任务与子 Agent，一直留在会话顶栏。

🎬 更多 AI 工具实战玩法：作者抖音 @泽轩604

这是什么 · 对标 · 功能 · 安装 · 原理 · FAQ · English

🔭 这是什么

dsh-hud 是一个面向 DeepSeek Harness Web UI 的只读 Agent 运行态观测插件。

它解决的不是「怎么让 Agent 更聪明」，而是长任务里那个更朴素、也更折磨人的问题：它还在跑吗？用了哪个模型？上下文快满了吗？时间花在模型还是工具上？后台到底还有几个任务？

紧凑状态条常驻会话标题栏，显示运行状态、模型、上下文压力和累计步数；点击后展开 Token、耗时、Jobs、子 Agent、Provider、Workspace 与 Session ID。数据直接来自 Harness 已有的 snapshot / projection，无需轮询、不额外调用模型，也不占用提示词上下文。

目标很简单：不用离开当前会话，就知道 Agent 做到哪了、消耗了什么、还能跑多久。

🎯 它对标什么

最接近的一组参照，是 Claude Code 的 /statusline、/context 与 /usage，再加上 /tasks / /agents 对后台工作的可见性；Codex 侧借鉴的是长任务与多 Agent 协同时「不用离开当前任务就能掌握运行状态」的产品思路。

| 你想知道什么 | Codex / Claude Code 中的参照 | dsh-hud 当前实现 |
| Agent 还在运行吗？ | 长任务状态、Claude Code /tasks | 运行 / 空闲状态点，活动 Jobs 数量 |
| 当前走哪个模型？ | 活动模型显示、Claude Code status line | 最近一次 Assistant 请求的 Model + Provider |
| 上下文还剩多少？ | Claude Code /context、context progress bar | Projected context pressure、已用 Token / 窗口大小 |
| 这轮消耗了什么？ | Claude Code /usage / /cost | 含缓存读写的输入 Token、输出 Token；模型耗时与工具耗时 |
| 任务推进到哪里？ | Steps、后台任务、subagents / multi-agent | Turns / Steps、Jobs、子 Agent 数量 |
| 我现在在哪个会话？ | status line 的 cwd / session metadata | Workspace 名称与 Session ID |

dsh-hud 不是 1:1 复刻，也不是控制台：它不会切换模型、停止任务或估算美元费用。它专注做一件事——以 Harness 原生 UI 的方式，把当前会话已经存在的运行数据持续露出来。

✨ 功能

| | 能力 |
| 🟢 | 运行状态：Agent 运行时显示动态状态点，空闲时自动归静 |
| 🤖 | 模型路由：展示最近一次 Assistant 调用使用的模型与 Provider |
| 🧠 | 上下文压力：显示占用百分比、已用 Token 与上下文窗口，并用进度条直观呈现 |
| 🔢 | Token 统计：汇总未缓存输入、缓存读写与输出 Token |
| 🧭 | 会话进度：实时显示 Turns、Steps、模型耗时和工具耗时 |
| 🧵 | 并行任务：展示正在运行的 Jobs 与当前子 Agent 数量 |
| 📍 | 会话定位：快速查看 Workspace 与 Session ID |
| 🎨 | 原生观感：复用 Harness 主题变量，支持明暗主题、窄屏与减少动态效果偏好 |
| ♿ | 键盘可用：支持焦点状态、Esc 关闭详情面板与完整 ARIA 描述 |
| 🪶 | 轻量无轮询：直接消费 Harness snapshot 与 projection，不额外请求 Host |

🚀 安装

环境要求

- DeepSeek Harness 0.1.0-rc.6
- Node.js 22.19+ 或 24+
- pnpm 11.x

一行安装（推荐）

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add github:zexuanw958-svg/dsh-hud

从源码安装

git clone https://github.com/zexuanw958-svg/dsh-hud.git
cd dsh-hud
pnpm install
pnpm build

安装到 DeepSeek Harness 的 Web profile
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add "$(pwd)"

然后重启 Web UI：

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web

打开任意会话后，HUD 会出现在会话标题栏。点击它即可展开详情。

插件通过本地 link: 安装。移动或删除仓库目录会让链接失效；需要卸载时运行 npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web remove dsh-hud。

🏗️ 工作原理

flowchart LR
A["Harness session snapshot"] --> D["dsh-hud"]
R["request/context route projection"] --> D
B["contextPressure / tokenUsage"] --> D
C["sessionStats / jobs / subagents"] --> D
D --> E["Compact header status"]
D --> F["Expandable detail panel"]

插件使用官方 conversation.session.header.actions slot 注入一个自包含的 React 组件：

- Host 侧只把已有的 request/context 事件折叠成只读模型路由 projection，不拦截或改写 Agent 流程；
- Client 侧订阅 Harness 已有的 session snapshot 与 projections；
- 数据变化由 Harness 推送触发渲染，没有定时轮询；
- HUD 数据只用于 UI，不会被塞进提示词或占用模型上下文。

📁 项目结构

dsh-hud/
├── src/
│ ├── index.ts # Host 插件入口 │ ├── projection.ts # Provider / Model 路由 projection │ └── client/ │ ├── index.tsx # Header slot 与 HUD 组件 │ ├── format.ts # Token、耗时与模型路由格式化 │ └── styles.ts # Harness 主题适配样式 ├── tests/ # 单元测试与构建产物契约测试 ├── cordis.patch.yml # DSH bundle patch ├── tsdown.config.ts # Host / Client 双入口构建 └── package.json

🧪 开发与测试

pnpm install
pnpm check

pnpm check 会依次执行严格类型检查、Host/Client 构建和 Vitest 测试。

🧩 兼容性

| dsh-hud | DeepSeek Harness | 状态 |
| 0.1.x | 0.1.0-rc.6 | ✅ 已验证 |

DeepSeek Harness 目前仍处于 RC 阶段，官方 slot 或 projection API 变化时，本插件也可能需要跟随升级。

❓ 常见问题

为什么打开首页看不到 HUD？

HUD 属于会话标题栏。先打开或创建一个会话，它才会出现。

会拖慢 Agent 或额外消耗 Token 吗？

不会。插件只消费 Harness 已经维护的前端状态，没有额外模型调用，也不会把统计信息写入模型上下文。

为什么上下文或模型一开始显示为空？

新会话尚未发生模型调用时，还没有可统计的数据。发送第一条消息后会自动更新。

支持桌面端或其他 profile 吗？

当前版本针对 Web profile 构建和验证；其他平台尚未承诺兼容性。

🗺️ Roadmap

- 可配置的 HUD segments 与显示顺序
- Git branch / dirty state / CI 状态数据源
- 上下文压力阈值与视觉告警
- 主题包与第三方 segment provider 协议

📄 许可证

MIT —— 可自由使用、修改和分发。欢迎 Issue 与 PR。

🌐 English

dsh-hud is a read-only Agent runtime observability plugin for the DeepSeek Harness Web UI.
你可以把它看作 DeepSeek Harness 原生的对应实现，对标 Claude Code 的状态栏、上下文与用量视图，以及后台任务可见性——目标同样是让长时间运行、多智能体的 Codex 工作流一眼看清状态。它回答长跑过程中真正要紧的运维问题：智能体还在活动吗，当前走的是哪条模型路由，上下文还剩多少，时间和 token 花在哪了，任务或子代理是否还在跑。

它在官方会话头部槽位里加了一条原生观感的状态条。紧凑视图显示当前模型、智能体状态、上下文压力和步数；点开可看 token 用量、模型/工具耗时、任务、子代理、服务商、工作区和会话详情。它直接消费 Harness 已有的快照与投影——不轮询、不额外调用模型、不占用提示词上下文。

亮点

- 原生集成 conversation.session.header.actions
- 实时上下文压力与 token 统计
- 轮次、步数、模型耗时与工具耗时
- 活动任务与子代理数量
- Harness 主题 token、响应式布局、可访问的键盘操作
- 不轮询、不额外请求 Host、零模型上下文开销

安装

npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add github:zexuanw958-svg/dsh-hud
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web

开发时也可以从本地检出安装：

git clone https://github.com/zexuanw958-svg/dsh-hud.git
cd dsh-hud
pnpm install
pnpm build
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add "$(pwd)"
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 web

打开会话，在头部找 HUD。运行 pnpm check 可对项目做类型检查、构建和测试。

许可证

MIT。欢迎提 issue 和 pull request。