dsh-proactive (dsh-proactive)
john-walks-slow/dsh-proactive/packages/dsh-proactive
Host-level proactive wake-ups for DeepSeek Harness: the model schedules its own alarms (once, recurring interval, or cron, with optional random jitter), cold sessions are woken on time by session resume, model-initiated follow-ups are gated by quiet hours and a daily delivery budget, silent wake turns end with proactive_silence and are folded out of model context as tombstones, and a web panel (settings section plus per-session tab, SSE live refresh) manages alarms and wake history.
Установка
dsh plugin --profile web add github:john-walks-slow/dsh-proactiveЭтот плагин находится в подкаталоге packages/dsh-proactive репозитория.
README
dsh-proactive
让 DeepSeek Harness（DSH）的模型主动跟进：模型给自己设定 host 级闹钟，到点由宿主唤醒目标会话执行一轮——即使会话早已冷却、页面早已关闭也会按时触发；无事可做的唤醒回合可以静默收尾并自动折叠，用户完全无感知。
你会看到什么
- 定时提醒：到点唤醒会话，模型按闹钟指令产出一条正常的聊天回复，按 DSH 既有投递规则送达（接了 IM 私聊的会话自动送达私聊，Web 会话内正常出现）。
- 静默心跳：没有值得打扰用户的事时，模型调用
proactive_silence静默收尾——不产生任何可见消息，整次唤醒交换被折叠成模型侧一枚小墓碑（[dsh-proactive silent wake <id> <时间>]），不污染长上下文。 - Web 管理面板：设置页出现「主动唤醒」节（全局配置 + 所有会话的闹钟表格），每个会话页多一个「主动唤醒」tab（本会话闹钟与唤醒历史），SSE 实时刷新。
闹钟模型
- 三种类型：
once（单次）/every（循环间隔）/cron（五字段表达式），统一支持jitter_seconds随机延迟。 - 一个开关：
respect_quiet_hours——false（默认）为用户委托提醒：安静时段照常触发、不占日预算；true为模型自主跟进：遵从安静时段与每日投递预算。 - 三种目标：
resume（既有会话，默认）/fork（从源会话分支）/new（新建空会话）。
安装
npm（预构建，推荐）：
dsh plugin --profile web add dsh-proactive
GitHub 源码安装（monorepo 子目录；pnpm ≥10 需允许构建脚本）：
dsh plugin --profile web add github:john-walks-slow/dsh-proactive#path:/packages/dsh-proactive
# 建议钉住 commit：github:john-walks-slow/dsh-proactive#<sha>&path:/packages/dsh-proactive
# 首次 add 会被 pnpm 拦截：把 pnpm 提示的包名加入
# ~/.dsh/profiles/web/pnpm-workspace.yaml 的 allowBuilds 后重跑
完整配置、GUI 面板、工具清单与行为细节见 packages/dsh-proactive/README.md。
权限与兼容
- 定时唤醒：插件在宿主侧持有调度器（单定时器重臂），到点会唤醒目标会话执行一轮；服务重启后闹钟从
$DSH_HOME/proactive/恢复。 - 通知渠道：无推送服务、无外部集成——唤醒回合的可见回复走 DSH 正常消息投递；
proactive_silence回合零投递。 - 网络请求：插件自身不发起任何外部网络请求；管理面板的 HTTP/SSE 路由（
/api/dsh-proactive/*）只挂在本地 dsh webserver 上；唤醒回合由 dsh 按用户已配置的 LLM 网关正常调用。 - 文件写入：仅
$DSH_HOME/proactive/（alarms.json / runs.jsonl / state.json / config.json）。
目录结构
packages/dsh-proactive/— 插件源码、测试与构建产物（lib/），npm 包dsh-proactivedocs/— 特性与问题记录
License
MIT