前言¶
DeepSeek Harness（DSH）的扩展能力通常以插件形式接入。dsh-monitor 面向其中一类具体需求：外部消息、通知或日志在 agent 空闲期间到达时，让 agent 能被及时唤醒。
如果希望在 DSH 中实现类似 Claude Code Monitor 的能力，dsh-monitor 提供了一个插件化路径：为消息源建立持续后台 watcher，在新内容到达时唤醒 owning agent。
这是什么¶
dsh-monitor 是 AbnerAI 维护的 DeepSeek Harness 插件，许可证为 MIT。
它把“监视消息源并唤醒 agent”做成 DSH 插件能力。插件提供 monitor、monitor_list 和 monitor_stop 三个工具，用于创建、查看和停止 watcher。
支持两类消息源：
source: file：监视一个 append-only NDJSON inbox；source: command：按间隔重跑 shell command，并投递输出差量。
核心功能¶
持续监视消息源¶
插件可以在消息源上建立 persistent, background watchers。
watcher 在会话内持续有效，可以在需要时手动停止，也会在插件卸载时自动清理。
新内容到达时唤醒 agent¶
当有新内容到达时，插件会唤醒 owning agent。
根据 agent 当前状态，唤醒方式不同：
- idle agent 使用
agent.followup()； - busy agent 使用
agent.inject()。
这意味着新消息不只是被记录，而是进入当前会话并触发 agent 后续处理。
支持 NDJSON inbox¶
使用 source: file 时，插件监视一个 append-only NDJSON inbox。
写入新的一行后，插件会把新内容交给 agent，用于触发后续处理。
支持命令输出差量¶
使用 source: command 时，插件按 poll_interval_ms 间隔重跑 shell command，并投递自上次运行以来的输出差量。
安装与启用¶
先确认运行环境满足要求：需要 DeepSeek Harness（dsh），并且具备 Cordis-based plugin loader，支持 bundles / cordis.patch.yml。
插件的 peer dependencies 包括：
dsh-agent
dsh-llm
dsh-tools
cordis
这些依赖由 harness runtime 满足。
从 npm 安装时，可以执行：
npx @deepseek-ai/dsh@latest plugin --profile web add dsh-monitor
如果从 git 地址安装，可以执行：
npx @deepseek-ai/dsh@latest plugin --profile web add https://github.com/AbnerAI/dsh-monitor
如果从本地目录安装，先在该包目录内执行：
pnpm install
再执行：
npx @deepseek-ai/dsh@latest plugin --profile web add /path/to/dsh-monitor
本地目录安装方式适用于已经在本机准备 dsh-monitor 包的情况。前面的 pnpm install 用于先解决包自身依赖。
典型用法¶
监视 NDJSON inbox¶
告诉 agent 对一个 inbox 文件建立 watcher：
monitor(source="file",
path="/absolute/path/to/inbox.ndjson",
name="my-inbox",
poll_interval_ms=1000)
这里 source 指定为 file。path 必须是绝对路径，或以 ~ 开头。poll_interval_ms 默认是 2000。
工具会返回一个 watcher id，例如 monitor-1。之后每有新行写入该文件，插件都会唤醒 agent。
NDJSON 示例行：
{"content":"hello","ts":1712345678}
查看和停止 watcher¶
查看当前已建立的 watcher：
monitor_list
按 id 停止一个 watcher：
monitor_stop(id="monitor-1")
监视命令输出¶
如果目标不是文件，而是命令每次重跑后变化的输出，可以使用：
monitor(source="command", command="tail -n 5 /var/log/app.log", poll_interval_ms=5000)
这里 source 指定为 command，插件按 5000ms 间隔重跑命令，并投递输出差量。
适用场景与注意¶
dsh-monitor 适合需要让 DSH agent 对外部入站消息保持响应的场景，例如：
- 消息或通知 broker 向 append-only NDJSON 文件写入记录；
- 日志文件持续增长，需要按间隔检查命令输出变化；
- agent 在等待外部输入时，希望新消息能直接唤醒它。
使用前需要特别注意：插件运行在当前 dsh 进程权限内，安装前应检查源码、依赖和许可证。
已核实信息中的许可证为 MIT。path 参数必须可解析为绝对路径；poll_interval_ms 决定轮询频率，默认值是 2000。
结尾¶
dsh-monitor 的价值，是把“持续监视消息源”变成 DSH 会话中可建立、可查看、可停止的能力，并在新消息到达时唤醒 agent。
插件目录页：https://www.skillhub.cn/plugins/AbnerAI/dsh-monitor
GitHub：https://github.com/AbnerAI/dsh-monitor
