CONTRIBUTE

一起构建这个平台

EvoKernel Spec 是把"任意模型 → 任意硬件"映射成可计算知识图的开源项目。当前：28 家厂商 · 39 张加速卡 · 19 个模型 · 22 个实测案例。每个数字都带 evidence 引证。三条赛道见下。

tier: official
🏷

厂商官方数据

你代表 NVIDIA / AMD / 华为 / 寒武纪 等硬件厂商

为你的产品补充或校正权威数据。引用白皮书或 datasheet；维护者通过厂商 PR 渠道验证身份；带 vendor-attested 标签优先合并。

提交厂商声明 →
tier: estimated → official
🛠

社区数据补充 / 校正

任何有公开来源的人——论文、博客、GitHub repo、MLPerf 结果均可

修正一个错误数字 / 补全缺失字段 / 替换失效 evidence URL。与厂商声明同流程；按 source-type 矩阵自动分级。

提交校正 →
tier: measured
✅

实测部署案例

你在真硬件上跑了真模型，有日志可证

一条 measured case 直接喂入 Calibration Map，立刻让该硬件在所有模型上的 Tier 1 估算更准。最高杠杆的贡献类型。

提交案例 →

贡献闭环

  1. 1/5

    从上方 3 条赛道中选一条并开 issue (或直接 fork → PR)

  2. 2/5

    维护者在 72 小时（厂商）或 7 天（社区/案例）内回应

  3. 3/5

    审查通过后 YAML 进入 data/ 目录，CI 在每次提交都重新校验

  4. 4/5

    下次 build 自动反映新数据 —— /showcase, /pricing, 计算器全部刷新

  5. 5/5

    打 tag release 时你会出现在 CONTRIBUTORS.md 和 GitHub Release 注记里

数据可信度 —— 三档说明

每个量化声明都带三档之一。tier 反映的是该字段证据的强度，不是来源文档整体的可靠性。

🏷

tier: official

厂商权威发布。白皮书、datasheet、厂商署名的 MLPerf submission。

✅

tier: measured

在真硬件上独立观测得到。可复现，附带日志 + commit hash + 脚本。

⚠️

tier: estimated

推算、推断或外推得到。与实测对齐校准过，但不是直接观测。

完整政策见: docs/DATA-TIERING.md →

直接发 PR (跳过 issue 流程)

熟悉项目的贡献者建议直接 PR：fork → 新分支 → 改 YAML → push → PR。issue 模板只是引导表单，直接操作更快。 

# 新增一张加速卡
git clone https://github.com/ying-wen/evokernel-spec
cd evokernel-spec
pnpm install
# 新建 data/hardware/{vendor}/{slug}.yaml
# 按 schema 填字段（参考 schemas/hardware.ts）
pnpm validate           # zod schema + 交叉引用校验
pnpm test               # 单元测试
./launch.sh             # 本地预览验证
git checkout -b add-{slug}
git add data/hardware/{vendor}/{slug}.yaml
git commit -s -m "data: add {slug} hardware"
git push -u origin add-{slug}
gh pr create

详细开发文档: docs/DEVELOPMENT.md →

署名与社区