开发与贡献
理解 Gemini CLI 包结构,搭建源码环境,选择集成测试、回归测试和行为评估。
This page has not been translated into English yet. The original Chinese version is shown below.
本目录面向修改 Gemini CLI 本身的贡献者。这里的 npm scripts、测试目录和发布流程属于官方 Gemini CLI 源码仓库,不是在任意业务项目里运行的通用命令。
理解和修改源码
选择验证方式
发布与仓库管理
In this section
- 架构与包结构区分终端界面、核心代理循环和 npm 发布包,理解上下文、工具与回退服务。
- 贡献流程与文档规范按官方 issue、CLA、审阅和 preflight 要求提交 Gemini CLI 代码与文档变更。
- 源码构建与本地调试在官方源码仓库构建 CLI,使用 Node、React DevTools 和本地 OpenTelemetry 查看运行行为。
- 集成测试与沙箱矩阵构建实际测试 bundle,筛选端到端用例,重新生成模型响应并保留失败产物。
- 内存与性能回归测试运行独立基线测试,理解中位数、异常值过滤和更新基线的含义。
- 行为评估与 EDK编写验证工具行为的 eval,使用静态校验、重复运行和 JSON 报告检查质量。
- 发布渠道与维护流程理解 npm 渠道、版本完整性检查、手动发布与 dry run 的作用。
- 发布补丁与渠道回退通过补丁 PR 将 main 修复带入发行分支,区分更换 npm tag 与发布新版本。
- 发布验收与稳定性门槛结合 CI、E2E、安装冒烟、预览使用和真实用户流程决定发布是否就绪。
- 官方仓库自动分流与 PR 管理理解 issue 标签、PR 关联、领取超时与大小标签,按机器人反馈补齐信息。