Pyx Scan

核心用法

pyx-scan 是一款专为 AI 代理环境设计的安全审计工具，通过调用 PYX Scanner API 对第三方技能进行预安装风险评估。其工作流程高度标准化：解析 owner/name 格式的技能标识 → 调用 API 获取安全数据 → 根据响应状态生成五级 verdict（SAFE/OUTDATED/CAUTION/FAILED/UNSCANNED/ERROR）→ 输出结构化 Markdown 报告。

该工具强制要求实时 API 调用，禁止缓存或假设结果，确保评估时效性。对 FAILED verdict 采取零容忍策略，严禁软化表述；对 CAUTION verdict 则强制用户二次确认，形成人机协同的安全闸门。

显著优点

1. 主动防御架构：在技能执行前拦截，而非事后检测，符合零信任安全模型
2. 多维度评估体系：整合 trust_score、risk_score、confidence、intent、status 等指标，避免单一指标误判
3. 版本一致性校验：通过 is_outdated 与 commit 比对，识别"安全旧版本被恶意更新"的供应链攻击场景
4. 降级容错机制：WebFetch 失效时自动回退 curl，网络层鲁棒性较强
5. 自反身性设计：甚至对自身执行诚实扫描，体现安全工具应有的透明度

潜在局限

• 外部依赖风险：核心功能绑定 scanner.pyxmate.com，若该域名遭受 DNS 劫持或长期宕机，将完全失效
• 扫描覆盖率盲区：UNSCANNED 状态仅提示人工审查，未提供自动化代码静态分析能力
• 评分黑箱问题：trust_score 与 risk_score 的计算逻辑未公开，用户难以验证评分公正性
• rate limit 敏感：429 错误直接阻断流程，无本地队列或延迟重试机制

适合人群

• 企业级 AI 代理平台的运维管理员
• 使用多技能编排框架（如 LangChain、AutoGPT 插件系统）的开发者
• 对供应链安全有合规要求的金融、医疗行业 AI 部署场景

常规风险

| 风险类型 | 说明 |

|---------|------|

| API 单点故障 | 服务端不可用导致安全验证真空 |

| 误报/漏报 | 评分算法缺陷可能导致危险技能误判为 SAFE |

| 数据投毒 | 若 PYX Scanner 的数据源被污染，将传播错误信任信号 |

| 社交工程绕过 | 攻击者可能诱导用户忽略 CAUTION 提示手动确认 |

核心用法

pyx-scan 是一款专为 AI 生态设计的安全验证工具，用于在安装或使用其他 Agent Skill 前进行风险筛查。用户只需提供目标技能的 owner/name 格式标识（如 anthropic/web-search），该工具即可调用 PYX Scanner 官方 API 返回信任评分、风险等级及安全建议。

工作流程分为五步：解析用户输入 → 调用 PYX Scanner API（优先使用 WebFetch，失败则回退至 curl）→ 处理各类 HTTP 状态码 → 根据 API 返回的 recommendation 字段判定 verdict（SAFE/OUTDATED/CAUTION/FAILED/UNSCANNED/ERROR）→ 输出结构化 Markdown 报告。每种 verdict 对应差异化的报告模板，SAFE 技能直接展示信任评分与能力清单，FAILED 技能则明确警告禁止安装。

显著优点

1. 零代码风险设计：纯 Markdown 文档型 Skill，无可执行脚本，从根本上杜绝了恶意代码注入的可能性。
2. 双重调用保障：WebFetch 与 curl 双通道回退机制，确保在网络波动或工具限制场景下仍能完成扫描。
3. 分级报告体系：六种 verdict 分类清晰，用户可快速理解风险等级并做出决策，无需解读原始 JSON。
4. 自我扫描意识：内置对自身扫描的逻辑，即使检查 pyx-scan 本身也会如实执行，体现安全工具应有的透明度。

潜在缺点与局限性

• 依赖外部 API：核心功能完全依赖 scanner.pyxmate.com 的可用性，若服务宕机或遭遇 rate limit（429），工具将失效。
• curl 回退存在注入风险：虽然文档明确要求输入格式验证，但 curl 命令拼接仍存在理论上的命令注入可能，需用户端严格校验。
• T3 来源可信度：发布者为个人开发者（fysoul17），非企业或知名组织背书，生产环境使用前建议额外代码审查。
• 无本地缓存机制：每次调用均实时请求 API，无法离线查询或追溯历史扫描记录。

适合的目标群体

• AI Agent 平台运营方：需要批量验证社区 Skill 安全性的平台管理员。
• 谨慎型开发者与终端用户：在引入第三方 Skill 前希望获得独立安全评估的技术用户。
• 企业合规团队：需对 AI 工具链进行安全审计的 DevSecOps 或信息安全人员。

使用风险

• 网络依赖风险：scanner.pyxmate.com 服务的稳定性直接影响工具可用性；建议使用前确认网络连通性。
• 输入验证责任：虽然 Skill 文档提示验证格式，但实际输入校验由调用方（Agent 或用户）承担，格式错误可能导致 API 404 或意外的 curl 行为。
• curl 回退的安全边界：在 WebFetch 不可用的场景下，curl 回退机制需确保 owner/name 不含 shell 元字符，建议优先配置 WebFetch 环境以规避此路径。
• 许可证缺失：当前未明确声明开源许可证，商业场景集成前需与作者确认授权条款。