API 参考

徽章与嵌入

GET /api/badge/{owner}/{slug} 返回平台实时签发的 SVG 徽章,展示仓库当前可验证的复现等级。

GET /api/badge/{owner}/{slug}

返回平台实时签发的 SVG 徽章,展示该仓库当前可验证的复现等级。端点公开,无需鉴权,也没有任何 query 参数(不提供样式选项)。

徽章为 shields 风格的 image/svg+xml:左侧固定为 CiteArk 松鼠 + 文字标的 lockup 品牌区,右侧为 Run · Match · Repeat 三环指示器与随验证进度切换的状态词(PendingRunMatchReproduced)。它不是仓库作者维护的静态图片,而是平台根据仓库快照实时判定的结果。

响应缓存:

  • 正常徽章: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.tssrc/domain/rings.ts。徽章不表示 CiteArk 对整篇论文作真实性背书,它只表示在徽章链接所指向的明确版本、环境和输入条件下,平台保存了相应状态所要求的执行证据。

嵌入

[![CiteArk](https://citeark.com/api/badge/<所有者>/<仓库名>)](https://citeark.com/r/<所有者>/<仓库名>)

建议链接回对应的 CiteArk 仓库页,让读者能继续查看 Claims、运行记录、证据与来源。