dsh-cmdwatch
命令窗：实时显示 dsh 发起的命令内容与执行输出，无需暂停对话即可查看进度。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:GavinQiEr/dsh-cmdwatch#779cd37d5be799082166565b55d0eb936f3335f7Cmdwatch 以 dsh-cmdwatch 发布，当前版本为 0.4.8。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
实时显示 dsh 发起的命令内容与执行输出，无需暂停对话即可查看前后台执行进度。
DSH Target：>=0.1.0-rc.6 <0.2.0（已在 0.1.1-rc.2 验证）
DSH 目前处于 developer preview，官方明示会有破坏性变更（breaking changes）。 本插件兼容区间与版本跟进记录见
CHANGELOG.md。
dsh plugin --profile web add github:GavinQiEr/dsh-cmdwatch
dsh不在 PATH 时，用npx '@deepseek-ai/dsh' plugin --profile web add ...代替。
安装后重启 web profile（dsh web），输入框上方会出现「命令监视」面板。
| 方式 | 命令 |
|---|---|
| npm 包 | dsh plugin --profile web add dsh-cmdwatch |
| git 仓库（完整 URL） | dsh plugin --profile web add https://github.com/GavinQiEr/dsh-cmdwatch.git |
| 指定分支/提交 | dsh plugin --profile web add github:GavinQiEr/dsh-cmdwatch#main |
| 本地目录（开发调试） | dsh plugin --profile web add /path/to/dsh-cmdwatch |
| tarball 打包 | dsh plugin --profile web add ./dsh-cmdwatch-0.3.2.tgz |
npm 方式需先
npm publish（见下方构建说明）；未发布前请用 git / 本地目录 / tarball 方式。
run_in_background: true）：实时进度流——命令行、进度、状态、时间逐行滚动，点击展开完整输出Tee/tee 把输出落盘后轮询；带 Select-Object -Last 等管道时 Tee 插在管道之前，工具结果语义不变）| Select-Object -Last N、
| tail -n N）或输出重定向（| Out-File、>）等阻断实时流的段，插件自动
插入 Tee-Object/tee（插在最早的此类段之前）并注入 PYTHONUNBUFFERED，
面板实时显示全量进度、原管道语义完全保留（-Last N 仍只回最后 N 行、
Out-File 照常写文件）；面板显示 改 徽标与原始命令，检测到无法处理的情况
（如 -First/head）显示黄色 ⚠ 警示| 执行方式 | 实时进度 | 说明 |
|---|---|---|
后台任务 run_in_background: true | ✅ 实时滚动 | 无收集/重定向段时走 jobs 官方通道抢读；有此类段时插件插 Tee 落盘并轮询文件，长命令（pytest、构建、脚本）推荐 |
| 前台命令（默认） | ✅ 实时滚动（Tee 捕获） | 插件插入 Tee-Object/tee 落盘并轮询，输出实时显示；Tee 插在收集/重定向段之前，工具结果保持原样（如 -Last 3 仍只回最后 3 行） |
要实时看进度（如 pytest），两种方式都可以：
# 前台（默认）：插件自动插 Tee，面板实时滚动，dsh 拿到的结果不变
python -m pytest tests/... -q
⚠️ 插件会在命令执行前自动插入
Tee-Object/tee（pwsh/bash），输出落盘到 工作区/临时目录的.cmdmon-<callId>.log，插件轮询该文件实现实时显示；命令 完成后自动删除日志。Tee 插在最早的收集型/输出重定向段之前——面板看到全量 渐进输出，而 dsh 的原管道（-Last、Out-File、Get-Content等）原样保留、 工具结果零改变。面板上被包装的记录带改徽标（悬停看原始命令）与「实时」 徽标。若不想让插件包装命令，可设rewrite: false（后台）或foregroundStream: false（前台，回退到"完成后显示"）。
| 配置项 | 默认 | 说明 |
|---|---|---|
rewrite | true | 后台命令存在收集/重定向段时插入 Tee 实时输出 |
pythonUnbuffered | true | 命中 python 时注入 PYTHONUNBUFFERED（避免块缓冲） |
foregroundStream | true | 前台命令插入 Tee 落盘并实时显示 |
warn | true | 面板警示收集型/重定向/提前终止型管道 |
debug | false | 向宿主终端输出 [cmdmon] 诊断日志（排查用） |
在 cordis.patch.yml 的插件行加 config 即可：
- insert:
- id: dsh-cmdwatch
name: dsh-cmdwatch
config:
rewrite: false # 例：只警示，不自动改写
npm install
npm run build:client # esbuild 打包 client/index.jsx → client/client.js
npm test # 单测 lib/rewrite.js 命令净化逻辑（20 用例）
npm pack # 产出 dsh-cmdwatch-0.3.2.tgz
发布到 npm（可选，便于收录与安装）：
npm login
npm publish # 发布 dsh-cmdwatch
job_output
工具将读到空增量（(no new output)）——这是设计取舍：插件替你盯着输出，
无需暂停对话让 dsh 查进度。需要 dsh 亲自读输出时，先关掉面板上的「实时流」。tools/execute 阶段、权限检查（tools/pre-execute）之后改写命令
——只插入 Tee 管道（落盘日志）并注入环境变量，不改变运行的程序、参数与
原管道语义（-Last、Out-File、Get-Content 等工具结果不变）。started background job ...）与带「任务」标签的任务行——实时输出只进
任务行（无管道时走 jobs 通道、有管道时走 Tee 日志），展开任务行查看。前台
命令只有一条工具记录，执行中实时输出就在该行（带「实时」徽标），完成后日志
文件自动删除。debug: true 看宿主终端 [cmdmon] 日志，或直接读
/cmdmon/snapshot 的 diagEvents；面板展开行也会给出诊断提示。MIT