集成与自动化

📖 本篇术语速查表

英文 / 缩写	中文	一句话解释
集成与自动化	integration	集成和自动化能力的总览。
按需选用	pick	按需求选该用什么。
安全自动化	safe	自动化守权限和审查。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你按需求在 Gemini CLI 的集成与自动化各能力里选该用什么。

你是 Gemini CLI 集成与自动化导航顾问。

【角色】
Gemini CLI 集成与自动化导航顾问，按最小够用、安全合规优先的原则给可落地方案，每条结论都落到能照做的步骤或示例，不停留在空泛建议。

【输入】
- 我的需求（IDE / hook / 脚本 / CI / 本地）：___
- 是交互用还是自动化：___
- 涉及写操作 / 联网吗：___
- 团队还是个人：___
- 经验水平：___

【工作流程】
1. 把需求归到对应能力
2. 区分交互用还是自动化
3. 涉及自动化时提示权限和审查
4. 给该先做什么
5. 给落地下一步

【输出规范】
▌一、需求归类
▌二、交互 vs 自动化
▌三、自动化的权限审查
▌四、落地下一步

【硬约束】
- 自动化守最小权限
- 会改代码的自动化要有审查
- 凭据安全处理
- 不要替我臆测情况或编造不存在的配置，信息不全先问清
- 不确定的配置或接口一律以官方文档为准，禁止照搬过时写法

Gemini CLI 不只适合在终端聊天。真正落地时，它会进入 IDE、Shell 脚本、CI、GitHub issue、PR review 和本地开发环境。

这一组页面解决“如何把 Gemini CLI 放进工作流”的问题。先选入口，再看权限、输入输出和失败兜底。

学习路径

flowchart LR
    IDE["IDE integration"] --> Hooks["Hooks"]
    Hooks --> Headless["Headless mode"]
    Headless --> Automation["Shell / CI automation"]
    Automation --> GitHub["GitHub Action"]
    GitHub --> IssuePR["Issue / PR automation"]
    IssuePR --> LocalDev["Local development"]
    LocalDev --> Troubleshooting["Troubleshooting"]

    style IDE fill:#dbeafe,stroke:#3b82f6
    style Headless fill:#dcfce7,stroke:#22c55e
    style GitHub fill:#fef3c7,stroke:#f59e0b

IDE + Hooks

人在编辑器里工作时，先看 IDE companion 和 lifecycle hooks。

Headless + Automation

需要脚本化或 CI 调用时，从 headless mode 开始。

GitHub Action

需要 issue、PR、review 自动化时，进入 run-gemini-cli GitHub Action。

页面	适合场景
IDE 集成	需要编辑器上下文、原生 diff、ACP
Hooks	需要在工具调用前后插入校验、阻断或日志
Headless mode	需要非交互式调用 Gemini CLI
自动化脚本	需要把 CLI 放进 Shell、CI 或批处理
GitHub Action	需要在 GitHub workflow 里运行 Gemini CLI
Issue 与 PR 自动化	需要自动分诊 issue、生成回复、辅助 PR review
本地开发	需要贡献 Gemini CLI 或排查 CLI 自身 bug

选择方式

人在 IDE 里工作     IDE companion 或 ACP
需要流程拦截        hooks
需要脚本调用        headless mode
需要 CI 自动处理    run-gemini-cli GitHub Action
需要改 Gemini CLI   本地开发流程

进入前检查

检查项	为什么重要
输入是否可重复	自动化必须能在无人工补充的情况下复跑
输出是否可审计	CI、issue 和 PR 场景要能追踪 Gemini 做了什么
权限是否收窄	hooks、headless、GitHub Action 都可能放大工具权限
失败是否可兜底	自动化失败要回到日志、人工 review 或普通 CLI

下一步

先读：IDE 集成。