前言¶
使用 DeepSeek Harness（DSH）时，会话日志和统计信息通常散落在各自的界面中：会话列表、运行记录、Token 计数。想要快速了解「这周发了多少条消息」「最近一个月 Token 消耗如何」需要在不同页面之间切换。一种直观的方式是把每日活动画成网格图：一天一个方格，有活动就高亮，不同颜色表示活动强度。这种方式在 GitHub 的贡献日历中已经非常成熟，把它引入 DSH 的 Web 界面可以让使用情况一目了然。
这是什么¶
dsh-conv-calendar 是一个 DeepSeek Harness 插件，由 Leni-More 维护。它在 DSH Web 界面的左侧栏增加一个「Conversation calendar」入口，打开后显示一个 GitHub 风格的贡献日历网格。网格按本地时间统计过去 53 周的数据，每个方格对应一天，颜色深浅表示该天的活动量。插件同时提供四种指标切换：Prompts（发送的消息数）、Conversations（活跃会话数）、Tokens（总 Token 消耗）和 Output（模型输出 Token）。点击某个方格可以查看当天的详细统计。
核心功能¶
- 侧边栏入口：在 Web GUI 左侧栏显示一个图标，点击打开全页日历视图。
- GitHub 风格网格：显示最近 53 周，从周一为起始日，五个颜色深浅，每天一个方格。
- 四种指标：
- Prompts：当天发送的消息数量
- Conversations：当天活跃的会话数
- Tokens：当天总 Token 消耗（输入 + 输出 + 缓存读取）
- Output：当天模型输出 Token 数量
- 统计卡片：根据当前选择的指标显示总活动天数、当前连续天数（含最长连续天数）、本月活动、上月活动和单日最高活动量。
- Token 细分：在 Tokens 或 Output 模式下，鼠标悬停在方格上会显示
in · out · cached的细分数据。 - 主题适配：颜色来自 DSH 的主题变量，浅色和深色模式都能正常显示。
- 双语：跟随 UI 语言切换中英文。
安装与启用¶
安装前需要确保满足环境要求：
- DeepSeek Harness 版本 0.2.1-rc.2 或兼容版本
- Node.js 22.15 或更高版本（用于日志的 zstd 压缩解析）
从 npm 安装（推荐）：
dsh plugin --profile desktop add dsh-conv-calendar
从本地 checkout 安装：
dsh plugin --profile desktop add link:/absolute/path/to/dsh-conv-calendar
安装后需要重启 DeepSeek Harness。插件在启动时从配置文件读取 bundle 列表，因此必须重启才能生效。重启后，左侧栏会出现「Conversation calendar」图标，打开即可看到已填充的历史数据，当天发送新消息后对应的方格会逐渐加深。
卸载时执行：
dsh plugin --profile desktop remove dsh-conv-calendar
如果插件导致应用无法启动，可以通过编辑 $DSH_HOME/profiles/<name>/package.json 中的 dsh.profile.bundles 字段删除 dsh-conv-calendar 行，而不是使用恢复对话框。
典型用法¶
安装并重启后，默认显示最近 53 周的日历。在左侧栏点击「Conversation calendar」图标进入全页视图。顶部可以选择四种指标：Prompts、Conversations、Tokens、Output。切换指标时，下方的统计卡片会同步更新。
在 Tokens 或 Output 模式下，将鼠标悬停在某个方格上，会显示当天的详细数据：输入 Token、输出 Token 和缓存读取 Token。这对于分析缓存命中率或优化 Prompt 长度很有帮助。
插件会自动从当前的 session/event feed 中实时计数新消息和回复。对于历史数据，它会通过 Host 的 ctx.sessionQuery 接口进行回填，每条会话只读取一次，活动会话每次刷新都会重新读取并合并。回填过程有 8 秒的时间预算，剩余部分在下次刷新时继续。
适用场景与注意¶
适合经常使用 DSH 进行多会话开发的用户，希望直观查看每日活动量、追踪长期使用习惯或分析 Token 消耗模式。
注意以下几点：
- 插件在 Host 进程中运行，读取本地会话日志。确保日志路径和权限正确。
- 安装前建议查看源码与许可证（MIT）。
- 某些指标可能显示不同结果。例如，只有模型回复而没有用户发送消息的一天，在 Prompts 指标下为 0，但在 Tokens 指标下可能有值。
- 状态文件位于
$DSH_HOME/plugins/dsh-conv-calendar/state.json，删除该文件会清除所有统计数据，下次启动时重新构建。
总结¶
dsh-conv-calendar 为 DSH 用户提供了一个直观的方式查看每日对话量和 Token 消耗。通过 GitHub 风格的网格和四种指标切换，可以在 Web 界面中快速掌握使用情况，帮助优化工作流和资源分配。
- 目录页：https://www.skillhub.cn/plugins/Leni-More/dsh-conv-calendar
- GitHub：https://github.com/Leni-More/dsh-conv-calendar
