aider.env样例-中文解释

##########################################################
# 1- aider .env 配置文件示例。
# 2- 请将其放置在您 git 仓库的根目录下。
# 3- 或者，您也可以使用 `aider --env <文件名>` 命令来指定配置文件路径。
##########################################################

#################
# 4- 大语言模型 (LLM) 相关参数：
# 5- #
# 6- 请在此处包含 xxx_API_KEY 参数以及您的 LLM 所需的其他特定参数。
# 7- 详细信息请参阅： https://aider.chat/docs/llms.html。

## 7.1- OpenAI 相关设置
#OPENAI_API_KEY=

## 7.2- Anthropic 相关设置
#ANTHROPIC_API_KEY=

##... （其他模型提供商）

#############
# 8- 主要模型配置：

## 8.1- 指定用于核心交互（主聊天）的模型
#AIDER_MODEL=

########################
# 9- API 密钥及相关设置：

## 9.1- 设置您的 OpenAI API 密钥
#AIDER_OPENAI_API_KEY=

## 9.2- 设置您的 Anthropic API 密钥
#AIDER_ANTHROPIC_API_KEY=

## 9.3- 指定 API 请求的基础 URL （例如用于代理或私有部署）
#AIDER_OPENAI_API_BASE=

## 9.4- （此选项已弃用，请改用 --set-env OPENAI_API_TYPE=<值>）
#AIDER_OPENAI_API_TYPE=

## 9.5- （此选项已弃用，请改用 --set-env OPENAI_API_VERSION=<值>）
#AIDER_OPENAI_API_VERSION=

## 9.6- （此选项已弃用，请改用 --set-env OPENAI_API_DEPLOYMENT_ID=<值>）
#AIDER_OPENAI_API_DEPLOYMENT_ID=

## 9.7- （此选项已弃用，请改用 --set-env OPENAI_ORGANIZATION=<值>）
#AIDER_OPENAI_ORGANIZATION_ID=

## 9.8- 设置环境变量（用于控制 API 行为，可设置多个）
#AIDER_SET_ENV=

## 9.9- 为特定服务提供商设置 API 密钥（例如：`--api-key provider=<key>` 会将环境变量 `PROVIDER_API_KEY` 设为 `<key>`）
#AIDER_API_KEY=

#################
# 10- 模型具体设置：

## 10.1- 列出名称与（部分）输入相匹配的已知模型
#AIDER_LIST_MODELS=

## 10.2- 为尚不知晓的模型指定一个包含 aider 特定设置的文件
#AIDER_MODEL_SETTINGS_FILE=.aider.model.settings.yml

## 10.3- 为尚不知晓的模型指定一个包含上下文窗口大小和使用成本信息的文件
#AIDER_MODEL_METADATA_FILE=.aider.model.metadata.json

## 10.4- 添加模型别名，方便调用（可添加多个）
#AIDER_ALIAS=

## 10.5- 设置 `reasoning_effort` API 参数（默认：不设置）
#AIDER_REASONING_EFFORT=

## 10.6- 为支持此功能的模型设置“思考” token 预算（默认：不设置）
#AIDER_THINKING_TOKENS=

## 10.7- 连接模型服务时是否验证 SSL 证书（默认为 True，即验证）
#AIDER_VERIFY_SSL=true

## 10.8- API 调用的超时时间（单位：秒）（默认：无超时限制）
#AIDER_TIMEOUT=

## 10.9- 指定 LLM 生成代码变更时应使用的编辑格式（默认格式取决于所选模型）
#AIDER_EDIT_FORMAT=

## 10.10- 强制主聊天使用 `architect` 编辑格式
#AIDER_ARCHITECT=

## 10.11- 是否自动接受由 `architect` 格式生成的代码变更（默认为 True，即自动接受）
#AIDER_AUTO_ACCEPT_ARCHITECT=true

## 10.12- 指定用于生成 git 提交信息和总结聊天历史的模型（默认模型取决于 `--model` 参数）
#AIDER_WEAK_MODEL=

