前言¶
DeepSeek Harness（DSH）Web Client 是一个基于插件架构的客户端。在进行长对话、批量测试或监控资源消耗时，开发者需要实时掌握当前会话的上下文窗口占用率以及账户余额。@achasoft/dsh-usage-info 插件通过在会话头部提供一个按钮，将上下文可视化与账户余额读取集成在 Web 界面中，解决了手动查询和估算成本的问题。
这是什么¶
这是一个为 DeepSeek Harness Web Client 设计的插件，用于显示上下文占用率和账户余额。它包含一个会话头部的读出按钮、一个余额读取能力接口（Seam），以及一个 DeepSeek 提供商。该插件由 navid-kianfar 维护，遵循 MIT 许可证。
核心功能¶
插件主要提供以下功能：
- 头部读出：在会话头部的工具栏中显示一个按钮。该按钮会显示上下文占用率的环形图，以及账户余额的首个货币单位。在数据未加载前显示仪表盘图标；无法读取余额时显示琥珀色圆点；余额低于或等于阈值时按钮变红。
- 上下文可视化：显示上下文百分比、已用/窗口令牌数（
~used / window），并通过彩色条形图展示系统提示词、工具定义和对话部分的占比（估算值）。 - 会话成本计算：根据配置费率计算会话成本，包含总令牌数，以及按桶分类的成本（未缓存输入、缓存写入、缓存读取、输出）。在首次计费前，令牌数显示为“—”。
- 余额读取：支持通过宿主机 API 密钥读取 DeepSeek 提供商的余额，无需将密钥暴露给浏览器。
- 设置卡片：在插件配置中提供开关，控制各部分显示、刷新间隔（秒）、低余额阈值、成本货币和费率。
安装与启用¶
安装该插件到 web 配置文件（dsh web 启动的配置）：
dsh plugin --profile web add @achasoft/dsh-usage-info
安装完成后，重启 dsh web 即可加载插件。
典型用法¶
- 启用余额读取：在
dsh web中启用内置的 DeepSeek 提供商，这是读取余额的前提。 - 查看面板：点击会话头部的按钮打开使用情况面板，查看上下文和成本。点击面板外部或按
Escape键关闭。 - 配置设置：进入 Settings > Plugins > Plugin configuration，展开 Usage information。在此处调整刷新间隔、低余额阈值或费率。
适用场景与注意¶
- 版本要求：必须使用 DeepSeek Harness Web Client 版本
0.1.5-rc.2。 - 运行环境：需要 Node.js 版本
^22.19或>=24，且 PATH 中需包含pnpm。 - 余额读取限制：余额读取功能依赖宿主机端的 API 密钥。OpenAI 兼容网关通常不提供余额端点（返回 404），此时插件会停止轮询。同一时间只能挂载一个提供者。
- 自动保存：设置卡片没有保存按钮，任何开关或文本字段在输入有效值后即自动保存；刷新间隔在失焦或回车时保存。
- 源码审查：安装前应检查源码与许可证，因为插件以当前 DSH 进程的权限运行。
短结尾¶
该插件为 DeepSeek Harness Web Client 提供了直观的上下文监控与成本追踪能力。通过宿主机读取余额的设计，确保了 API 密钥的安全性。更多细节与源码请访问 GitHub 仓库。
