DeepSeek Harness (DSH) 的 Web profile 提供了模块化扩展能力。在使用过程中，开发者需要频繁确认 DeepSeek 官方账户余额与 OpenCode Go 套餐的剩余情况。dsh-sidebar-balance 插件将这两个核心数据直接嵌入侧边栏底部，与「设置」同排，不改变原有布局，只做极简的数字展示。
安装¶
在终端中执行以下命令安装插件。该插件支持通过 GitHub、本地路径或 npm 安装，无需额外构建授权。
dsh plugin --profile web add github:zhouchengke2046/dsh-sidebar-balance
安装后，请确保已安装并启动支持 Web profile 的 DSH 客户端。
核心功能¶
该插件主要包含以下能力：
- 极简单行展示：以纯文字形式融入侧边栏底部，与设置按钮同排，不新增入口，不改变页面布局。
- 双余额集成：常驻显示 DeepSeek 官方余额，右侧附带 OpenCode Go 套餐消耗进度圆环。
- 原生适配：完全消费 DSH 设计令牌，自动适配深浅色主题。
- 安全设计：API Key 仅在宿主进程内解析，浏览器端仅接收数字结果，避免 Key 泄露。
- 自动刷新：余额与圆环每 60 秒自动刷新，点击金额可立即刷新，失败时保留旧值并降级。
使用方法¶
- 常驻行交互：侧边栏底部的常驻行中，左侧为设置按钮（点击打开设置面板），右侧为余额金额与 Go 消耗圆环。点击金额仅刷新数据，不会误触设置面板。
- 悬浮卡片：鼠标移动到金额上，会弹出磨砂玻璃效果的悬浮卡片，显示 DeepSeek 余额明细（总金额、充值、赠送）以及 OpenCode Go 三窗口（滚动 5h、周、月）的余量与进度。
- 折叠适配：当侧边栏折叠时，常驻行仅保留设置图标，悬浮卡片功能依然可用。
配置与依赖¶
使用该插件需要满足以下环境要求：
- DeepSeek Harness 版本 0.1.0-rc.6+ (Web profile)
- Node.js ≥ 18
插件依赖宿主环境中的两个环境变量来获取数据：
DEEPSEEK_API_KEY：用于查询 DeepSeek 官方账户余额。OPENCODE_GO_API_KEY：用于查询 OpenCode Go 套餐使用情况。
原理与说明¶
- 零构建：插件为纯 JavaScript 手写 bundle，无需 Node.js 构建步骤。
- 重启功能：侧边栏中的刷新按钮仅刷新余额数据，不包含重启功能。重启功能由独立的
dsh-restart插件负责。 - 加载机制：浏览器端通过 Host 路由自托管，配合
tapIndex注入方式加载，非client-modules扫描路径，确保在任意安装位置均可正常工作。
信息来源¶
- 插件目录：https://www.skillhub.cn/plugins/zhouchengke2046/dsh-sidebar-balance
- 源码仓库：https://github.com/zhouchengke2046/dsh-sidebar-balance
