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 <profile> add "git+https://github.com/2huy4n/roleplaytimer#v0.2.0"

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