roleplaytimer

Roleplaytimer

Proactive wake-up plugin for DeepSeek Harness: periodically simulates a user message so a roleplay agent speaks first.

Target profile

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add github:2huy4n/roleplaytimer#da6f1d121e115194afe3c8f5d53344f6579ddb56

Compatibility and provenance

Roleplaytimer is published as roleplaytimer and currently resolves to version 0.2.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility: *
Runtime surfaces: web
Release source: github
Registry updated: 9/23/2026

Versions

0.2.0stable

9/23/2026

0.1.1stable

9/23/2026

README

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 控制面板：勾选「启用主动唤醒」，再对着你想唤醒的会话点「取消静音」。

README

roleplaytimer

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

它做什么

投递走 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 控制面板：勾选「启用主动唤醒」，再对着你想唤醒的会话点「取消静音」。

Roleplaytimer

Compatibility and provenance

Versions

Related plugins

Roleplaytimer

README

roleplaytimer

它做什么

硬约束

配置项

调试面板

安装

Compatibility and provenance

Versions

Related plugins

Related plugins

Related plugins

README

roleplaytimer

它做什么

硬约束

配置项

调试面板

安装