Spark Program | CKB Developer Onboarding Guide

English
,
19

星火计划：终止对 CKB Developer Onboarding Guide 项目的资助

星火计划致力于支持社区开发者和创新项目。我们始终以透明、公正和负责任的态度管理每一笔资助。经过委员会的慎重评估，我们遗憾地宣布，对 CKB Developer Onboarding Guide 项目的资助已正式终止。

项目基本信息

  • 项目名称：CKB Developer Onboarding Guide
  • 开发者/团队：Milan Matejic（@Mateja3m）
  • 项目简介（提案内容）：

CKB Developer Onboarding Guide 是一个以文档为核心的结构化入门资源，旨在帮助开发者从零开始完成 Nervos CKB 区块链的环境搭建并顺利开始开发。项目重点包括：分步骤入门流程、环境配置指导、RPC 与 Indexer 配置、故障排查与修复矩阵、第一个可运行的开发流程、AI 辅助调试，以及中英双语版本。

  • 项目讨论与详情主要链接：Spark Program | CKB Developer Onboarding Guide - Nervos Talk
  • 代码仓库：GitHub - Mateja3m/ckb-developer-onboarding-guide

终止决定及原因

申请人在项目执行期间提交了中期资助申请，声称已完成 M1（第 1–2 周）及 M2 第 1 周的工作内容。委员会依据提案基线，对申请人自述已完成的交付物进行了审核，发现即便仅围绕其声称完成的内容评估，交付质量仍未达到提案承诺的基本标准——初级用户看到目前的文档后仍然无法确定自己是否能够成功运行节点或进行项目开发，机器输出的大量日志也缺乏简明扼要的指导。

具体情况梳理

1. 中期资助审核阶段（5/9 委员会反馈）

申请人提交中期资助申请后，委员会对已提交内容进行了审核，发现三个主要问题并明确要求改进：

  • 结构混乱：文档缺乏清晰的 Quick Start → 进阶路径 → 故障排查的逻辑主线，初级用户无法快速找到所需内容。
  • 信息密度不足：大量内容是框架性描述（如 “validation framework aligned”），缺乏可执行的实际命令、预期输出和可复现步骤。
  • How to Verify 缺失：文档未提供明确的 PASS/FAIL 检查清单，读者无法自行判断是否成功完成了环境搭建。

委员会据此拒绝了中期支付申请，并给出具体改进要求。

2. 申请人重构响应（5/12–5/14）

申请人接受反馈后进行了仓库重构。委员会认可以下改进：

  • 结构改进：Quick Start → Branching Paths → Troubleshooting → FAQ → How to Verify 的主路径趋于清晰。
  • 验证标准：PASS/FAIL 标准已加入 how-to-verify.md。
  • 信息密度：去掉了此前大量框架性官话，内容更聚焦。

但重构过程中暴露了新的问题：

  • 重构移除了此前的交付证据：5/12 的 commit 0592d8f（“Stop tracking report and reference docs”）将所有 docs/reports/ 和 docs/reference/ 移出 git 跟踪；5/13 的 commit e05a59b 将 validation-logs/ 加入 .gitignore。申请人声称文件"只是移动了位置，并未删除"，但这些内容在 GitHub 上已不可见，委员会的可验收基线被实质性缩小。这与"提案锁定，按基线验收"的程序要求存在冲突。
  • 重构后内容体量显著不足：仓库仅剩 README + docs/ 下 5 个主文档 + 6 个 validation 文件，实际内容约 15 KB。

3. 委员会对申请人自述已完成内容的复核

考虑到申请人一直在为中期资助申请调整交付物，委员会对于尚未到期的里程碑（M2 后半及 M3）的完成情况不予置评，仅围绕申请人自述已完成的内容进行逐项核实。核实结果如下：

申请人声称已完成的内容 委员会核实结果
Prerequisites + Environment Setup ✓ 已在 quick-start.md 和 how-to-verify.md 中体现
Quick Start Path（公共 RPC，首次成功） △ quick-start.md 存在，但声称 10–15 分钟可完成，仅在申请人自己的 Mac 上测过，未经第三方环境验证
CKB Node Setup + RPC Setup △ 未按提案设为独立章节，仅作为 branching-paths.md 中 Path B/C 的各一个 RPC 调用出现
Indexer Setup △ 仅 Path C 一个 get_indexer_tip 调用，远未达到独立章节的深度
Troubleshooting Matrix △ 仅 7 类症状，每类约 5 行；缺少提案 Section 8 要求的 expected output / reproducible command 成对结构
公开仓库 + MIT License ✓

