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

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

adapters/tools/claude-code.yaml

@@ -1,5 +1,5 @@
 # ============================================================
-# AgentDock 适配器 · Anthropic Claude Code（Wave 2 全字段）
+# AgentDock 适配器 · Anthropic Claude Code（Wave 2.1）
 # 数据依据：调研底稿 agent-cli-survey-2026-08-24.md §2 + 架构 §3.3
 # ============================================================
 id: claude-code
@@ -7,7 +7,7 @@ name: Claude Code
 name_zh: Claude Code
 vendor: Anthropic
 status: available
-adapter_version: 1.0.0
+adapter_version: 1.1.0
 license: 专有（仅官方渠道安装、不重打包、不修改二进制）
 
 platforms:
@@ -72,6 +72,9 @@ authorization:
       env_keys: [ANTHROPIC_API_KEY]
       notes_zh: 设置 ANTHROPIC_API_KEY 后 CLI 优先使用 API Key
 
+# 配置机制（调研底稿 §2「配置机制」）：用户级 ~/.claude/settings.json（JSON）
+# 官方确认：settings.json 内 env 块可注入环境变量；ANTHROPIC_API_KEY / ANTHROPIC_BASE_URL /
+#   ANTHROPIC_AUTH_TOKEN / ANTHROPIC_CUSTOM_HEADERS；默认模型经 /model 命令调整（非 settings.json 字段）。
 configuration:
   files:
     - path: "~/.claude/settings.json"
@@ -81,31 +84,37 @@ configuration:
     - key: ANTHROPIC_API_KEY
       sensitive: true
       maps_to_field: api_key
-    - key: ANTHROPIC_BASE_URL
-      sensitive: false
-      maps_to_field: base_url
+    - key: ANTHROPIC_AUTH_TOKEN
+      sensitive: true
+      maps_to_field: auth_token
   fields:
-    - id: model
-      label_zh: 默认模型
-      help_zh: Claude Code 使用的默认模型
-      required: false
-      sensitive: false
-      type: string
-      storage: file
     - id: env.ANTHROPIC_BASE_URL
       label_zh: Base URL
-      help_zh: 自定义 API 端点 / 网关 / 代理（写入 settings.json 的 env 块）
+      group: advanced
+      help_zh: 官方环境变量 ANTHROPIC_BASE_URL，写入 settings.json 的 env 块（自定义 API 端点/网关/代理）
       required: false
       sensitive: false
       type: url
       storage: file
+      docs_url: https://code.claude.com/docs/en/env-vars
     - id: api_key
       label_zh: API Key
-      help_zh: 存入系统密钥库（对应 ANTHROPIC_API_KEY）
+      group: auth
+      help_zh: 存入系统密钥库（对应 ANTHROPIC_API_KEY），设置后优先于订阅登录
       required: false
       sensitive: true
       type: string
       storage: keyring
+      docs_url: https://code.claude.com/docs/en/env-vars
+    - id: auth_token
+      label_zh: Bearer 令牌
+      group: auth
+      help_zh: 可选，存入系统密钥库（对应 ANTHROPIC_AUTH_TOKEN，Bearer 头）；一般用户无需填写
+      required: false
+      sensitive: true
+      type: string
+      storage: keyring
+      docs_url: https://code.claude.com/docs/en/env-vars
 
 diagnostics:
   - rule_id: path.not_installed
@@ -115,13 +124,38 @@ diagnostics:
 
 documentation:
   quickstart_zh: 安装后运行 `claude` 登录，或用 `claude -p "提示词"` 无头执行。
+  install_zh: 推荐 winget（`winget install Anthropic.ClaudeCode`）；也可走官方 PowerShell 脚本（irm https://claude.ai/install.ps1）或 npm（`@anthropic-ai/claude-code`，Node 22+）。
+  auth_zh: ① 浏览器 OAuth：运行 `claude` 按提示登录（Pro/Max/Team/Enterprise/Console 账号；免费版不含 Claude Code）；② API Key：设置 ANTHROPIC_API_KEY 后 CLI 优先使用（非交互 -p 模式下有 key 即直接使用）。
   commands:
     - cmd: claude
       desc_zh: 启动交互式会话
     - cmd: claude -p "提示词"
