Expand netx-ops into a field playbook with clear CLI batch rules.

Document host_name-only replies, vendor/? exploration, and same-vendor command variance without abandoning working commands.

skills/ops/netx-ops/reference.md

@@ -1,22 +1,47 @@
-# netx-ops quick reference
+# netx-ops 速查
 
-## Can it log in?
+## 两套「一批」
 
-1. `listCliTargets` / `listManagedNe` → if found, `execManagedNe(…, commands=["show version"])`
-2. Else `queryNmsNeInventory` → report NMS presence; say CLI not managed if absent from managed list
+- **多台一批**：一次调用打多台（`nms_ne_ids`/`targets`）
+- **同台多条**：一台上一次 `commands[]` 多条（含多个 `… ?` 分裂）
+- 禁止：同轮多台各调一次 `execManagedNe`
 
-## NMS freshness
+## 新鲜度
 
-- `runNmsDiagnostics` / `aggregateNmsAlarms` → `meta.last_seen_min` / `max`
+- `runNmsDiagnostics` / `aggregateNmsAlarms` → `meta.last_seen_*`
+- 快照：时间窗 ∈ min~max；勿默认「现在−30 分钟」
 
-## Shortcuts
+## 能否登录
 
-| Intent | Call |
-|--------|------|
+1. `listCliTargets` / `listManagedNe` → 命中则实测 `show version` 或 `display version`
+2. 未命中 → inventory 说明有无；未进 CLI 通道则本通道不能登
+
+## 短路径
+
+| 意图 | 调用 |
+|------|------|
 | Critical Top | `aggregateNmsAlarms(severity=critical, top_ne=20)` |
-| Fiber / LOS | Raw `keyword=LOS` / `Fiber Break` |
-| Inventory | `queryNmsNeInventory(keyword=…)` / `getNmsNe` |
-| CLI batch | `execManagedNe(nms_ne_ids=[…], commands=[…])` |
-| Paths | `findTopologyPaths(from_nms_ne_id, to_nms_ne_id)` |
+| 态势 | `runNmsDiagnostics` / `aggregateNmsAlarms` |
+| 断纤 / LOS | Raw `keyword=LOS` / `Fiber Break` |
+| 光功率门限 | Raw `keyword=optical power` + 前缀（≠ 断纤） |
+| 离线 | Raw `keyword=BN EMS` |
+| 单机告警 | 限定 `host_name` |
+| 证据 | `queryNmsAlarmsRaw(field_preset=evidence)` |
+| 清单 | `queryNmsNeInventory` / `getNmsNe` |
+| 多台 CLI | `execManagedNe(nms_ne_ids=…)` 或 `targets` |
+| 路径 | `findTopologyPaths` |
+| A<>B 光 | 两端 host → 路径 → 多台一批 optic CLI |
 
-DSH: prefix tools with `netx__`.
+## 展示
+
+- 只展示 **host_name**；严禁 UUID
+- 无 `host_name`：丢弃
+- DSH：前缀 `netx__`
+
+## 厂商与 `?`
+
+- 华为 `display`；其他多 `show`；方法同一套 `?`
+- **同厂也可能命令不一**：一台失败 ≠ 全网作废；失败台另探，成功台继续原命令；**已成功过的命令优先复用**
+- `^` 前正确 → 加 `?`（可接词尾）
+- **同台分裂**：一台 `commands[]` 多条 `… ?`；**不是**多台同探
+- ZTE 光：`opticalinfo brief` → `optical brief` → `show optical?`