面向 AI 生态的技能安全扫描工具，支持安装前/后双重检测，自动拦截高危代码，为 Skill 市场建立可信准入门槛。
说明：
## 核心用法
SkillScan 是专为 AI Skill 生态设计的安全网关工具，采用「安装前拦截 + 安装后复核」的双层防护机制。其核心工作流程包括：
1. **触发场景全覆盖**：无论是用户通过 .zip 上传、git clone、npx 安装，还是简单询问「这个 skill 安全吗」，系统自动激活扫描流程
2. **三级检测体系**：
– 本地文件静态分析（目录结构、可疑代码模式）
– 云端哈希缓存查询（避免重复扫描已知安全包）
– 深度沙箱上传分析（未知包体提交至 `skillscan.tokauth.com` 云端检测）
3. **分级响应策略**：
– 安全/未知（Exit 0）：直接放行
– 低中风险（Exit 1）：弹窗警告，用户确认后可选继续
– 高危/严重（Exit 2）：**强制阻断，无例外通道**
– 扫描失败（Exit 3）：友好提示重试机制
## 显著优点
– **零信任架构**：不预设任何 skill 可信，包括官方市场来源
– **性能优化**：SHA256 目录指纹缓存机制，常见包秒级返回结果
– **跨平台**：原生支持 Windows/macOS/Linux 三端部署
– **静默运维**：自动每日更新威胁库，无需用户干预
– **开放 API**：标准化 REST 接口便于第三方市场集成
## 潜在局限
– **网络依赖**：未知包体必须上传云端，离线环境无法完成完整扫描
– **隐私考量**：代码上传至第三方服务器，对闭源商业 skill 存在顾虑
– **误报风险**：启发式规则可能标记合法但非常规的代码模式
– **覆盖盲区**：动态行为分析能力有限，侧重静态代码检测
– **180秒超时**：复杂包体可能因轮询超时而返回不确定状态
## 适合人群
– AI 助手平台运营方（构建 skill 市场的安全准入体系）
– 企业级 AI 部署团队（防止内部 skill 供应链污染）
– 安全意识较高的终端用户（个人设备上的 skill 来源管控）
– Skill 开发者（发布前自检，提升市场信任度）
## 常规风险
| 风险类型 | 说明 |
|———|——|
| 供应链劫持 | 若 `SKILL_SCANNER_UPDATE_URL` 被恶意重定向，威胁库本身可被投毒 |
| API 密钥泄露 | 硬编码凭证扫描时需确保传输 TLS 完整性 |
| 绕过攻击 | 符号链接、路径遍历可能逃避目录级哈希校验 |
| 拒绝服务 | 超大 skill 包上传导致带宽/扫描队列拥塞 |
## 使用建议
企业部署建议配置私有扫描节点替代默认公有 API，并启用 `first-run` 对存量 skill 进行基线清查。个人用户遇到 Exit 2 阻断时，应视为强烈信号，除非能人工审计代码，否则不建议强制绕过。
会员专属
