dsh-reactor:让 DeepSeek Harness 的 Agent 主动值守的事件驱动运行时
snhna-a/dsh-reactor
dsh-reactor 是 DeepSeek Harness 的事件驱动自动化插件,通过轮询、文件监听、命令与 webhook 触发条件判断,自动拉起隔离 Agent 会话自主完成任务。
dsh-reactor 是给 DeepSeek Harness 加装事件驱动能力的自动化插件,把只会按需应答的 Agent 变成持续值守的守护进程。它先由事件源感知变化,再用 JSONPath 与运算符评估条件,确认值得行动后才在隔离会话中启动 Agent 自主完成目标。相比固定时间表跑脚本的做法,它多了确定性校验、失败分类与智能重试,并用预算闸门、审批门与冷却机制兜住风险,每次决策链都留痕可查。
如何安装
dsh plugin --profile web add github:snhna-a/dsh-reactor- 分类
- 工具与能力
- 平台
- DSH Plugin
- 作者
- snhna-a
- 分发方式
- 插件
dsh-reactor 核心特性
dsh-reactor 仓库简介
它是做什么的?
Reactor 是 DeepSeek Harness(DSH)的事件驱动自动化插件,把按需应答的 Agent 变成主动值守的守护进程。它解决传统定时任务「到点就跑、不看条件、跑完不管」的问题:先由事件源感知变化,再评估条件,最后才决定是否行动。插件由 snhna-a 维护,采用 MIT 协议,用 TypeScript 编写,最近更新于 2026-09。
核心功能
- 事件源接入:支持 HTTP 轮询、本地文件监听、命令输出解析与外部 webhook 推送四类触发方式。
- 条件评估:用 JSONPath 取值,配合 eq/ne/gt/contains/exists/changed 等运算符与 AND/OR 组合判断是否真正需要行动。
- Goal 模式执行:把目标与事件上下文注入隔离的 Agent 会话,由 LLM 自主读文件、跑命令、验证并修复,而不是执行固定脚本。
- 确定性校验与重试:Agent 结束后检查文件是否存在、命令退出码等硬指标,并对失败自动分类、对瞬时错误智能重试一次。
- 安全护栏:预算闸门限制每日运行次数与 token 上限,高风险动作需人工审批,另有冷却与并发重叠保护。
- 运行留痕:完整记录 Run Trace 决策链,并把上次摘要注入下一次运行以延续任务。
怎么使用这个插件?
在 DSH 中启用后,直接用自然语言描述目标即可,例如「监听部署文件的 version 字段,变化时发 webhook 告警」,Agent 会调用 reactor_define 建好规则并在后台持续运行。规则可覆盖轮询状态接口、监听本地文件、定时执行命令并分析输出等场景;需要调整时修改对应规则的事件源、条件或执行模式即可。DSH Web 右下角会出现时钟主题的悬浮组件,可拖拽吸附到任意边角、缩放并打开半透明设置面板,触发时给出提醒。
报错怎么排查?
规则没有按预期触发时,先确认事件源是否真的产生了变化,再检查条件表达式里的 JSONPath 路径与运算符是否匹配实际数据结构。若运行被拦截,多半是命中了预算闸门、冷却窗口或并发重叠保护,可放宽对应限制后重试;被标记为高风险的动作需要等待人工审批。Agent 执行失败时查看 Run Trace 里的失败分类:瞬时错误会自动重试一次,可修复类错误需按提示补齐工作区、文件或网络前置条件。
本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准:snhna-a/dsh-reactor。插件是安装时就在你机器上运行的第三方代码;收录不代表背书——安装前请自行审阅源码。
DSH Plugin 常见问题
