Skill 安全检测用于检查终端上的 Skill 文件，帮助管理员发现恶意代码、查看检测结果，并处理误报或提取文件分析。

功能介绍 #

Skill 是供 AI Agent 执行特定任务的一组指令及相关资源，可包含操作说明、脚本、模板等文件。员工下载或使用第三方 Skill 时，其中的指令或脚本可能引导 Agent 执行高风险操作，因此需要检查其内容及来源。管理员可以配置实时扫描和定时扫描，在文件落盘、发生变更或到达指定时间时检查风险。

飞连通过文件哈希值与威胁情报库比对，识别已知恶意 Skill；启用内容云查后，还会将 Skill 文件内容上传云端，检查恶意内容和高风险代码。检测到风险后，客户端将告警统一上报至管理后台；若策略开启了终端通知，还会向员工发出告警提示，引导其处理风险文件。管理员可以集中查看风险代码及影响设备，提取文件进一步分析，或在确认误报后添加白名单。

同一终端只执行一条 Skill 安全检测策略，多条策略不会叠加或合并。命中多条策略时，优先执行优先级数值最高的一条；数值相同时，执行最近添加或修改的一条。

前提条件 #

企业已开通 AI 安全授权，管理员具备对应功能的菜单及操作权限。详细计费说明请参看计费项。

新增 Skill 安全检测策略 #

检测策略用于指定 Skill 的扫描方式、检测范围和通知方式。首次使用时，请先创建并启用策略；实时扫描和定时扫描至少开启一项，也可以同时开启。策略生效后，终端检测到的风险会展示在审计日志中。

1. 登录管理后台。

2. 在左侧导航栏，选择 AI 安全 ＞ 供应链安全 ＞ Skill 安全检测。

3. 切换至策略配置页签，单击右侧 ＋ 创建策略。

   

4. 在创建策略页面，完成以下配置，然后单击确定。

   说明

   Skill 云查功能支持 Windows、macOS 与 Linux 系统，客户端版本要求如下。

   • Skill Hash 云查：要求飞连客户端 3.3.12及以上版本。
   • Skill 内容云查：要求飞连客户端 3.3.21及以上版本。

   基本信息

   配置项	说明
   策略名称	自定义名称，用于标识当前策略，最多 100 个字符。
   优先级	设置当前策略的优先级。取值范围为 0 ～ 100，数值越大表示优先级越高。多条策略可以同时启用；同一终端命中多条策略时，仅执行优先级最高的一条，数值相同则按最近添加或修改时间确定。

   云查方式

   配置项	说明
   Skill Hash 云查	默认开启，不可关闭。通过 Skill 文件哈希值与威胁情报库比对，快速识别已知恶意 Skill。
   Skill 内容云查	开启后，将 Skill 源码内容上传至云端进行语义级检测，以识别代码逻辑中潜在的未知恶意行为（仅上传 Skill 文件内容）。

   扫描方式

   配置项	说明
   实时扫描	开启后，针对终端上的 Skill 文件进行实时扫描，在新的 Skill 文件落盘或发生变更时触发检测，识别潜在的恶意内容并上报告警。
   定时扫描	开启后，支持针对终端本地已有的 Skill 文件状态进行定时巡检，以发现潜伏或被篡改的恶意 Skill。
   扫描频率	可指定为每小时一次或每天一次。选择每天一次时需设置检测时间，时间以页面提示的服务端时区为准。飞连在允许的时间段内启动一次扫描；任务启动后，结束时间不受该时间段限制。如果终端在整个时间段内始终处于离线或不可扫描状态（如关机），系统将自动跳过当天的该次扫描任务。

   处置方式

   配置项	说明
   日志审计	针对恶意 Skill 进行审计日志上报。默认开启，不可关闭。检测到的风险事件将统一汇总至管理端的审计日志页面进行展示，便于安全管理员进行全局的监控和溯源。

   通知

   配置项	说明
   终端通知	开启后，当在终端发现恶意 Skill 时，客户端会主动弹窗通知用户，提示存在安全风险。您可以单击右侧的配置，自定义多语言的弹窗提示内容。

   生效范围

   配置项	说明
   生效范围	定义当前策略的生效对象。支持选择全部或从员工/设备维度进行部分选择，同时支持在已选择的生效对象中，进一步排除特定员工或设备，使其不受该策略影响。

