信任徽章

信任徽章让开发者和用户一眼就能验证 AI Skill 和 Gene 的安全性、声誉和适应度。基于 V(g) 安全扫描器和 Rotifer Protocol 的声誉系统。

徽章类型

类型	标签	数据来源	显示内容
安全	`rotifer safety`	V(g) 静态分析等级 (A/B/C/D/?)	代码安全扫描结果
声誉	`rotifer reputation`	注册表中的 Gene `reputation_score`	综合信任评分
适应度	`rotifer F(g)`	Arena 适应度值 F(g)	最新 Arena 竞争评分
开发者	`rotifer reputation`	开发者声誉评分	作者信誉度

快速开始

使用徽章生成器

创建徽章最简单的方式是使用徽章生成器：

选择徽章类型（安全 / 声誉 / 适应度 / 开发者）
输入标识符（Skill 名称、Gene 名称或用户名）
点击 Generate 预览
将 Markdown 代码片段复制到你的 README 中

使用 CLI

运行 V(g) 扫描并嵌入安全徽章：

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

然后添加到 README：

![Rotifer Safety](https://img.shields.io/endpoint?url=https://badge.rotifer.dev/safety/@alice/search-web)

嵌入徽章

所有徽章通过 shields.io 使用 Endpoint Badge 格式渲染。

Markdown

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

HTML

<img src="https://img.shields.io/endpoint?url=https://badge.rotifer.dev/safety/@author/skill-name" alt="Rotifer Safety" />

徽章样式

追加 &style= 自定义外观：

样式	参数
Flat（默认）	`&style=flat`
Flat Square	`&style=flat-square`
Plastic	`&style=plastic`
For the Badge	`&style=for-the-badge`

示例：

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

API 参考

徽章 API 托管在 badge.rotifer.dev，返回 shields.io Endpoint Badge 兼容的 JSON。

`GET /safety/:skill_id`

返回 Skill 的 V(g) 安全等级。

参数	描述
`skill_id`	Skill 标识符（如 `@author/skill-name`）

`GET /gene/:identifier`

返回 Gene 的声誉评分。

参数	描述
`identifier`	Gene UUID、纯名称或限定名称（`@owner/gene-name`）

`GET /gene/:identifier/fitness`

返回 Gene 的 Arena 适应度评分 F(g)。

参数	描述
`identifier`	Gene UUID、纯名称或限定名称（`@owner/gene-name`）

`GET /dev/:username`

返回开发者声誉评分。

参数	描述
`username`	开发者用户名

响应格式

所有端点返回相同的 JSON 结构：

{
  "schemaVersion": 1,
  "label": "rotifer safety",
  "message": "A",
  "color": "brightgreen",
  "cacheSeconds": 3600
}

标识符未找到时：

{
  "schemaVersion": 1,
  "label": "rotifer safety",
  "message": "not found",
  "color": "lightgrey",
  "cacheSeconds": 3600
}

Gene 标识符解析

/gene/ 端点接受三种标识符格式：

格式	示例	解析方式
UUID	`550e8400-e29b-41d4-a716-446655440000`	直接查找
限定名称	`@alice/search-web`	按所有者 + 名称查询
纯名称	`search-web`	按名称查询（最新已发布版本）

缓存与 CORS

所有响应包含 Cache-Control: public, max-age=3600（1 小时缓存）
已为所有来源启用 CORS（Access-Control-Allow-Origin: *）