dsh-awesome-hud

🧭 使用说明

• HUD 面板：悬浮于聊天页右上角，宽度 300px，高度上限为输入框底部（留 8px 底距），内容超出时面板内部滚动（滚动条仅在滚动时显示，停止 2s 后渐隐）；聊天内容与输入框随面板展开自动向左让位，不会重叠。
• 设置菜单：「会话」模块右上角齿轮打开菜单，可勾选展示「上下文窗口 / 用量 / git / 子代理任务 / 任务 / MCP」模块（用量仅在其可用时列出），底部「取消 / 确认」按钮丢弃或保存勾选；「会话」模块恒展示。用量可用时，菜单内额外提供「用量模块内容」分组，可分别开关 DeepSeek 余额与 OpenCode Go 用量两行组的展示。
• 上下文窗口：进度条颜色随占用率自动切换；「压缩」在会话空闲时可用，运行中按钮禁用并提示原因。
• 用量模块：位于「上下文窗口」模块下方。数据复用 dsh-account-usage 插件路由（host 侧各有 30s/60s 缓存），面板打开时立即加载、之后每 60 秒轮询；四行数据均缩进展示，行首分别带 DeepSeek / OpenCode Go 图标；模块支持折叠，默认展开（折叠状态经 localStorage 持久化）。
  • DeepSeek 余额：展示余额合计（充值 + 赠送），「跳转」按钮弹出选择菜单，可跳转 deepseek 开放平台或 opencode go 用量页；点击具体余额数值可直接打开设置面板「账户」分区的 deepseek 标签页；仅当已配置 DEEPSEEK_PLATFORM_TOKEN 时展示该行。
  • OpenCode Go 用量：三行分别展示 oc-go 5h / 1w / 1m 窗口用量百分比，点击具体百分比数值可直接打开设置面板「账户」分区的 opencode go 标签页；仅当已配置 OpenCode Go Key 且订阅有效（/api/account-usage/opencode 返回 ok + keySource）时展示。
  • 模块可见性与可配置内容：DeepSeek 与 OpenCode Go 各自独立——仅 DeepSeek 可用只显示余额行，仅 OpenCode 订阅中只显示用量三行，二者均未配置时模块与设置项整体隐藏；展示内容可在「用量模块内容」分组中单独开关（host settings 持久化，随 profile 同步）。
• git 模块：每 5 秒随面板打开自动刷新；「git graph」弹窗展示当前仓库（全部引用）最近 80 条提交图；HEAD 指向版本以放大的白色填充圆点 + 蓝色描边标记；变更文件列表面板内展示（状态字母按类型着色——修改 M 黄色、新增 A 蓝色、删除 D 红色、未跟踪 ? 灰色，重命名 R / 复制 C 蓝色）。
• 子代理任务模块：按层级缩进展示全部后代子代理；执行中状态徽章为黄色，已完成为绿色；点击条目跳转对应子代理会话页。
• MCP 模块：开关控制 dsh 全局的 MCP 服务启停；切换后页面自动刷新生效；模块默认展开，无任何 MCP 服务时仍展示空状态。
• 折叠状态：各模块折叠/展开状态刷新页面后保持（localStorage）；「会话」模块图标使用 DSH favicon。
• 新开会话页：新建/空白会话（无会话记录）页面默认不展示 HUD；进入真实会话后自动恢复之前状态（不覆盖用户记忆）。