徽章与嵌入
GET /api/badge/{owner}/{slug} 返回平台实时签发的 SVG 徽章,展示仓库当前可验证的复现等级。
GET /api/badge/{owner}/{slug}
返回平台实时签发的 SVG 徽章,展示该仓库当前可验证的复现等级。端点公开,无需鉴权,也没有任何 query 参数(不提供样式选项)。
徽章为 shields 风格的 image/svg+xml:左侧固定为 CiteArk 松鼠 + 文字标的 lockup 品牌区,右侧为 Run · Match · Repeat 三环指示器与随验证进度切换的状态词(Pending → Run → Match → Reproduced)。它不是仓库作者维护的静态图片,而是平台根据仓库快照实时判定的结果。
响应缓存:
- 正常徽章:
cache-control: public, max-age=300, stale-while-revalidate=86400 - 仓库不存在:返回 404 SVG(状态文案为
not found),缓存 60 秒
等级口径
右侧状态词与全站 Run · Match · Repeat 三环同源,全部由真实执行证据驱动(见核心概念):
| 状态词 | 三环 | 底色 | 判定 |
|---|---|---|---|
Reproduced | ●●● | 绿 | 至少一条 claim 已有独立 Agent / runner / 环境的成功复现记录 |
Author verified | ◉◉◉ | 绿 | 论文作者或可信机构已对当前 Artifact root 完成可验证签名确认(L5) |
外圈不会从执行记录或 runner attestation 自动推断,只会在存在明确且可验证的作者或机构签名时显示。
| Match | ●●○ | 绿 | 存在 verified claim 与 verified run 的交集,即成功运行与已验证结论相互关联 |
| Run | ●○○ | 蓝 | 存在 verified run,但没有与之匹配的 verified claim |
| Pending | ○○○ | 橙 / 灰 | 尚无成功执行证据;仅完成结构化索引(compilation.state = verified)时底色为灰 |
等级判定的细节实现见 src/domain/badge.ts 与 src/domain/rings.ts。徽章不表示 CiteArk 对整篇论文作真实性背书,它只表示在徽章链接所指向的明确版本、环境和输入条件下,平台保存了相应状态所要求的执行证据。
嵌入
[](https://citeark.com/r/<所有者>/<仓库名>)建议链接回对应的 CiteArk 仓库页,让读者能继续查看 Claims、运行记录、证据与来源。