DSH Runtime Environment Watch
English | 中文
给 DeepSeek Harness（DSH） 的定时状态巡检插件：不只检查模型的工作环境（cwd、Git、关键文件、工具链），还可以定时检查电脑硬件（CPU、内存、磁盘、电池、GPU、进程、端口、温度）和远程设备/机器人（HTTP JSON、SSH/命令、TCP、文件心跳）。
每条状态都带采集时间、数据年龄、阈值和异常标记；定时器在 Host 里按秒调度，和模型是否有动作无关。
它解决一些大模型（如 deepseekV4.1F1017）在上下文里最常见的两类失误：
- 模型在会话开头跑一次
pwd/git status/node -v，之后默认环境没变； - 模型把第一次检查结果当成永久权威，直到命令失败才回头怀疑。
硬件和机器人状态同理：温度、占用、电量、网络、机器人模式都会变，不能只看一次。
它做什么
- 静态规则：系统提示里只放固定规则（
interpolate: false），说明环境/硬件/远程状态都是带时间戳的快照，最新巡检或工具结果才有效，过期先刷新。没有会变的数值，系统提示前缀保持稳定。 - 定时调度：
CheckScheduler每秒 tick，按每个 check 的intervalSeconds到期执行；结果保存在内存里。配置文件的 mtime 变化会在 5 秒内热加载。 - 模型输入推送：在
agent/pre-step时把最新运行时/硬件/远程状态拼成一条带时间戳的消息放到模型输入尾部；首次、环境重大变化、状态变化、阈值告警或心跳（默认 10 分钟）时推送。 - 工具：
-runtime_env：只看模型工作环境（cwd、Git、关键文件、工具链）。
-status_check：立即跑全部或指定的状态检查，返回运行时 + 硬件 + 远程设备的合并报告。 - 开关：
enabled默认开启。关掉后静态规则、定时检查、两个工具一起停用。
快速开始
从 GitHub 安装
dsh plugin --profile desktop add --allow-build=dsh-runtime-env-watch github:ZachT11/dsh-runtime-env-watch --trust-lockfile
新仓库不足 24 小时时 pnpm 的 minimumReleaseAge 会拦截，所以需要 --trust-lockfile。如果 pnpm 拒绝执行构建，在 profile 的 pnpm-workspace.yaml 加：
allowBuilds:
dsh-runtime-env-watch: true
从本地 checkout 安装
dsh plugin --profile desktop add .\dsh-runtime-env-watch
dsh --profile desktop --dump-config # 可选
重启 DSH 后生效。卸载：
dsh plugin --profile desktop remove dsh-runtime-env-watch
默认行为
没有 runtime-checks.json 时，只跑内置硬件检查：
- CPU 使用率 / 核数
- 内存已用 / 总量
- 系统盘已用 / 剩余
- 开机时长
这些走 Node 的 os / fs.statfs，不需要 PowerShell。
配置检查项
检查项定义在 runtime-checks.json，路径由 checksFile 控制，默认相对于当前 workspace。它是普通 JSON，支持热加载；不要提交带密钥的实际配置，仓库已把 runtime-checks.json 加进 .gitignore。
完整样例见 runtime-checks.example.json。示例里的 battery、gpu、robot 需要机器上真的有对应设备或服务；没有就删掉对应的 check 或 metrics。
最小硬件示例：
{
"checks": [
{
"id": "hardware",
"kind": "hardware",
"intervalSeconds": 15,
"metrics": ["cpu", "memory", "disk", "uptime"]
}
]
}
通用字段
| 字段 | 说明 |
|---|---|
id |
唯一名称，报告和 status_check({id}) 用它 |
kind |
hardware / http / command / tcp / file |
intervalSeconds |
该检查的周期，5–3600，缺省用 statusIntervalSeconds |
timeoutMs |
单次检查超时，缺省由周期推导，最多 15 秒 |
enabled |
false 时不执行 |
expect |
阈值/断言，见下 |
hardware
metrics 可选：cpu、memory、disk、uptime、battery、gpu、processes、ports、temperature。
cpu/memory/uptime：Nodeos，无外部依赖。disk：Nodefs.statfs；diskPaths可指定盘符/挂载点，默认系统盘。battery：PowerShellWin32_Battery（WMI），笔记本/带电池设备可用。gpu：nvidia-smi，没有 NVIDIA 驱动会记为失败项。processes/ports：PowerShellGet-Process/Get-NetTCPConnection。temperature：WMIMSAcpi_ThermalZoneTemperature，很多主板不暴露，失败会明确写出。
示例：
{
"id": "battery",
"kind": "hardware",
"intervalSeconds": 60,
"metrics": ["battery"],
"expect": { "battery.percent": { "min": 20 } }
}
http（远程机器人/服务）
{
"id": "robot",
"kind": "http",
"intervalSeconds": 10,
"url": "http://192.168.1.50:8080/api/status",
"headers": { "Authorization": "Bearer REPLACE_ME" },
"fields": {
"battery": "battery.level",
"mode": "mode",
"x": "pose.x",
"y": "pose.y",
"error": "error"
},
"expect": {
"battery": { "min": 20 },
"error": { "equals": null }
}
}
fields用点路径从 JSON 里取值，也支持[0]数组下标。- 没有
fields时，整个 JSON 对象作为数据；_status是 HTTP 状态码。 - 非 2xx 直接算失败；超时由
timeoutMs控制。
command（SSH/ROS/本地脚本）
{
"id": "robot-camera",
"kind": "command",
"intervalSeconds": 15,
"command": ["ssh", "robot@192.168.1.50", "cat /run/camera.json"],
"json": true,
"fields": { "fps": "fps", "online": "online" },
"expect": { "fps": { "min": 5 } }
}
command是 argv 数组，不经过 shell，避免引号/注入问题。json: true时解析 stdout；否则把 stdout 放进stdout字段。- 可以用 SSH、
ros2 topic echo --once、本地桥接脚本、PLC/机器人厂商 CLI。 - 命令以 Host 权限执行，只配置可信命令。
tcp（端口/链路）
{
"id": "robot-link",
"kind": "tcp",
"intervalSeconds": 5,
"host": "192.168.1.50",
"port": 8080
}
连不上/超时记为失败。
file（心跳文件）
{
"id": "robot-heartbeat",
"kind": "file",
"intervalSeconds": 15,
"path": "D:/robot/heartbeat.json",
"maxAgeSeconds": 60,
"minSize": 1
}
exists: false表示“文件必须不存在”。minSize/maxAgeSeconds不满足会告警。
expect 断言
expect 的 key 是数据路径，value 支持：
min/max：数值范围equals：严格相等（对象/数组按稳定序列化比较）contains：字符串包含exists：是否存在（null是否算存在由这条规则决定）
不满足时该 check 标记为“异常”，报告里带具体原因。
插件配置
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
true |
总开关（volatile，切换后下一次请求生效） |
probeSeconds |
30 |
运行时环境（runtime_env）的最小探测间隔 |
statusIntervalSeconds |
30 |
检查项没有写 intervalSeconds 时的默认周期 |
reminderMinutes |
10 |
无变化时的心跳间隔 |
staleMinutes |
10 |
状态超过该年龄时在报告里标“数据已过期” |
watchFiles |
见源码 | 运行时巡检关注的关键文件 |
checksFile |
runtime-checks.json |
检查项配置文件，相对 workspace 或绝对路径 |
sectionOrder |
21 |
静态规则段在系统提示里的位置 |
probeSeconds、statusIntervalSeconds、reminderMinutes、staleMinutes、watchFiles、checksFile 是普通配置，不在自动设置表单里；改 profile 的 cordis.patch.yml 后重启。
使用
正常对话即可。第一次 agent/pre-step 后会看到：
【AI 运行环境巡检】第 3 轮 · 第 1 步 · 采集于 2026/10/26 07:51:55（0 秒前）
工作目录：D:/Project/DSH/寻找
平台：Windows_NT 10.0.26100（x64） / Node v24.21.0 / git version 2.56.0.windows.1
Shell：PowerShell 7.6.6
Git：当前目录不是 Git 仓库（git 可用）
关键文件：package.json 20:06:21；package-lock.json 20:06:21
变化：首次巡检，无历史可比
规则：……
【硬件与远程状态】按配置周期巡检；采集于 2026/10/26 07:51:55
- 硬件：正常；CPU 12%（12 核）；内存 63%（9.6 GB/15.2 GB）；磁盘 C:\ 已用 63.2%（剩余 73.6 GB）；开机 6d 15h
- robot：正常；battery=78；mode=AUTO；x=1.2；error=null
异常：robot battery=12 < 20
- 让模型“检查运行环境”：调用
runtime_env。 - 让模型“检查所有状态/机器人状态”：调用
status_check；可传{ "id": "robot" }或{ "refresh": true }。 - 设置 → 插件里的
runtime-env-watch自动表单只有enabled一个开关。
安全与限制
command/http检查以 Host 权限执行；只配置可信地址和命令。runtime-checks.json已被.gitignore忽略，不要把 token、密码提交到仓库。- 定时器只在 DSH 运行时工作；DSH 关闭后不会检查。
- 检查结果在下一次模型 step 才注入会话；模型空闲时不会主动弹聊天通知。需要“无人值守告警”要再接通知渠道（邮件/IM/webhook）或 DSH automation。
- 硬件指标依赖平台：battery/processes/ports/temperature 需要 PowerShell/WMI；GPU 需要
nvidia-smi；没有对应能力时会在报告里明确写失败项，不会假装正常。 - 它是“状态巡检”，不是“项目依赖预检（doctor）”：不读
engines/requirements 做 semver 比对，也不检查目标部署机。 - 不原生支持 MQTT/ROS 协议；用
command调ros2、mosquitto_sub或本地桥接脚本即可。
开发与验证
pnpm install --node-linker=hoisted
pnpm run check
pnpm run check 覆盖：运行时巡检、硬件解析、HTTP/命令/TCP/文件检查、阈值、配置解析、调度器、pre-step 推送和两个工具。
License
MIT
