如何为 codex-desktop-linux 贡献代码：新手开发者指南与验证手册

如何为 codex-desktop-linux 贡献代码新手开发者指南与验证手册【免费下载链接】codex-desktop-linuxUnofficial ChatGPT desktop app for Linux (formerly the Codex app), built locally from OpenAI’s official macOS app. Includes Chat, Work, and Codex. Packages for Debian/Ubuntu (.deb), Fedora/openSUSE (.rpm), Arch (pacman), Nix/NixOS, and AppImage, with Wayland and X11 support.项目地址: https://gitcode.com/gh_mirrors/co/codex-desktop-linuxcodex-desktop-linux是为 Linux 打造的非官方 ChatGPT 桌面应用桌面菜单中显示为ChatGPT Community它基于 OpenAI 官方签名的 Linux 包重新打包提供 Chat、Work、Codex 三大能力并支持 deb、RPM、pacman、AppImage、Nix 五种安装包格式与 Wayland/X11 双桌面协议。本文为新手开发者提供一份完整的贡献代码指南从找到适合你的贡献方向、搭建构建环境到掌握项目内置的验证手册Validation Playbook一步步完成你的第一个 Pull Request 项目贡献入门先读懂三份核心文档在写第一行代码前官方要求先阅读项目约定。这三份文档决定了什么能改、什么不能改CONTRIBUTING.md — 贡献总则如何提 PR、验证清单、工程标准AGENTS.md — 硬性规则信任边界、生成物隔离、运行时不变量docs/agents/validation-playbook.md —验证手册源码检查、安全矩阵、包矩阵、更新器测试的完整清单一句话记住核心约束OpenAI 官方签名的 Linux 包是唯一上游禁止引入替代源格式干净构建不启用任何 ASAR 功能必须保证resources/app.asar逐字节一致。新手贡献方向5 类友好任务清单项目明确欢迎以下贡献按新手友好度从高到低排列 方向说明起步位置复现并记录回归问题针对当前官方稳定包复现 bug 并补充文档提 Issue 时附发行版、桌面会话、架构、包版本、功能 ID改进可选功能及测试完善默认关闭的 Linux 功能及其相邻测试linux-features/验证多平台矩阵deb/RPM/pacman/AppImage/Nix × Wayland/X11 × amd64/arm64见 docs/raspberry-pi-5.md 等文档改进安装器/更新器/打包提升安全覆盖与打包质量updater/src/、packaging/修正文档让文档与当前命令、运行时归属保持一致docs/添加一个功能的硬性要求每个功能模块linux-features/id/必须自包含包含feature.json、README.md、显式的defaultEnabled: false和覆盖其生效契约的测试。例如可以参照 linux-features/ui-tweaks/ 或 linux-features/read-aloud/ 的结构。编辑前的避坑规则这些目录永远别碰⚠️ 项目最严格的规则之一是只改源码所有者不碰生成物禁止编辑/提交codex-app/、codex-app-next/、codex-app.backup-*、dist/、dist-next/、target/、候选目录linux-features/features.json是本地状态文件不要把它提交进仓库核心 ASAR 补丁默认注册表为空新增核心补丁必须有复现的启动级故障 强制回归测试路径要加引号、破坏性操作要校验目标、避免通配符清理生成物的正确修法是改模板重新构建而不是就地修补。详见 docs/agents/generated-and-runtime-notes.md。环境搭建一键安装构建依赖并本地跑通克隆仓库并安装依赖git clone https://gitcode.com/gh_mirrors/co/codex-desktop-linux cd codex-desktop-linux bash scripts/install-deps.sh ./install.sh常用 Make 命令速查构建要求 Node.js 20、npm、Python 3、curl、gpgv、dpkg-deb、tar、make、C/C 工具链Rust 用于更新器与保留的 Rust 原生功能。完整定义见 Makefile命令作用make bootstrap-native自动安装构建依赖然后构建、打包并安装本发行版包新手首选make install-native跳过依赖安装直接构建、打包、安装make setup-native交互式配置可选功能向导不构建make deb/make rpm/make pacman/make appimage产出对应格式安装包到dist/make ci-pr/make ci-all运行本地 PR 套件 / 完整 CI 套件建议从当前main切出聚焦分支避免把格式变更、依赖刷新混进行为修改。验证手册从快速检查到完整 CI 的 3 层验证这是新手最容易忽视、也是项目最看重的部分。原则是先用最小相关集合共享改动再扩大覆盖面。完整清单见 docs/agents/validation-playbook.md。第 1 层快速源码检查提交前必跑bash -n install.sh scripts/lib/*.sh launcher/start.sh.template bash tests/scripts_smoke.sh node --test scripts/lib/upstream-linux-package.test.js node --test scripts/patch-linux-window-ui.test.js scripts/lib/linux-features.test.js linux-features/*/test.js cargo test -p codex-update-manager cargo clippy -p codex-update-manager --all-targets -- -D warnings覆盖 Shell 语法、冒烟测试、上游包校验逻辑、补丁引擎、Rust 更新器测试与 Clippy 静态检查。第 2 层按改动类型走专项矩阵功能改动运行相邻功能测试 单独启用该功能构建一次包内容改动检查 deb/RPM/pacman/AppImage/Nix 产物注意 AppImage 永不注入--no-sandbox上游源安全改动覆盖合法/损坏/未签名/错误密钥的InRelease、摘要不匹配、架构不支持等全部信任失败场景且必须失败即关闭更新器改动中断下载、信任失败、运行中构建、退出后提升、回滚、状态迁移仅文档改动检查 Markdown 链接、Make 目标与功能 ID 和源码一致并运行git diff --check第 3 层本地完整 CI./scripts/ci-local.sh pr # 标准 PR 套件core、deb、rpm、pacman ./scripts/ci-local.sh all # 追加 install-deps、nix、upstream该脚本基于容器在 Ubuntu/Debian/Fedora/Arch 等镜像中执行等价于线上 CI 的本地版本入口为 scripts/ci-local.sh。提交 Pull Request高质量 PR 的 5 要素问题与方案描述问题、用户可见行为变化影响面涉及的包格式、架构、功能 ID精确验证列出实际运行的验证命令与结果风险声明未测的手工矩阵、安全/回滚风险可审查的提交粒度优先先加回归测试再做修复其他红线不要自行给 PR 打仓库标签由维护者按 docs/label-governance.md 应用同一时间只保持一个 PR 打开绝不为让测试通过而削弱签名、哈希、沙箱、候选提升等安全校验。关键路径速查改动该去哪儿找不确定改哪个文件时按 docs/agents/repository-map.md 的路由表定位你想改的东西去这里上游包验证/提取逻辑scripts/lib/upstream-linux-package.js构建编排install.sh启动器行为launcher/start.sh.templateASAR 补丁引擎scripts/patches/、scripts/patch-linux-window-ui.jsLinux 可选功能linux-features/Rust 更新器updater/src/Nix 支持flake.nix、nix/小贴士删除任何描述符、辅助 crate 或脚本前先全局搜索它的所有消费者 总结为 codex-desktop-linux 贡献代码的路径非常清晰读三份核心文档 → 选一个聚焦任务 → 用make bootstrap-native跑通本地构建 → 按验证手册从最小检查逐步扩大到完整 CI → 提交包含 5 要素的 PR。保持改动小、测试先行、安全校验永不妥协你就能顺利合入第一个 PR。祝你贡献愉快【免费下载链接】codex-desktop-linuxUnofficial ChatGPT desktop app for Linux (formerly the Codex app), built locally from OpenAI’s official macOS app. Includes Chat, Work, and Codex. Packages for Debian/Ubuntu (.deb), Fedora/openSUSE (.rpm), Arch (pacman), Nix/NixOS, and AppImage, with Wayland and X11 support.项目地址: https://gitcode.com/gh_mirrors/co/codex-desktop-linux创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考