## 10.13- 指定用于执行编辑器相关任务的模型（默认模型取决于 `--model` 参数）
#AIDER_EDITOR_MODEL=

## 10.14- 指定编辑器模型使用的编辑格式（默认格式取决于编辑器模型本身）
#AIDER_EDITOR_EDIT_FORMAT=

## 10.15- 是否仅允许使用元数据已知的模型（默认为 True，遇到未知模型会提示警告）
#AIDER_SHOW_MODEL_WARNINGS=true

## 10.16- 是否检查所选模型是否支持 `reasoning_effort` 或 `thinking_tokens` 等特定设置（默认为 True）
#AIDER_CHECK_MODEL_ACCEPTS_SETTINGS=true

## 10.17- 聊天历史记录的 token 数量软上限。超出此限制后，系统将开始对历史记录进行摘要。若未指定，则使用模型定义的 `max_chat_history_tokens` 值。
#AIDER_MAX_CHAT_HISTORY_TOKENS=

#################
# 11- 缓存相关设置：

## 11.1- 是否启用对发送给模型的提示（prompt）进行缓存（默认为 False，即不缓存）
#AIDER_CACHE_PROMPTS=false

## 11.2- 每隔 5 分钟发送 ping 请求以保持提示缓存活跃状态的次数（默认为 0，即不发送）
#AIDER_CACHE_KEEPALIVE_PINGS=false

###################
# 12- 代码仓库地图 (Repomap) 设置：

## 12.1- 设置用于 repo map 的建议 token 数量，设为 0 则禁用此功能
#AIDER_MAP_TOKENS=

## 12.2- 控制 repo map 的刷新时机。可选值：`auto`（自动）, `always`（总是）, `files`（文件变更时）, `manual`（手动）（默认为 `auto`）
#AIDER_MAP_REFRESH=auto

## 12.3- 当用户未明确指定文件时，用于 repo map 的 token 数量乘数（默认为 2）
#AIDER_MAP_MULTIPLIER_NO_FILES=true

################
# 13- 历史记录文件：

## 13.1- 指定存储用户输入历史的文件路径（默认为 `.aider.input.history`）
#AIDER_INPUT_HISTORY_FILE=.aider.input.history

## 13.2- 指定存储完整聊天记录的文件路径（ Markdown 格式）（默认为 `.aider.chat.history.md`）
#AIDER_CHAT_HISTORY_FILE=.aider.chat.history.md

## 13.3- 是否在启动时恢复上一次的聊天记录（默认为 False）
#AIDER_RESTORE_CHAT_HISTORY=false

## 13.4- 指定一个文件用于记录与 LLM 交互的详细日志（例如：`.aider.llm.history`）
#AIDER_LLM_HISTORY_FILE=

##################
# 14- 终端输出显示设置：

## 14.1- 启用适合深色背景终端的颜色方案（默认为 False）
#AIDER_DARK_MODE=false

## 14.2- 启用适合浅色背景终端的颜色方案（默认为 False）
#AIDER_LIGHT_MODE=false

## 14.3- 是否启用美化且带颜色的终端输出（默认为 True）
#AIDER_PRETTY=true

## 14.4- 是否以流式方式显示模型的响应（默认为 True）
#AIDER_STREAM=true

## 14.5- 设置用户输入文本的颜色（默认为 `#00cc00`）
#AIDER_USER_INPUT_COLOR=#00cc00

## 14.6- 设置工具（如文件操作、命令执行）输出的颜色（默认：不指定特殊颜色）
#AIDER_TOOL_OUTPUT_COLOR=

## 14.7- 设置工具执行出错信息的颜色（默认为 `#FF2222`）
#AIDER_TOOL_ERROR_COLOR=#FF2222

## 14.8- 设置工具警告信息的颜色（默认为 `#FFA500`）
#AIDER_TOOL_WARNING_COLOR=#FFA500

## 14.9- 设置 AI 助手（模型）输出文本的颜色（默认为 `#0088ff`）
#AIDER_ASSISTANT_OUTPUT_COLOR=#0088ff

