前言¶
用 DeepSeek Harness 做日常对话和开发时，会话日志里其实已经有 token 与模型信息，但客户端默认不会把这些汇总成「哪天用了多少、大概花了多少钱」。若只靠翻历史会话或外部记账，很难一眼看出近一年的使用节奏。
下面介绍社区插件 dsh-activity-heatmap（维护者 ZhouXiaoXian233，分类为客户端）。它在 Harness 里实现类似 GitHub 个人主页的日历热力图：一格代表一天，颜色反映当天使用强度，并附带 token 统计与按模型拆分的估算金额。数据只读会话事件，不改会话内容。
这是什么¶
dsh-activity-heatmap 是 DeepSeek Harness 的客户端插件，npm 包名同为 dsh-activity-heatmap，当前版本 0.1.0，许可证 MIT。运行环境要求 Node.js >= 20、DSH >= 0.2.0-rc.1。
插件通过 dsh.bundle.patch 与 dsh.client 接入：装好后侧边栏会出现入口，无需额外改 Harness 主配置即可打开整页热力图。
核心功能¶
日历热力图¶
- 侧边栏底部图标行最右侧增加热力图图标，点击进入「活动热力图」整页。
- 默认展示近 365 天的格子，并自动铺满窗口宽度；右上角可切换「近 365 天 / 近 90 天 / 近 30 天 / 全部」，格子数量与统计范围同步变化。
- 统计卡片与「按模型统计」表均跟随当前所选时间段。
格子颜色含义¶
| 颜色 | 含义 |
|---|---|
| 灰 | 当天没有任何记录（含未打开应用） |
| 最浅绿 | 当天打开过应用，但没有发起对话 |
| 浅绿 → 深绿（4 档） | 当天活跃度按近 365 天活跃日的 25 / 50 / 75 分位分档 |
活跃度分计算公式：
对话轮数 + 模型调用次数 + 计费 token ÷ 10000
其中计费 token = input + output + (cacheRead + cacheWrite) × 0.1（缓存读写按 1/10 权重，避免长上下文把分数拉高）。活跃日不足 4 天时，退化为按当期最大值线性分档。
数据来源与账本¶
插件只读会话日志里 assistant/message 事件的 usage 与 provider:model，不修改任何会话内容。
- 历史会话在首次请求时自动回放补齐；之后通过
session/event实时累加。 - 每个会话记录已折叠到的事件序号，重复扫描不会重复计数；fork 出来的会话会跳过继承事件。
- 「打开过应用」由侧边栏图标每 5 分钟发一次心跳记录。
本地状态与诊断文件位于 $DSH_HOME/storages/activity-heatmap/：
state.json：账本（删除即可清零，重启后重新回放）probe.log：请求记录last-payload.json：最近一次下发的数据
单价与估算金额¶
页面「价格设置」可改默认价与各模型单价，保存后立即生效，写入 $DSH_HOME/storages/activity-heatmap/config.json，无需重启。
- 单位：元 / 1M tokens，分「缓存命中 / 缓存未命中 / 输出」三档。
- 未单独配置的模型使用默认价，默认值为 DeepSeek 官方参考价 0.2 / 2 / 3（cacheHit / cacheMiss / output）。
custom-api:*为私有网关，无公开价，若要准确金额需在弹窗或配置里填写自有单价。
也可直接编辑配置文件（同样即时生效）：
{
"currency": "CNY",
"default": { "cacheMiss": 2, "cacheHit": 0.2, "output": 3 },
"models": {
"custom-api:deepseek-flash": { "cacheMiss": 4, "cacheHit": 1, "output": 16 }
}
}
安装与启用¶
任选其一即可。
插件市场：在 DSH 插件市场中搜索 dsh-activity-heatmap 或「活动热力图」，一键安装。
npm：安装包名 dsh-activity-heatmap（含 dsh.bundle.patch 与 dsh.client），装完即出现在侧边栏。
本地开发：将仓库路径以 link: 形式写入 profile；改完文件后停用/启用一次插件即可热重载。
典型用法¶
- 完成安装后，在侧边栏底部找到热力图图标并打开整页视图。
- 根据需要切换「近 365 天 / 近 90 天 / 近 30 天 / 全部」，查看对应时段的格子与汇总。
- 若使用
custom-api:*或需要更贴近账单的单价，点击「价格设置」或编辑config.json后保存，页面估算会立即更新。 - 若要清空统计从头回放，删除
$DSH_HOME/storages/activity-heatmap/state.json后重启 DSH。
适用场景与注意¶
适合：长期在 DSH 里对话、希望用日历直观看到使用节奏，并希望在客户端内做 token 与粗略费用估算的开发者。
注意：
- 插件在当前 DSH 进程权限下运行，会读取本地会话日志并写入
$DSH_HOME/storages/activity-heatmap/。安装前建议浏览 GitHub 仓库 源码并确认 MIT 许可证是否满足你的环境要求。 - 社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，本插件为社区贡献的客户端扩展。
结尾¶
dsh-activity-heatmap 把 Harness 里分散的 usage 事件汇总成可切换时间范围的 GitHub 式热力图，并在同一页完成按模型的 token 与估算费用展示；只读日志、本地账本，适合作为日常使用的自检视图。
- 目录页：https://www.skillhub.cn/plugins/ZhouXiaoXian233/dsh-activity-heatmap
- GitHub：https://github.com/ZhouXiaoXian233/dsh-activity-heatmap
