银河麒麟代码贡献必须通过GitHub提交PR,Bug反馈可选社区论坛或GitHub Issue,文档翻译则用GitLab;需确认系统版本、签署DCO、规范分支与提交信息。

你想在银河麒麟操作系统生态中提交代码改进或报告真实遇到的Bug,但发现官方没有明确指引入口,也不清楚该走哪个平台、用什么流程、是否需要签署CLA——这种困惑很常见,尤其当系统自带的“帮助”菜单里只写着“联系技术支持”。
确认你的身份与目标类型
先区分你是要提交代码补丁(如修复某个UKUI组件崩溃)、提交翻译/文档更新,还是仅反馈一个可复现的Bug。三者路径完全不同:【代码贡献必须通过GitHub提交PR,不能发邮件或工单】;而Bug反馈既可在社区论坛提交,也可在GitHub Issue中创建,但后者更易被开发团队直接追踪。
打开终端执行 cat /etc/os-release | grep -E "(VERSION_ID|ID_LIKE)",确认你使用的是银河麒麟V10 SP1/SP2或openKylin 2.0+版本。低于此版本的系统对应仓库已归档,新PR将不被受理。
向GitHub官方仓库提交代码补丁(PR)
银河麒麟桌面端核心组件(UKUI、kylin-update、kylin-security-manager等)及openKylin全量项目均托管于https://github.com/kylinsource 和 https://github.com/openkylin。商业版专属模块(如KMS内生安全子系统)不对外开放源码,不可提交PR。
方法一:直接Fork→Clone→Commit→Push→Create PR
第一步:访问 https://github.com/kylinsource/ukui-control-center → 点击右上角“Fork”,选择你的个人账户完成分叉。
第二步:在银河麒麟系统中打开终端,执行 git clone https://github.com/你的用户名/ukui-control-center.git → cd ukui-control-center。
第三步:添加上游远程源以便同步最新变更:git remote add upstream https://github.com/kylinsource/ukui-control-center.git → git fetch upstream → git checkout -b fix-brightness-slider-origin upstream/main。
这一步必须基于upstream/main而非本地master分支创建特性分支,否则CI检查会失败;分支名需体现修改意图,禁止使用feature1、test等模糊命名。
第四步:完成代码修改后,执行 git add . → git commit -m "fix(control-center): correct brightness slider range on ARM64 displays" → git push origin fix-brightness-slider-origin。
第五步:回到GitHub页面,点击“Compare & pull request”,填写标题与描述。描述中必须包含复现步骤、预期行为、实际行为,并附上截图或日志片段(如 journalctl -u ukui-control-center --since "2026-11-05 15:00:00")。
注意:所有PR必须签署Developer Certificate of Origin(DCO),即在commit message末尾添加 Signed-off-by: 你的真名 。未签名的PR会被自动关闭。
在麒麟社区论坛提交Bug报告
适合无法定位具体代码位置、仅能描述现象的用户,例如“点击任务栏音量图标后整个UKUI卡死3秒”“麒麟软件中心搜索中文包名无结果”。论坛地址为 https://bbs.kylinos.cn,需注册账号并完成手机实名认证(未实名用户无法发帖)。
进入“问题反馈→桌面环境”或“问题反馈→系统更新”版块,点击“发新帖”。标题格式必须为【V10 SP2】【UKUI 4.0.8】+ 具体现象,例如【V10 SP2】【UKUI 4.0.8】右键桌面空白处偶发无响应。
正文中需包含:【完整系统信息】:执行 inxi -Fxz | grep -E "(Kernel|Desktop|Machine)" 输出结果;【精确复现步骤】:不要写“经常出现”,要写“连续右键桌面5次,第3次必现”;【附加证据】:使用系统自带的“屏幕录制”工具录下前10秒操作过程,上传至附件(MP4格式,≤20MB)。
论坛帖子不会触发自动CI验证,但麒麟OS QA团队每日人工巡检,高优先级Bug(如导致数据丢失、权限越界)会在48小时内回复并分配内部编号(如KY-2026-1105-087)。
通过GitLab提交文档或翻译更新
银河麒麟官方文档(https://docs.kylinos.cn)和openKylin帮助中心(https://help.openkylin.top)使用GitLab Pages构建,源文件存于 https://gitlab.com/kylinsource/docs 和 https://gitlab.com/openkylin/help-center。此处接受非代码类轻量贡献。
方法二:在线编辑→提交MR
找到对应语言的Markdown文件(如zh_CN/installation.md),点击右上角铅笔图标,在Web界面直接修改错别字或补充缺失步骤,填写简短描述后点击“Propose changes”。系统将自动创建Merge Request,无需配置本地Git环境。
方法三:提交翻译建议(无需账号)
在任意文档页面底部点击“Edit this page on GitLab”,跳转后选择左下角“Suggest translation”,填写建议译文并提交。该操作不产生MR,由社区翻译组统一审核合并。

















