DeepSeek Harness 计费插件

English | 中文

一个 DeepSeek Harness 插件，在 Web 会话头部直接显示你的 DeepSeek 账户余额、当前会话（本轮对话）的花费，以及今日所有会话的共花费；每条已完成的回合还会在消息操作行行尾以静态金额显示本轮花费，详情面板底部带今日各会话花费排行。

余额是 GET /user/balance 的真实数字；会话花费、本轮花费与今日共花费是按官方峰/谷单价对每条消息的计费 token 逐条计价的结果，不是计费承诺。

显示什么

• 会话头部徽标 —— 两行：剩余余额（剩余额度：¥X）＋ 本轮对话的计费花费（本轮对话花费：¥X）。
• 详情面板 —— 剩余金额、本会话花费（本会话花费）与其右侧的今日所有会话共花费（今日共花费），以及每个模型一行的花费分项（缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z），外加手动刷新按钮与花费说明；面板底部是今日会话花费排行：按今日花费从高到低排列的会话列表（会话名取日志中的中文标题，重命名后自动同步；最多显示前 10 条，其余以「…还有 N 个会话」提示）。
• 本轮花费金额 —— 每条已完成回合的收尾消息操作行行尾（时钟之后）显示纯静态的 ¥X：不可点击、无图标、无「花费」字样、不弹卡片，字体样式逐项复刻时钟文本（13px 次级字号、tertiary 色、nowrap），并且始终显示（不随悬停隐藏，与时钟文本一致——整行的悬停显隐规则让两者同进退）；回合没有 DeepSeek 用量（花费为 0）或加载失败时不显示。
• 失败与空态 —— 会话或今日没有可计价消耗时显示「暂无消耗记录」而不是编造数字；未配置 key、凭据被拒或传输错误时显示弱化的「额度不可用」，其提示携带 Remote 自己的错误信息。

数据更新机制

• 会话花费自动跟随 —— 当前会话每到达一条新消息，徽标就只重算本会话的花费与今日共花费（纯本地计价，不发网络请求），连续对话时花费会实时跟着走。主机端按增量计价：会话日志未变化时直接命中主机端缓存，日志增长时只重算新增的尾部。
• 额度保持手动 —— 余额是账户级数据，只在挂载、切换会话、手动点刷新、或刷新浏览器时重新查询 /user/balance；没有轮询，不会自动跟随账户变化。
• 刷新期间旧值保留 —— 刷新失败保留上一次有效值，不会清空。

显示样式

真实会话中的会话头部徽标与详情面板（剩余金额、本会话花费与今日共花费、按模型分项、今日会话花费排行），以及消息操作行行尾的本轮花费金额：

详情面板特写 —— API 剩余金额、本会话花费 与 今日共花费、按模型分项（缓存命中 · 未命中输入 · 输出）与今日会话花费排行：

本轮花费金额特写 —— 操作行行尾（时钟之后）的静态 ¥ 金额：

包结构

| 包 | 侧 | 作用 | | --- | --- | --- | | packages/llm-billing —— @rayadesu/dsh-llm-billing | 主机端 | 负责 /user/balance 传输与峰/谷计价表。对外暴露 billing Remote（getBalance、getSessionSpend、getTodaySpend、getTodaySessionsSpend、getTurnSpend）。 | | packages/ui-billing —— @rayadesu/dsh-client-ui-billing | 浏览器端 | 自己挂载 billing Remote，并贡献会话头部徽标与详情面板、消息操作行行尾的静态本轮花费金额。 |

前置条件

• DeepSeek Harness（dsh）—— 插件运行在 dsh profile 内。
• 一个 DeepSeek API key —— 余额从 DeepSeek API 读取，所以每个用户都需要自己的 key。

安装

安装（已发布到 npm，一条命令）

三个包已发布到 npm 的 @rayadesu scope。一条命令同时安装 bundle 与两个插件包 （bundle 把两个插件包声明为 peer 依赖，而 profile 默认不自动安装 peer，所以要显式列出）。

用哪个 dsh 命令取决于你的 dsh 安装方式：

• 全局安装 —— 任意目录直接用全局 dsh：

  dsh plugin --profile web add @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @rayadesu/dsh-client-ui-billing

• 源码构建的 dsh（deepseek-harness 源码目录）—— CLI 只在源码目录里能解析， 所以要在这个目录里用 pnpm 跑（pnpm dsh 即源码内二进制，等价于全局 dsh）：

  cd deepseek-harness
  pnpm dsh plugin --profile web add @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @rayadesu/dsh-client-ui-billing

pnpm 11 发布龄门槛

