147 lines
4.4 KiB
YAML
147 lines
4.4 KiB
YAML
# ============================================================
|
||
# 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 高级配置本表单不覆盖，以官方文档为准
|