iSource 全局白名单基线

要解决什么问题

在安全运营里，全局白名单往往不是「改一条规则」就结束：你要先知道规则落在哪个资产域（primaryRegionId），再按威胁名、源/目的 IP 与端口等条件构造请求，新增之后还要导出留档做核对。iSource 侧列表查询能力未在公开 REST 里铺开，实务上「查当前有哪些白名单」通常等价于导出文件再解读。

技能如何工作

本 skill 只覆盖 全局白名单基线（导出类型 type=1），核心链路是：

1. 确认作用域：查询资产域，得到 scope.primaryRegionId / 名称；用户明确要求「全部资产域」时再评估是否使用 [-1]。
2. 新增规则：把用户输入（推荐模板字段：资产域、威胁名称、源/目的/攻击者/受害者 IP、源/目的端口、描述）映射为 V2 写接口字段；支持单 IP、区间、多条目（; 分隔）。默认先预览 payload，用户确认后再执行真实新增。
3. 导出备份：用户确认后调用导出；响应对应为文件流（常见为 .xlsx），不要按 JSON 解析。
4. 闭环输出：说明新增了哪条规则、落在哪个资产域、是否已完成导出，以及「查询」是否已通过导出结果展示。

执行时必须使用 skill 附带的 Python 脚本（如 whitelist-payload、whitelist-create --execute、whitelist-download --execute），不要用通用 HTTP 工具或临时脚本直连接口。连接信息需包含 host 与 API token；仅 IP/主机名时会自动补全为 https://。

边界与注意点

• 写操作与下载均需用户明确确认后再加 --execute。
• 用户要的是文件类/域名类白名单或「导入文件白名单」时，超出本 skill 主链（默认只处理全局白名单 type=1）。
• 描述 字段用于结果回显，不直接进入 V2 全局白名单请求体；端口字段为字符串（多端口 ,，范围 -）。