🌟 ArenaPro 创作者激励计划
为了表彰并激励每一位为 ArenaPro 生态注入创意的你，我们正式推出创作者激励计划。我们相信，一个繁荣的社区是由成员的无私分享、热情互助和高质量创作共同构建的。
此计划旨在建立一个公平、透明的荣誉体系，让你的每一份贡献都能被看见、被认可。
✨ 我们的荣誉头像框
我们为你准备了四款设计精美的专属头像框：
【初阶贡献者之辉】：授予那些积极拥抱 ArenaPro 工作流，并迈出坚实创作第一步的新锐力量。
【Git 协作贡献者】：授予那些熟练 Git 团队协作，为项目的规范与高效贡献力量的创作者。
【AP 代码活动获奖者】：授予那些在 AP 官方或认可的民间举办的代码活动中表现活跃或取得优异成绩的创作者。
【进阶核心贡献者】：授予那些对 ArenaPro 生态做出了卓越、深远贡献的核心成员，你们是社区的基石。
🎯 如何解锁你的专属头像框？
【一】初阶贡献者之辉
此头像框旨在鼓励你完整地体验 ArenaPro 的开发流程，并将你的创意变为现实。
- 基本要求: 所有申请人须先加入 ArenaPro AP 官方创作者 QQ 群：492953731。这是我们进行核实与沟通的基础。
- 达成方式: 满足以下任意一项贡献，即可在群内联系管理员申请。
| 贡献方式 | 目标与要求 |
|---|---|
| 发布原创作品 | 目标: 使用 ArenaPro 完整地开发并发布一款原创扩展地图作品。 核验标准: ① 原创性与完整性: 作品必须为个人或团队原创，具有明确玩法和完整体验，严禁抄袭或简单搬运。 ② 技术规范: 项目核心代码需使用 TypeScript 编写，并体现其语言特性，而非简单的 JS 改后缀名。 ③ 编辑器使用: 申请人账号在 ArenaPro 编辑器中的累计有效活跃天数不少于 14 天。 ④ 社区分享: 完成发布后，需将作品链接分享至 AP 官方 QQ 群内。 |
| 积极社区互助 | 目标: 长期（至少一个月）在社区中积极、友善地解答他人疑问。 核验标准: ① 内容相关性: 回答需与 ArenaPro 编辑器使用、TypeScript 编程或相关工作流 高度相关，能切实帮助他人解决技术问题。 ② 官方认可: 获得 AP 官方管理员的认可。 |
💡 你的 ArenaPro 学习地图
这是我们为你梳理的核心知识点，希望能帮你顺利发布第一个作品：
- 掌握 TypeScript 核心基础
- [ ] 理解并使用 TypeScript 的基本类型，如
string,number,boolean,any[]。- [ ] 能够使用
interface或type为复杂的游戏对象（如玩家属性、道具）创建类型定义。- [ ] 掌握函数的类型签名（参数类型和返回值类型）。
- [ ] 能够使用
import和export来组织和复用代码模块。- 熟悉 ArenaPro 开发工作流
- [ ] 成功创建一个 ArenaPro 项目，并理解其基本目录结构 (
src,dist,package.json)。- [ ] 熟练使用 VSCode 连接到游戏，并进行热更新调试。
- [ ] 了解
client和server目录的区别，并能在正确的入口编写代码。
【二】Git 协作贡献者
此头像框旨在表彰你对规范化、工程化开发流程的掌握，尤其是 Git 在团队协作中的出色运用。
- 基本要求: 所有申请人须先加入 ArenaPro AP 官方创作者 QQ 群。
- 达成方式: 满足以下任意一项贡献，即可在群内联系管理员申请。
| 贡献方式 | 目标与要求 |
|---|---|
| 规范化个人项目管理 | 目标: 在个人项目中展现出专业、规范的 Git 全周期管理能力，能独立维护一个结构清晰、版本迭代规范的项目。 核验标准: ① 专业的 Git Flow: 项目需遵循 Git Flow 规范，体现清晰的分支管理策略。 - 合并路径: 每个 feature 分支在完成后，都应被合并回 dev 分支；dev 的阶段性成果最终合并入 main 分支。② 规范的提交历史: - 提交数量: 整个项目需有至少 20 条有意义的 commit 记录。 - 提交格式: 强烈推荐遵循 Conventional Commits 规范 (如 feat:, fix:, docs:)，或保持统一、清晰的自定义风格。③ 严谨的版本发布: - 发布标签: main 分支上的每个重要版本都必须打上语义化版本号的 tag（如 v1.0.0, v1.1.0）。项目中需至少存在 2 个版本标签。④ 完整的项目文档: - 项目根目录下必须包含一个高质量的 README.md，清晰说明项目的功能、如何使用以及开发状态。 |
| 积极参与团队协作 | 目标: 作为核心贡献者，深度参与一个公开的、两人以上的 ArenaPro 社区项目，并做出持续、有价值的贡献。 核验标准: ① 持续的贡献: 向同一个社区项目成功提交并合并了至少 10 次有价值的 Pull Request (PR)。 ② 高质量的 PR: PR 需体现出多样性与深度，例如修复核心 Bug、实现独立功能模块、进行代码重构或完善重要文档。所有 PR 都应遵循高标准： - 关联 Issue: 任何非微小改动都应先创建 Issue 讨论，并在 PR 中链接。 - 清晰的描述: 详尽解释变更的背景、实现思路和测试方法。 - 小而专注: 每个 PR 聚焦于解决一个问题，避免混合多个不相关的改动。 ③ 深度的协作沟通: - 响应审查: 能够根据审查意见，高效地进行多轮代码修改和讨论。 |
💡 解锁“Git 协作贡献者”所需技能清单
这是一份为你量身打造的技能清单，旨在帮你掌握工业级 Git 工作流，并成功解锁此荣誉。
- Git Flow 与个人项目管理 (对应“规范化个人项目管理”路径)
- [ ] 掌握 Git Flow: 能够熟练运用
feature->dev->main的分支开发模型。- [ ] 践行 Conventional Commits: 学习并使用
feat:,fix:,docs:,refactor:等规范化前缀来编写提交信息，让历史记录清晰可读。- [ ] 实施语义化版本控制: 熟练使用
git tag -a vX.Y.Z -m "Release notes"来为你的main分支创建和标记重要的发行版本。- [ ] 编写专业的项目文档: 能够撰写一份高质量的
README.md，清晰地介绍项目背景、核心功能、安装和使用方法。- 团队协作与 Pull Request (对应“积极参与团队协作”路径)
- [ ] 创建高质量的 PR: 练习将大型任务拆解为小而专注的 PR，并为每个 PR 编写清晰的标题和详尽的描述，解释“为什么”和“怎么做”。
- [ ] 关联 Issue 与 PR: 学习在 Gitee/GitHub 上，通过关键词（如
closes #123）将你的 PR 与相关 Issue 关联起来，形成完整的工作流闭环。- [ ] 参与代码审查 (Code Review): 能够根据他人的审查意见，在本地高效地修改代码，并通过
git push --force-with-lease(推荐) 或git push -f更新到已有的 PR 分支。- [ ] 保持分支同步: 熟练使用
git fetch和git rebase(或git merge) 将目标仓库的最新变更同步到你的开发分支，并主动解决可能出现的合并冲突。
【三】AP 代码活动获奖者
此头像框为不定期举办的 ArenaPro 官方代码活动的专属奖励，是荣誉与实力的象征。
- 获取方式: 参与由 AP 官方发起或合作举办的主题编程挑战、Game Jam、代码分享会等活动，并达成该活动所规定的奖励条件。
- 关注渠道: 所有活动信息将第一时间在 ArenaPro AP 官方创作者 QQ 群 中发布，敬请关注群公告和通知。
【四】进阶核心贡献者
此荣誉授予对生态做出卓越、深远贡献的成员。满足以下不同类别中的任意两项，即可申请。
- 基本要求: 所有申请人须先加入 ArenaPro AP 官方创作者 QQ 群。
| 类别 | 贡献方式 | 具体要求 |
|---|---|---|
| A. 高质量内容创作 | 精品游戏 | 使用 ArenaPro 开发的作品，被 AP 官方评为“推荐”、“精选”或获得其他同等级别的官方荣誉。 |
| 开源工具库 | 编写并发布了一个高质量的、可供其他创作者复用的 NPM 包（发布在 @dao3fun 组织下），需经官方评估，或能证明已被多个社区项目实际采用。 | |
| B. 深度社区贡献 | 优质教程 | 撰写了图文并茂的 ArenaPro 深度教程或技术实践文章，并被 AP 官方收录至官方文档、教程案例或社区精华区。 |
| 社区领导力 | 作为核心社区的管理员或长期（三个月以上）公认的技术领袖，在维护社区秩序、引领技术讨论、组织社区活动等方面做出了杰出贡献。 | |
| 活动组织 | 独立或主导发起并成功组织了至少一次有影响力的社区 AP 代码类活动，如线上 Game Jam、主题分享会、代码挑战赛等。 | |
| C. 关键技术突破 | 代码贡献 | 向 神岛实验室 Gitee/Github 开源项目提交了有价值的 Pull Request (PR) 并被成功合并。 |
| D. 荣誉集结 | 荣誉收集 | 同时拥有【初阶贡献者之辉】、【Git 协作贡献者】与【AP 代码活动获奖者】。 |
🚀 申请与审核流程
- 加入群组: 确保你已加入 ArenaPro AP 官方创作者 QQ 群。
- 准备材料: 根据你达成的条件，准备好相应的证明材料（如：作品链接、Git 仓库地址、社区发言截图、Issue/PR 链接等）。
- 提交申请: 在 QQ 群中联系任意一位 AP 官方管理员，私聊提交你的申请理由和证明材料。
- 官方审核: AP 官方团队将在 7 个工作日内对你的申请进行审核。
- 荣誉授予: 审核通过后，我们将为你发放对应的头像框奖励。
❓ 常见问题 (FAQ)
Q: 我可以用同一个项目申请多个头像框吗？
- A: 当然可以！我们完全支持“一鱼多吃”，并鼓励对作品的持续投入。例如：① 你用项目 A 获得了“初阶贡献者”；② 后续你为它引入了规范的 Git Flow 和版本管理，就可以用它继续申请“Git 协作贡献者”；③ 如果这个项目后续还被官方评为精品，它依然可以作为申请“进阶核心贡献者”的材料。
Q: “初阶贡献者”要求的“编辑器累计有效活跃天数”是如何计算的？
- A: “有效活跃天”指的是你在当天有使用 ArenaPro 编辑器进行实际操作（如保存脚本、编辑场景、调试等）并与编译代码至地图。你不需要全天在线，只要当天有有效活动记录即被记为 1 个活跃天。
Q: 申请“Git 协作贡献者”时，我需要同时满足“个人项目管理”和“团队协作”两项要求吗？
- A: 不需要。这两条是并列路径，你只需选择其中任意一条，并完整地满足该路径下的所有核验标准，即可申请。我们鼓励你根据自己的实际情况和项目经历，选择最适合你的那一条进行挑战。
Q: 我们是团队协作，奖励如何分配？
- A: 我们不接受以团队为单位的集体申请，所有荣誉均只授予个人。 对于团队协作完成的项目，所有做出核心贡献的成员均可 独立 提交申请。我们主要通过项目的 Git 提交历史来客观评估每位成员的贡献量和具体分工。因此，规范的、能体现个人工作的 Git 提交记录是申请的关键。申请时，也请简要说明你在团队中的主要职责。
Q: 如果我的申请被拒绝了，该怎么办？
- A: 如果申请未通过，你可以随时向审核的管理员询问具体原因。在根据建议进行完善后，我们随时欢迎你再次提交申请。
Q: 我在计划发布之前的贡献算数吗？
- A: 当然算！本激励计划追溯所有历史贡献。只要你的贡献符合上述标准，即可申请。
每一行代码，每一次分享，都是在为我们共同的创作世界添砖加瓦。ArenaPro 团队再次感谢你的支持与热爱，我们期待看到更多闪耀着贡献者光辉的头像出现在社区的每一个角落！