前言¶
在 DSH 中调用 DeepSeek API 时，经常会需要看几类信息：账户余额还剩多少、今日实际消费了多少、Token 构成是什么、最近一周或本月的费用趋势是否异常。这些信息如果都要切到外部平台页面查看，会打断当前工作。
dsh-codex-meter 把这些用量信息接到 DSH 的 Settings → Usage 页面里：余额、今日消费、Token 分析、费用趋势、实时 API 活动都可以在本地页面查看。它是按 DSH 插件方式接入的，不是独立站点，也不是官方应用商店入口。
这是什么¶
dsh-codex-meter 是 ChrisZhangWG 维护的 DSH 插件，许可证为 MIT。它面向 DSH web 客户端，按 DSH 标准 bundle 插件设计，使用 dsh.bundle.patch 和 dsh.client 接入。
它主要解决以下问题：
- 在 DSH 内查看 DeepSeek API 余额；
- 在 DSH 内查看今日消费和 Token 构成；
- 在 DSH 内查看
7D/Month费用趋势； - 在 DSH 内查看当前 API 调用是否处于
Active/Idle状态。
该插件界面全部为英文。
核心功能¶
Settings → Usage 页面¶
dsh-codex-meter 提供原生 Settings → Usage 页面，展示与 DeepSeek API 用量相关的数据。
页面会显示以下数据项：
Account balance：DeepSeek API 余额；Today：今日消费；Last balance change：最近一次余额变动。
如果配置了 DEEPSEEK_PLATFORM_TOKEN，Today 相关数据可以来自官方接口；如果未配置或 token 失效，页面会退回本地估算。
Today’s token analysis¶
Today's token analysis 展示今日官方分析信息，包括：
- 请求数；
- 今日费用；
Cache efficiency区间尺；Context size区间尺。
它用于判断今日请求规模、缓存效率和上下文占用情况。
Official cost trend¶
Official cost trend 提供两个视图：
7D
Month
每个每日费用点会显示数据标签，并统计周期内的：
Total
Daily avg
Peak
这个视图适合查看一周或本月费用变化。
API activity¶
API activity 展示实时状态：
Active
Idle
其中：
Active表示有模型 API 请求正在运行；Idle表示当前没有模型 API 请求。
工具执行、权限等待等状态不会被计入活跃 API 调用。
API activity 不缓存，始终来自实时活动接口：
GET /api/codex-meter/api-activity
缓存行为¶
插件的用量缓存存活时间为 7 天。
打开 Settings → Usage 时，页面会先显示最近一次成功获取的统计数据，同时继续拉取最新数据。刷新期间会显示：
Showing saved data · refreshing…
如果刷新失败，插件会保留已有数据，不会把已有统计直接清掉。
密钥边界¶
插件只缓存展示型统计数据，例如余额、今日消费、官方 Token 分析、趋势数据等。
插件不缓存以下类型信息：
DEEPSEEK_PLATFORM_TOKEN
API Key
凭据
浏览器只访问宿主本地路由。仓库中不存储任何密钥值，也不会把密钥发送给浏览器。
安装与启用¶
常规安装¶
推荐使用 DSH 插件命令安装到指定 profile：
dsh plugin --profile <name> add dsh-codex-meter
如果要从 GitHub 仓库安装，可以使用：
dsh plugin --profile <name> add github:ChrisZhangWG/dsh-codex-meter
如果 profile 名称是 web，可以使用：
dsh plugin --profile web add dsh-codex-meter
桌面版手动接线¶
桌面版需要手动接线时，先复制插件包到 profile 的 node_modules：
PROFILE=~/.dsh/profiles/desktop
mkdir -p "$PROFILE/node_modules"
cp -R dsh-codex-meter "$PROFILE/node_modules/"
然后软链宿主依赖：
mkdir -p "$PROFILE/node_modules/@deepseek-ai"
ln -sfn "/Applications/DSH Desktop.app/Contents/Resources/app.asar.unpacked/node_modules/@deepseek-ai/dsh-credentials" \
"$PROFILE/node_modules/@deepseek-ai/dsh-credentials"
在 $PROFILE/cordis.patch.yml 中追加 loader 条目：
- insert:
- id: codex-meter
name: dsh-codex-meter
完全重启 DSH Desktop 后，进入：
Settings → Usage
查看插件页面。
插件的宿主依赖版本约束为：
@deepseek-ai/dsh-credentials >=0.1.0-rc.6 <0.2.0-0
典型用法¶
读取余额¶
余额读取使用：
DEEPSEEK_API_KEY
配置后，Settings → Usage 中的 Account balance 可以显示 DeepSeek API 余额。
获取官方数据¶
官方数据需要使用：
DEEPSEEK_PLATFORM_TOKEN
获取方式如下：
- 登录
platform.deepseek.com； - 打开浏览器 DevTools Console；
- 执行下面的表达式：
JSON.parse(localStorage.getItem('userToken')).value
把得到的 token 存到：
~/.dsh/.credentials.yaml
示例：
DEEPSEEK_PLATFORM_TOKEN: <token>
配置后，今日官方消费、趋势图和逐日相关数据来自官方接口。
注意，DEEPSEEK_PLATFORM_TOKEN 会随平台会话过期。失效时，Today 行会显示：
Today (refresh needed)
并自动退回本地估算。重新获取 token 后，可以恢复官方数据。
本地测试¶
如果需要运行测试：
npm test
宿主路由¶
插件使用以下宿主路由：
GET /api/codex-meter/balance
GET /api/codex-meter/api-activity
GET /api/codex-meter/session-cost
其中：
GET /api/codex-meter/balance用于余额、官方数据、今日分析、余额变动等；GET /api/codex-meter/api-activity用于实时Active/Idle状态；GET /api/codex-meter/session-cost是本地估算，不是官方账户扣费记录，Settings → Usage页面不使用它。
适用场景与注意¶
dsh-codex-meter 适合以下使用场景：
- 希望在 DSH 内查看 DeepSeek API 余额；
- 希望把今日消费、Token 构成和费用趋势放进
Settings → Usage； - 希望区分
Active/Idle，判断当前是否有模型 API 请求； - 希望减少在 DSH 和平台页面之间来回切换。
使用前需要注意：
- 插件作为 DSH 插件运行，使用当前 DSH 进程的权限和本机凭据；
- 安装前应检查源码、依赖和许可证；
- 官方数据依赖
DEEPSEEK_PLATFORM_TOKEN，该 token 可能随平台会话过期； API activity只表示模型 API 调用状态，工具执行和权限等待不计入活跃调用；- 本地估算数据不是官方账户扣费记录。
许可证方面，dsh-codex-meter 为 MIT。价格引擎移植自 bpc-oss/dsh-web-billing，宿主逻辑参考 dsh-deepseek-quota，两者均为 MIT。
结尾¶
dsh-codex-meter 的价值在于：把 DeepSeek API 的余额、今日消费、Token 构成、费用趋势和实时 API 活动集中到 DSH 的 Settings → Usage 页面中。它不改变 DeepSeek 平台的计费规则，也不把密钥暴露到浏览器；它提供的是一个本地可查、可缓存展示型统计、保留实时 API 状态的用量视图。
GitHub 仓库：
https://github.com/ChrisZhangWG/dsh-codex-meter
DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。本次已核实资料未给出该插件的目录页 URL，因此不写具体目录链接；如需查找，可按插件名 dsh-codex-meter 在 DSH 社区目录中检索。
