English | 中文
这是一个 CNB 平台的入门闯关仓库。你将通过实际操作，逐步解锁 CNB 的各项功能——从设置个人信息到配置流水线，从构建容器镜像到创建 NPC。
每个任务都有明确的目标和验证机制，提交 PR 后流水线会自动检查你的完成情况。
- Fork 本仓库 — 点击右上角 Fork 按钮，将仓库 fork 到你的个人空间
- 完成任务 — 按关卡顺序完成对应任务
- 提交 PR — 将改动提交到你 fork 的仓库，然后向本仓库发起 Pull Request
- 等待验证 — CI 流水线会自动验证，结果以评论形式反馈（✅ 通过 / ❌ 未通过）
💡 如果当前任务不涉及代码修改（比如只需要设置个人信息），你可以随便加个文件（比如添加一个
hello.txt写下你的名字），只要能提交一个 PR 触发流水线就行。
| 编号 | 任务 | 说明 | 参考文档 |
|---|---|---|---|
| 1.1 | 修改默认用户名 | CNB 注册后会分配一个默认用户名（如 cnb.cwH7BL2BwHA），前往 账号设置 修改为一个有辨识度的用户名 | 无 |
| 1.2 | 设置个人签名 | 个人签名（Bio）会展示在你的主页上，让其他开发者快速了解你。进入 个人设置 填写即可 | 无 |
| 1.3 | 设置个人仓库墙 | 仓库墙是你个人主页上的"橱窗"，Pin 上你最得意的项目，让访客一眼看到你的代表作 | 无 |
| 1.4 | 关注指定用户 | 关注其他开发者后，你可以在动态中看到他们的最新活动。比如可以关注：Hunter Bown、哪嘟通临时工 等等 | 无 |
| 1.5 | 关注指定仓库 | Star 是对优质仓库的认可。比如 Star 以下仓库：cnb/feedback、examples/showcase | 无 |
| 编号 | 任务 | 说明 | 参考文档 |
|---|---|---|---|
| 2.1 | 配置保护分支 | 保护分支可以防止未经 Review 的代码直接 push 到主分支。在仓库「设置 → 分支保护」中配置。如果你是仓库负责人或管理员，可以同时开启「管理员及负责人可以推送到保护分支」选项，以保证后续闯关更顺利 | 无 |
| 2.2 | 添加开源 LICENSE | 开源许可证声明了代码的使用规则。没有 LICENSE 的代码默认是"保留所有权利"的，加一个标准许可证（如 MIT）才能让别人放心使用你的代码 | Choose a License |
| 2.3 | 仓库 UI 定制 | 通过 .cnb/settings.yml 配置文件，你可以自定义仓库页面上 Fork 按钮和云原生开发按钮的描述、悬浮图片等，让仓库更有个性 | UI 定制 |
| 编号 | 任务 | 说明 | 参考文档 |
|---|---|---|---|
| 3.1 | 开启事件自动触发 | Fork 的仓库默认不会自动触发云原生构建。需要在仓库「设置 → 云原生构建」中开启「允许事件自动触发」和「允许定时任务自动触发」，这样后续的流水线任务才能正常运行 | 无 |
| 3.2 | Push 触发器 | 最基础的触发方式，代码推送到指定分支时自动运行流水线，适合持续集成场景 | 快速开始 |
| 3.3 | Crontab 定时触发器 | 通过 cron 表达式配置定时任务，适合定期构建、数据同步、健康检查等场景。格式："crontab: 30 5 * * *" | Branch 事件 |
| 3.4 | Pull Request 触发器 | PR 创建或更新时触发，用于自动化代码检查、单元测试、构建验证，是 Code Review 的好帮手 | Pull Request 事件 |
| 3.5 | Tag push 触发器 | 推送 Tag 时触发，通常用于发布 Release、构建正式版本的镜像 | Branch 事件 |
| 3.6 | Web trigger 触发器 | 在仓库构建页面手动点击触发，适合需要人工确认后才执行的任务 | 页面操作事件 |
| 3.7 | API trigger 触发器 | 通过 Open API 或内置任务 cnb:trigger 触发其他仓库的流水线，实现跨仓库联动 | API 请求事件 |
| 3.8 | 部署触发器 | 通过 .cnb/tag_deploy.yml 定义部署环境和审批流程，在 Release 页面一键部署，支持多环境串联和审批机制 | 自定义部署 |
| 编号 | 任务 | 说明 | 参考文档 |
|---|---|---|---|
| 4.1 | 使用云原生开发环境 | 点击仓库页面的「云原生开发」按钮，即可在浏览器中启动一个完整的开发环境（VS Code），无需在本地安装任何工具 | 云原生开发介绍 |
| 4.2 | 配置自定义开发环境 | 默认开发环境可能不包含你需要的工具。通过在 .cnb.yml 的 vscode 事件中指定自定义 Docker 镜像，可以预装特定语言、框架和工具链 | 自定义开发环境 |
| 4.3 | 配置开发环境预览 | 配置 onlyPreview 和 launch 后，云原生开发环境会自动启动你的 Web 应用并提供在线预览链接，方便实时查看效果 | 预览模式配置 |
| 编号 | 任务 | 说明 | 参考文档 |
|---|---|---|---|
| 5.1 | Docker 制品 | 通过流水线构建 Docker 镜像并推送到 CNB 内置制品库，实现代码到可部署镜像的自动化。制品库地址格式：docker.cnb.cool/<slug>/<image-name> | Docker 制品 |
| 5.2 | NPM 制品仓库 | CNB 支持托管私有 NPM 包，团队内部的公共组件库可以通过 NPM 制品仓库统一管理和分发 | NPM 制品 |
| 5.3 | Maven 制品仓库 | Java 项目可以将构建产物发布到 CNB 的 Maven 制品仓库，方便团队内依赖管理 | Maven 制品 |
| 编号 | 任务 | 说明 | 参考文档 |
|---|---|---|---|
| 6.1 | 创建任务集 | 任务集（Missions）是 CNB 的轻量项目管理功能，支持创建、分配和追踪工作项。你可以在组织中创建任务集来管理团队的开发计划和 Bug 跟踪 | 任务集 |
| 编号 | 任务 | 说明 | 参考文档 |
|---|---|---|---|
| 7.1 | 开启仓库知识库 | 开启知识库后，AI 会自动索引你的代码仓库内容，在 Issue 和 PR 中提供更精准的上下文感知回答。在仓库「设置」中一键开启 | 知识库 |
| 7.2 | 开启 Wiki | CodeWiki 是与代码仓库深度集成的文档系统，通过在 .cnb.yml 中配置 cnbcool/codewiki:latest 镜像来启用，适合维护项目文档和团队知识沉淀 | CodeWiki |
| 7.3 | 创建并启用 NPC | NPC（Non-Player Character）是 CNB 平台的 AI 智能助手。你可以创建自定义 NPC，它能自动进行代码评审、总结 PR、回答技术问题，甚至根据需求修改代码 | NPC |
共 7 个关卡，26 个任务。 祝你闯关愉快！
遇到问题？欢迎在 cnb/feedback 提 Issue 反馈。
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