## 14.10- 设置命令补全菜单的文本颜色（默认：使用终端的默认文本色）
#AIDER_COMPLETION_MENU_COLOR=

## 14.11- 设置命令补全菜单的背景颜色（默认：使用终端的默认背景色）
#AIDER_COMPLETION_MENU_BG_COLOR=

## 14.12- 设置命令补全菜单中当前选中项的文本颜色（默认：使用终端的默认背景色）
#AIDER_COMPLETION_MENU_CURRENT_COLOR=

## 14.13- 设置命令补全菜单中当前选中项的背景颜色（默认：使用终端的默认文本色）
#AIDER_COMPLETION_MENU_CURRENT_BG_COLOR=

## 14.14- 设置 Markdown 代码块的高亮主题（默认为 `default`，可选 `monokai`, `solarized-dark`, `solarized-light` 或 Pygments 内建的其他主题，请参考 https://pygments.org/styles）
#AIDER_CODE_THEME=default

## 14.15- 在执行 git 提交时是否显示文件内容的具体差异（diffs）（默认为 False）
#AIDER_SHOW_DIFFS=false

###############
# 15- Git 集成设置：

## 15.1- 是否启用 git 仓库集成功能（默认为 True）
#AIDER_GIT=true

## 15.2- 是否自动将 `.aider*` 文件添加到 `.gitignore` 中（默认为 True）
#AIDER_GITIGNORE=true

## 15.3- 指定 aider 使用的忽略文件路径（默认为 git 仓库根目录下的 `.aiderignore`）
#AIDER_AIDERIGNORE=.aiderignore

## 15.4- 是否仅在当前 git 仓库的子目录树范围内操作（默认为 False）
#AIDER_SUBTREE_ONLY=false

## 15.5- 是否允许 aider 自动提交由 LLM 生成的代码变更（默认为 True）
#AIDER_AUTO_COMMITS=true

## 15.6- 当检测到仓库存在未提交的更改（dirty state）时，是否允许 aider 进行提交操作（默认为 True）
#AIDER_DIRTY_COMMITS=true

## 15.7- 是否在 git 提交记录的作者（Author）字段中标记由 aider 产生的变更（默认为 True）
#AIDER_ATTRIBUTE_AUTHOR=true

## 15.8- 是否在 git 提交记录的提交者（Committer）字段中标记由 aider 执行的提交（默认为 True）
#AIDER_ATTRIBUTE_COMMITTER=true

## 15.9- 如果变更是由 aider 生成的，是否在提交信息前自动添加 `aider: ` 前缀（默认为 False）
#AIDER_ATTRIBUTE_COMMIT_MESSAGE_AUTHOR=false

## 15.10- 是否为所有由 aider 执行的提交信息都自动添加 `aider: ` 前缀（默认为 False）
#AIDER_ATTRIBUTE_COMMIT_MESSAGE_COMMITTER=false

## 15.11- 在执行 git 提交时，是否自动添加 `--no-verify` 参数以跳过 pre-commit 钩子（默认为 False，即执行钩子）
#AIDER_GIT_COMMIT_VERIFY=false

## 15.12- 执行一次提交操作：使用合适的提交信息将所有待处理的变更提交，然后退出 aider
#AIDER_COMMIT=false

## 15.13- 指定用于生成 git 提交信息的自定义提示（prompt）模板
#AIDER_COMMIT_PROMPT=

## 15.14- 执行模拟运行（dry run），即预览操作过程但不实际修改任何文件（默认为 False）
#AIDER_DRY_RUN=false

## 15.15- 是否跳过对当前 git 仓库状态的健全性检查（默认为 False）
#AIDER_SKIP_SANITY_CHECK_REPO=false

## 15.16- 是否启用文件监视功能，以检测代码中的 AI 编码注释（默认为 False）
#AIDER_WATCH_FILES=false

########################
# 16- 代码检查、修复与测试：

## 16.1- 对指定的文件运行代码风格检查（Lint）并尝试自动修复问题；若未指定文件，则处理当前有修改的文件
#AIDER_LINT=false