-      desc_zh: 无头单次执行
+      desc_zh: 无头单次执行（--print）
+    - cmd: claude -p "提示词" --output-format json
+      desc_zh: 结构化 JSON 输出
+    - cmd: claude --allowedTools "Bash(git:*)"
+      desc_zh: 预授权指定工具
+    - cmd: claude --continue
+      desc_zh: 续接最近的会话
+    - cmd: claude --resume <会话ID>
+      desc_zh: 恢复指定会话
     - cmd: claude doctor
       desc_zh: 环境诊断
-  updated_at: "2026-08-24"
+    - cmd: claude --version
+      desc_zh: 显示版本号
+  params:
+    - param: -p / --print
+      desc_zh: 非交互模式，执行后退出
+    - param: --output-format
+      desc_zh: 输出格式（text / json / stream-json）
+    - param: --json-schema
+      desc_zh: 约束输出为指定 JSON Schema
+    - param: --allowedTools
+      desc_zh: 预授权工具列表
+    - param: --bare
+      desc_zh: 极简启动模式
+  updated_at: "2026-08-25"
   risks_zh:
-    - 专有许可：只引导官方渠道安装，不重打包、不修改二进制
+    - 专有许可：只引导官方渠道安装，不重打包、不修改二进制、不代付费
+    - 原生 Windows 无沙箱功能，需要沙箱请使用 WSL2（以官方文档为准）
+    - 默认模型经 /model 命令调整，非 settings.json 字段，故本表单未提供模型字段

adapters/tools/codex.yaml

@@ -1,5 +1,5 @@
 # ============================================================
-# AgentDock 适配器 · OpenAI Codex CLI（Wave 2 全字段）
+# AgentDock 适配器 · OpenAI Codex CLI（Wave 2.1）
 # 数据依据：调研底稿 agent-cli-survey-2026-08-24.md §1 + 架构 §3.3
 # ============================================================
 id: codex
@@ -7,7 +7,7 @@ name: Codex CLI
 name_zh: Codex CLI
 vendor: OpenAI
 status: available
-adapter_version: 1.0.0
+adapter_version: 1.1.0
 license: Apache-2.0
 
 platforms:
@@ -76,6 +76,10 @@ authorization:
       env_keys: [OPENAI_API_KEY]
       notes_zh: API Key 从系统密钥库读取，经 stdin 注入，不进 argv
 
+# 配置机制（调研底稿 §1「配置机制」）：用户级 ~/.codex/config.toml（TOML）
+# 官方确认可配：model / approval_policy / sandbox_mode / model_reasoning_effort /
+#   web_search / log_dir / [model_providers.<id>]（base_url / env_key / wire_api）/
+#   简化键 openai_base_url。表单字段名与官方文档一致。
 configuration:
   files:
     - path: "~/.codex/config.toml"
@@ -85,31 +89,52 @@ configuration:
     - key: OPENAI_API_KEY
       sensitive: true
       maps_to_field: api_key
-    - key: OPENAI_BASE_URL
-      sensitive: false
-      maps_to_field: openai_base_url
   fields:
     - id: model
       label_zh: 默认模型
-      help_zh: Codex 使用的默认模型（如 gpt-5.6-terra）
+      group: common
+      help_zh: 官方键 model，如 gpt-5.6-terra（对应官方 config-basic 文档）
       required: false
       sensitive: false
       type: string
       storage: file
+      docs_url: https://learn.chatgpt.com/docs/config-file/config-basic
+    - id: approval_policy
+      label_zh: 审批策略
+      group: advanced
+      help_zh: 官方键 approval_policy，控制执行命令前是否需人工确认
+      required: false
+      sensitive: false
+      type: enum
+      storage: file
+      docs_url: https://learn.chatgpt.com/docs/config-file/config-basic
+      options:
+        - value: untrusted
+          label_zh: 不信任（全部确认）
+        - value: on-failure
+          label_zh: 失败时确认
+        - value: on-request
+          label_zh: 每次请求确认
+        - value: never
+          label_zh: 永不确认
     - id: openai_base_url
       label_zh: Base URL
-      help_zh: 自定义 OpenAI 兼容端点（简化键）
+      group: advanced
+      help_zh: 官方简化键 openai_base_url，自定义 OpenAI 兼容端点/网关/代理
       required: false
       sensitive: false
       type: url
       storage: file
+      docs_url: https://learn.chatgpt.com/docs/config-file/config-advanced
     - id: api_key
       label_zh: API Key
-      help_zh: 存入系统密钥库，写入后仅显示「已保存」
+      group: auth
+      help_zh: 存入系统密钥库（对应环境变量 OPENAI_API_KEY），写入后仅显示「已保存」；也可用 codex login --with-api-key 注入
       required: false
       sensitive: true
       type: string
       storage: keyring
