跳转到内容
Rotifer Rotifer Protocol

V(g) 安全扫描器

rotifer vg

Section titled “rotifer vg”

对 Skill 或 Gene 目录运行 V(g) 静态分析。扫描源代码中的安全相关模式，并输出安全等级（A/B/C/D/?）。

Terminal window
rotifer vg [path] [options]

参数：

参数必填描述
path否Skill 或 Gene 目录路径。默认为 .

选项：

选项描述
--id <skill_id>报告中包含的 Skill/Gene 标识符
--json输出原始 JSON 报告而非格式化输出
--all扫描所有代码文件，而不仅是 src/

安全规则

Section titled “安全规则”

V(g) 检查 7 种安全相关代码模式：

规则检测目标严重程度
S-01动态代码执行（eval()、Function()）🔴 严重
S-02系统命令执行（child_process、exec、spawn）🔴 严重
S-03代码混淆（atob() + eval 组合）🔴 严重
S-04可疑外部通信（fetch()、http.request）🟡 高
S-05环境变量访问（process.env）🟡 高
S-06持久外联连接（WebSocket、net.Socket）🟡 高
S-07文件系统操作（fs.readFile、fs.writeFile）🟠 中

安全等级

Section titled “安全等级”
等级条件徽章颜色
A0 个严重 + 0 个高brightgreen
B0 个严重 + ≤2 个高green
C0 个严重 + >2 个高yellow
D≥1 个严重red
?未找到源代码（纯 prompt Skill）lightgrey

示例

Section titled “示例”

扫描当前目录：

Terminal window
$ rotifer vg

扫描指定 Skill 并附带标识符：

Terminal window
$ rotifer vg ./my-skill --id @alice/search-web

输出 JSON 用于 CI/CD：

Terminal window
$ rotifer vg ./my-skill --json > report.json

扫描所有文件（不仅是 src/）：

Terminal window
$ rotifer vg ./my-skill --all

JSON 输出格式

Section titled “JSON 输出格式”

使用 --json 时，输出遵循以下结构：

{
  "skill_id": "@author/skill-name",
  "scanned_at": "2026-03-19T12:00:00Z",
  "grade": "B",
  "findings": [
    {
      "rule": "S-04",
      "severity": "HIGH",
      "file": "src/api.ts",
      "line": 42,
      "snippet": "fetch('https://api.example.com/...')"
    }
  ],
  "stats": {
    "files_scanned": 3,
    "lines_of_code": 245
  }
}

信任徽章

Section titled “信任徽章”

扫描后，为你的 README 生成信任徽章。访问徽章生成器或直接嵌入：

![Safety](https://img.shields.io/endpoint?url=https://badge.rotifer.dev/safety/@author/skill-name)

查看信任徽章指南了解所有徽章类型和嵌入选项。