@caizhiyuan/dsh-tool-monitor
DeepSeek Harness 插件：后台文件/命令/WebSocket 监视器在有新输出时唤醒所属会话，并通过专用 WebSocket 在 Web 会话标头中显示实时监视器列表。包含宿主核心和 Web 客户端部分，无需构建步骤。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @caizhiyuan/dsh-tool-monitor@0.5.1Tool Monitor 以 @caizhiyuan/dsh-tool-monitor 发布，当前版本为 0.5.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个 dsh-plugin：后台监听文件、命令输出或WebSocket，输出到达时唤醒所属会话，并在 Web 会话头部提供实时监听的列表与输出查看面板。MIT License。
monitor_start 对 file、command 或 ws 发起后台监听，返回 monitor_id 后立即继续。pattern（JS 正则）限定只对匹配输出触发。ws) 模式：
[binary frame, N bytes]，内容不解析透传。1000/1001 → completed；异常如 1006/1011 → failed），方便判断正常还是异常。pattern 过滤），让你看到失败原因。protocols 提供子协议数组，按 WebSocket 规范（RFC 6455）协商子协议。monitor_start — 启动监听。参数：source(file|command|ws)、path/command/url、protocols(ws 子协议数组，可选)、duration_seconds(0=持续到会话/插件停止)、interval_ms(默认3000，对 ws 无意义/忽略)、pattern(正则，仅匹配触发)、initial_snapshot(file 现有内容作为首批)、one_shot(首次触发后自动停止)、max_chars(缓冲尾保留，默认4000)monitor_read(id) — 增量读取（消费游标，同 job_output）monitor_stop(id) — 停止（command 会杀后台进程）monitor_list() — 本会话可见的监听器Map（id 形如 monitor-N），状态词 running / stopped / completed / failed，不写入 ctx.jobs，因此不会出现在框架的「后台任务」列表里。file/command 走轮询 tick；ws 为事件驱动，连接一个出站 WebSocket（ws 包的客户端），text/binary/error/close 各自映射为通知与终态。ctx.get('webServer').registerUpgrade({ path: '/tool-monitor/ws' }) 注册专属 WS 端点，再用 ws 包的 WebSocketServer.handleUpgrade 握手。每次注册表变化（启动 / 停止 / 结束 / 移除）就给该会话的连接推一份 { type:'snapshot', monitors:[...] }；新连接建立先发一次 baseline；loopback 校验拒绝非本地来源；插件卸载时注销路由。/tool-monitor/list（优先走 harness 的 connection.rpc，取不到该服务时回退为同源 fetch 打同一路由，认证随连接走）；不用自有 WebSocket —— 桌面版 UI 跑在 dsh-app: scheme 下，它不是 ws scheme（new WebSocket("dsh-app://…") 会抛错），而启动参数里的 --fetch-schemes=dsh-app 允许 fetch。头部按钮复用框架的 StateDot + IconChevronDownOutlineRegular，图标按名字在运行时探测、取不到就跳过该图标（曾因写了并不存在的 IconChevronDownOutline14，React.createElement(undefined) 在渲染期抛 "Element type is invalid"，导致整个 slot 条目被 abdicate —— 永久退出投影，控件再也不显示），与「后台任务」等控件视觉一致。monitor_read（增量、消费游标）；Web 端点开行时经 /tool-monitor RPC read（保留窗口、非消费）。输出不随推送下传。UserMessage（source {kind:'plugin:tool-monitor', form:'notice', summary}）。owner 空闲 → 立即 owner.followup(msg) 唤醒；owner 忙 → 通知存入插件自有队列（pending，不进 agent inbox），待该 owner 转为 idle（监听 agent/status）时把队列按 monitor 分组、合并成一条 followup 发出。因此忙时不会被反复打断，也不会因中断/取消丢消息；没有唤醒预算，不会出现"跑几次后不再唤醒"。agent/disposed 或插件卸载会停止其所有监听。本包声明了 dsh.bundle.patch（./cordis.patch.yml），因此它是完整的组合包（bundle）：装进 profile 后会自动成为一层 profile layer 并插入自己，不需要再手工改 profile 的 cordis.patch.yml。
# 1) 从 npm 安装
dsh plugin --profile web add @caizhiyuan/dsh-tool-monitor
# 1b) 或从源码安装（开发用；link 后改源码即生效，宿主改动仍需重启）
dsh plugin --profile web add link:W:/图南/dsh-tool-monitor
# 2) 重启 dsh（宿主模块 + 新 client bundle 生效；client 部分刷新页面加载）
dsh plugin add 会把包名追加进 profiles\web\package.json 的 dsh.profile.bundles，并校验 dsh.bundle.patch 指向的 patch 文件可解析；GUI 里的插件管理器走同一条路径（installBundle）。
若包只声明
dsh.client而没有dsh.bundle，安装会被拒（declares no dsh.bundle），因为 profile 的 layer 栈只接受声明了dsh.bundle.patch的组合包。前提：dsh profile 需已组合
webServer（Web 版默认有）；headless 无webServer时插件仍可用（模型工具正常），只是没有 WS 推送。
lib/index.js — Host 插件：{name:'tool-monitor', inject:[...], Config(zod), apply}；自注册表、每 tick 轮询（file/command）、出站 ws 客户端（source=ws）、忙时排队 + 空闲合并投递、agent/disposed 清理、/tool-monitor/ws 端点、/tool-monitor RPC（read/stop，直接注册在 webServer 前缀路由上，绕开 connection.rpc.handle 在 cordis>=4 的 inject 限制）。lib/client.js — Web 客户端半部（window.__ModuleLoader__ 格式）：会话头部注册 monitor-list（order 30），连自有 WS 收 snapshot，点开查看/停止。cordis.patch.yml — 组合包 patch：dsh.bundle.patch 指向它，内容为把本包 insert 进 profile layer 栈。"type":"module"，纯 ESM / 模块加载器格式）。