限时活动
Token 价格限时 5 折:输入 ¥60¥30/ 百万 Token,输出 ¥240¥120/ 百万 Token

Agent 的行动边界从 Skill 开始

上传 Skill 压缩包,动态运行观测其真实执行链路,联合分析文档、代码、配置与素材,识别静态扫描难以发现的隐藏风险,给出可执行的处置建议。

上传单个 Skill

快速识别一个 Skill 压缩包中的隐藏风险

拖拽 zip 文件到此处,或点击浏览
仅支持 .zip 格式 · 单个 Skill 检测
Trust & Compliance

你的数据,始终在明确的边界内被处理

Brane Matrix 提供 Data Processing Agreement,清晰约定数据的处理目的、安全责任、保存期限与用户权利,让个人与企业客户都能放心使用。

限定处理目的 明确保存与删除 企业签署支持
已选择 0 个
加载中…

Total Skills

0
我测试过的 Skill 总数

风险分布

扫描趋势(近 7 天)

Recent Scans

最近项目

查看全部 →
项目名Skill 数量最新检测时间风险等级
Q3 供应商安全审查 3 2026-07-30 08:05 Critical
内部工具批次检测 6 2026-07-28 14:20 Medium
Q3 供应商安全审查
3 个 Skill · 创建于 2026-07-25
Critical
内部工具批次检测
2 个 Skill · 创建于 2026-07-20
Medium

欢迎回来

使用手机号登录 Brane Matrix,未注册的手机号将自动创建账号

+86
Brane Matrix · Scan Report

批量 Skill 检测报告

各风险等级 Skill 数量

0检测 Skill

模型用量

逐个检测结果

#Skill风险等级检测摘要操作
Brane Matrix · Scan Report

Skill 检测结果

综合安全判定

Brane Matrix · Scan Report

Skill 检测报告

综合安全判定

声明功能与实际行为

声明的功能 / 权限

实际行为记录

具体发现项

概述

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:

https://www.branematrix.com/skillscanner/v1

身份认证

每次调用需要同时提供 appid 和 apikey,两者必须属于同一个应用,否则返回 401。

Authorization: Bearer sk-bm-live-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx X-App-Id: app_xxxxxxxxxxxxxxxx

在「我的主页 → 应用与 API Key」中先创建应用拿到 appid,再在该应用下创建 API Key。删除应用会连同其下所有 Key 一起失效。

API Key 拥有和你账号相同的调用权限并会消耗你的 Token,请勿在客户端代码或公开仓库中硬编码。

单次检测

提交一个 zip 包(内含单个 Skill),同步返回检测结论。按实际模型用量计费,最低 ¥1.50。zip 最大 50MB。

POST/v1/scan
参数类型必填说明
filefile是Skill 的 zip 包
trusted_domainsstring否可信域名白名单,多个域名用逗号分隔。命中白名单的域名不会被当作可疑的网络访问上报,适合 Skill 里本来就会正常联到的自有域名/依赖源。这里传的域名会跟你在「我的主页 → 白名单管理」里维护的账号白名单合并生效,互不覆盖
languagestring否结果里描述性文本用哪种语言:cn(默认,中文)或 en(英文)。overall_risk/verdict/severity 这几个分类值不受影响,始终是英文
deep_scanboolean否是否启用深度检测(思考模式):true 深度检测,更慢但更准;false(默认)普通检测。按实际模型 token 用量计费,深度检测通常耗费更多 token
即使不传 trusted_domains,系统也会自动带上你在「我的主页 → 白名单管理」里当前启用的白名单域名(系统默认的代码托管/包管理域名 + 你自己添加的域名);传了这个参数会在账号白名单基础上追加,互不覆盖。具体启用/禁用哪些域名,去「我的主页 → 白名单管理」里改

请求示例(curl)

curl https://www.branematrix.com/skillscanner/v1/scan \ -H "Authorization: Bearer $BM_API_KEY" \ -H "X-App-Id: $BM_APP_ID" \ -F "file=@skill.zip"

请求示例(带 trusted_domains,非必要参数)

