DeepSeek Harness Usage 插件介绍

前言¶

DeepSeek Harness (DSH) 采用“一切皆插件”的架构，通过扩展插件来增强核心能力。对于开发者而言，监控 Token 使用量、估算模型成本以及分析调用趋势是日常工作的重要部分。DeepSeek Harness Usage 插件旨在解决这一需求，它是一个本地优先的插件，直接从 DSH 的会话日志中读取数据，提供成本分析、趋势图表和活动热力图，而无需依赖外部遥测服务或创建并行数据库。

这是什么¶

该插件由维护者 syncended 开发，目前处于 MVP（最小可行性产品）阶段，支持 DSH 的 0.1.5-rc.2 主面板 API，并保留了对旧版 0.1.1-rc.2 的导航回退支持。作为本地工具，它严格遵循“只读”原则，会话日志是数据的单一来源。

核心功能¶

插件提供了一套完整的使用分析工具，主要包含以下功能：

全功能工作区：点击侧边栏的 Usage 即可打开完整的工作区界面。
时间范围筛选：支持 30 天、90 天、1 年以及全部时间范围的数据查看。
成本分析：
- API 估算：提供除 Codex 以外的提供商的 Token 率估算。
- Codex API 等效值：提供 openai-codex 提供商的假设性成本估算。
- 实际费用：当前不可用，插件不导入发票或支付记录。
交互式图表：
- 趋势图：支持指针和键盘提示的交互式图表，可查看 Token、估算成本或调用次数。
- Token 混合可视化：使用圆环图展示输入/输出/缓存的 Token 比例。
- 活动热力图：交互式 365 天热力图，支持多种颜色模式和四分位数强度设置。
数据细分：支持按提供商、按模型进行使用量拆解，并按会话、调用次数、Token 体积和估算成本排序。
智能处理：
- 时区感知：浏览器时区感知的日期分组。
- 后台扫描：Host 启动后自动后台扫描，并定期刷新，不干扰主界面渲染。
- 缓存机制：修订感知缓存，跳过未更改的会话，支持磁盘检查点复用。

安装与启用¶

在安装或升级后，需要重启 dsh web 进程以使插件生效。

dsh plugin --profile web add @syncended/dsh-usage

重启后刷新页面，在侧边栏中打开 Usage 即可查看数据。

配置与使用¶

插件支持通过配置文件覆盖定价或扫描行为。

编辑 $DSH_HOME/profiles/web/cordis.patch.yml 文件中的 usage 行：

- id: usage
  config:
    scanConcurrency: 2
    scanBatchSize: 32
    refreshIntervalSeconds: 60
    cachePath: /absolute/path/to/usage-checkpoint.json

定价说明¶

Token 率估算不是支付记录：仪表盘区分 API 估算和 Codex 等效值，两者均为估算值，不构成实际账单。
分类规则：分类使用提供商路由（不区分大小写），而非模型名称。这意味着通过企业网关访问 GPT 模型不会被自动归类为订阅使用。
语言设置：界面语言遵循 DSH Web UI 的 <html lang> 设置（即 DSH 内置语言），而非浏览器区域设置。

注意事项¶

只读模式：插件不修改数据，仅读取日志。
依赖 Host：需要 Host 支持 appReady 信号以实现最佳的后台扫描体验（旧版 Host 仍可使用）。
开源许可：插件遵循 MIT 许可证，请自行检查源码与许可证后再行安装。

生态与链接¶

该插件属于 DSH 插件生态的一部分，与 DeepSeek 官方无直接从属关系。更多详情可访问：
* GitHub 仓库
* 技能社区插件目录