sage-reminder

sage-reminder（时间提醒）

DSH 会话头部的一个时间模块：现在时间 / 距你上次发消息 / 提醒 / 倒计时。

定位是会话内的短期时间提醒 —— 管"此刻这台机器上的计时"，不承担"关了也不会忘"的责任。 收起时只占一小条，点开向下拉出面板；到点时模块边框呼吸发亮 + 界面浮条。

DSH 版本兼容性（0.1.3 核对于官方桌面版 0.2.0-rc.2 与网页版 0.2.0-rc.1） conversation.session.header.actions 槽位、ctx.slots API、以及「到点唤醒会话」走的 sessions.binding(id).session.prompt() 链，在 0.1.6 → 0.1.7 → 0.2.0 三个版本线上均未改变。 0.1.3 起 package.json 带 engines.dsh，且 peer 不设上界 —— 任何未来的 DSH 版本都不会被这道 声明挡在门外。（反例：dsh-skill-mcp-panel 曾因 peer 上界 <0.2.0-0 让所有 0.2.x 用户的面板整体消失。） 0.1.1 加的槽位挂载失败留痕仍然有效：ctx.slots 缺失或注入抛异常会在控制台报警 —— 这两种情况下模块以前是彻底无声的，只表现为「这插件好像没装」。

纯前端插件（dsh.client.platform = web）：

• 时间是浏览器本地时间
• 提醒与倒计时存在浏览器 localStorage
• 到点提示 = 模块边框呼吸灯 + 界面浮条
• host 半不参与任何事 —— 不发系统通知、不读文件、不建网络连接

两个模块，分工是「留不留」

界面

收起态（会话头部，紧邻「客厅」按钮）—— 上行日期，下行星期与时刻，右侧胶囊是最近一个到期的计时：

点模块向下拉出面板：

面板自上而下四段：现在时间（秒级）→ 距你上次发消息 → 提醒 → 倒计时， 最底部是「到点唤醒会话」开关（默认关）。

• 「还剩多久」只在 10 分钟内转成金色，其余时候是灰的
• 条目的操作按钮 hover 才浮出来
• 模块右边的小胶囊 = 最近一个要响的东西，不用展开就能看见
• 到点浮条只显示你设的内容（名字），不加「到点了」这类旁白

用法

• 点模块展开面板；Esc、点面板外面、或再点一次收起
• 提醒 → + 新建：名称 + 时间（时 / 分滚轮）→ 保存即启动
  • 到点响一次，之后照常留在列表里等下一个钟点（长期保留、不消费）
  • 列表里 ▶ 启动、⏸ 关闭、⋯ 编辑（编辑页左下角是 删除）
• 倒计时 → + 新建：名称 + 时长（天 / 时 / 分 / 秒滚轮）→ 开始
  • 它是一次性的：跑完自动从列表清理
  • 列表里 ⏸ 暂停 / 继续、× 删除
• 到点唤醒会话（面板最底部，默认关）：提醒到点时往当前会话发一条署名消息，把空闲的会话叫醒
  • 提醒专属；倒计时不唤醒
  • 会话正在跑的时候不发 —— 不打断正在进行的回合
  • 发了没有、为什么没发，面板上看得到（上次唤醒：已投递 / 跳过：会话正在跑 / …）
  • ⚠️ 每次唤醒 = 一轮完整的模型调用（真花钱），所以默认关、一条条单独开

时间怎么选

• 一律滚轮，不接受文字输入 —— 避免有人敲进 ahfkhas 这类非时间字符
• 三种改法：点上下行、鼠标滚轮、↑ / ↓ / PageUp / PageDown
• 24 / 60 进制：时 0-23、分 0-59、秒 0-59、天 0-99。列之间不做进位 —— 要 90 分钟就写「1 时 30 分」，不写「90 分」
• 不做重复规则（只一次 / 每天 / 每周）：提醒天生就是"这个钟点"，没什么可选的

安装

// profile 的 package.json
"dependencies": {
  "sage-reminder": "link:<你的路径>/sage-reminder"   // 本地目录用 link:，发布版写版本号
},
"dsh": { "profile": { "bundles": [ ..., "sage-reminder" ] } }

然后在该 profile 目录跑 pnpm install，重启（或刷新页面）。

host 侧注册了什么

什么都没注册。 host 半是故意空的（lib/index.js 只有一个 apply() 打一行启动标记）：

• 不注册工具、不注册服务、不读文件、不起进程、不建网络连接
• 数据全在浏览器 localStorage，定时也全在浏览器
• host 半被加载之后不做任何事 —— profile 与它的关系只是"这个包在 bundles 里"

原则是把复杂度压到最小：会话头部的一个时间模块，不该为了"更稳"而拖出一条宿主侧的数据通道。

可选升级路线（当前故意不做）

下面几条都是讨论过、明确决定先不做的方向。记在这里是因为它们各有真实代价 —— 将来真要做时照这张表决策，别凭感觉加。

别做半迁移。 只把某一类提醒搬到宿主侧、另一类留在 localStorage，结果是两个真相源 + "为什么这条留下了那条没了"的困惑。要做就整库一起搬。

设计上值得一提的三处

一、面板挂在模块自己的容器上，且右对齐。 不是开一个全屏 overlay，而是 「模块 + 下拉面板」包在同一个 position: relative 的容器里，面板绝对定位到它 —— 跟着模块走，不需要算坐标。用 right: 0 而不是 left: 0：模块在会话头部右侧， 往右展开会顶出窗口（实测溢出 127px）。

二、滚轮的对齐靠几何保证，不靠 margin 凑。 列高 = 可见行数 × 行高（3 × 24px）， 中间那一行天然落在列的正中，而高亮条也画在列的正中 —— 两者必然重合。 （早先用 margin-top 把首行往下推，本来就偏 10px；再叠上一条被上一行孤儿声明吃掉的 .ck-picker 规则，整块滚轮就退化成了上下两坨。）

三、会话事件窗口要「订阅」而不是「读一次」。 「距你上次发消息」取自 sessions.binding(sessionId).eventSource。 实测它第一次 getSnapshot() 拿到的 entries 是空数组，要 subscribe() 等事件填进来。 用户消息的事件名是 user/message。 拿不到就整行隐藏 —— 不编假数据。

已知限制

• 数据活不过一次 DSH 重启。 提醒与倒计时存在浏览器 localStorage， 而 localStorage 的隔离键是 scheme + host + 端口；桌面壳每次启动都用 --port 0 （OS 随机分配端口）→ 重启之后 origin 变了，这些数据就读不到。 这是 2026-09-19 当面确认的定位：它就是"会话内的短期提醒"，不承担跨重启持久化 —— 真要做，就不止是个 DSH 插件了（要 host 半存盘 + 定时 + 系统级提醒）。 刷新页面不影响。
• 「距你上次发消息」依赖 DSH 客户端内部接口（sessions 服务 + 会话事件流）。 接口若变，这一行会安静地消失，不影响其余功能。
• 不含系统通知。到点提醒只有界面内的呼吸灯与浮条 —— 页面不在前台时会错过。

许可

MIT