前言¶
在 DeepSeek Harness（DSH）里跑智能体或对话时，百炼 Token Plan 的额度往往要在阿里云控制台里单独打开页面查看。月窗口、周窗口和 5 小时窗口各自刷新，叠加包、订阅到期和重置倒计时分散在不同区块，和本地开发节奏对不上。下面介绍的 dsh-token-meter（npm 包名 dsh-plan-meter）是社区维护者 lkpsg 发布的 DSH 客户端插件：在 Web UI 侧边栏和页脚提供用量面板，通过官方百炼 CLI 登录态读取额度，不要求控制台 Cookie、API Key 或 RAM AccessKey。
这是什么¶
dsh-token-meter 面向已订阅百炼 Token Plan、并在 DSH Desktop 或 web profile 下工作的开发者。插件在 DSH 内展示控制台同源的用量摘要：月 / 周 / 5 小时窗口的已用与剩余比例、下次重置时间及倒计时、订阅计划与续费状态、加购 credits、重置卡信息等；并标注最近一次成功拉取时间，支持手动刷新与可配置的自动刷新间隔。数据经同源 API 由宿主侧 Node 读取 ~/.bailian/config.json 中的 CLI token，再请求百炼控制台网关；token 不会写入插件自有存储，也不会返回给浏览器。
核心功能¶
面板为独立侧边栏页 Plan usage，页脚另有紧凑 chip 显示月剩余比例并可点开同一页面。已核实展示项包括：
- 月 / 周 / 5 小时窗口：与控制台一致的百分比、剩余额度、下次重置时间与实时倒计时。
- 订阅：计划代码、状态、剩余天数、到期日与自动续费标记。
- 加购 credits：剩余 / 已用 / 总量及有效加购项数量。
- 重置卡：若计划具备，显示最近生效时间与过期时间。
- 新鲜度：上次成功读取时间、过期标记、手动刷新；背景轮询与可配置刷新间隔（默认 10 分钟，范围 1–1440 分钟）。
插件无运行时 npm 依赖；出站请求仅指向百炼控制台主机，无遥测或第三方分析。当前版本仅支持个人 Token Plan；团队 Token Plan 需 OpenAPI AK/SK，本插件不读取。
环境与依赖¶
- DSH 版本 >= 0.2.0（Desktop 或
webprofile）。 - 已全局安装并登录官方百炼 CLI（与持有 Token Plan 的账号一致）：
npm i -g bailian-cli
bl auth login
登录会打开浏览器完成阿里云账号认证，CLI 将控制台 token 写入 ~/.bailian/config.json。若使用国际站控制台：
bl auth login --console --console-site international
安装与启用¶
DSH Desktop（推荐）¶
- 打开 Settings → Plugins。
- 选择 Install from GitHub（或目录/market 列出后从市场安装）。
- 填写仓库地址：
https://github.com/lkpsg/dsh-token-meter。 - 若宿主提示，重新加载窗口。
Desktop 使用应用自带 profile，一般无需再执行下面的 CLI 安装命令。
CLI（web / headless profile）¶
dsh plugin --profile web add github:lkpsg/dsh-token-meter
本地开发时可指向目录：
dsh plugin --profile web add link:/absolute/path/to/dsh-token-meter
插件以当前 DSH 进程权限运行；安装前建议在 GitHub 查看源码与 MIT 许可证（package.json 当前发布版本为 0.2.0）。
典型用法¶
- 按上文完成百炼 CLI 安装与
bl auth login。 - 在 DSH 侧边栏打开 Plan usage。
- 若仍提示 “Connect the Bailian CLI”，点击 Check again。
每次拉取都会重新读取 CLI token，因此重新执行 bl auth login 后无需重启 DSH 即可生效。登出使用 bl auth logout，面板会回到 setup 卡片。
在面板设置中可调整：
- Region：中国大陆或阿里云国际站，须与
bl auth login使用的控制台站点一致。 - Refresh interval：1–1440 分钟；点击 Refresh 会绕过缓存。页面可见时每 30 秒轮询一次，但宿主仅在配置的间隔后才会再次请求百炼；失败请求会节流 30 秒。
可选环境变量（资料原文）：
| 变量 | 用途 |
|---|---|
BAILIAN_CONFIG_DIR |
CLI 的 config.json 所在目录（默认 ~/.bailian） |
DSH_PLAN_METER_STATE_DIR |
插件状态目录（默认 $DSH_HOME/storages/dsh-plan-meter，主要用于测试 hook，仅存展示设置） |
适用场景与注意¶
适合：已在 DSH 中日常开发、订阅个人百炼 Token Plan，并希望在本机 DSH 界面内对照 5 小时 / 周 / 月窗口与 credits，避免频繁切控制台的用户。
务必知晓：
- 必须有可用的
bl auth login；无 Cookie、API Key、AccessKey 回退路径。 - CLI token 可能过期，需重新登录；
sk-...类 API Key 无法读取 Token Plan 额度，属平台限制而非插件开关。 - 控制台内部 API 可能变更，解析失败时需等待插件更新；插件与阿里云无隶属关系。
- 团队 Token Plan、模型推理与 API Key 管理仍应在百炼控制台处理。
结尾¶
dsh-token-meter 把百炼 Token Plan 的多窗口用量、订阅与加购信息收敛到 DSH 侧边栏与页脚，依赖官方 CLI 登录，不额外收集凭证。目录与分类信息可在社区插件页查看；源码、截图与中文 README 见 GitHub。
- 插件目录页：https://www.skillhub.cn/plugins/lkpsg/dsh-token-meter
- GitHub：https://github.com/lkpsg/dsh-token-meter