## 16.2- 为不同编程语言指定运行的 lint 命令，例如："python: flake8 --select=..." （可指定多条）
#AIDER_LINT_CMD=

## 16.3- 在代码变更后是否自动运行 lint 检查（默认为 True）
#AIDER_AUTO_LINT=true

## 16.4- 指定用于运行测试的命令
#AIDER_TEST_CMD=

## 16.5- 在代码变更后是否自动运行测试（默认为 False）
#AIDER_AUTO_TEST=false

## 16.6- 执行测试，尝试修复发现的问题，然后退出 aider
#AIDER_TEST=false

############
# 17- 使用情况分析：

## 17.1- 是否允许在本会话中收集匿名的使用情况数据（默认为 `random`，即随机决定）
#AIDER_ANALYTICS=

## 17.2- 指定一个文件用于记录使用情况分析事件的日志
#AIDER_ANALYTICS_LOG=

## 17.3- 是否永久禁用使用情况分析功能（默认为 False）
#AIDER_ANALYTICS_DISABLE=false

############
# 18- 版本升级：

## 18.1- 仅检查是否有可用更新，并将结果通过退出状态码返回
#AIDER_JUST_CHECK_UPDATE=false

## 18.2- 启动时是否检查 aider 是否有新版本可用（默认为 True）
#AIDER_CHECK_UPDATE=true

## 18.3- 在新版本首次运行时是否显示该版本的发布说明（默认：不设置，运行时会询问用户）
#AIDER_SHOW_RELEASE_NOTES=

## 18.4- 从项目的 `main` 开发分支安装最新版本（通常为测试版）
#AIDER_INSTALL_MAIN_BRANCH=false

## 18.5- 从 Python 包索引 ( PyPI ) 将 aider 升级到最新的稳定版本
#AIDER_UPGRADE=false

########
# 19- 运行模式：

## 19.1- 指定一条消息直接发送给 LLM ，处理完回复后即退出（此模式下禁用交互式聊天）
#AIDER_MESSAGE=

## 19.2- 指定一个文件，将其内容作为消息发送给 LLM ，处理完回复后即退出（此模式下禁用交互式聊天）
#AIDER_MESSAGE_FILE=

## 19.3- 是否在浏览器中启动 aider 的图形用户界面 ( GUI )（默认为 False）
#AIDER_GUI=false

## 19.4- 在使用 Web UI 时，是否启用命令行与网页间的聊天内容自动复制粘贴功能（默认为 False）
#AIDER_COPY_PASTE=false

## 19.5- （调试用）从指定的文件中应用代码变更，而不是启动交互式聊天
#AIDER_APPLY=

## 19.6- 将剪贴板中的内容作为代码编辑指令，使用主模型配置的编辑器格式进行应用
#AIDER_APPLY_CLIPBOARD_EDITS=false

## 19.7- （调试用）完成所有启动初始化步骤后，在开始接受用户输入前直接退出
#AIDER_EXIT=false

## 19.8- （调试用）打印当前的 repo map 信息然后退出
#AIDER_SHOW_REPO_MAP=false

## 19.9- （调试用）打印 aider 使用的系统提示（system prompts）然后退出
#AIDER_SHOW_PROMPTS=false

#################
# 20- 语音输入设置：

## 20.1- 录制语音时使用的音频格式（默认为 `wav`）。选择 `webm` 或 `mp3` 格式需要系统安装了 ffmpeg
#AIDER_VOICE_FORMAT=wav

## 20.2- 使用 ISO 639-1 语言代码指定语音识别的语言（默认为 `auto`，自动检测）
#AIDER_VOICE_LANGUAGE=en

## 20.3- 指定用于录制语音的输入设备名称
#AIDER_VOICE_INPUT_DEVICE=

#################
# 21- 其他杂项设置：

## 21.1- 指定需要 aider 编辑的文件（可指定多个）
#AIDER_FILE=

## 21.2- 指定仅供 aider 读取的文件（可指定多个）
#AIDER_READ=

