前言¶
DeepSeek Harness (DSH) 的核心架构基于插件化设计。在实际的智能体开发或运维场景中，管理多个订阅账户、监控配额使用情况以及追踪本地运行日志是高频需求。dsh-token-usage 旨在为 DSH 提供一套统一的账户与配额观察机制，以及本地使用账本，解决在多提供者环境下难以追踪成本和订阅状态的问题。
插件定位¶
这是一个针对 DeepSeek Harness 的管理安全类插件，专注于账户管理、订阅配额观察和本地使用记录。插件由 shaomingbo 维护，采用 MIT 许可证开源。
核心能力¶
该插件提供了以下功能，覆盖了从连接管理到运行时诊断的多个层面：
- 统一提供者连接：支持对多种提供者的统一连接管理。
- 账户与配额观察：提供订阅配额的观察能力，支持本地使用账本的记录。
- Antigravity 账户池：支持主-详情视图的账户池管理，支持激活、移除账户、池内轮转以及自动故障转移。
- 原生
codex-runtime/v1能力：提供所有者绑定的原生codex-runtime/v1能力接口。 - 订阅登录管理：支持订阅登录状态管理，包括
pending-login和显式的取消操作。 - SDK 流诊断：提供 SDK 级别的流诊断，可识别
completed、failed、cancelled和timed-out四种终端状态。 - 原生压缩计数器：提供原生压缩过程的计数统计。
安装与启用¶
插件通过 NPM 生态进行分发。在安装前，请确保你的运行环境满足依赖要求（见下方说明）。
- 确认 Node.js 版本。根据
package.json，插件要求node版本大于等于22.19.0。 - 执行安装命令：
npm install dsh-token-usage
安装完成后，插件将注册到 DSH 的插件系统中。根据配置，bin/install.js 会被执行以完成必要的初始化设置。
典型用法¶
该插件通常需要与特定的配套组件配合使用，以发挥完整的诊断和压缩功能。
- 配合压缩组件：为了获得完整的诊断阶段和压缩计数功能，建议将此插件与
dsh-codex-compaction0.3.2 配对使用。 - 启用可选诊断：在启用压缩 0.4.0 时，可以激活
completed、failed、cancelled和timed-out等可选的诊断阶段。
插件会通过原生接口与 DeepSeek 的运行时进行交互，利用 codex-runtime/v1 的 seam 来获取底层的运行状态。
注意事项¶
在使用该插件时，请注意以下事实：
- 数据安全：插件在 SQLite、RPC、日志或导出数据中不包含遥测数据、提示词或任何密钥信息。
- 验证机制：假传输和隔离的配对快照是独立于真实模型接受进行验证的，仅用于测试环境。
- 已知非阻塞限制：在压缩状态中，取消操作可能会显示
CODEX_RUNTIME_ERROR，这是一个已知的行为，不会影响核心功能的运行。
结语¶
dsh-token-usage 为 DSH 提供了坚实的账户管理和运行时诊断基础。如果你需要深入监控 DeepSeek Harness 的运行状态和账户配额，该插件是一个可以直接落地的选择。
- 插件目录: dsh-token-usage
- 源代码: GitHub