+      docs_url: https://learn.chatgpt.com/docs/config-file/config-advanced
 
 diagnostics:
   - rule_id: path.not_installed
@@ -118,14 +143,44 @@ diagnostics:
   - rule_id: config.corrupt
 
 documentation:
-  quickstart_zh: 安装后运行 `codex` 登录账号，或用 `codex exec "任务"` 无头执行。
+  quickstart_zh: 安装后运行 `codex` 登录 ChatGPT 账号，或用 `codex exec "任务"` 无头执行。
+  install_zh: 推荐 `npm install -g @openai/codex`（本适配器默认渠道）；也可走官方 PowerShell 脚本（irm https://chatgpt.com/codex/install.ps1）或 GitHub Releases 二进制。
+  auth_zh: 三种授权：① 浏览器登录 ChatGPT 账号（`codex login`，需订阅计划）；② 设备码（`codex login --device-auth`）；③ API Key（`codex login --with-api-key`，从 stdin 读取，或经 OPENAI_API_KEY 环境变量）。
   commands:
     - cmd: codex
       desc_zh: 启动交互式会话
     - cmd: codex exec "提示词"
-      desc_zh: 无头单次执行
+      desc_zh: 无头单次执行（别名 codex e）
+    - cmd: codex exec --json "提示词"
+      desc_zh: 以 JSONL 事件流输出
+    - cmd: codex exec --output-schema <schema>
+      desc_zh: 约束输出为指定 JSON Schema
+    - cmd: codex exec -o 文件
+      desc_zh: 将输出写入文件
+    - cmd: codex exec --sandbox
+      desc_zh: 在沙箱中执行
+    - cmd: codex login
+      desc_zh: 浏览器登录 ChatGPT 账号
+    - cmd: codex login --device-auth
+      desc_zh: 设备码流程登录
+    - cmd: codex login --with-api-key
+      desc_zh: 从 stdin 读取 API Key 登录
     - cmd: codex login status
-      desc_zh: 查询登录状态
-  updated_at: "2026-08-24"
+      desc_zh: 查询当前登录状态
+  params:
+    - param: --json
+      desc_zh: 以 JSONL 事件流输出（exec 子命令）
+    - param: --output-schema
+      desc_zh: 约束输出为指定 JSON Schema
+    - param: -o / --output
+      desc_zh: 输出写入文件
+    - param: --ephemeral
+      desc_zh: 使用不落盘的临时会话
+    - param: --sandbox
+      desc_zh: 在沙箱中执行
+    - param: --device-auth
+      desc_zh: 使用设备码流程登录（login 子命令）
+  updated_at: "2026-08-25"
   risks_zh:
     - --version 官方文档未确认，适配器已标 version_unconfirmed 并实测兜底
+    - 表单覆盖常用配置键；model_providers 表等高级自定义 provider 请以官方文档为准（见上方链接）

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 高级配置本表单不覆盖，以官方文档为准

adapters/tools/kimi.yaml

@@ -1,5 +1,5 @@
 # ============================================================
-# AgentDock 适配器 · Kimi CLI（月之暗面 Moonshot）（Wave 2 全字段）
+# AgentDock 适配器 · Kimi CLI（月之暗面 Moonshot）（Wave 2.1）
 # 数据依据：调研底稿 agent-cli-survey-2026-08-24.md（Kimi 章节）+ 架构 §3.3
 # 铁律：只走官方 code.kimi.com 脚本 / PyPI kimi-cli，严禁 npm（仿名包）。
 # ============================================================
@@ -8,7 +8,7 @@ name: Kimi CLI
 name_zh: Kimi CLI
 vendor: 月之暗面
 status: available
-adapter_version: 1.0.0
+adapter_version: 1.1.0
 license: Apache-2.0
 
 platforms:
@@ -78,6 +78,9 @@ authorization:
       env_keys: [KIMI_API_KEY]
       notes_zh: Moonshot 开放平台 API Key
 
+# 配置机制（调研底稿 Kimi 章节）：~/.kimi/config.toml（TOML，兼容 JSON）
+# 可配 default_model、providers（type/base_url/api_key）、models 等；
+# 环境变量：KIMI_API_KEY / KIMI_BASE_URL / KIMI_MODEL_NAME / KIMI_MODEL_TEMPERATURE。
 configuration:
   files:
     - path: "~/.kimi/config.toml"
