DSH Plugins
返回列表
⚙️

dsh-watch-kit-plugin

工作流 更新于 2026.10.29

在终端中运行以下命令:

dsh plugin install rokyaria/dsh-watch-kit-plugin

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中通过插件页或 plugin_manager 安装,也可执行 dsh plugin install rokyaria/dsh-watch-kit-plugin,源码仓库为 https://github.com/rokyaria/dsh-watch-kit-plugin。

插件介绍

如果你希望 DeepSeek Harness 在后台替你「盯着」邮箱、脚本或自定义条件,又不想每隔几分钟就发起一轮空对话、白白消耗 token,这类需求正是 dsh-watch-kit-plugin 要解决的。它不是系统 cron,也不是 OS 通知中心,而是嵌在 DSH 生命周期里的调度器:按 watches.json 里配置的间隔到期运行 checker,只有 checker 在 stdout 里明确返回 notify:true 时,才会向指定会话投递 [WATCH 通知] 并唤醒 agent;无事可报时保持静默,零 token、零对话。

核心能力围绕「少契约、可观测」展开。配置与用户级 $DSH_HOME/watch/ 下的 SQLite 数据库是运行事实源;你编辑 JSON 后自行发送一次 /watch-reload 即可同步(agent 不能代发)。同一轮同一目标会话的多条通知会合并成一条消息,stdout 只承载唤醒信号与摘要,大结果应由 checker 写入文件。插件提供 watch_runs 查看运行、通知与失败统计,watch_sessions 便于为 watch 指定 target。随包可选 mailbox 扩展则把常见「来信提醒 + agent 处理」场景封装成 preset,无需从零写 IMAP checker。

适合已经日常使用 DSH、且愿意用一份 JSON 描述「查什么、多久查一次、通知到哪条会话」的用户。自定义 checker 可以是 Python、Node 或脚本(argv 直 exec、不经过 shell),是否「只在变化时提醒」、去重与重试逻辑由 checker 自己维护状态——插件负责调度、契约校验与投递,而不是替你实现业务规则。需要跨机器高可用或 OS 级沙箱隔离的场景,应另选架构;在本机、单用户、与 agent 工作流紧耦合的巡检与事件唤醒,则是它的主场。

使用场景

  • 按固定间隔运行自定义 checker,仅在 notify:true 时向会话投递通知并唤醒 agent
  • 用随包 mailbox preset 监控 IMAP 新信与待处理邮件,让 agent 按 skill 处理来信
  • 通过 watch_runs 观察 invoke、通知与投递失败,用 checker 自管状态实现「有变化才提醒」

适合人员

  • 已在日常使用 DSH、希望后台巡检但不空耗 token 的用户
  • 愿意维护 watches.json 与 checker 契约的开发者或 power user
  • 需要会话级邮件/脚本/条件提醒并与 agent 工作流衔接的团队或个人