前言¶
DeepSeek Harness 用户通常管理许多会话、后台任务和计划提醒，但很难看到这些工作：何时运行、持续多久或何时触发下一个重复任务。dsh-calendar 将现有的使用历史转化为美观的日历视图。
这是什么¶
dsh-calendar 是一个 DeepSeek Harness 客户端插件，由 YLifeOnlyOnce 维护，采用 MIT 许可证。它提供日、7 天、月和年视图，以可视化 DeepSeek 的操作。插件零配置，无需额外数据存储，并将历史记录在启动时折叠和缓存。
核心功能¶
插件提供多种视图和交互方式：
- 时间轴视图：提供 7 天时间轴（七列，每列一天，垂直 24 小时轴）和日时间轴（24 小时 Gantt 轴，按 workspace → session 分组）。
- 热力图与网格：年度热力图（GitHub 风格 52×7 贡献图）和月网格（经典日历，带每日热力条和总计）。
- Workspace 头部：时间轴行包含文件夹图标、发光强调条和药丸徽章，显示会话数和活跃时间。
- 交互与导航：点击时间轴条可打开实际对话；悬停任何单元格或条目可显示窗口、持续时间和轮次。
- 可拖动卡片：主 UI 卡片（统计、年、7 天、日、月）浮动在主界面上。拖动
⠿手柄移动，使用▾折叠，使用×关闭。 - 统计与追踪：统计条显示活跃时间、会话、轮次、工具调用和 tokens。Token 使用量按天、会话或 workspace 计费。
- 主题与动画：跟随 Harness 主题（浅色/深色），包含温和的入场效果和解密揭晓标题。
安装与启用¶
- 执行安装命令：
dsh plugin --profile web add dsh-usage-calendar
- 重启
dsh web。 - 打开 Settings → 📅 Calendar。
典型用法¶
- 视图切换：使用
‹›和 Today 在日、7 天、月和年视图间切换。 - 快速跳转：点击热力图单元格、月单元格或时间轴条以跳转到特定日期或对话。
- 卡片管理：拖动卡片手柄调整位置，使用
▾折叠面板，使用×移除卡片。 - 信息查看：悬停任意单元格或条目查看具体窗口、时长和轮次计数。
兼容性与注意¶
- 版本要求：需要 DeepSeek Harness 0.1.1-rc.1（next）或 0.1.0-rc.7。
- 零维护：无需配置或额外数据存储，插件以当前 Harness 进程权限运行。
- 预览能力：无需运行 Harness 即可通过演示页面预览视觉效果。
总结¶
dsh-calendar 为 DSH 用户提供了可视化和追踪使用模式的方法，将原始日志转化为直观的时间轴和日历。有关源代码和目录，请访问提供的 GitHub 链接。
