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 字段，故本表单未提供模型字段