# ============================================================
# AgentDock 适配器 · Google Gemini CLI（Wave 2 全字段）
# 数据依据：调研底稿 agent-cli-survey-2026-08-24.md §3 + 架构 §3.3
# ============================================================
id: gemini
name: Gemini CLI
name_zh: Gemini CLI
vendor: Google
status: available
adapter_version: 1.0.0
license: Apache-2.0

platforms:
  windows:
    architectures: [x64]
    notes: 官方要求 Windows 11 24H2+
  linux:
    distributions: [ubuntu]
    architectures: [x64]
    min_ubuntu: "20.04"

official:
  homepage: https://github.com/google-gemini/gemini-cli
  docs: https://geminicli.com/docs/get-started/installation/
  allowed_hosts: [registry.npmjs.org, geminicli.com, github.com]

runtime_deps:
  - id: node
    semver_range: ">=20"
    required_for: [install, run]

install:
  preferred: npm
  channels:
    - id: npm
      platforms: [windows, linux]
      command: [npm, install, -g, "@google/gemini-cli"]
      package: "@google/gemini-cli"
      elevate: never
      post_checks: [detect]

detect:
  executable: gemini
  version_args: ["--version"]

update:
  method: npm_update
  command: [npm, update, -g, "@google/gemini-cli"]

uninstall:
  method: npm_uninstall
  command: [npm, uninstall, -g, "@google/gemini-cli"]
  keep_config_default: true

authorization:
  modes:
    - mode: browser_oauth
      command: [gemini]
      notes_zh: 运行 gemini 选「Sign in with Google」浏览器登录
    - mode: api_key
      env_keys: [GEMINI_API_KEY]
      notes_zh: 设置 GEMINI_API_KEY 环境变量（AI Studio 申请）

configuration:
  files:
    - path: "~/.gemini/settings.json"
      format: json
      scope: user
  environment:
    - key: GEMINI_API_KEY
      sensitive: true
      maps_to_field: api_key
    - key: GOOGLE_GEMINI_BASE_URL
      sensitive: false
      maps_to_field: base_url
  fields:
    - id: model.name
      label_zh: 默认模型
      help_zh: Gemini CLI 使用的默认模型
      required: false
      sensitive: false
      type: string
      storage: file
    - id: env.GOOGLE_GEMINI_BASE_URL
      label_zh: Base URL
      help_zh: 覆盖 Gemini API 默认地址（须 HTTPS，代理/网关场景）
      required: false
      sensitive: false
      type: url
      storage: file
    - id: api_key
      label_zh: API Key
      help_zh: 存入系统密钥库（对应 GEMINI_API_KEY）
      required: false
      sensitive: true
      type: string
      storage: keyring

diagnostics:
  - rule_id: path.not_installed
  - rule_id: path.not_in_path
  - rule_id: dependency.node_below_min
  - rule_id: version_conflict.multiple_copies
  - rule_id: config.corrupt

documentation:
  quickstart_zh: 安装后运行 `gemini` 登录，或用 `gemini -p "提示词"` 无头执行。
  commands:
    - cmd: gemini
      desc_zh: 启动交互式会话
    - cmd: gemini -p "提示词"
      desc_zh: 强制非交互单次执行
  updated_at: "2026-08-24"
  risks_zh:
    - 官方发行形态为 npm 包，依赖 Node 20+，适配器已声明运行时门槛
    - Windows 官方要求 11 24H2+，低版本 Win10 显示「官方未支持」