前言¶
DeepSeek Harness（DSH）在单次会话里已经能看到不少统计，但跨会话、跨项目、跨时间段的整体图景往往要靠自己翻记录或手工汇总。如果你需要回答「这段时间 effort 落在哪些日期、哪些工作区」「哪些时段更活跃、Token 主要被哪些模型吃掉」，以及是否需要一份可发给客户或同事的静态报告，单靠当前会话面板通常不够。
下面介绍社区插件 dsh-workload-report（产品侧品牌名 TimeMirror，仓库名便于在 DSH 生态检索）。它由 tableau-China 维护，分类为客户端插件，当前版本 1.0.1，在 npm 以包名 dsh-workload-report 发布，许可证 MIT，运行环境要求 Node.js >= 22。
这是什么¶
dsh-workload-report 是 DSH 的 DeepSeek Harness 插件：在官方会话与投影接口之上，提供按日期与工作区维度的 effort 与 Token 洞察——日历热力图、时刻分析、工作区占比、模型用量等，并支持导出自包含 HTML 报告。
与「只看当前 session」不同，它强调跨时间、跨工作区的汇总；指标定义在仪表盘与导出报告间保持一致，避免同一数字两处说法不一。
核心功能¶
以下能力均来自插件 README（1.0.0 功能列表，当前包版本 1.0.1）。
仪表盘与 KPI¶
- 八个 KPI：累计活跃时间（净活跃，等待时间单独一行）、总 Token（完整整数可核对）、模型费用估算、活跃天数、对话数、轮次/步数、缓存读取占比、最活跃模型等。
- 按日趋势：日历热力图（周一至周日 × 年-周，颜色与柱高表示活跃时间）或柱状图；周末配色区分，峰值柱带标签，单元格与轴均有 tooltip。
- 时刻分析：默认按 Token 输出 分小时柱状图（可切换为 轮次）；柱上方圆点表示人类消息密度。
- 工作区占比：Top 6 + 其他，环形图可在时间与 Token 之间切换。
- 模型 Token 占比：仪表盘紧凑环形图；完整明细在「模型用量」页签（treemap、堆叠日趋势、明细表、官方定价链接等；无官方价格的模型费用显示 —）。
- Top 会话与每日明细：会话表可排序；每日明细覆盖最近 31 天。
导出与界面¶
- 自包含 HTML 报告：单文件、内联 CSS 与 SVG，无脚本、无外部资源；支持浅/深主题、自定义标题与备注；可选
anonymize=1隐藏工作区名与会话标题。内容结构与仪表盘对齐。 - 主题与语言：颜色使用宿主主题 token（
--dsw-*）；中英文 UI 对齐。 - AI 用户画像（默认包含、须手动点击 Generate）：仅基于聚合统计调用模型，不读取对话正文、标题或路径；失败时回退本地规则。可选余额芯片（
balance.enabled: true，默认关闭）由宿主调用官方deepseekAccount服务。
数据原则（简要）¶
- 仅使用官方接口：
sessionQuery.listSessions()、投影（sessionProjections、sessionProjectionCache）、必要时observeSession()/readSession()事件日志；不解析*.jsonl.zstd或内部投影缓存文件。 - 默认零出站请求；本地索引写在
<DSH_HOME>/workload-report/index-v7.json（可删，会重建）。 - 无法读取的旧会话会在 UI 中排除并计数，不编造数字。
打开面板时不触发事件日志冷读（README 称冷开约 25 ms、热开约 1 ms，为隔离实例测量值）。
安装与启用¶
安装后需重启 Web profile。入口在侧边栏底部：Workload report（中文：工作量报告）。仓库已提交构建产物 lib/client.js，从 npm/GitHub 安装无需本地 build。
# npm（已发布包）
dsh plugin add dsh-workload-report
# 或直接从 GitHub
dsh plugin --profile web add github:tableau-China/dsh-workload-report#main
# 或链接本地检出目录
dsh plugin --profile web add link:$PWD
卸载：
dsh plugin --profile web remove dsh-workload-report
典型用法¶
- 按上述命令安装并重启 Web profile，在侧边栏打开 Workload report。
- 在仪表盘切换「按日期 / 按工作区」等视图，查看 KPI、热力图、时刻分析与工作区、模型占比。
- 需要对外汇报时，使用导出功能生成自包含 HTML；若不宜暴露工作区或会话标题，导出时启用
anonymize=1。 - 若使用 AI 用户画像，先阅读页内说明，再点击 Generate；同一统计指纹会复用磁盘缓存。
指标完整定义见仓库 docs/metrics.md；活跃时间等易误读项在 README 中有单独说明。
适用场景与注意¶
适合：长期在 DSH 多工作区、多会话下工作，需要复盘时间分布、Token/模型成本，或定期给客户、团队输出只读报告的用户。
注意：
- 插件以当前 dsh 进程权限运行，安装前请自行审阅 tableau-China/dsh-workload-report 源码与 MIT 许可证。
- 社区目录 SkillHub 插件页 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文介绍的是社区客户端插件，非官方应用商店条目。
- 费用为估算，仅对具备官方公开价格的模型显示；出站网络仅发生在用户显式启用的能力（如余额芯片、点击 Generate 的 AI 画像）。
结尾¶
dsh-workload-report 把「我做了什么」与「消耗了多少 Token/成本」放在同一套按日期、按工作区的视图里，并可用一份静态 HTML 带走相同定义的数据。若要安装说明与隐私细节，以 GitHub README 为准。
