前言¶
DeepSeek Harness (DSH) 的插件生态允许在会话头部直接扩展功能。sage-reminder 是一个时间模块，显示现在时间、距上次发消息时间，并提供提醒与倒计时功能。它与需要跨会话持久化的长期工具不同，定位是“会话内的短期时间提醒”，仅管理“此刻这台机器上的计时”。
核心功能¶
- 会话头部的时间模块：展开面板后，自上而下显示现在时间、距你上次发消息时间、提醒列表、倒计时列表。收起时只占一小条，右侧胶囊显示最近一个到期的计时。
- 纯前端插件：数据存储于浏览器
localStorage。Host 半不注册工具、服务、文件、进程或网络连接。 - 两种提醒模式：
- 提醒：设定一天内的一个钟点（时/分），到点响一次后留在列表中，等待下一个钟点。
- 倒计时：设定一段时长（天/时/分/秒），跑完自动从列表清理。
- 操作支持：支持启动、关闭、暂停、继续、编辑、删除操作。
- 到点唤醒会话：提醒到点时向当前会话发消息，把空闲会话叫醒（默认关闭）。
安装与启用¶
在 profile 的 package.json 中添加依赖，并配置 bundles。
// profile 的 package.json
"dependencies": {
"sage-reminder": "link:<你的路径>/sage-reminder" // 本地目录用 link:，发布版写版本号
},
"dsh": { "profile": { "bundles": [ ..., "sage-reminder" ] } }
在该 profile 目录运行 pnpm install，重启 DSH（或刷新页面）。
典型用法¶
- 基础交互：点模块展开面板，Esc 或点击外部收起。时间选择使用滚轮（24/60 进制），不接受文字输入，支持鼠标滚轮或键盘
↑↓PageUpPageDown。 - 创建提醒：点击
+ 新建，输入名称，使用滚轮设定时和分，保存即启动。列表中▶启动、⏸关闭、⋯编辑（编辑页左下角有删除）。 - 创建倒计时：点击
+ 新建，输入名称，使用滚轮设定天、时、分、秒，点击开始。跑完自动清理。列表中⏸暂停/继续、×删除。 - 到点唤醒会话：面板底部有开关（默认关），仅提醒可用。到点时会话正在跑时不发，空闲时会话发署名消息。面板会显示状态（如“已投递”或“跳过：会话正在跑”）。
注意事项¶
- 数据隔离：数据存储于浏览器
localStorage，隔离键包含端口。桌面壳每次启动使用随机端口（--port 0），重启后 origin 变化，数据无法读取。刷新页面不影响。 - 接口依赖：“距你上次发消息”依赖 DSH 客户端内部接口（
sessions.binding），接口变更会导致该行消失。 - 无系统通知：到点提示仅通过界面呼吸灯与浮条展示，不含系统通知，页面不在前台会错过。
- Host 半留空：Host 半故意留空（
lib/index.js只有一个apply()），不读写文件、不建网络连接。
结语¶
sage-reminder 将复杂度压到最小，专注于会话内的短期时间管理。如果你需要的是“关了也不会忘”的长期提醒，需要考虑其他方案。
