角色唤醒计时器 2huy4n/roleplaytimer

roleplaytimer

让 DSH 的角色扮演智能体在用户长时间沉默后主动开口。

它做什么

用户沉默达到设定时长后，插件向该会话投递一条 user 角色的 follow-up 消息，内容由可编辑的「唤醒提示词」渲染而成。智能体被唤醒后按角色卡继续以角色身份发言，而不是等待用户输入。

投递走 DSH 的正式接缝 agent.followup()，并只在智能体处于空闲时通过
agent.runMaintenance() 投递——不会打断正在进行的回合。

唤醒时刻不是死板的定时器：可以设一个模糊区间，实际唤醒在其中随机发生。
例如间隔 180 分钟 + 模糊 30 分钟 → 真实唤醒落在 150~210 分钟之间。

硬约束

- 必须有活着的根 agent：只有 DSH 应用正在运行、且该会话已打开时才可能投递。
应用关闭期间不投递，也不补发。
- 空闲才投递：用户正在对话时不会插话；runMaintenance 占用中会退避重试。
- 倒计时以最后一次真实用户消息为起点：插件自己的唤醒消息（source.kind = 'plugin'）不计入用户活动。
- 新会话默认静音（opt-in）：唤醒会往用户的历史里写东西，所以插件第一次看到某个会话时默认不唤醒，需要在面板里对该会话点「取消静音」。仅影响首次出现的会话，已有会话保留各自的静音状态。

配置项

| 键 | 默认 | 说明 |
| enabled | false | 总开关 |
| defaultMuted | true | 首次出现的会话是否默认静音（默认不唤醒，须手动取消静音）|
| intervalMinutes | 150 | 用户沉默多久后唤醒一次 |
| jitterMinutes | 0 | 模糊区间（±分钟）：例 间隔 180 + 模糊 30 → 实际在 150~210 分钟内随机唤醒，0 = 精确 |
| dailyMaxWakes | 6 | 每日上限，0 = 不限；次日 00:00 重置 |
| quietStart / quietEnd | 23:30 / 08:00 | 静默时段，跨午夜有效；留空关闭 |
| wakePrompt | 见下 | 唤醒提示词，支持 {minutes} {count} {time} {session_id} |
| debugEnabled | true | 是否显示调试面板 |

调试面板

- 模拟经过时间：+30 / +150 / 自定义分钟数，只改变插件的判断时钟，不动系统时间
- 立即唤醒：绕过计时立刻投递
- 静音 / 取消静音：按会话关闭唤醒（新会话默认已静音，想唤醒谁就对谁点「取消静音」）
- 重置计时：把该会话当作刚刚有用户发言
- 投递日志：最近 20 次投递记录

安装

dsh plugin --profile add "git+https://github.com/2huy4n/roleplaytimer#v0.2.0"

重启 DSH，在「设置」里找到 roleplaytimer 控制面板：勾选「启用主动唤醒」，再对着你想唤醒的会话点「取消静音」。