DeepSeek Harness 允许并行管理多个会话，但在全局范围内查看所有会话的交互历史（用户消息、助手回复、工具调用）通常比较困难。现有的界面通常局限于当前会话。dsh-calendar 插件提供了一个根作用域的日历表面，将 Harness 中所有会话的交互事件聚合到一个视图中。
插件定位¶
- 插件名称：
dsh-calendar - 维护者：
necokeine - 许可证：MIT
- 核心价值：为 DeepSeek Harness 提供一个跨会话的交互事件日历，替代仅关注当前会话的单一视图。
核心功能¶
- 全 Harness 视图：提供统一的日历界面，展示所有会话的交互事件（用户消息、助手回复、工具调用、回合边界），而不仅限于当前会话。
- 实时更新：主机端通过 SSE 通道在事件被追加到日志时，立即将新事件推送到打开的日历中。
- 历史回填：在启动时填充已存在的会话，并通过
sessionPersistence尽力读取持久化的日志。 - 可扩展的合并：对于未知的（插件合并的）事件类型，插件会将其回退到类型名称；无需维护每个类型的注册表。
- 有界内存：采用滚动 90 天窗口策略，并限制每天最多保留 2000 个事件。
安装与启用¶
插件仅针对 DeepSeek Harness 的 Web 表面（dsh web）生效。
安装命令如下：
dsh plugin --profile web add @necokeine/dsh-calendar
安装完成后，重启 dsh web 并刷新页面，侧边栏底部会出现 Calendar 条目。该 Bundle 贡献了一个唯一命名的 Loader 行；当前版本的 @deepseek-ai/dsh-web-app 组成部分不包含需要禁用或替换的日历行。
若需移除：
dsh plugin --profile web remove @necokeine/dsh-calendar
典型用法¶
- 查看全局视图：在侧边栏底部点击 Calendar，即可查看全月视图。每一天的单元格显示当天的活跃会话数量，点击某一天会列出该天的所有活跃会话及其标题、持续时间和事件数，展开后可查看原始事件列表。
- 查询 JSON 数据：通过 HTTP 接口查询指定日期范围内的每日会话分桶数据：
GET /calendar/events?from=2026-09-01&to=2026-09-18
- 接收实时流：通过 SSE 通道接收实时事件帧：
GET /calendar/stream
注意事项¶
- pnpm 版本依赖：如果使用 pnpm ≥ 10，安装 Git 源码版本时会阻塞构建，除非在 profile 的
pnpm-workspace.yaml中将该包加入allowBuilds列表，且检出目录必须生成lib/。 - 无模型交互影响：该插件仅索引持久化的会话事件并暴露给 Web 日历 UI，不会改变模型输入或 KV-cache 行为，也不会添加工具或提示词部分。
- 插件兼容性：安装过程不会自动覆盖现有的日历行，需确认当前 UI 组成部分未包含冲突的日历组件。
总结¶
dsh-calendar 解决了 Harness 用户在多会话并行开发时难以快速定位和回顾交互历史的问题。它通过根作用域的日历表面和实时 SSE 流，为开发者提供了一个事实优先的全局交互视图。更多细节可查阅 GitHub 仓库 或 社区目录。
