欢迎回来
使用手机号登录 Brane Matrix,未注册的手机号将自动创建账号
上传 Skill 压缩包,动态运行观测其真实执行链路,联合分析文档、代码、配置与素材,识别静态扫描难以发现的隐藏风险,给出可执行的处置建议。
快速识别一个 Skill 压缩包中的隐藏风险
一次检测多个 Skill,并生成风险汇总报告
Brane Matrix 提供 Data Processing Agreement,清晰约定数据的处理目的、安全责任、保存期限与用户权利,让个人与企业客户都能放心使用。
统一管理所有 Skill 检测记录与项目组
| 项目组名称 | 项目数 | 创建人 | 创建时间 | Skill 总数 | 风险项 | |
|---|---|---|---|---|---|---|
| 加载中… | ||||||
这是你个人的 Skill 检测概览
待解决的高危问题,以及最近的项目
| 项目名 | Skill 数量 | 最新检测时间 | 风险等级 | |
|---|---|---|---|---|
| Q3 供应商安全审查 | 3 | 2026-07-30 08:05 | Critical | |
| 内部工具批次检测 | 6 | 2026-07-28 14:20 | Medium |
把历史记录中检测过的 Skill 打包成项目文件夹,方便按批次归档与汇报
使用手机号登录 Brane Matrix,未注册的手机号将自动创建账号
| # | Skill | 风险等级 | 检测摘要 | 操作 |
|---|
用你的 API Key 调用 Brane Matrix Skill Scanner,把检测能力接入你自己的流水线
Skill Scanner API 让你在自己的 CI/CD 流水线、Agent 市场审核系统或内部工具中,以编程方式提交 Skill 压缩包并获取安全检测结果。请求与响应均为 JSON,文件上传为 multipart/form-data。
检测是同步返回的:提交后请求会一直挂到扫描完成,直接在响应里给出风险等级和结论,不需要轮询。耗时取决于包的大小与复杂度,通常数十秒,最长 10 分钟。
调用方的 HTTP 超时请设到 10 分钟以上,否则可能在结果返回前就断开。
计费按扫描实际消耗的模型 token 计算(输入 ¥60 ¥30/百万、输出 ¥240 ¥120/百万,限时活动价,均向上取整到万),从账户余额扣除。1KB 文件输入约 940 Token、输出约 400 Token。详见「限制与计费」。
Base URL:
每次调用需要同时提供 appid 和 apikey,两者必须属于同一个应用,否则返回 401。
在「我的主页 → 应用与 API Key」中先创建应用拿到 appid,再在该应用下创建 API Key。删除应用会连同其下所有 Key 一起失效。
API Key 拥有和你账号相同的调用权限并会消耗你的 Token,请勿在客户端代码或公开仓库中硬编码。
提交一个 zip 包(内含单个 Skill),同步返回检测结论。按实际模型用量计费,最低 ¥1.50。zip 最大 50MB。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| file | file | 是 | Skill 的 zip 包 |
| trusted_domains | string | 否 | 可信域名白名单,多个域名用逗号分隔。命中白名单的域名不会被当作可疑的网络访问上报,适合 Skill 里本来就会正常联到的自有域名/依赖源。这里传的域名会跟你在「我的主页 → 白名单管理」里维护的账号白名单合并生效,互不覆盖 |
| language | string | 否 | 结果里描述性文本用哪种语言:cn(默认,中文)或 en(英文)。overall_risk/verdict/severity 这几个分类值不受影响,始终是英文 |
| deep_scan | boolean | 否 | 是否启用深度检测(思考模式):true 深度检测,更慢但更准;false(默认)普通检测。按实际模型 token 用量计费,深度检测通常耗费更多 token |
请求示例(curl)
请求示例(带 trusted_domains,非必要参数)
请求示例(返回英文结果,非必要参数)
请求示例(启用深度检测,非必要参数)
请求示例(Python)
响应示例
包结构不合法(缺 SKILL.md、路径穿越、解压炸弹等)会直接返回 400 invalid_skill_package,不建单也不扣费。
| 字段 | 类型 | 说明 |
|---|---|---|
| run_id | string | 本次检测的唯一 ID,可用于对账或排查 |
| status | string | 固定为 completed(检测是同步返回的,走到响应即已完成) |
| mode | string | 固定为 single(单次检测) |
| filename | string | 提交的 zip 文件名 |
| overall_risk | string | 总体风险等级,见「风险分级」:Critical / High / Medium / Low |
| verdict | string | 结论标签,如 Malicious / Suspicious / Benign |
| summary | string | 一句话摘要,和 result.summary 一致 |
| result | object | 详细检测结果,见下表 |
| usage | object | 本次模型用量:input_tokens / output_tokens / input_fee / output_fee |
| cost | number | 本次应收费用(元) |
| charged | number | 实际扣除金额(元),正常情况下等于 cost |
| balance | number | 扣费后账户余额(元) |
| elapsed_ms | number | 扫描耗时(毫秒) |
| 字段 | 类型 | 说明 |
|---|---|---|
| overall_risk | string | 同顶层 overall_risk(英文分类值:Critical/High/Medium/Low,用于程序判断,不做中文翻译) |
| verdict | string | 同顶层 verdict(英文分类值:Malicious/Suspicious/Benign) |
| final_assessment | string | 处置建议(中文):允许 / 允许并监控 / 沙箱隔离 / 阻止 |
| primary_threat_vector | string | 主要威胁类型(中文),如"数据外泄"、"供应链风险"、"社会工程" |
| summary | string | 一句话摘要(中文) |
| intent_profile | object | Skill 声称的用途画像,见下表 |
| behavior_profile | object | 实际行为画像,见下表 |
| findings | array | 具体发现项列表,见下表;未发现问题时为空数组 |
| 字段 | 类型 | 说明 |
|---|---|---|
| claimed_purpose | string | Skill 自己声明的用途(中文) |
| declared_capabilities | array | 声明拥有的能力列表(中文) |
| declared_permissions | array | 声明需要的权限列表(中文) |
| expected_workflow | string | 预期的执行流程描述(中文) |
| image_usage_in_workflow | string | 图像素材在流程中的作用(中文):无 / 可选 / 必要 / 不明确 |
| 字段 | 类型 | 说明 |
|---|---|---|
| referenced_files | array | 代码里引用到的文件列表 |
| file_reads | array | 实际会读取的文件/路径 |
| file_writes | array | 实际会写入的文件/路径 |
| network_calls | array | 实际会访问的网络地址 |
| subprocess_usage | array | 会拉起的子进程/外部命令 |
| environment_access | array | 会读取的环境变量 |
| visual_resources | array | 用到的图片/视频等视觉素材及其用途说明 |
| 字段 | 类型 | 说明 |
|---|---|---|
| file | string | 问题所在的文件路径 |
| lines | string | 问题所在的行号范围,如 "42-58" |
| severity | string | 该发现项的风险等级(英文分类值:Critical/High/Medium/Low) |
| category | string | 问题分类(中文),如"数据外泄"、"权限提升" |
| evidence | string | 具体证据描述(中文) |
| why_it_matters | string | 为什么这是个问题、可能造成的影响(中文) |
| exploit_scenario | string | 可能被利用的场景举例(中文) |
| recommended_fix | string | 建议的修复方式(中文) |
| 等级 | 含义 | 建议处置 |
|---|---|---|
| Critical | 确认存在恶意行为 | 阻断,禁止进入生态 |
| High | 高风险行为,证据充分 | 阻断或沙箱隔离观察 |
| Medium | 存在越权或可疑行为 | 沙箱隔离观察 |
| Low | 轻微问题或需关注项 | 提示关注 |
| HTTP | error | 说明 |
|---|---|---|
| 401 | invalid_api_key | API Key 无效或已删除 |
| 401 | missing_app_id | 缺少 X-App-Id 头 |
| 401 | app_key_mismatch | appid 与 API Key 不属于同一应用 |
| 403 | app_disabled | 应用已停用 |
| 403 | not_verified | 账号尚未完成个人认证或企业认证,请先认证后再调用 |
| 400 | invalid_skill_package | 包结构校验未通过,未扣费 |
| 402 | insufficient_balance | 余额不足(一次检测至少 ¥1.50),请求未被处理 |
| 413 | file_too_large | zip 超过大小上限 |
| 404 | run_not_found | run_id 不存在或不属于该账号 |
| 502 | scan_failed | 扫描引擎异常或超时,不扣费 |
| 项目 | 限制 |
|---|---|
| 单次检测 | zip ≤ 50MB,最长 10 分钟 |
| 每账号应用数 | 10 个 |
| 每应用 Key 数 | 10 个 |
| 项目 | 单价 | 取整方式 |
|---|---|---|
| 输入 token | 不足 1 万按 1 万算,向上取整 | |
| 输出 token | 不足 1 万按 1 万算,向上取整 |
按扫描实际消耗的模型 token 计费,两项相加即为本次费用。因为都向上取整,一次成功检测最低 ¥1.50。参考:1KB 文件输入约 940 Token、输出约 400 Token。举例:输入 25,314 + 输出 8,102 → 输入算 3 万(¥0.90)、输出算 1 万(¥1.20),合计 ¥2.10。
响应里的 usage 会给出本次的 token 数与分项费用,cost 是应收金额,charged 是实际扣除金额,balance 是扣费后余额,可直接用于对账。
计费时机:扫描成功后按实际用量扣费。包结构校验不通过(400)、余额不足(402)、扫描失败或超时(502)都不扣费,所以不存在需要退款的情况。
| 时间 | 项目 | 方式 | 用量(入/出) | 消费 |
|---|---|---|---|---|
| 加载中… | ||||