Wave 3: 补齐九个适配器（Qwen/CodeBuddy/Cline/Copilot/Crush/Goose/Aider/Cursor/Warp）

Co-authored-by: multica-agent <github@multica.ai>
2026-08-25 19:13:37 +08:00
parent 4a2be5899d
commit b0d7124170
13 changed files with 1345 additions and 193 deletions
@@ -1,28 +1,146 @@
 # ============================================================
-# 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/linux：architectures、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 适配器 · Aider（aider.chat）（Wave 3）
+# 数据依据：调研底稿 agent-cli-survey-2026-08-24.md + 架构 §3.3
+# 注意：官方独立安装器 aider-install / PyPI aider-chat；不走 brew；独立 Python 3.12 环境。
 # ============================================================
 id: aider
 name: Aider
 name_zh: Aider
 vendor: aider.chat
 status: available
+adapter_version: 1.1.0
+license: Apache-2.0
+
+platforms:
+  windows:
+    architectures: [x64]
+    notes: 官方 PS 脚本 / PyPI；独立 Python 3.12 环境
+  linux:
+    distributions: [ubuntu]
+    architectures: [x64]
+
+official:
+  homepage: https://aider.chat
+  docs: https://aider.chat/docs/
+  allowed_hosts: [aider.chat, pypi.org, github.com]
+
+runtime_deps:
+  - id: uv
+    semver_range: ">=0"
+    required_for: [install]
+  - id: python
+    semver_range: ">=3.12"
+    required_for: [run]
+
+install:
+  preferred: official_script
+  channels:
+    - id: official_script
+      platforms: [windows]
+      script:
+        url: https://aider.chat/install.ps1
+        kind: powershell_irm
+      elevate: never
+      post_checks: [detect]
+    - id: official_script
+      platforms: [linux]
+      script:
+        url: https://aider.chat/install.sh
+        kind: bash_pipe
+      elevate: never
+      post_checks: [detect]
+    - id: pypi_uv
+      platforms: [windows, linux]
+      command: [uv, tool, install, aider-chat]
+      package: aider-chat
+      elevate: never
+      post_checks: [detect]
+
+detect:
+  executable: aider
+  version_args: ["--version"]
+
+update:
+  method: pypi_upgrade
+  command: [uv, tool, upgrade, aider-chat]
+
+uninstall:
+  method: package_manager
+  command: [uv, tool, uninstall, aider-chat]
+  keep_config_default: true
+
+authorization:
+  modes:
+    - mode: api_key
+      env_keys: [ANTHROPIC_API_KEY, OPENAI_API_KEY]
+      notes_zh: 仅 API Key：各家模型 Key（Anthropic / OpenAI 等）
+
+# 配置机制（调研底稿 Aider 章节）：YAML。用户级 ~/.aider.conf.yml（项目级 .aider.conf.yml）。
+configuration:
+  files:
+    - path: "~/.aider.conf.yml"
+      format: yaml
+      scope: user
+  environment:
+    - key: ANTHROPIC_API_KEY
+      sensitive: true
+      maps_to_field: api_key
+  fields:
+    - id: model
+      label_zh: 主模型
+      group: common
+      help_zh: 官方键 model，Aider 主模型（如 anthropic/claude-sonnet-4）
+      required: false
+      sensitive: false
+      type: string
+      storage: file
+      docs_url: https://aider.chat/docs/configuration/aider_conf.html
+    - id: api_key
+      label_zh: API Key
+      group: auth
+      help_zh: 存入系统密钥库（对应 ANTHROPIC_API_KEY / OPENAI_API_KEY 等环境变量）
+      required: false
+      sensitive: true
+      type: string
+      storage: keyring
+      docs_url: https://aider.chat/docs/configuration/api-keys.html
+
+diagnostics:
+  - rule_id: path.not_installed
+  - rule_id: path.not_in_path
+  - rule_id: dependency.uv
+  - rule_id: dependency.python_below_min
+  - rule_id: version_conflict.multiple_copies
+  - rule_id: config.corrupt
+
+documentation:
+  quickstart_zh: 安装后配置 API Key，在项目目录运行 `aider`，或用 `aider --message "提示词"` 无头执行。
+  install_zh: 推荐官方独立安装器 aider-install（Windows 用 install.ps1 / Linux 用 install.sh，自动装独立 Python 3.12 环境）；也可用 PyPI `uv tool install aider-chat`。不走 brew。
+  auth_zh: 仅 API Key：各家模型 Key（ANTHROPIC_API_KEY / OPENAI_API_KEY 等），保存后经环境变量注入。
+  commands:
+    - cmd: aider
+      desc_zh: 启动交互式会话
+    - cmd: aider --message "提示词"
+      desc_zh: 无头单次执行
+    - cmd: aider --model <模型>
+      desc_zh: 指定模型
+    - cmd: aider --version
+      desc_zh: 显示版本号
+    - cmd: aider --yes
+      desc_zh: 自动接受所有建议
+  params:
+    - param: --message / --msg
+      desc_zh: 无头单次执行
+    - param: --model
+      desc_zh: 指定模型
+    - param: --yes
+      desc_zh: 自动接受所有建议
+    - param: --edit-format
+      desc_zh: 编辑格式
+    - param: --chat-mode
+      desc_zh: 会话模式
+  updated_at: "2026-08-25"
+  risks_zh:
+    - 不走 brew（官方不推荐，安装路径与依赖易出问题）
+    - 官方独立安装器自动装独立 Python 3.12 环境，本适配器声明 uv/python 依赖仅针对 PyPI 渠道
+    - 项目级 .aider.conf.yml 与多 provider 高级配置本表单不覆盖，以官方文档为准