ops: use host_name as primary key for alarm NE display

Co-authored-by: Cursor <cursoragent@cursor.com>

skills/_workspace/ops/ops-netx-ume-playbook/SKILL.md

@@ -75,19 +75,20 @@ description: 面向 ops 专家的 netx UME 运维作业手册。覆盖告警查
 - 没有工具证据时，不得臆测告警事实。
 - **用户用英文提问时（强制）**：回复中**不得出现任何汉字**；工具里的中文告警字段（原因、对象名、描述等）必须先**译成英文**再写入表格或正文，禁止原样粘贴；网元名用 `host_name`，协议类维度用英文类别名（Other/Clock/…）。
 
-### 网元名称（强制）
+### 网元展示：以 host_name 为主键（强制）
 
-- 凡涉及网元，用户可见文本一律用 **网元名称** = 网元表 `host_name`（告警 raw：`ne_host_name`；清单/`netx_get_ume_ne`：`host_name`）。
-- **禁止**在表格、结论、Top 列表里写裸 `ne_id`（UUID）。
-- 仅有 `ne_id` 时必须先解析名称，再输出：
-  1. 少量 ID：`netx_get_ume_ne` 逐条取 `host_name`；
-  2. 多条 / 统计：`netx_query_ume_ne_inventory` 分页，或 `netx_sql_query_ume` 中 `JOIN ume_inventory_ne ne ON ne.ne_id = …` 选出 `ne.host_name`；
-  3. 原始告警证据：`netx_query_ume_alarms_raw` 的 `select_fields` 或 `field_preset` 须含 `ne_host_name`（勿只取 `alarm_ne_id`）。
-- `host_name` 为空时可用 `user_label` / `ne_name` 作显示后备，并标注缺失；仍不得用 `ne_id` 顶替。
+- **告警/统计里标识网元时，主键永远是 `host_name`**（主机名），不是 `ne_id`。表格第一列、Top 网元、分组键、结论里的网元名都用它。
+- **优先数据源**（同步时已写入告警表）：
+  - `netx_query_ume_alarms` → 字段 **`host_name`**
+  - `netx_query_ume_alarms_raw` → **`alarm_host_name`**（`select_fields` / `brief` / `evidence` 预设已包含）
+  - 聚合 → `group_by=alarm_host_name` 或 `group_by=ne_host_name`
+- **禁止**对用户展示裸 `ne_id` / `alarm_ne_id`；`ne_id` 仅作查询参数。
+- `host_name` 为空时：用 `user_label` / `ne_name` 并注明缺失；仍不得退回 UUID。
+- 仅当列表接口缺 `host_name` 时再 `netx_get_ume_ne` / 网元清单 / SQL JOIN 补全。
 
 ## 推荐分析模式
 
-- 高风险网元：`netx_aggregate_ume_alarms_raw` + `group_by=ne_host_name`（勿按 `alarm_ne_id` / `ne_ne_id` 分组对外展示）+ 严重度过滤。
+- 高风险网元：`netx_aggregate_ume_alarms_raw` + `group_by=alarm_host_name`（首选）或 `ne_host_name` + 严重度过滤；勿按 `alarm_ne_id` 分组对外展示。
 - 严重度分布：`group_by=alarm_perceived_severity`。
 - 事件趋势切片：raw 查询中组合 `time_from/time_to` + `event_type`。
 

skills/_workspace/ops/ops-netx-ume-playbook/reference.md

@@ -23,7 +23,8 @@
   - `alarm_alarm_key`
   - `alarm_perceived_severity`
   - `alarm_last_seen_at`
-  - `ne_host_name`（网元名称，对外展示首选）
+  - `alarm_host_name`（告警表已冗余的网元主机名，**对外展示主键，放首列**）
+  - `ne_host_name`（与上同义，优先 `alarm_host_name`）
   - `ne_user_label`
   - `ne_ip_address`
 - **禁止**在用户可见输出中只列 `alarm_ne_id`；需要网元身份时必须带 `ne_host_name` 或先联查网元表。
@@ -33,7 +34,7 @@
 - 工具：`netx_aggregate_ume_alarms_raw`
 - 常用分组：
   - `group_by=alarm_perceived_severity`
-  - `group_by=ne_host_name`（网元名称；勿用 `alarm_ne_id` / `ne_ne_id` 作对外维度）
+  - `group_by=alarm_host_name` 或 `group_by=ne_host_name`（网元主键；勿用 `alarm_ne_id` / `ne_ne_id`）
   - `group_by=alarm_event_type`
   - `group_by=ne_connection_status`
   - `group_by=alarm_perceived_severity, group_by2=ne_host_name`