dsh-tool-monitor
针对现有 DeepSeek Harness 后台任务的事件驱动监控
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:yoke233/dsh-tool-monitor#244e8eb1f4828c2c6cc4eee664b6d895b8e6e315Tool Monitor 以 dsh-tool-monitor 发布，当前版本为 0.1.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh-tool-monitor 通过惰性输出 tee 监听现有 DSH 后台 Job，而不重复执行原命令
让 DeepSeek Harness 在后台服务出错时立即收到事件。
订阅已经运行的 Bash 或 PowerShell Job；保留原始 job_output，不启动第二个业务进程。
快速开始 · 为什么需要它 · 工作方式 · 工具参数 · 兼容性与边界
安装到 DSH profile：
dsh plugin --profile web add github:yoke233/dsh-tool-monitor
启动或重启 profile：
dsh --profile web
先正常启动后台服务：
pwsh(command: "npm run dev", run_in_background: true)
→ pwsh-1
再让 job_monitor 订阅这个 Job：
{
"job_id": "pwsh-1",
"description": "监听后端错误",
"pattern": "error|fatal|exception"
}
→ monitor-1
monitor-1 只订阅 pwsh-1 的输出。出现匹配行时，插件向所属 Agent 投递会话事件；原服务始终只运行一份。
DSH 的普通后台 Job 会在任务结束时通知 Agent，但长期运行的后端服务可能在退出前就已经出现需要处理的错误。这个插件补充运行中的事件通道：
| 行为 | 结果 |
|---|---|
监听现有 job_id | 不重新执行服务命令 |
| 一次读取、多路分发 | Monitor 不会吃掉 job_output 的内容 |
| 惰性启用 tee | 没有 Monitor 的 Job 保持官方读取路径，不被轮询 |
| Host 本地过滤与批处理 | 没有匹配事件时，不触发模型请求 |
| 独立 Monitor 生命周期 | 停止 Monitor 不会终止目标 Job |
Bash / Pwsh background process
│
│ readOutput() once
▼
lazy bounded output tee
┌────────────┴────────────┐
▼ ▼
job_output monitor-N
original output filtered complete lines
│
▼
followup() / inject()
插件使用兼容的 JobRegistry 实现扩展官方 LocalJobRegistry，继续复用 DSH 的所有权隔离、等待、取消、完成通知、容量限制和清理语义。原来的 job_list、job_output、job_kill 以及 Bash/Pwsh 工具保持不变。
完整设计和生命周期约束见 DESIGN.md。
| 参数 | 必填 | 说明 |
|---|---|---|
job_id | 是 | 已有流式后台 Job 的 id，通常来自带 run_in_background: true 的 bash 或 pwsh |
description | 是 | 显示在 Monitor 通知中的简短说明 |
pattern | 否 | JavaScript 正则表达式，逐完整输出行匹配 |
case_sensitive | 否 | 是否区分大小写，默认 false |
timeout_ms | 否 | 订阅时限；默认持续到目标 Job 结束 |
Monitor 本身也是普通 Job：
job_list 同时显示目标 Job 和 Monitor。job_output 分别读取目标 Job 的原始输出和 Monitor 的匹配输出。job_kill monitor-1 只停止订阅。readOutput() 的后台 Job；非流式 Job 会被明确拒绝。job_output 会显示明确提示。pnpm install
pnpm run build
pnpm test
dsh plugin --profile web add ./dsh-tool-monitor
测试覆盖 Bash、PowerShell、原 job_* 工具兼容、输出竞态、所有权隔离、目标结束与独立取消。