DeepSeek Harness 插件：侧边栏实时余额 + 每轮对话花费

前言¶

DeepSeek Harness (DSH) 采用模块化设计，鼓励通过插件扩展功能。在开发或调试过程中，实时掌握账户余额与单次对话的成本非常重要。dsh-deepseek-usage 插件旨在解决这一问题，它直接在 DeepSeek Harness 的侧边栏和对话底部展示相关数据。

插件简介¶

名称：@blackthunder2191026/dsh-deepseek-usage

维护者：BlackThunder2191026

定位：侧边栏实时余额显示 + 每轮对话花费（人民币，含 token 明细）。

核心功能：
* 侧边栏余额：在左下角显示 DeepSeek 账户余额，默认每 60 秒刷新一次。点击可展开充值余额 / 赠送余额并手动刷新；侧栏收窄成图标栏时显示为彩色状态点。
* 每轮对话花费：在每一轮对话底部的信息栏里额外显示这一轮花费的人民币金额，点击可展开三列明细（项目 / tokens / 单价）。

安装¶

插件已发布至 npm，包名为 @blackthunder2191026/dsh-deepseek-usage。

方式一：命令行安装（推荐）¶

npx @deepseek-ai/dsh plugin --profile desktop add @blackthunder2191026/dsh-deepseek-usage

安装完成后需重启 dsh 进程。

方式二：图形市场安装¶

在市场的搜索框查找 dsh-deepseek-usage。

方式三：从 GitHub 源码安装¶

npx @deepseek-ai/dsh plugin --profile desktop add github:BlackThunder2191026/dsh-deepseek-usage

注意：若使用 pnpm，可能需要在 pnpm-workspace.yaml 中配置 allowBuilds，因为插件包含 prepare 钩子（仅做文件完整性检查）。

⚠️ 升级注意事项¶

如果之前安装的是不带 scope 的旧包 dsh-deepseek-usage，安装新包后会出现两套余额栏。升级前需先移除旧包：

npx @deepseek-ai/dsh plugin --profile desktop remove dsh-deepseek-usage
npx @deepseek-ai/dsh plugin --profile desktop add @blackthunder2191026/dsh-deepseek-usage

配置与计费¶

配置项¶

配置文件位于 profile 的 cordis.patch.yml，行 id 为 deepseek-usage。需整段替换而非深合并。

- id: deepseek-usage
  name: dsh-deepseek-usage
  config:
    apiKeyEnv: DEEPSEEK_API_KEY
    currency: CNY
    balanceTtlMs: 30000
    defaultModel: deepseek-flash
    maxTurns: 300
    models:
      deepseek-flash:
        hit: { peak: 0.04, offPeak: 0.02 }
        miss: { peak: 2, offPeak: 1 }
        output: { peak: 8, offPeak: 4 }
      deepseek-v4-pro:
        hit: { peak: 0.3, offPeak: 0.15 }
        miss: { peak: 9, offPeak: 4.5 }
        output: { peak: 27, offPeak: 13.5 }

计费逻辑¶

计价依据：来自官方 DeepSeek 中文定价页，单位为元/百万 tokens。
计算公式：

    花费(CNY) = 未命中输入 × miss价 + (缓存命中输入 + 缓存写入) × hit价 + 输出 × output价

高峰/低谷：周一至周五 09:00-12:00 与 14:00-18:00 为高峰，其余时段为低谷，高峰费率是低谷的两倍。
生效范围：只有已结束的轮次才会计价。

注意事项与环境要求¶

环境要求：
- dsh：必须使用带 Web 界面的 profile（desktop 或 web），headless 或 SDK profile 无效。
- Node.js：宿主版本需 >= 22.19。
- 凭据：需要官方 DeepSeek provider 的 DEEPSEEK_API_KEY（环境变量或 ~/.dsh/.credentials.yaml）。
平台支持：不含平台相关代码，支持 Windows / macOS / Linux。
运行时依赖：零运行时依赖，host 半不 import 任何包，client 半只依赖 dsh 的 react。
调试：
- Host 半代码变动需重启 dsh。
- Client 半代码变动需刷新页面（Ctrl+F5）。

常见问题¶

出现两套余额栏：旧版 dsh-deepseek-usage 与新版 @blackthunder2191026/dsh-deepseek-usage 同时安装。请按上述升级步骤操作。
侧边栏没有余额行：检查 profile 是否带 Web 界面；或查看 curl "http://127.0.0.1:<端口>/deepseek-usage/summary?debug=1" 的响应。
余额显示不可用：未配置 DEEPSEEK_API_KEY 或未使用官方 DeepSeek provider。
安装失败提示只能安装 npm 包：某些客户端只接受 包名@精确版本，请使用方式一或方式四。

结语¶

该插件提供了 DeepSeek Harness 开发者所需的成本监控能力，直接在官方客户端界面展示余额与明细。更多细节与源码可参考项目主页。