开发与贡献
理解 Gemini CLI 包结构，搭建源码环境，选择集成测试、回归测试和行为评估。
本目录面向修改 Gemini CLI 本身的贡献者。这里的 npm scripts、测试目录和发布流程属于官方 Gemini CLI 源码仓库，不是在任意业务项目里运行的通用命令。
理解和修改源码
选择验证方式
发布与仓库管理
本节文档
- 架构与包结构区分终端界面、核心代理循环和 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 关联、领取超时与大小标签，按机器人反馈补齐信息。