# ============================================================
# 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]
  source:
    kind: pypi
    package: 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 高级配置本表单不覆盖，以官方文档为准