欢迎加入CJMP社区:https://Atomgit.com/CJMP
一、CJMP 是什么
CJMP 是 AtomGit 上的高性能跨平台开发框架组织,目标是构建同时支持 UI 和逻辑跨平台的开发框架,并提供接近原生的性能体验。
CJMP - 开源代码托管,代码协作 - AtomGit
https://Atomgit.com/CJMP

CJMP 组织下包含多个仓库,如:
- Docs:应用开发者和框架开发者文档
- Engine:UI 引擎
- CJFrontend:仓颉 UI 前端
- SystemLibs:系统能力抽象和适配
- Tools:命令行工具和开发工具链
- OpenSDK:CJMP SDK 发布仓
- Test:测试框架和测试用例
- Community:跨平台框架 SIG 会议材料和纪要
第一次参与时,建议优先从文档修复、Issue 反馈、测试用例或小范围工具改动开始,熟悉 CJMP 的协作方式后,再参与 Engine、SystemLibs 等核心仓库。
二、成为 CJMP 贡献者需要做什么
这里我大概描述一下,如果想查看详细的贡献指南可以看下方

- 反馈代码或文档问题。
- 补充、修正文档和示例。
- 修复 Bug。
- 增加功能或测试用例。
- 改进构建、命令行工具和 IDE 插件。
- 参与 Issue、PR 讨论和代码检视。
- 参与社区 SIG 讨论,整理会议材料。
无论贡献哪类内容,都需要遵循目标仓库的 README、Issue 模板、贡献指南和 MR/PR 模板。
三、CJMP 官方贡献流程
3.1 Fork 主仓到个人账号
进入你感兴趣的仓库地址,这里我选择了该仓库地址。VibeCoding:基于 AI Agent 的 CJMP 开发场景配置仓库项目 - AtomGit

点击创建fork后,会进入下面网页,不用改动,点击创建Fork项目即可。

创建成功如下:

3.2 Git相关操作
这里我大概一下描述`git相关操作`
# 1.克隆你的Fork到本地(origin自动指向你的Fork)
git clone 仓库地址
# 2.添加主仓远程,命名:upstream(用于同步主仓最新代码)
git remote add upstream 仓库地址
git remote -v # 确认:origin=你的Fork,upstream=主仓
# 3.基于默认分支opensource创建开发分支
git checkout -b feature/add-kimi-mcp-template
# 4.改文件:新增mcp/kimi/mcp.json,更新README.md
# 5.提交到本地仓库
git add mcp/kimi/mcp.json README.md
git config user.name "Deng666" # 提交署名用你的 AtomGit 用户名
git commit -m "feat: add Kimi Code CLI MCP template for cjmp-docs"
# 6.推送到你的Fork
git push -u origin feature/add-kimi-mcp-template
3.3 创建 Pull Request
推送代码完成后,点击下一步即可。

这里写好PR的标题,选择好对应的PR模板,根据你修改的内容进行选择,如果有不懂的可以看下图(有描述)

这里使用md写好你修改功能的对应描述,前置PR留空即可。我们这次是独立的小改动,不依赖任何其他 PR,所以这个字段保持空白/不设置,直接提交即可。

默认是勾选`合并后关闭已关联的issue`,建议再勾选上接受Pull Request合入时删除源分支。合入后自动删掉你 Fork 里的`feature/add-kimi-mcp-template`分支,保持仓库干净。删的只是 Fork 里的临时分支,你的提交已经进主仓了,不会丢东西。最后点击创建

新建成功如下:

3.4 签署《社区贡献者协议》
提交PR需要签署CLA协议,签署完成即可。


3.5 评论 retest 触发 CI 门禁
在评论区输入框输入`retest`并且点击发送评论,就会触发CL门禁。


3.6 踩坑实录:被 CI 打回与修正
这里因为标题描述得不规范,被CL打回了,然后修改了多次,最终发现是标题写的不对。我们只需要修改成featurevibecoding即可。注意在仓库里面有说明:
- 一级标签(必选):feature:新功能 or bugfix:缺陷修复 or refactor 重构
- 二级标签(按照模块选):文档列了engine、cj-ui、docs、devtools、ide-plugins等
具体可以查看:Docs/zh-cn/contribute/doc-template/MergeRequest-template.md-代码预览-Docs:基于仓颉生态的高性能跨平台开发框架项目 - AtomGit

3.7 等待维护者审查并合入
最终通过门禁即可等待合入,至此CJMP的贡献流程完成。