管理检测策略 #

创建检测策略后，管理员可以查看策略下发和生效情况，并根据需要调整优先级、生效范围或启停状态。需要维护已有策略时，按以下步骤操作。

1. 登录管理后台。

2. 在左侧导航栏，选择 AI 安全 ＞ 供应链安全 ＞ Skill 安全检测。

3. 在策略配置页面，管理员可进行以下管理操作：

   • 运行状态监控：通过页面顶部的仪表盘查看配置策略数、生效设备数及配置同步进度。服务端配置版本是当前策略配置的版本标识，新增、修改或删除策略后会更新。结合已拉取最新配置、拉取到配置，但非最新的设备数和未拉取到最新配置的设备数，可检查哪些终端仍需同步；终端拉取到最新版本，表示检测配置已同步。

   • 策略检索：支持按生效状态、员工或部门、设备、策略名称或 ID 组合筛选，并支持按编辑时间排序。

   • 日常运维：在策略列表中，管理员可以直观预览各策略的核心参数并执行以下操作：

     • 状态切换：通过生效状态栏的开关一键开启或关闭特定策略。关闭策略后，受影响的终端将自动重新匹配下一条最高优先级的策略。

     • 查看策略变更信息：在策略列表中，您可以直接查看每条策略的最近修改人和最近修改时间，快速追溯策略的变更历史。

     • 查看生效终端设备：单击策略列表中的实际生效设备/应生效设备栏数字，可进入策略生效状态详情页。在详情页中，支持查看终端的策略版本更新时间。单击数字旁刷新按钮可主动获取最新生效状态数据。

     • 其他操作：

       • 复制：以现有策略为模板快速创建新规则。
       • 编辑：修改策略的参数、处置方式或生效范围。
       • 删除：永久移除不再需要的策略。删除操作不可撤回，请在确认业务影响后执行。

查看审计日志 #

终端检测到恶意 Skill 后，管理员可在审计日志中查看风险文件、命中策略、受影响的员工和设备，以及当前处置状态。需要排查检测结果或跟进文件处理情况时，按以下步骤查看。

查看路径 #

1. 登录管理后台。

2. 在左侧导航栏，选择 AI 安全 ＞ 供应链安全 ＞ Skill 安全检测。

3. 在页面顶部切换至审计日志页签。
   列表中每行显示一个终端上的恶意 Skill 文件。同一终端、同一路径下的文件再次被检测到或被删除时，会更新同一条记录，您可以直接查看该文件的最新状态。

   

告警列表字段说明 #

在告警列表中，您可以通过各项筛选条件进行组合筛选，快速定位目标威胁事件。您也可以单击列表右上角的自定义列，根据审计需求勾选并调整列表展示的信息。核心字段说明如下：

查看告警详情 #

单击告警列表中的操作列的详情，可以进入恶意 Skill 详情页，查看文件风险、影响设备及处置记录。

事件详情 #

事件详情页签集中展示了该 Skill 的基本信息、风险信息、以及触发告警的终端用户与设备详情。

处置记录 #

在处置记录页签中，可按时间查看该恶意 Skill 的检测与处置记录，包括发生时间、处置状态和具体说明，用于跟进风险文件的处理过程。

处理风险文件和配置白名单 #

针对列表中的恶意文件，管理员可以下发以下响应指令，提取风险文件，或为确认可信的文件配置白名单。

提取文件 #

当发现可疑的未知威胁，或者需要对某次告警进行深入的安全分析时，管理员可以通过提取文件功能，将终端上的恶意文件回传至管理后台。

需要一次提取多个文件时，在告警列表勾选目标记录，单击列表下方的批量提取文件。提取后仍在终端安全 > 威胁响应中查看各任务的执行结果。

1. 定位需要提取的恶意 Skill 文件，执行以下任一操作下发提取指令：

   • 在告警列表中提取：在目标告警事件的操作列，单击提取文件。
   • 在告警详情页中提取：单击目标告警进入详情页，在页面右上角单击提取文件。