dsh profile 通过 pnpm 安装插件，而 pnpm 11 的供应链发布龄门槛默认不会采纳发布不足 24 小时的包——刚发布的新版本不会立即被解析。想在发布后立刻拿到最新版：

• 在 profile 的 pnpm 配置里关掉发布龄门槛：

  # ~/.dsh/profiles/web/pnpm-workspace.yaml
  minimumReleaseAge: 0

• 或者在 24 小时窗口内用显式钉版本安装（显式钉版本可绕开门槛，把 0.3.0 换成你要的版本； 源码构建的 dsh 用 pnpm dsh …，同上）：

  dsh plugin --profile web add @rayadesu/[email protected] @rayadesu/[email protected] @rayadesu/[email protected]

手动补行（仅当不想用 bundle 时）：

# ~/.dsh/profiles/web/cordis.patch.yml
- insert:
    - id: llm-billing
      name: '@rayadesu/dsh-llm-billing'
    - id: ui-billing
      name: '@rayadesu/dsh-client-ui-billing'

常用命令

下面以全局 dsh 为例；源码构建的 dsh 用 pnpm dsh 并在 deepseek-harness 源码目录执行， 子命令完全一致。

dsh plugin --profile web list    # 列出 web profile 已安装的插件
dsh plugin --profile web add @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @rayadesu/dsh-client-ui-billing
dsh plugin --profile web remove @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @rayadesu/dsh-client-ui-billing
dsh plugin --profile web update  # 把插件更新到当前允许的最新版本
dsh plugin --profile web update --latest  # 忽略声明的版本区间，把所有插件升到最新发布版本

update 遵循 profile package.json 里的版本区间，只在该插件声明的 semver 范围内升级。 加上 --latest（pnpm update 的选项）则忽略这些区间，把所有插件直接升到最新发布的版本—— 用于在版本可解析后立刻拿到新发布。源码构建的 dsh 要在 deepseek-harness 目录里用 pnpm dsh … 执行，和其余命令一样。

依赖说明

两个插件包把它们依赖的 DeepSeek Harness 包（@deepseek-ai/cordis、 @deepseek-ai/dsh-credentials、@deepseek-ai/dsh-session 以及客户端运行时包） 声明为 peerDependencies（^0.1.2-alpha.5）。dsh profile 默认不自动安装 peer，所以 这些由 dsh 安装本身通过 profiles/node_modules 回退提供，而不是从 registry 拉取—— 无需额外安装，安装机也不需要 registry token。

插件按 0.1.2-alpha.5 发布线构建，同时兼容读取两代 DSH 运行时：live Session 日志面 （0.1.1-rc.2 及以前为 Session.events + header.seedLength，0.1.2-alpha.4 起为 snapshotEvents() + inheritedEventCount），以及持久化服务面（0.1.1-rc.2 及以前为 inspect/listSnapshots，0.1.2-alpha.5 的 handle 化改造后为 open+SessionHandle/list——即含该重构的 checkout master）。投影单元的 init 按新签名声明（带元数据参数），同时保持旧的无参调用方式可用。

浏览器半测通过 module-loader shim 跑已发布的 client bundle；由于 0.1.2-alpha.5 客户端栈把运行时从 dsh-client-runtime（已删除）拆进 dsh-client-store、 dsh-client-ui-session、dsh-client-ui-chat 与 renderer 持有的 SlotRegistry， 测试底座在回退 require 后会复查已注册的 bundle 导出，并用 resolve alias 固定 react 副本。assistant-actions slot 行从 ui-conversation 移到了 ui-chat， 插件客户端侧也引入了 ui-chat 的类型合并。

配置你的 DeepSeek API key

二选一：在网页「模型」页填入（会把 DEEPSEEK_API_KEY 写入 ~/.dsh/.credentials.yaml），或导出环境变量：

export DEEPSEEK_API_KEY=sk-...

重启

dsh web

开发

