Wave 2.1: 返工黑屏/安装进度/官方配置三层/文档深度/真机列表

老板实测 5 条修复：DiagTab Hooks 黑屏、安装三阶段进度、配置按官方字段三层分组、FR-09 中文文档、detectCliAll 接入列表页。

adapters/tools/gemini.yaml

@@ -1,5 +1,5 @@
 # ============================================================
-# AgentDock 适配器 · Google Gemini CLI（Wave 2 全字段）
+# AgentDock 适配器 · Google Gemini CLI（Wave 2.1）
 # 数据依据：调研底稿 agent-cli-survey-2026-08-24.md §3 + 架构 §3.3
 # ============================================================
 id: gemini
@@ -7,7 +7,7 @@ name: Gemini CLI
 name_zh: Gemini CLI
 vendor: Google
 status: available
-adapter_version: 1.0.0
+adapter_version: 1.1.0
 license: Apache-2.0
 
 platforms:
@@ -61,6 +61,9 @@ authorization:
       env_keys: [GEMINI_API_KEY]
       notes_zh: 设置 GEMINI_API_KEY 环境变量（AI Studio 申请）
 
+# 配置机制（调研底稿 §3「配置机制」）：用户级 ~/.gemini/settings.json（JSON，官方发布 JSON Schema）
+# 关键键：model.name（默认模型）、security.auth.selectedType（认证方式）；
+# 环境变量：GEMINI_API_KEY / GOOGLE_GEMINI_BASE_URL（须 HTTPS）/ GEMINI_MODEL。
 configuration:
   files:
     - path: "~/.gemini/settings.json"
@@ -70,31 +73,34 @@ configuration:
     - 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 使用的默认模型
+      group: common
+      help_zh: 官方键 model.name，settings.json 中的默认模型
       required: false
       sensitive: false
       type: string
       storage: file
+      docs_url: https://geminicli.com/docs/reference/configuration/
     - id: env.GOOGLE_GEMINI_BASE_URL
       label_zh: Base URL
-      help_zh: 覆盖 Gemini API 默认地址（须 HTTPS，代理/网关场景）
+      group: advanced
+      help_zh: 官方环境变量 GOOGLE_GEMINI_BASE_URL（覆盖 Gemini API 默认地址，须 HTTPS，代理/网关场景）；写入 settings.json 的 env 块
       required: false
       sensitive: false
       type: url
       storage: file
+      docs_url: https://geminicli.com/docs/reference/configuration/
     - id: api_key
       label_zh: API Key
-      help_zh: 存入系统密钥库（对应 GEMINI_API_KEY）
+      group: auth
+      help_zh: 存入系统密钥库（对应环境变量 GEMINI_API_KEY，AI Studio 申请）
       required: false
       sensitive: true
       type: string
       storage: keyring
+      docs_url: https://geminicli.com/docs/get-started/authentication/
 
 diagnostics:
   - rule_id: path.not_installed
@@ -104,13 +110,39 @@ diagnostics:
   - rule_id: config.corrupt
 
 documentation:
-  quickstart_zh: 安装后运行 `gemini` 登录，或用 `gemini -p "提示词"` 无头执行。
+  quickstart_zh: 安装后运行 `gemini` 选「Sign in with Google」登录，或用 `gemini -p "提示词"` 无头执行。
+  install_zh: 推荐 `npm install -g @google/gemini-cli`（需 Node 20+）；免安装可用 `npx @google/gemini-cli` 临时试用。
+  auth_zh: ① Google 账号 OAuth：运行 `gemini` 选「Sign in with Google」浏览器登录（免费档 60 请求/分钟）；② API Key：设置 GEMINI_API_KEY 环境变量（AI Studio 申请，免费档 1000 请求/天）；③ Vertex AI 走 ADC/服务账号（本表单不覆盖）。
   commands:
     - cmd: gemini
       desc_zh: 启动交互式会话
     - cmd: gemini -p "提示词"
-      desc_zh: 强制非交互单次执行
-  updated_at: "2026-08-24"
+      desc_zh: 强制非交互模式，单次执行
+    - cmd: gemini -p "提示词" --output-format json
+      desc_zh: 以 JSON 输出结果
+    - cmd: gemini -m <模型>
+      desc_zh: 指定模型
+    - cmd: gemini -i
+      desc_zh: 执行后进入交互模式
+    - cmd: gemini --version
+      desc_zh: 显示版本号
+    - cmd: npx @google/gemini-cli
+      desc_zh: 免安装临时运行
+    - cmd: GEMINI_API_KEY=<key> gemini
+      desc_zh: 用 API Key 环境变量启动
+  params:
+    - param: -p / --prompt
+      desc_zh: 强制非交互模式
+    - param: --output-format
+      desc_zh: 输出格式（text / json / stream-json）
+    - param: -m / --model
+      desc_zh: 指定模型
+    - param: -i
+      desc_zh: 执行后转交互
+    - param: -v / --version
+      desc_zh: 显示版本号并退出
+  updated_at: "2026-08-25"
   risks_zh:
     - 官方发行形态为 npm 包，依赖 Node 20+，适配器已声明运行时门槛
     - Windows 官方要求 11 24H2+，低版本 Win10 显示「官方未支持」
+    - Vertex AI（ADC/服务账号）与 security.auth.selectedType 高级配置本表单不覆盖，以官方文档为准