DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在开发或使用 DSH Web GUI 进行智能体开发时，实时了解当天的 Token 消耗成本与缓存命中率（Cache Hit Rate）能显著提升调试效率。dsh-cost-widget 插件提供了这一能力，将关键指标集成到 Web 界面中。
插件定位¶
这是一个 DSH Web GUI 客户端插件，由 zhangshaobo608 维护。它解决的问题是：在不离开 Web 界面的情况下，查看 DeepSeek 开放平台账号当天 V4-Flash / V4-Pro 的每百万 token 平均费用及缓存命中率。
核心功能¶
- 悬浮浮窗：提供可拖拽的悬浮浮窗，包含紧凑悬浮条与完整面板两种形态。
- 成本计算：展示当天 V4-Flash / V4-Pro 每百万 token 的平均费用（= 当天成本 ÷ 当天 token 数 × 100 万）。
- 指标概览：展示缓存命中率（含进度条）、今日消耗、请求数、今日总成本、总命中率、余额。
- 时段标识：北京时间 9:00–12:00、14:00–18:00 为峰时，其余为闲时。
- 自动刷新：每 5 分钟自动刷新，支持手动刷新。
- 位置记忆：面板位置保存在
localStorage中。
安装与启用¶
前置条件：需要 DSH web profile（@deepseek-ai/dsh >= 0.1.0-rc.6）。
执行以下命令添加插件：
dsh plugin --profile web add "github:zhangshaobo608/dsh-cost-widget"
重启 dsh web 后，浏览器硬刷新（Cmd+Shift+R），面板会挂载在 Web GUI 侧栏底部动作区（sidebar.footer.action 插槽）。
配置凭证（一次性）¶
插件通过 harness 凭证管道读取平台会话 token。在 ~/.dsh/.credentials.yaml 中添加：
DEEPSEEK_PLATFORM_TOKEN: <userToken>
获取 userToken 的方法：在 Chrome 登录 platform.deepseek.com 后，F12 Console 执行以下命令，token 会自动复制到剪贴板：
copy(JSON.parse(localStorage.getItem('userToken')).value)
复制输出的长串（以 eyJ 开头）并粘贴到配置文件中。
数据来源与安全¶
- 数据来源：数据来自
platform.deepseek.com的内部 API（/api/v0/usage/by_api_key/{amount,cost}和/users/get_user_summary），与官方用量页共用同一 JSON 接口，非爬网页。 - 接口安全：插件只在本机注册一个只读回环接口
GET /api/dsh-cost/today，非本机调用直接 403。 - 凭证限制：公开 API key（
api.deepseek.com）只有/user/balance，没有用量统计，因此用量统计必须使用平台会话 token。
典型用法¶
- 重启
dsh web，浏览器硬刷新。 - 在右下角或侧栏动作区找到默认形态的紧凑悬浮条（
DeepSeek ¥x · 命中率 · 峰/闲）。 - 点击悬浮条展开完整面板，查看详细数据。
- 按住标题栏可拖动面板到任意位置。
注意事项¶
- 插件只在本机运行，位置记忆在
localStorage中。 - 公开 API key 无用量统计，必须配置平台会话 token 才能获取数据。
- 安装前建议检查源码与许可证。
总结¶
该插件为 DSH 用户提供了轻量级的成本与缓存监控方案。社区目录与 GitHub 仓库链接如下：
