ongridio [能力: host_bash]
本工具在目标设备上运行单条 shell 命令或 pipe 管道，由边端 internal/edgeagent/cmdpolicy 沙箱
做策略校验。v1 是 read-only policy，写操作一律被拒。
调用规则
host_bash(device_id=<num>, cmd="<command>")
device_id必填：与 @-mention chip 和 Promdevice_idlabel 一致cmd必填：单条命令或单层 pipe；不支持;&&||$()<()>>>反引号 / heredoctimeout_seconds可选：默认 30s，最大 300s
允许的命令分类
| 分类 | 示例 binary | 备注 |
|---|---|---|
| 文件系统读 | ls / cat / head / tail / find / du / stat / grep / awk / sed / wc | sed -i / find -delete / awk system() 拒 |
| 系统状态读 | ps / df / free / uptime / iostat / vmstat / lsof / ss / netstat / dmesg / journalctl | journalctl --rotate / --vacuum-* 拒 |
| 网络配置读 | iptables -L / ip addr / tc qdisc show / mount -l / crontab -l | iptables -A / ip addr add / mount /a /b 拒 |
| OVS 探测 | ovs-vsctl show / list-br / get / find / list；ovs-ofctl dump-flows / dump-ports / show；ovs-dpctl show；ovs-appctl fdb/show / lacp/show 等 | add-br / del-br / set / add-flow / del-flows 全拒 |
| nftables / conntrack | nft list ruleset / list table；conntrack -L / -S / -G / -E；ipset list；ethtool -i <iface> | nft add/delete/flush；conntrack -F / -D；ethtool -K/-G/-s 全拒 |
| eBPF 只读 | bpftool prog show / map dump / btf dump / net show / link show / iter list / feature probe | bpftool prog load / attach；map create / update 全拒（要写 BPF 走 Layer-3 preset） |
| 网络命名空间 | ip netns list / identify / pids；ip netns（裸= list） | ip netns exec / add / del 拒（exec 会重入沙箱）。深入 inspect 走 host_netns_inspect skill（未上） |
| 服务状态读 | systemctl status / cat / list-units / is-active | systemctl restart / stop / start 拒（用 host_restart_service） |
| 网络探测 | nc -z / curl --head / dig / host / ping / traceroute | curl -o / wget / nc -e/-l 拒；目标 host 须在 operator allowlist 内 |
推荐套路（诊断 / 探索）
问"哪个进程吃 cpu"：
host_bash(device_id=N, cmd="ps aux --sort=-%cpu | head -10")
问"nginx 最近一小时报错了哪些"：
host_bash(device_id=N, cmd="journalctl -u nginx --since '1 hour ago' | grep -i error | head -50")
问"看下 /var 哪些子目录占用最大"（也可以用 host_du_summary）：
host_bash(device_id=N, cmd="du -sh /var/* | sort -rh | head -10")
问"iptables 当前规则"：
host_bash(device_id=N, cmd="iptables -L -n")
问"哪个端口开着"：
host_bash(device_id=N, cmd="ss -tlnp")
不要做的事
- 不要尝试 redirect 写文件（
> /tmp/x）—— 沙箱拒 - 不要尝试用
bash -c套子壳 —— bash / sh / zsh / dash 整个 ClassDenied - 不要尝试
sed -i—— 用 sed 看就行，改文件不在本工具职责 - 不要尝试
systemctl restart—— 用 host_restart_service skill（带 reviewer 二审） - 被拒后不要重试同一条命令 —— 读 response.reason，调整命令再发
- 不要用本工具替代结构化查询 —— 简单 cpu/mem/进程查询用 get_host_load / get_host_processes
v1 实现说明
- Policy =
cmdpolicy.DefaultReadOnly()，operator 可在/etc/ongrid-edge/bash-policy.yaml扩展或收紧（替换某个 binary 的 matchers / 缩短 path allowlist / 改 timeout / 加 network allowlist） - 网络出站默认全拒（
network_host_allowlist=[]），operator 显式添加 CIDR 或 hostname suffix 才放行 - Path allowlist 默认
/var /opt /home /tmp /srv /data（与 host_files 共享同一份） - stdout cap 64 KiB / stderr cap 16 KiB / 默认 timeout 30s / 单段 argv ≤32