用途
该技能用于从 UniFi MCP 的邻居观测数据生成确定性的低干扰 WiFi 信道规划，主要意图是减少重叠与同频争用，保持分配可复现、可解释，并提供安全的变更上线与验证流程。
主要能力
- 按频段独立规划：2.4 GHz 候选为 1-14（实际非重叠为 1、6、11），5 GHz 按本地策略集；不跨频段混用观测与候选。
- 数据来源分离：内部 AP 到 AP 图用于信道分配，来源为 list_site_internal_ap_neighbors_v2；外部 rogueap 数据仅作可选参考，不作为内部图使用。
- 冲突评分：依据 RSSI 权重等级（≥-55 为 4.0，-65 至 -55 为 3.0，-75 至 -65 为 2.0，-85 至 -75 为 1.0），同信道计全权重，2.4 GHz 相邻信道计 0.5 倍权重，非重叠为 0；5 GHz 按占用 20MHz 块重叠比例计分。
- 确定性全局分配：按邻居压力降序处理 AP，每次分配后对整个内部图重新评分，使用降序压力与升序信道作为固定平局规则；在分数接近（相对 2% 或绝对 0.01 容差）时优先均衡信道分布，其次最小化变更数量。
- 数据质量控制：丢弃缺少 ap_mac、channel 或 signal 的记录；缺少频段维度的记录不得用于分配；缺少带宽时按保守 20MHz 回退并标记中等置信度。
- 安全上线：分波次应用变更，首波最多 3 个 AP 射频，后续每波最多剩余变更射频的 25%，未经明确确认不更改超过站点 50% 的射频；每次变更前持久化原信道、带宽与功率设置，验证异常时回滚。
- 输出契约：返回包含 ap_mac、current_channel、proposed_channel、band、confidence、reason 的规划表，以及同频冲突增量估计、变更 AP 数、跳过 AP 及原因等汇总指标。
使用方式
- 发现：运行 list_sites 选择 site_id，用 list_devices_by_type（type=uap）构建受管 AP 集合，在固定窗口（默认 24 小时）内用 list_site_internal_ap_neighbors_v2 拉取内部图；必要时用 list_ap_neighbors_v2 排查单个 AP，可选拉取 list_neighboring_aps 作为外部上下文。
- 规划：生成每 AP 候选排序与建议信道，标记高风险 AP（数据稀疏、last_seen 过旧、极端噪声）。
- 分阶段：先用 set_ap_radio_channel 小批量应用，等待验证窗口并比较客户端健康与事件，异常超阈值时恢复已持久化的设置。
- 扩展：分波次上线其余 AP，重新运行邻居扫描并调整。
适用场景
适用于基于 UniFi MCP 遥测进行射频优化、降低信道冲突的 2.4 GHz 与 5 GHz 信道规划，包括密集站点、缺少平面图或物理坐标时的规划（以内部邻居图作为可测量的重叠代理）。
限制
- 内部图为空时不得自动分配；仅有 rogueap 数据时返回“内部数据不足”，不推导 AP 到 AP 的确定性分配。
- 无观测的 AP 保持当前信道并标记低置信度；若 list_site_internal_ap_neighbors_v2 报告 skipped_aps，这些 AP 保持不变并标记低置信度。
- 不得仅凭主信道数值推断占用块，需使用 UniFi 报告的主/控制/中心信道与带宽表示；信息不足时标记中等置信度并采用保守解释。
- 不得从邻居行的 channel 字段推断观察者自身当前信道；Auto 状态仅在该 AP 作为被观察邻居出现新鲜记录时推断，并标记中等置信度。
- 拒绝不可能的 RSSI 离群值（如高于 -20 dBm 或低于 -95 dBm，除非有意配置）。
- 当当前配置已在评分容差内时，返回 0 变更的 no-op 规划，不制造变更。
- 物理 AP 位置不可用时，不得声称两台 AP 在物理上相距较远或位于不同区域，除非 UniFi 报告或操作者提供。