本仓库是独立的 pnpm workspace：两个插件包从 npm 解析 @deepseek-ai/* peer 包， 构建不需要完整的 DeepSeek Harness checkout。

环境要求：Node ^22.19 || >=24 与 pnpm。

pnpm install                 # 安装 workspace 与 npm 开发依赖
pnpm run build               # host 面（tsc + tsdown + typert 产物），再 client 面
pnpm run typecheck           # 两个编译面
pnpm run test                # vitest 单元/浏览器测试
pnpm run verify              # 发布前校验（prepublishOnly 也会自动运行）

host 面会从源码重新生成 lib/typert.host.js 与 lib/typert.remote-client.*， 包名取自各 package.json；client 面重建 lib/client.js。lib/ 是 git-ignored 的构建产物，不要手工修改。一旦 typert 清单里的 TYPERT.package 与 package.json 的 name 不一致，verify 会在发布前直接失败。

typert 生成器只认工作区内已注册协议包里的 Remote/TypertRemoteService 声明，所以 packages/typert-protocol 内嵌了 npm 上 @deepseek-ai/[email protected] 的 声明文件；dsh 依赖线升级时，从安装包重新刷新它。

发布（bundle 与两个插件包统一版本号；prepublishOnly 会自动跑 verify 门禁）。 要用 npm publish 且必须在各包目录内执行——pnpm publish 会失败（token 读取方式问题）， 而 npm publish packages/llm-billing 这种带路径参数的形式会被 npm 解析成 GitHub 仓库简写， 触发假的 git ls-remote 而不是发布。registry 要求 bypass-2FA 的 token（npm login 的会话 token 会 E403）。

一次性配置 token（之后命令里不再出现 token） —— 在 ~/.npmrc 里写一行并引用环境变量， npm 发布时从环境展开：

//registry.npmjs.org/:_authToken=${NPM_TOKEN}

然后设置环境变量并直接 npm publish —— token 不在任何命令行参数里，也不进 shell 历史：

export NPM_TOKEN=<你的 npm token>
cd packages/llm-billing && npm publish
cd packages/ui-billing && npm publish
npm publish   # @rayadesu/dsh-billing bundle（仓库根）

（备选：把真实 token 直接写进 ~/.npmrc，如 npm config set //registry.npmjs.org/:_authToken <TOKEN>， 之后命令行同样不含 token。无论哪种方式，绝不把 token 提交进仓库。）

配置

两个包都有合理默认值，下面都是可选的。

主机端（llm-billing）

| 字段 | 默认 | 含义 | | --- | --- | --- | | apiKeyEnv | DEEPSEEK_API_KEY | 每次调用时解析的凭据引用（环境变量）名。 | | baseURL | $DEEPSEEK_BASE_URL，其次 https://api.deepseek.com | 端点基础地址；会追加 /user/balance。 | | models | V4 Flash + V4 Pro + V4 Flash Vision Exp | 展示用的模型行，按展示顺序。 | | billing.peakHours | 09:00–12:00、14:00–18:00（北京，仅工作日） | 高峰时段窗口，仅周一至周五适用；周末与其余时段均为低谷。 | | billing.models | 官方 V4 费率 | 每个模型的峰/谷单价行（cacheHitInput、cacheMissInput、output，单位：元/百万 token）。 |

会话花费是怎么算的

• 每条 assistant/message 事件报告三个计费 token 桶：缓存命中输入、未命中输入（未缓存输入 + 缓存写入）、输出（含推理）。
• 每条消息按其发生时刻（北京时间）所在的峰/谷时段单价计价，三个桶分别计费（缓存命中 ¥X · 未命中输入 ¥Y · 输出 ¥Z），再按模型汇总。高峰窗口仅周一至周五适用；周末全天按低谷价计费。
• 今日共花费按同一个计价规则汇总当天（北京时间自然日）所有会话的事件；事件归属的日期同样按北京时间计算。
• 本轮花费按同一规则计价该回合 turn/start..turn/end 区间内的消息（定位到收尾消息的会话 id + 消息 id）。
• 今日会话花费排行按同一规则按会话汇总今日花费（跨天会话只统计今天的部分），从高到低排序；会话名取日志中最后一条 session/title 事件（自动生成的中文标题或用户重命名的新标题）。
• 没有费率行的模型不计入（内置价目表目前含三个 V4 行：V4 Flash、V4 Pro、V4 Flash Vision Exp）。计费按 DeepSeek 8 月 17 日实行的费率；周末按低谷价计费的规则按 8 月 23 日生效的调整执行。

已知限制

• 有费率行才计价 —— 会话花费、本轮花费与今日共花费只统计价目表（billing.models）里有的模型。
• 按需聚合 —— 今日共花费与今日会话排行在主机端 60 秒缓存之后计算；缓存未命中时只扫描持久化日志自上次解析以来变化过的会话（有投影注册表时，活跃会话直接读投影单元），增长中的会话花费按增量计价（只重算新增尾部）。
• 排行只显示前 10 —— 详情面板最多展示前 10 个会话，其余以「…还有 N 个会话」提示。
• 本轮花费只出现在已定稿的收尾消息 —— 中断的回合没有操作行，不显示本轮花费；冷会话（投影缓存直接命中）排行标题可能显示「未命名」，待其日志被重新读取后恢复。
• 额度不自动跟随 —— 余额保持手动刷新（无轮询），账户在其他客户端产生消耗时，界面值不会自动变化，需手动刷新或刷新浏览器。
• 是估算，不是承诺 —— 会话花费按官方单价对 token 计价；实际计费以服务商为准。

许可证

MIT