原生 dsh 插件：把闹钟调度提升到宿主进程层级——`$DSH_HOME/proactive/` 下的持久化闹钟、冷会话唤醒、墓碑折叠式静默收尾、免打扰与每日投递预算，以及两端 SSE 实时同步的面板。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-10
许可证
作者未说明
01它能帮你完成什么？
让模型自己设定后续跟进，使任务在会话早已冷却、页面早已关闭之后仍能准时恢复
宿主级闹钟（once / every / cron / 文件表）到点唤醒目标会话跑完一轮，跑完即释放句柄
在 DeepSeek Harness 里运行长周期或无人值守 agent、需要它自己回头检查的人
避免自主唤醒打扰用户
`proactive_reclaim` 静默收尾，把整轮唤醒折叠成约 70B 的墓碑；另有免打扰时段与每日投递预算
想要主动型 agent、但不希望被意外通知打断或污染长期上下文的团队
02如何接入 DeepSeek Harness？
前置条件
- dsh 0.2.0-rc.1 及以上——在更早的 0.1.x 上会被 dsh 的 peer 检查跳过、插件根本不加载
- 一个 `web` profile（README 用 `--profile web` 安装）
安装步骤
- 01
从 npm 安装：`dsh plugin --profile web add dsh-proactive`
$ dsh plugin --profile web add dsh-proactive
- 02
或从 monorepo 子目录安装：`dsh plugin --profile web add github:john-walks-slow/dsh-proactive#path:/packages/dsh-proactive`——建议钉住 commit（`#<sha>&path:/packages/dsh-proactive`），首次 add 被 pnpm 拦截时把提示的包名加入 `~/.dsh/profiles/web/pnpm-workspace.yaml` 的 `allowBuilds` 后重跑
$ dsh plugin --profile web add github:john-walks-slow/dsh-proactive#path:/packages/dsh-proactive
验证接入成功
- 打开会话页的“主动唤醒”Tab 或设置页控制中心——两端都通过 `/api/dsh-proactive/events` 的 SSE 实时同步
- 对新闹钟点“立即触发”按钮，调测真实唤醒下的表现
03DSH 适配与能力边界
原生宿主级 dsh 插件：包内自带 `dsh.bundle.patch`，`dsh plugin add` 后 dsh loader 会自动挂载 `cordis.patch.yml`，无需手工改 profile。它为每个 root agent 注册宿主级工具（`proactive_set`、`proactive_list`、`proactive_update`、`proactive_cancel`、`proactive_update_settings`、`proactive_reclaim`）。
宿主级闹钟调度
`proactive_set`，时间选择器五选一：`at` / `after_seconds` / `every_seconds` / `cron` / `schedule_file`，另有抖动、免打扰与目标模式→落在 `$DSH_HOME/proactive/` 的持久化闹钟，服务重启后自动恢复
`every` 需 ≥300s，`cron` 相邻触发需 ≥300s`jitter_seconds` 在每次触发时追加 `uniform(0, jitter)` 抖动，避免整点扎堆静默唤醒与墓碑折叠
模型判断无事可报的唤醒回合→以 `proactive_reclaim` 作为唯一动作——不输出可见文本，整轮折叠成约 70B 的单行墓碑，人类可读日志仍保留全部轨迹
该回合不消耗每日可见消息额度文件表闹钟句柄
指向单个绝对 JSON 路径的 `schedule_file`→由文件条目派生的子闹钟——写文件即可增删改，幂等且重启自愈
一个文件只允许一个句柄；文件是条目的唯一真源，删文件等于撤销该计划原子写是硬契约：写临时文件再 rename，不要直接 delete 再 create基于 SSE 的实时面板
`/api/dsh-proactive/events` 服务端事件→会话页“主动唤醒”Tab（清单、历史审计、新建/暂停/恢复/编辑/立即触发）与设置页的全宿主控制中心
全局护栏集中在这里：总开关、每日投递限额、夜间免打扰时段、新建闹钟默认 prompt
04适合谁？何时不该用？
适合
- 在 DeepSeek Harness 里运行长周期或无人值守 agent、需要它自己回头检查的人
- 想要主动型 agent、但不希望被意外通知打断或污染长期上下文的团队
不适合
- 在 dsh 0.1.x 上装本版本会被 peer 检查跳过、插件根本不加载；那些部署请继续用 `dsh-proactive@0.2.3`。
- 从 0.2.x 升级：旧的 `config.scheduleFiles` 全局 glob 已删除，每个文件必须各建一个句柄（停 dsh 后跑 `scripts/migrate-schedule-files.mjs`，或用 `proactive_set` / 面板逐个建），否则这些时间表文件不再产生闹钟，旧机制留下的 `decl_*` 闹钟会被当孤儿清掉。
- 句柄未给任何 `target_*` 时，只接受“文件的祖父目录恰好是一个已注册 workspace”这一约定，否则闭式报错并要求显式传 `target_workspace_path` / `target_session_id`。
05兼容性、维护与安全提示
- 在 dsh 0.1.x 上装本版本会被 peer 检查跳过、插件根本不加载；那些部署请继续用 `dsh-proactive@0.2.3`。
- 从 0.2.x 升级：旧的 `config.scheduleFiles` 全局 glob 已删除，每个文件必须各建一个句柄（停 dsh 后跑 `scripts/migrate-schedule-files.mjs`，或用 `proactive_set` / 面板逐个建），否则这些时间表文件不再产生闹钟，旧机制留下的 `decl_*` 闹钟会被当孤儿清掉。
- 句柄未给任何 `target_*` 时，只接受“文件的祖父目录恰好是一个已注册 workspace”这一约定，否则闭式报错并要求显式传 `target_workspace_path` / `target_session_id`。
- 插件自身绝不发起任何外部网络请求；面板依赖 `/api/dsh-proactive/*` 下的本地 dsh 服务，除文件表句柄显式声明的单个 JSON 路径外，所有写操作都严格局限于 `$DSH_HOME/proactive/`。
README 声明 MIT（facts pack 的 license 字段为空）· 未发布 GitHub Release（latest_release 为空）
06常见问题
它和会话内定时器有什么不同？
会话内定时器的生命周期绑定前端或会话句柄，会话冷却、页面关闭或进程回收就会失效。dsh-proactive 把调度提升到宿主进程，数据持久化于 `$DSH_HOME/proactive/`，到点通过 `resume` 唤醒冷会话，跑完即释放句柄，服务重启自愈。
支持哪些 dsh 版本？
当前版本面向 dsh 0.2.0-rc.1 及以上。更早的 0.1.x 上会被 dsh 的 peer 检查跳过、插件根本不加载，那些部署请改用 `dsh-proactive@0.2.3`。
主动唤醒会不会一直弹消息打扰我？
无事可报时模型可以把 `proactive_reclaim` 作为唯一动作：不输出任何可见文本，整轮在模型可见上下文里折叠成一行约 70B 的墓碑。免打扰时段可直接跳过触发，每日投递预算也会限制可见消息数量。
装完还需要手工改 profile 吗？
不需要。包内自带 `dsh.bundle.patch`，`dsh plugin add` 之后 dsh loader 会自动挂载 `cordis.patch.yml`。
文件表闹钟是什么？
它是单个绝对路径 JSON 时间表文件的句柄（`type: "file"`），本身永不触发，而是把文件里的条目同步成自己名下的子闹钟；子闹钟就是普通闹钟，走同一条调度、计费与重试路径。
07相关的 DSH 工作流
archify
作者 tt-a1i
为编码智能体生成美观可验证的架构图、时序图与数据流图，输出自包含 HTML，支持动效与清晰导出。
openviking
作者 volcengine
为 AI 智能体打造的自进化上下文数据库，统一智能体记忆、知识 RAG 与技能。
aitoearn
作者 yikart
面向抖音、快手、小红书和视频号的 AI 内容发布工作流，提供相关平台与 MCP 工具集成。
learn-harness-engineering
作者 walkinglabs
Harness 工程新手教程，从 0 到 1 系统学习智能体工作流框架。
08数据与来源
安装即生效：包内自带 `dsh.bundle.patch`，dsh loader 自动挂载 `cordis.patch.yml`，无需手工改 profile 配置。
插件为每个 root agent 注册以下 host 级工具（冷唤醒会话与普通日常会话均完全可用）：
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-11-10。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。