Wave 2: 五件套打通全链路(安装/检测/配置/授权/诊断)

- 五个适配器 YAML 全字段补齐(codex/claude-code/gemini/kimi/opencode)
- agentdock-config:TOML/JSON 编解码 + 原子写 + 自动备份
- agentdock-diag:PATH/依赖版本/版本冲突/配置损坏四类规则
- agentdock-core:detectCli/previewAction/runAction 流式/readConfig/writeConfig/authStatus/diagnose
- Tauri IPC 命令 + CLI 详情页/安装确认弹窗/配置表单/诊断页
- cargo test 75 项通过(含 4 项真机 ignored 自测),前端 build 通过
This commit is contained in:
leefer
2026-08-25 08:58:38 +08:00
parent c47494180b
commit 01996a80fe
33 changed files with 9404 additions and 152 deletions
+120 -21
View File
@@ -1,28 +1,127 @@
# ============================================================
# AgentDock 适配器占位(Wave 1,对齐架构 §3.1 完整 schema
# 本波仅填五字段(id/name/name_zh/vendor/status);其余字段留空,
# Wave 2 起按调研底稿 agent-cli-survey-2026-08-24.md 逐项填充,禁止编造。
#
# 完整字段(全部留空占位,Wave 2 填写):
# adapter_version # semver,如 1.2.0
# license # 展示用;专有许可注明「仅官方渠道安装、不重打包」
# platforms # windows/linuxarchitectures、notes、min_ubuntu
# official # homepage / docs / allowed_hosts(网络白名单)
# runtime_deps # [ { id, semver_range, required_for: [install|run] } ]
# install # preferred + channels[ {id, platforms, command[], script, package, elevate, elevate_reason_zh, post_checks} ]
# detect # executable / version_args / version_regex / version_unconfirmed / path_hints
# update # method + command[]
# uninstall # method + command[] + keep_config_default
# authorization # modes[ {mode, command[], env_keys[], status_command[], notes_zh} ]
# configuration # files[] / environment[] / fields[]
# diagnostics # [ { rule_id } ]
# documentation # quickstart_zh / commands[] / updated_at / risks_zh[]
#
# 铁律:所有 command 一律 argv 数组,禁止 shell 元字符(| & ; $ \ > < (`);
# 本波不实现任何真实安装/检测/配置/授权命令(那是 Wave 2 的事)。
# AgentDock 适配器 · Anthropic Claude CodeWave 2 全字段
# 数据依据:调研底稿 agent-cli-survey-2026-08-24.md §2 + 架构 §3.3
# ============================================================
id: claude-code
name: Claude Code
name_zh: Claude Code
vendor: Anthropic
status: available
adapter_version: 1.0.0
license: 专有(仅官方渠道安装、不重打包、不修改二进制)
platforms:
windows:
architectures: [x64]
notes: 原生支持,Windows 10 1809+ / Windows Server 2019+
linux:
distributions: [ubuntu]
architectures: [x64]
min_ubuntu: "20.04"
official:
homepage: https://claude.ai
docs: https://code.claude.com/docs/en/setup
allowed_hosts: [claude.ai, registry.npmjs.org, github.com]
runtime_deps: []
install:
preferred: winget
channels:
- id: winget
platforms: [windows]
command: [winget, install, Anthropic.ClaudeCode]
package: Anthropic.ClaudeCode
elevate: never
post_checks: [detect]
- id: official_script
platforms: [windows]
script:
url: https://claude.ai/install.ps1
kind: powershell_irm
elevate: never
post_checks: [detect]
- id: npm
platforms: [windows, linux]
command: [npm, install, -g, "@anthropic-ai/claude-code"]
package: "@anthropic-ai/claude-code"
elevate: never
post_checks: [detect]
detect:
executable: claude
version_args: ["--version"]
version_regex: "^(\\d+\\.\\d+\\.\\d+)"
update:
method: winget_upgrade
command: [winget, upgrade, Anthropic.ClaudeCode]
uninstall:
method: package_manager
command: [winget, uninstall, Anthropic.ClaudeCode]
keep_config_default: true
authorization:
modes:
- mode: browser_oauth
command: [claude]
notes_zh: 运行 claude 后按浏览器提示登录(Pro/Max/Team/Enterprise/Console 账号)
- mode: api_key
env_keys: [ANTHROPIC_API_KEY]
notes_zh: 设置 ANTHROPIC_API_KEY 后 CLI 优先使用 API Key
configuration:
files:
- path: "~/.claude/settings.json"
format: json
scope: user
environment:
- key: ANTHROPIC_API_KEY
sensitive: true
maps_to_field: api_key
- key: ANTHROPIC_BASE_URL
sensitive: false
maps_to_field: base_url
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 块)
required: false
sensitive: false
type: url
storage: file
- id: api_key
label_zh: API Key
help_zh: 存入系统密钥库(对应 ANTHROPIC_API_KEY
required: false
sensitive: true
type: string
storage: keyring
diagnostics:
- rule_id: path.not_installed
- rule_id: path.not_in_path
- rule_id: version_conflict.multiple_copies
- rule_id: config.corrupt
documentation:
quickstart_zh: 安装后运行 `claude` 登录,或用 `claude -p "提示词"` 无头执行。
commands:
- cmd: claude
desc_zh: 启动交互式会话
- cmd: claude -p "提示词"
desc_zh: 无头单次执行
- cmd: claude doctor
desc_zh: 环境诊断
updated_at: "2026-08-24"
risks_zh:
- 专有许可:只引导官方渠道安装,不重打包、不修改二进制