## 21.3- 是否在终端启用 VI 风格的编辑模式（默认为 False）
#AIDER_VIM=false

## 21.4- 指定聊天交互中使用的语言（默认：不指定，使用系统当前的语言环境设置）
#AIDER_CHAT_LANGUAGE=

## 21.5- 对于所有需要确认的操作，是否总是自动回答“是”（yes）
#AIDER_YES_ALWAYS=

## 21.6- 是否启用更详细的日志输出（verbose mode）
#AIDER_VERBOSE=false

## 21.7- 启动时从指定文件加载并执行其中定义的 `/commands`
#AIDER_LOAD=

## 21.8- 指定处理输入和输出时使用的字符编码（默认为 `utf-8`）
#AIDER_ENCODING=utf-8

## 21.9- 写入文件时使用的换行符类型（默认为 `platform`，即适配当前操作系统）
#AIDER_LINE_ENDINGS=platform

## 21.10- 指定要加载的 `.env` 配置文件的路径（默认为 git 仓库根目录下的 `.env` 文件）
#AIDER_ENV_FILE=.env

## 21.11- 是否允许 aider 建议可能相关的 shell 命令（默认为 True）
#AIDER_SUGGEST_SHELL_COMMANDS=true

## 21.12- 是否启用支持历史记录和命令补全的增强型输入界面（默认为 True）
#AIDER_FANCY_INPUT=true

## 21.13- 是否启用多行输入模式，在该模式下使用 `Meta-Enter` (或 `Alt-Enter`) 提交输入（默认为 False）
#AIDER_MULTILINE=false

## 21.14- 当 LLM 的响应准备就绪时，是否通过终端发出提示音（bell）进行通知（默认为 False）
#AIDER_NOTIFICATIONS=false

## 21.15- 指定一个自定义命令用于发送通知，代替终端提示音。若未指定，则可能使用适配您操作系统的默认通知方式。
#AIDER_NOTIFICATIONS_COMMAND=

## 21.16- 是否自动检测输入中的 URL ，并询问用户是否要将其内容添加到聊天上下文中（默认为 True）
#AIDER_DETECT_URLS=true

## 21.17- 指定运行 `/editor` 命令时要使用的文本编辑器程序
#AIDER_EDITOR=

############################
# 22- 已弃用的模型设置（请优先使用 --model 参数）：

## 22.1- 使用 `claude-3-opus-20240229` 作为主聊天模型（此选项已弃用，请改用 --model）
#AIDER_OPUS=false

## 22.2- 使用 `anthropic/claude-3-7-sonnet-20250219` 作为主聊天模型（此选项已弃用，请改用 --model）
#AIDER_SONNET=false

## 22.3- 使用 `claude-3-5-haiku-20241022` 作为主聊天模型（此选项已弃用，请改用 --model）
#AIDER_HAIKU=false

## 22.4- 使用 `gpt-4-0613` 作为主聊天模型（此选项已弃用，请改用 --model）
#AIDER_4=false

## 22.5- 使用 `gpt-4o` 作为主聊天模型（此选项已弃用，请改用 --model）
#AIDER_4O=false

## 22.6- 使用 `gpt-4o-mini` 作为主聊天模型（此选项已弃用，请改用 --model）
#AIDER_MINI=false

## 22.7- 使用 `gpt-4-1106-preview` 作为主聊天模型（此选项已弃用，请改用 --model）
#AIDER_4_TURBO=false

## 22.8- 使用 `gpt-3.5-turbo` 作为主聊天模型（此选项已弃用，请改用 --model）
#AIDER_35TURBO=false

## 22.9- 使用 `deepseek/deepseek-chat` 作为主聊天模型（此选项已弃用，请改用 --model）
#AIDER_DEEPSEEK=false

## 22.10- 使用 `o1-mini` 作为主聊天模型（此选项已弃用，请改用 --model）
#AIDER_O1_MINI=false

## 22.11- 使用 `o1-preview` 作为主聊天模型（此选项已弃用，请改用 --model）
#AIDER_O1_PREVIEW=false