dsh-usage-insights
DeepSeek Harness 会话的本地只读使用情况和性能分析。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-usage-insights@0.2.0Usage Insights 以 dsh-usage-insights 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness 的本地只读用量面板。它从 DSH 会话事件中统计 Token、请求、Agent 活动、工具调用和性能，在“设置 > 工作活动”中提供可核对的卡片、趋势和分页明细。
当前版本为 alpha。插件不显示金额，不调用模型或服务商接口，也不修改、归档或删除会话。
dsh plugin --profile web add dsh-usage-insights@0.2.0
v0.2.0 命名空间改版：
dsh-activity-report已更名为dsh-usage-insights（插件 ID、HTTP 路由、storage domain、CSS 前缀与本地化命名空间全部更新）。安装旧包的 profile 请先dsh plugin --profile web remove dsh-activity-report，再安装新包并重启dsh web；派生聚合会从会话事件自动重建。
添加后重启 dsh web，再打开“设置 > 工作活动”。host 插件需要重启加载，client bundle 随页面刷新加载。
总输入 Token：
未缓存输入 + 缓存读取 + 缓存写入
总处理 Token：
总输入 Token + 输出
推理 Token 是输出的子集，不会再次加入总量。缓存复用率为缓存读取除以总输入 Token。Agent Usage 覆盖率为带 provider usage 的闭合步骤数除以全部闭合步骤数；模型耗时覆盖率和工具耗时覆盖率分别使用同一自然日 cohort 的已测样本数与闭合步骤/工具调用数。没有分母时显示“未报告”。工具失败率以已经返回结果的工具调用为分母。
today、7d 和 30d 使用配置的 IANA 时区自然日。API 返回实际 timezone、startDay 和排他的 endDayExclusive。卡片、趋势和明细从同一批日期桶聚合。时区或聚合算法版本改变时，插件会在打开兼容的 storage domain 后丢弃旧派生缓存并从会话事件重建，绝不混合不同统计口径。
SessionEvent，不接受历史原型的任意对象格式。compaction 请求来源，不混入 Agent 覆盖率分母。callId 配对并持久去重；重复事件不会增加调用数或覆盖原始起始时间。配对结果、失败和耗时归入调用自然日，使调用数与耗时覆盖率使用同一 cohort。负耗时归零，未闭合区间不进入耗时。插件只读取 DSH 已有的本地会话语料，并通过 DSH storageDomain 的 usage_insights domain 固化每会话聚合记录。实际介质由 DSH profile 的 storage backend 决定。界面和导出不包含提示词、回复正文、工具参数或工具输出。
当源会话从 DSH 逻辑语料中移除时，插件只清理自己对应的派生聚合记录，不修改或删除 DSH 会话数据。
cordis.patch.yml 暴露以下部署参数：
| 字段 | 默认值 | 说明 |
|---|---|---|
persistDebounceMs | 1000 | 实时事件合并写入的等待毫秒数；可设为 0 |
backfillConcurrency | 4 | 历史会话回填并发数，范围 1..32 |
defaultPageSize | 25 | 明细默认页大小，范围 1..200 |
timezone | 系统 IANA 时区 | 自然日分桶时区，例如 Asia/Shanghai；非法值会在加载时失败 |
| 路由 | 说明 |
|---|---|
GET /dsh-usage-insights/summary | 卡片、日期趋势、服务商/模型/来源汇总和数据状态 |
GET /dsh-usage-insights/breakdown | 指定维度、排序、方向、搜索、limit 和 cursor 的一页明细；实时投影变化会使旧 cursor 失效 |
GET /dsh-usage-insights/filters | 当前范围及筛选条件下可用的工作区、服务商和模型 |
GET /dsh-usage-insights/export.csv | 当前筛选和维度的完整 CSV |
POST /dsh-usage-insights/retry | 重试尚未固化的派生记录并返回最新状态 |
三个 JSON 读取接口都返回 timezone、startDay、endDayExclusive、status 和样本覆盖率。所有读取接口接受 range=today|7d|30d|all，以及可重复的 workspace、provider 和 model 参数。工具维度不接受 provider 或 model。无效筛选组合、枚举、排序、游标或页大小返回 HTTP 400；意外的内部异常返回不泄漏细节的 HTTP 500。
CSV 按维度使用固定列。服务商和模型导出包含 agent_requests、compaction_requests、steps、message_samples 和 ttft_samples，工作区与会话也包含 message_samples，可据此独立核对来源与覆盖率；工作区导出不会重复输出 workspace 列。
需要 Node.js ^22.19.0 或 >=24.0.0 与 pnpm。
pnpm install
pnpm run typecheck
pnpm test
pnpm run build
pnpm run verify:package
pnpm run build 生成 host/client bundle、source map、manifest 和声明文件。pnpm run verify:package 会检查导出、JavaScript 语法和 npm pack --dry-run 文件清单。
MIT