2. 确认提取后，系统会自动在终端安全 ＞ 威胁响应生成一个文件提取任务。

   • 若目标设备当前在线，系统将实时执行提取任务。
   • 若设备离线，指令将自动转为后台挂起状态，待设备下次联网后自动执行。

3. 您可以前往威胁响应页面查看任务进度，并在提取成功后下载该文件进一步分析。

配置 Skill 白名单 #

管理员可通过配置白名单，将可信任的扩展组件进行豁免，避免其被误报为恶意 Skill 而影响正常使用。根据实际场景，支持以下两种加白方式：

方式一：从告警日志快速加白

适用于在处理已知告警时，确认该文件为误报并需要立即豁免的场景。

1. 定位需要加白的恶意 Skill 告警，执行以下任一操作打开白名单配置弹窗：

   • 在告警列表中操作：在目标告警事件的操作列，单击添加白名单。
   • 在告警详情页中操作：单击目标告警进入详情页，在页面右上角单击添加白名单。

2. 在弹出的添加白名单侧滑页中，配置以下参数：

   • 操作系统：选择该白名单生效的系统环境，支持多选 Windows、macOS、Linux。
   • 白名单配置（文件 SHA256）：系统自动填入当前告警的文件 SHA256，按该值匹配需要豁免的文件。此入口不提供文件路径规则；如需按路径豁免，请按下文主动定义白名单规则中的步骤配置。
   • 备注：选填。建议填写添加白名单的原因（如“自研工具豁免”），方便后续审计。
   • 生效范围：选择该白名单是应用于全部对象还是仅针对部分对象（特定员工/设备）生效。

3. 配置完成后，单击确定。

添加成功后，系统后续将不再针对命中该白名单规则的文件触发告警，该规则统一在AI 安全 > 供应链安全 > Skill 安全检测 > 白名单中进行维护。

方式二：主动定义白名单规则

适用于已知合规组件的特征（如 SHA256 或路径），在产生告警前预先配置豁免的场景。

1. 在左侧导航栏，选择AI 安全 > 供应链安全 > Skill 安全检测。

2. 切换至 白名单页签。

3. 单击页面右侧的 + 添加白名单。

4. 在弹出的对话框中完成以下配置，并单击确定。

   • 操作系统：选择该白名单生效的系统环境，支持多选 Windows、macOS、Linux。

   • 白名单配置：单击 + 添加规则，支持组合使用以下条件（“且”关系）：

     • 文件 SHA256：基于文件内容的唯一哈希值进行识别。建议优先使用此方式以防路径伪装；添加多个 SHA256 时，用回车分隔。
     • 文件路径：基于文件在终端上的绝对路径进行豁免。路径字段支持通配符 *，可匹配任意字符或路径片段。例如，C:\Users\*\Documents\* 表示匹配所有用户文档目录下的所有文件。添加多个路径时，用回车分隔。

   • 备注：选填。建议填写添加白名单的原因（如“自研工具豁免”），方便后续审计。

   • 生效范围：选择该白名单是应用于全部对象还是仅针对部分对象（特定员工/设备）生效。

添加后，可在白名单页签按操作系统、白名单配置、备注及最近一次添加或修改人筛选规则，并通过操作列编辑或删除规则。修改前请核对生效对象和排除对象，确认规则适用的员工或设备。

在客户端处理恶意 Skill #

当策略生效且飞连客户端在终端上检测到恶意 Skill 文件时，客户端界面的变化和用户的处置流程如下：

1. 实时弹窗预警：若检测策略中启用了通知功能，一旦发现恶意 Skill，客户端会在用户桌面弹出气泡通知，通知内容将按照您在策略中自定义的文案进行展示。

2. 安全状态变更：飞连客户端的安全概览页面中，会出现针对恶意 Skill 的风险提示项，展示当前检测到的恶意 Skill 数量。

   

3. 用户自主处置：可引导终端用户单击弹窗通知，或界面上的恶意 Skill 风险提示项，进入修复页面对恶意 Skill 执行删除操作，从而清除本地风险文件。