前言¶
在 DeepSeek Harness(DSH)里跑智能体时,系统告警、邮件、行情、天气等信号往往来自不同模块。若各自实现一套「要不要通知 AI」的逻辑,重复且难维护,还容易把无关信息整批推给模型,污染上下文。社区插件 dsh-softsensor-hub(维护者 SteelUnion,分类:工作流)把这类输入收成一条链路:采集事件、按规则定级、写入事件库,并在该叫醒时叫醒 Agent。插件本身只负责「告诉」,不替 Agent 执行动作;换模型或换策略时不必改插件核心。
这是什么¶
dsh-softsensor-hub 是面向 DSH 的消息中枢与管家框架:事件模型、可热重载的规则引擎、事件存储,以及可插拔采集器;内置系统监控在插件进程内运行,不依赖外部守护进程。当前版本 0.6.3(MIT 许可),README 标明依赖 dsh ≥ 0.2.0-rc.1,测试套件约 799 项(除需邮件凭据的端到端外均可跑通)。
SkillHub 目录页:https://www.skillhub.cn/plugins/SteelUnion/dsh-softsensor-hub
源码:https://github.com/SteelUnion/dsh-softsensor-hub
核心功能¶
判轻重与投递策略¶
采集器产出事件(磁盘、内存、邮件、行情、天气等)后,规则引擎为事件定级,再决定如何对待 Agent:
采集器产出事件
↓
按规则定级
↓
critical ──→ 立刻叫醒 AI
warn ──→ 攒一批,凑够再叫
info ──→ 只留档,不打扰
↓
存进事件库(可回溯、可查询)
默认策略与上表一致:critical 立即通知,warn 批量后再通知,info 仅存档。规则可配置;插件不产生业务动作,只产出「该不该说」的判断。
四个内置采集器¶
| 采集器 | 作用 | 默认 |
|---|---|---|
system |
内存、磁盘、事件循环延迟 | 开 |
weather |
天气,按城市或 IP 定位 | 开 |
mail |
IMAP 收邮件 | 关 |
finance |
读量化库,产行情事件 | 关 |
采集器在插件进程内运行。README 说明:若采集依赖外部进程,进程退出后采集会静默中断;本插件设计为进程内运行以避免该问题。
配置与数据目录¶
首次启动会从 config.template.json 复制 config.json;配置里值为 null 的项待填写,旁有 _xxx说明 字段提示。装完后建议跑一次配置向导:能自证的项会自动标记,其余由用户选择。详细步骤见仓库内 INSTALL.md。
安装目录即默认数据目录(卸载前宜备份整个目录)。也可在 config.json 中修改 root 指向其他路径。典型布局如下:
dsh-softsensor-hub\
├── config.json 你的配置
├── logs\ 所有日志
├── inbox\ archive\ 消息队列
├── peers\ 对端登记
├── data\ 事件库、凭据库
└── lib\ test\ schema\ 代码与测试
日志位于 logs\,一行一条 JSON;排错可先查看 logs\errors.jsonl。各日志文件含义见 INSTALL.md 第五节。
安装与启用¶
下面命令来自项目 README(PowerShell 示例;在其它 shell 中可保留 npx 与 dsh plugin 参数,按本机 DSH 文档调整 profile):
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:SteelUnion/dsh-softsensor-hub
安装完成后重启 DSH,再按上文完成 config.json 与配置向导。
典型用法与场景¶
| 场景 | 没有中枢时 | 有 dsh-softsensor-hub 时 |
|---|---|---|
| 磁盘满 / 内存告警 | Agent 可能继续任务而不知资源已告急 | 按级别通知 Agent,便于先收手或调整 |
| 重要邮件 | 需人工翻收件箱 | Agent 可收到摘要并参与判断 |
| 行情异动 | 需持续盯屏 | 满足条件才通知,减少刷屏 |
| 大量低价值通知 | 易全部进入上下文 | 分级过滤,只推送该说的内容 |
插件以 只读设计 为取向(见 package.json 描述):统一收件与分级,不把「替 Agent 动手」写死在插件里。
适用场景与注意¶
适合已在 DSH 中运行 Agent、并希望把系统、邮件、天气、行情等外部信号纳入同一事件与规则管线的开发者。DSH 生态理念是「一切皆插件」;SkillHub 等为社区目录站点,与 DeepSeek / 幻方无官方从属关系,安装来源以目录页与 GitHub 为准。
权限与安全:插件与采集器在 当前 DSH 进程权限 下运行,可访问其配置允许的资源(含 IMAP、本地磁盘与内存指标等)。安装前应阅读源码与 MIT 许可证,确认配置项与凭据存放方式(data\ 等)符合你的安全策略;邮件等端到端能力需自行提供凭据,README 中相关测试亦依赖真实凭据。
0.6.3 版本说明:行为未改,主要为开源清单补充 SECURITY.md、Dependabot 配置与 package-lock.json。
结尾¶
dsh-softsensor-hub 把「收消息 → 定级 → 存库 → 按需叫醒 Agent」收拢到一套可热重载、可插拔采集器的框架里,并强调进程内采集与只读告知,便于在 DSH 工作流中减少重复投递逻辑与上下文噪声。