前言¶
对使用 DeepSeek Harness（DSH）的开发者来说，本地会话已经产生了 Token、请求、Agent 活动、工具调用和性能数据，但这些信息分散在会话事件中，不容易直接核对。
dsh-usage-insights 解决的是这个具体问题：它不新增模型调用，不显示金额，只读取 DSH 已有的本地会话语料，并在 DSH Web 的“设置 > 工作活动”中提供可筛选、可核对、可导出的用量面板。
这是什么¶
dsh-usage-insights 是 fazhu4 维护的 DeepSeek Harness 本地只读用量面板，当前版本为 0.2.0，许可证为 MIT。
它从 DSH 会话事件中统计 Token、请求、Agent 活动、工具调用和性能，并在“设置 > 工作活动”中提供卡片、趋势和分页明细。当前版本为 alpha。
核心功能¶
下面按面板能力说明。
时间范围与筛选¶
- 按已验证的 IANA 时区自然日查看
today、7d、30d或all数据。 - 可同时按工作区、服务商和模型筛选。
- 工具维度不接受服务商或模型筛选；该组合会返回
HTTP 400。
Token 与请求¶
- 分开展示未缓存输入、缓存读取、缓存写入、输出和输出中的推理 Token。
- 展示已计量请求、活跃工作区、活跃会话、Agent Usage、模型耗时、工具耗时、TTFT 覆盖率和缓存复用率。
趋势与明细¶
- 日趋势可在 Token 与请求数之间切换。
- 服务商和模型明细区分 Agent 与 Compaction 请求来源。
- 提供工作区、服务商、模型、会话和工具五种分页明细，可搜索和排序。
性能与导出¶
- 统计平均首 Token 时间、输出速度、模型耗时、工具耗时、工具失败日趋势和轮次结果。
- 导出与当前筛选及分析维度一致的 UTF-8 CSV。
- 会话行通过 DSH 客户端会话服务打开，不构造私有 URL。
界面与 API¶
- 中英文界面、键盘可操作标签页、可聚焦的图表日桶和窄屏布局。
- 提供
summary、breakdown、filters、export.csv、retry等 HTTP API。
安装与启用¶
v0.2.0 从 dsh-activity-report 更名。如果旧 profile 已安装 dsh-activity-report，先移除旧包：
dsh plugin --profile web remove dsh-activity-report
然后安装当前版本：
dsh plugin --profile web add dsh-usage-insights@0.2.0
经过上面的步骤后，重启 dsh web，再打开“设置 > 工作活动”。
典型用法¶
下面按文档给出的可复现步骤说明。
- 安装
dsh-usage-insights@0.2.0。 - 重启
dsh web。 - 打开“设置 > 工作活动”。
- 使用
range=today|7d|30d|all选择时间范围。 - 如需筛选，使用可重复的
workspace、provider、model参数。 - 查看工作区、服务商、模型、会话和工具明细，或导出 UTF-8 CSV。
- 如果查询工具维度，不要同时传服务商或模型参数；该组合会返回
HTTP 400。
配置¶
cordis.patch.yml 暴露以下部署参数：
| 字段 | 默认值 | 说明 |
|---|---|---|
persistDebounceMs |
1000 |
实时事件合并写入的等待毫秒数 |
backfillConcurrency |
4 |
历史会话回填并发数 |
defaultPageSize |
25 |
明细默认页大小 |
timezone |
系统 IANA 时区 | 自然日分桶时区 |
本地存储与隐私¶
- 插件只读取 DSH 已有的本地会话语料。
- 插件通过 DSH
storageDomain的usage_insightsdomain 固化每会话聚合记录。 - 插件不显示金额，不调用模型或服务商接口，也不修改、归档或删除会话。
- 界面和导出不包含提示词、回复正文、工具参数或工具输出。
- 当源会话从 DSH 逻辑语料中移除时，插件只清理自己对应的派生聚合记录，不修改或删除 DSH 会话数据。
开发与验证¶
开发验证需要 Node.js ^22.19.0 或 >=24.0.0 与 pnpm。
pnpm install
pnpm run typecheck
pnpm test
pnpm run build
pnpm run verify:package
适用场景与注意¶
适合需要在本地核对 DSH 会话用量、请求、Agent 活动、工具调用和性能信息的开发者或运维人员。
注意：
- 当前版本为 alpha。
- 插件以当前
dsh进程权限运行，安装前应检查源码、依赖和许可证。 - 插件不显示金额，不调用模型或服务商接口，也不修改会话。
- 工具维度不接受服务商或模型筛选，该组合会返回
HTTP 400。
结尾¶
dsh-usage-insights 的价值，是把 DSH 本地会话中已有的用量、请求、Agent 活动和工具调用信息组织成可核对、可筛选、可导出的只读面板。
- 目录页：https://www.skillhub.cn/plugins/fazhu4/dsh-usage-insights
- GitHub：https://github.com/fazhu4/dsh-usage-insights