核心问题：

  1. 初级用户仍无法获得有效指导：这是委员会评审的核心结论。目前的文档既不能让初级用户判断自己是否能成功运行节点，也不能在用户遇到大量机器日志输出时提供简明扼要的方向指引。作为一个定位于"面向无 CKB 经验开发者"的入门指南，这一根本性不足直接构成了交付不达标的判定依据。
  2. Troubleshooting Matrix 过于薄弱：仅 7 个症状条目，与提案 Section 8 承诺的"each entry includes root cause, fix steps, reproducible commands, expected outputs"有明显差距。这正是委员会在 5/9 反馈中要求的"How to Verify 要写成 checklist"的精神——申请人在 how-to-verify.md 上做到了，但 troubleshooting 部分仍未补齐。
  3. 未进行第三方复现验证：所有验证证据均来自申请人自己的开发机器（/Users/milanmatejic/...），contributor 列表仅有申请人一人。提案承诺"无 CKB 经验的开发者照着走即可"，但从未进行任何独立的第三方可复现性测试。对文档类项目而言，独立可复现性是衡量交付质量的基本前提。
  4. 周报与 commit 历史存在不一致：4/26 的 W2M1 周报明确写道"no GitHub push was performed, no git commit was created"，但 commit 历史显示 4/24（commit 87fa5a3）已 push 了 W2M1 相关内容。

委员会的最终决议

根据《星火计划小额资助方案》"3.3 完成政策"的相关规定：

  • 连续较长时间无实质性进展且无合理原因
  • 项目方向完全偏离原申请目标 / 资金使用严重偏离项目计划，且未经 Committee 批准

委员会认定，CKB Developer Onboarding Guide 项目在结构重组方面展现了一定的响应态度，委员会对此予以认可。但经复核，申请人自述已完成的内容在质量和实用性上仍未达到提案承诺的基本标准：初级用户无法从现有文档中获得可操作的有效指导；Troubleshooting Matrix 条目偏少且缺乏规范结构；所有内容仅在申请人单一环境下测试，未经任何独立第三方验证。委员会在中期审核中已明确指出问题并给予改进机会，申请人在结构层面有所响应，但内容的实质性质量问题并未得到根本解决。继续资助已无法保障原定生态价值实现，也不符合星火计划对项目基本可用性与交付一致性的要求。为维护计划的公信力与资源分配效率，最终遗憾地决定终止对该项目的资助支持。

资金处理情况

  • 已发放资金：
    • 首笔资助（20%）：10 USDI + 6,743 CKB
      • 交易哈希（10 USDI）：0xd629582ce9447337d7341472667d1b72a4109facb08072eab5fef41489869f58
      • 交易哈希（6,743 CKB）：0xf4b0600801f42dccf8c7c654305c9d13899f4f00ceb46a231ffae2893f9e6738
  • 剩余资金：不再发放，将从项目多签钱包退回 Spark Program 主钱包。

致社区

星火计划的核心原则是透明与负责。我们对 CKB Developer Onboarding Guide 项目提出的"为初级开发者提供结构化入门路径"这一出发点表示认可，也肯定申请人在接收反馈后进行结构重组的积极态度。但遗憾的是，在中期资助审核中，申请人自述已完成的内容经逐项核实后仍未达到提案基线的质量要求。此次终止决定是基于中期审核过程中的充分事实核查、多轮反馈沟通记录以及提案基线对照做出的，旨在保护社区资源并维护计划的可持续性。

我们鼓励开发者在项目执行中保持与委员会的紧密沟通，对技术瓶颈及时求助并接受建议。文档类项目尤其需要确保内容的独立可复现性——这不仅是验收标准，也是此类项目真正服务社区的基础。我们也欢迎有志于开发者入门方向的贡献者重新整理方案、以更稳健的方式再次申请。

星火计划将继续秉持"低门槛、快节奏、真支持"的理念，欢迎更多务实、可落地的创新项目加入。我们相信，通过更扎实的执行与协作，社区将诞生更多真正可靠的成果。

如对本决定有任何疑问，可在 Nervos Network Discord 的 Spark Program 频道或本帖下留言，委员会将及时回应。

2026-05-20

行天

代表星火计划委员会

6 Likes
CKB Ecosystem Biweekly Update