@@ -87,31 +90,34 @@ configuration:
     - key: KIMI_API_KEY
       sensitive: true
       maps_to_field: api_key
-    - key: KIMI_BASE_URL
-      sensitive: false
-      maps_to_field: base_url
   fields:
     - id: default_model
       label_zh: 默认模型
-      help_zh: Kimi CLI 使用的默认模型
+      group: common
+      help_zh: 官方键 default_model，Kimi CLI 使用的默认模型
       required: false
       sensitive: false
       type: string
       storage: file
+      docs_url: https://moonshotai.github.io/kimi-cli/en/configuration/config-files.html
     - id: env.KIMI_BASE_URL
       label_zh: Base URL
-      help_zh: 自定义 OpenAI 兼容端点
+      group: advanced
+      help_zh: 官方环境变量 KIMI_BASE_URL（自定义 OpenAI 兼容端点）；写入 config.toml 的 env 表，若需进程级生效请以官方 env-vars 文档为准
       required: false
       sensitive: false
       type: url
       storage: file
+      docs_url: https://moonshotai.github.io/kimi-cli/en/configuration/env-vars.html
     - id: api_key
       label_zh: API Key
-      help_zh: 存入系统密钥库（对应 KIMI_API_KEY）
+      group: auth
+      help_zh: 存入系统密钥库（对应环境变量 KIMI_API_KEY，Moonshot 开放平台获取）
       required: false
       sensitive: true
       type: string
       storage: keyring
+      docs_url: https://moonshotai.github.io/kimi-cli/en/configuration/env-vars.html
 
 diagnostics:
   - rule_id: path.not_installed
@@ -123,14 +129,42 @@ diagnostics:
 
 documentation:
   quickstart_zh: 安装后运行 `kimi login` 登录，或用 `kimi -p "提示词"` 无头执行。
+  install_zh: 只走官方渠道：`uv tool install kimi-cli`（本适配器默认）或官方脚本 code.kimi.com/install.sh（install.ps1）。脚本会自动装 uv 并从 PyPI kimi-cli 安装。严禁 npm（npm 上的 kimi-code 是第三方仿名包）。
+  auth_zh: ① Kimi Code 浏览器 OAuth（推荐，`kimi login`）；② Moonshot 开放平台 API Key（platform 侧获取后粘贴，经 KIMI_API_KEY 注入）。`kimi logout` 清除 OAuth 凭据。
   commands:
     - cmd: kimi
       desc_zh: 启动交互式会话
     - cmd: kimi login
       desc_zh: 登录（浏览器 OAuth 或 API Key）
+    - cmd: kimi logout
+      desc_zh: 清除 OAuth 凭据
     - cmd: kimi -p "提示词"
       desc_zh: 无头单次执行
-  updated_at: "2026-08-24"
+    - cmd: kimi --output-format stream-json -p "提示词"
+      desc_zh: print 模式 JSON 流输出
+    - cmd: kimi --quiet
+      desc_zh: 静默模式
+    - cmd: kimi --version
+      desc_zh: 显示版本号
+    - cmd: kimi info
+      desc_zh: 显示版本与协议信息
+    - cmd: kimi acp
+      desc_zh: IDE 集成 stdio（ACP 协议）
+  params:
+    - param: -p / --prompt
+      desc_zh: 处理后退出（无头模式）
+    - param: --print
+      desc_zh: 打印模式
+    - param: --output-format
+      desc_zh: 输出格式（如 stream-json）
+    - param: --quiet
+      desc_zh: 静默模式
+    - param: --afk
+      desc_zh: 离键模式
+    - param: --config-file
+      desc_zh: 指定配置文件路径
+  updated_at: "2026-08-25"
   risks_zh:
     - 严禁 npm：npm 上的 kimi-code 是第三方仿名包，与月之暗面无关
-    - 官方脚本会自动安装 uv 并从 PyPI kimi-cli 安装
+    - 官方脚本会自动安装 uv 并从 PyPI kimi-cli 安装（Python 3.12–3.14）
+    - providers 表（type/base_url/api_key 多 provider）等高级配置本表单不覆盖，以官方 config-files 文档为准

adapters/tools/opencode.yaml

@@ -1,5 +1,5 @@
 # ============================================================
-# AgentDock 适配器 · OpenCode（opencode.ai）（Wave 2 全字段）
+# AgentDock 适配器 · OpenCode（opencode.ai）（Wave 2.1）
 # 数据依据：调研底稿 agent-cli-survey-2026-08-24.md（OpenCode 章节）+ 架构 §3.3
 # ============================================================
 id: opencode