curl https://www.branematrix.com/skillscanner/v1/scan \ -H "Authorization: Bearer $BM_API_KEY" \ -H "X-App-Id: $BM_APP_ID" \ -F "file=@skill.zip" \ -F "trusted_domains=api.example.com,pypi.org"

请求示例(返回英文结果,非必要参数)

curl https://www.branematrix.com/skillscanner/v1/scan \ -H "Authorization: Bearer $BM_API_KEY" \ -H "X-App-Id: $BM_APP_ID" \ -F "file=@skill.zip" \ -F "language=en"

请求示例(启用深度检测,非必要参数)

curl https://www.branematrix.com/skillscanner/v1/scan \ -H "Authorization: Bearer $BM_API_KEY" \ -H "X-App-Id: $BM_APP_ID" \ -F "file=@skill.zip" \ -F "deep_scan=true"

请求示例(Python)

import requests BM_API_KEY = "sk-bm-live-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" BM_APP_ID = "app_xxxxxxxxxxxxxxxx" with open("skill.zip", "rb") as fh: resp = requests.post( "https://www.branematrix.com/skillscanner/v1/scan", headers={ "Authorization": f"Bearer {BM_API_KEY}", "X-App-Id": BM_APP_ID, }, files={"file": ("skill.zip", fh, "application/zip")}, # trusted_domains、deep_scan 都是非必要参数,不需要就不传这个字段 # deep_scan=true 启用深度检测(思考模式),更慢但更准,按实际 token 用量计费 data={"trusted_domains": "api.example.com,pypi.org", "deep_scan": "false"}, # 检测同步返回,耗时可能到几分钟,超时要给够(深度检测更慢,建议留更多余量) timeout=600, ) resp.raise_for_status() data = resp.json() print(data["overall_risk"], data["verdict"]) for f in data["result"]["findings"]: print(f["severity"], f["file"], f["lines"])

响应示例

{ "run_id": "3f2a1c88-....", "status": "completed", "mode": "single", "filename": "invoice-processor.zip", "overall_risk": "Critical", "verdict": "Malicious", "summary": "检测到数据外泄与权限滥用风险……", "result": { "overall_risk": "Critical", "verdict": "Malicious", "final_assessment": "阻止", "primary_threat_vector": "数据外泄", "summary": "检测到数据外泄与权限滥用风险……", "intent_profile": { "claimed_purpose": "自动处理发票并归档到本地数据库", "declared_capabilities": ["读取本地文件", "调用外部 OCR 接口"], "declared_permissions": ["文件系统读写"], "expected_workflow": "读取发票图片 → OCR 识别 → 写入本地数据库", "image_usage_in_workflow": "必要" }, "behavior_profile": { "file_reads": ["~/.ssh/id_rsa", "invoices/*.png"], "file_writes": ["output/result.db"], "network_calls": ["http://139.xxx.xxx.xxx/upload"], "subprocess_usage": [], "environment_access": ["AWS_SECRET_ACCESS_KEY"] }, "findings": [ { "file": "scripts/sync.py", "lines": "42-58", "severity": "Critical", "category": "数据外泄", "evidence": "向硬编码的外部地址上传 ~/.ssh 目录内容", "why_it_matters": "私钥一旦外泄,攻击者可直接接管关联主机", "exploit_scenario": "Skill 首次运行时静默回传密钥,用户无感知", "recommended_fix": "移除该网络调用,改为仅读取执行所需的最小权限文件" } ] }, "usage": { "input_tokens": 25314, "output_tokens": 8102, "input_fee": 1.80, "output_fee": 2.40 }, "cost": 4.20, "charged": 4.20, "balance": 99.75, "elapsed_ms": 42137 }

包结构不合法(缺 SKILL.md、路径穿越、解压炸弹等)会直接返回 400 invalid_skill_package,不建单也不扣费。

响应字段说明 · 顶层

字段类型说明
run_idstring本次检测的唯一 ID,可用于对账或排查
statusstring固定为 completed(检测是同步返回的,走到响应即已完成)
modestring固定为 single(单次检测)
filenamestring提交的 zip 文件名
overall_riskstring总体风险等级,见「风险分级」:Critical / High / Medium / Low
verdictstring结论标签,如 Malicious / Suspicious / Benign
summarystring一句话摘要,和 result.summary 一致
resultobject详细检测结果,见下表
usageobject本次模型用量:input_tokens / output_tokens / input_fee / output_fee
costnumber本次应收费用(元)
chargednumber实际扣除金额(元),正常情况下等于 cost
balancenumber扣费后账户余额(元)
elapsed_msnumber扫描耗时(毫秒)

响应字段说明 · result

字段类型说明
overall_riskstring同顶层 overall_risk(英文分类值:Critical/High/Medium/Low,用于程序判断,不做中文翻译)
verdictstring同顶层 verdict(英文分类值:Malicious/Suspicious/Benign)
final_assessmentstring处置建议(中文):允许 / 允许并监控 / 沙箱隔离 / 阻止
primary_threat_vectorstring主要威胁类型(中文),如"数据外泄"、"供应链风险"、"社会工程"
summarystring一句话摘要(中文)
intent_profileobjectSkill 声称的用途画像,见下表
behavior_profileobject实际行为画像,见下表
findingsarray具体发现项列表,见下表;未发现问题时为空数组

响应字段说明 · result.intent_profile

字段类型说明
claimed_purposestringSkill 自己声明的用途(中文)
declared_capabilitiesarray声明拥有的能力列表(中文)
declared_permissionsarray声明需要的权限列表(中文)
expected_workflowstring预期的执行流程描述(中文)
image_usage_in_workflowstring图像素材在流程中的作用(中文):无 / 可选 / 必要 / 不明确

响应字段说明 · result.behavior_profile

字段类型说明
referenced_filesarray代码里引用到的文件列表
file_readsarray实际会读取的文件/路径
file_writesarray实际会写入的文件/路径
network_callsarray实际会访问的网络地址
subprocess_usagearray会拉起的子进程/外部命令
environment_accessarray会读取的环境变量
visual_resourcesarray用到的图片/视频等视觉素材及其用途说明

响应字段说明 · result.findings[]

字段类型说明
filestring问题所在的文件路径
linesstring问题所在的行号范围,如 "42-58"
severitystring该发现项的风险等级(英文分类值:Critical/High/Medium/Low)
categorystring问题分类(中文),如"数据外泄"、"权限提升"
evidencestring具体证据描述(中文)
why_it_mattersstring为什么这是个问题、可能造成的影响(中文)
exploit_scenariostring可能被利用的场景举例(中文)
recommended_fixstring建议的修复方式(中文)

风险分级

等级含义建议处置
Critical确认存在恶意行为阻断,禁止进入生态
High高风险行为,证据充分阻断或沙箱隔离观察
Medium存在越权或可疑行为沙箱隔离观察
Low轻微问题或需关注项提示关注

错误码

HTTPerror说明
401invalid_api_keyAPI Key 无效或已删除
401missing_app_id缺少 X-App-Id 头
401app_key_mismatchappid 与 API Key 不属于同一应用
403app_disabled应用已停用
403not_verified账号尚未完成个人认证或企业认证,请先认证后再调用
400invalid_skill_package包结构校验未通过,未扣费
402insufficient_balance余额不足(一次检测至少 ¥1.50),请求未被处理
413file_too_largezip 超过大小上限
404run_not_foundrun_id 不存在或不属于该账号
502scan_failed扫描引擎异常或超时,不扣费

限制与计费

项目限制
单次检测zip ≤ 50MB,最长 10 分钟
每账号应用数10 个
每应用 Key 数10 个

计费规则

项目单价取整方式
输入 token¥60 ¥30 / 百万 Token不足 1 万按 1 万算,向上取整
输出 token¥240 ¥120 / 百万 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)都不扣费,所以不存在需要退款的情况。

F

Frieda

API Key 接入口

加载中…

账户消费

¥0.00
累计消费
¥0.00
输入消费
¥0.00
输出消费
¥0.00
账户余额

近 7 天消费趋势

7/24
7/25
7/26
7/27
7/28
7/29
7/30

收支记录

时间项目方式用量(入/出)消费
加载中…
拖动滑块完成拼图
按住滑块,拖到缺口位置
→