@@ -7,7 +7,7 @@ name: OpenCode
 name_zh: OpenCode
 vendor: opencode.ai
 status: available
-adapter_version: 1.0.0
+adapter_version: 1.1.0
 license: MIT
 
 platforms:
@@ -80,6 +80,9 @@ authorization:
     - mode: device_code
       notes_zh: GitHub Copilot 设备码登录（github.com/login/device 输码）
 
+# 配置机制（调研底稿 OpenCode 章节）：全局 ~/.config/opencode/opencode.json（JSON，带注释 jsonc 亦可）
+# model 字段设默认模型；每个 provider 可单独改 baseURL（含本地 Ollama/LM Studio 等 OpenAI 兼容端点）；
+# API Key 用环境变量引用接入，也可在 TUI 用 /connect 交互保存（凭据落 ~/.local/share/opencode/auth.json）。
 configuration:
   files:
     - path: "~/.config/opencode/opencode.json"
@@ -95,18 +98,31 @@ configuration:
   fields:
     - id: model
       label_zh: 默认模型
-      help_zh: OpenCode 使用的默认模型
+      group: common
+      help_zh: 官方键 model，全局默认模型（如 anthropic/claude-sonnet-4）
       required: false
       sensitive: false
       type: string
       storage: file
+      docs_url: https://opencode.ai/docs/config/
+    - id: provider
+      label_zh: 默认 Provider
+      group: common
+      help_zh: 官方键 provider，指定默认模型提供方（可选；留空则用模型名推断）
+      required: false
+      sensitive: false
+      type: string
+      storage: file
+      docs_url: https://opencode.ai/docs/providers/
     - id: api_key
       label_zh: API Key
-      help_zh: 存入系统密钥库（对应 OPENAI_API_KEY / ANTHROPIC_API_KEY）
+      group: auth
+      help_zh: 存入系统密钥库（对应 OPENAI_API_KEY / ANTHROPIC_API_KEY 等环境变量）；也可在 TUI 用 /connect 交互保存
       required: false
       sensitive: true
       type: string
       storage: keyring
+      docs_url: https://opencode.ai/docs/providers/
 
 diagnostics:
   - rule_id: path.not_installed
@@ -115,14 +131,38 @@ diagnostics:
   - rule_id: config.corrupt
 
 documentation:
-  quickstart_zh: 安装后运行 `opencode` 或 `opencode run "提示词"` 无头执行。
+  quickstart_zh: 安装后运行 `opencode`，或用 `opencode run "提示词"` 无头执行。
+  install_zh: 多渠道：npm `opencode-ai`（本适配器默认）、Windows choco/scoop、Linux 官方脚本、Homebrew。桌面版另有原生 .exe 安装器。
+  auth_zh: 授权面最全：① 纯 API Key（各家环境变量）；② 浏览器 OAuth（Claude Pro/Max、ChatGPT 订阅）；③ 设备码（GitHub Copilot，github.com/login/device 输码）；④ 企业级 OAuth。不绑定特定厂商。
   commands:
     - cmd: opencode
       desc_zh: 启动交互式会话
     - cmd: opencode run "提示词"
       desc_zh: 无头单次执行
+    - cmd: opencode run "提示词" --model <模型>
+      desc_zh: 指定模型无头执行
+    - cmd: opencode auth login
+      desc_zh: 浏览器 OAuth 登录
     - cmd: opencode auth list
       desc_zh: 查看已配置凭据
-  updated_at: "2026-08-24"
+    - cmd: opencode upgrade
+      desc_zh: 自升级
+    - cmd: opencode serve
+      desc_zh: 无头 HTTP 服务器模式
+    - cmd: opencode --version
+      desc_zh: 显示版本号
+  params:
+    - param: run "提示词"
+      desc_zh: 一次性执行后退出
+    - param: --model
+      desc_zh: 指定模型
+    - param: --format json
+      desc_zh: JSON 事件流输出
+    - param: --auto-approve
+      desc_zh: 自动批准权限请求
+    - param: -v / --version
+      desc_zh: 显示版本号
+  updated_at: "2026-08-25"
   risks_zh:
     - 官方未文档化安装包校验（SHA256/签名），适配器不强制校验
+    - 每个 provider 的 baseURL 高级配置（本地 Ollama/LM Studio 等）本表单不覆盖，以官方 providers 文档为准