← Tools

AiderAider

Aider-AI

编程终端本地开源 partial lifecycle: maintenance 核验Checked 2026-10-08

Aider 是一个终端 pair programming 工具。

它把 Git 集成当核心设计，不是附加功能。

AI 改动始终在版本控制里，可 diff 可撤销。

A terminal pair-programming tool where Git integration is core design, not an add-on — AI changes always live in version control, diffable and revertible.

适合与不适合When to use it, when not to

适合的场景：

需要 AI 改动始终留在 git 版本控制里、可 diff 可撤销的场景
需要连接本地模型或多家云端模型的用户

不适合这些场景：

需要新模型支持
依赖上游修复

它们的风险来自维护状态：最新 release 停在 2025-08，为 maintenance。

Scenarios where AI changes must stay in git version control, diffable and revertible. Users who need to connect local models or several cloud providers.

Not a fit for scenarios needing a new model release or relying on upstream fixes — the latest release stopped at 2025-08 and maintenance status is maintenance.

中文生态China availability 国产 / 国内可直接用 / 备案状态 · 快照domestic / direct access / CAC filing · snapshot 2026-10-20

出品属地Origin: 国外出品foreign-made　国外主体（网信办公示名单未见对应备案主体）。foreign entity (no matching filing entity in the CAC registry).
国内使用Direct access: 大陆可直连direct OK　官网仓库在 GitHub，大陆直连波动（同日实测 200/000 混合）；npm / PyPI 安装源实测稳定可达。Hosted on GitHub — direct reachability from mainland fluctuates (200/000 mixed on the same day); npm / PyPI install routes measured stable.
备案状态CAC filing: 未见于备案名单not in filing list：未见于网信办公示名单（2026-10-20 检索 13 批附件，https://www.cac.gov.cn/2024-04/02/c_1713729983803145.htm）；该产品未面向大陆公众提供服务，备案不适用。not in the CAC public registry (13 batch attachments searched 2026-10-20, https://www.cac.gov.cn/2024-04/02/c_1713729983803145.htm); the product does not serve the mainland public, so filing does not apply.

备案信息以网信办《生成式人工智能服务已备案信息》公示名单为准（按批次滚动更新，本站只抄编号不解读）；「大陆可直连」是本站从大陆网络直连实测的结果，不是厂商承诺。GitHub 类站点当日实测有波动，口径写在依据里。Filing status is quoted from the CAC public registry (updated batch by batch; this site copies the number and does not interpret it). "Direct access" is this site's own reachability measurement from a mainland network, not a vendor promise. GitHub-hosted sites fluctuated on the measurement day — the note says so.

固定坐标系Fixed coordinate system

8 个维度dimensions, 与同分区其他对象逐项可比each comparable item by item against others in the same section.

模型与开放条件Model & openness

支持云端与本地 LLM，可连接几乎任何模型，明确包含本地模型选项。

官方原文："README 当前推荐的模型是 Claude 3.7 Sonnet、DeepSeek R1 & Chat V3、OpenAI o1 / o3-mini / GPT-4o"

注意：这份推荐列表停留在上一代模型。

这与该项目 13 个月未发 release 的状态一致。

参考时需自行核对当前可用模型。

运行位置Where it runs

本地 Python 进程，在终端内运行，生命周期绑定终端会话。

退出终端即结束。

它是 PyPI 包 aider-chat。

官方徽章显示 680 万次安装。

另有 watch 常驻形态（见 IDE 形态条目）。

本地文件Local files

Repo Map 是本工具的核心机制。

它是一份简洁的整个 git 仓库的地图。

官方原文："Aider makes a map of your entire codebase, which helps it work well in larger projects."

map 里包含最重要的类与函数及其类型与调用签名。

每次用户提出改动请求时，repo map 都随请求一起发给模型。

map 包含仓库文件列表 + 每个文件的关键符号。

文档明确列出两个作用：

一是帮助它理解正在编辑的代码及其与代码库其他部分的关系
二是帮助它写新代码时复用代码库里已有的库、模块与抽象

支持 100+ 编程语言。

文件访问范围：能编辑的是你 /add 进 chat 的文件。

repo map 则扫描整个 git 仓库。

扫描范围受 .gitignore / .aiderignore 约束：--aiderignore 指定忽略文件，默认 git 根目录 .aiderignore；--subtree-only 只考虑当前子树。

仓库须是 git 仓库。

官方原文："无 git 时会先问你是否新建。"

map 的 token 预算由 --map-tokens 控制、刷新频率由 --map-refresh（auto/always/files/manual）控制。

大仓库的实际耗时与 token 开销官方未给数字，本站未实测。

关机后的任务Tasks after shutdown

不支持终端形态的后台长任务。

另有 watch 模式（见 IDE 形态条目）：常驻监听文件变化并响应编辑器里的 AI 注释。

但那是本地进程常驻，不是云端后台。

工具与扩展Tools & extensions

文件编辑 + Git 操作。

README 强调 Git 集成本身就是核心功能。

它会自动用合理的 commit message 提交。

你也可以用熟悉的 git 工具 diff、管理与撤销 AI 改动。

官方文档另有 docs/languages.md（语言支持）与 docs/git.md。

可配置 lint / 测试命令自动运行：

--lint-cmd / --auto-lint（默认对编辑过的文件跑 lint）
--test-cmd / --auto-test
/run 跑 shell 命令并可选加输出进 chat
/web 抓网页转 markdown
/paste 贴图

文档出处是 docs/usage/lint-test.html。

无内置 MCP 支持：官方选项表与文档站导航都没有任何 MCP 条目（已查 config/options.html 与 docs 目录）。

故不能接 MCP server。

上下文与记忆Context & memory

Repo Map 提供全库结构视图，每次请求随附（见 local_files）。

上下文超限用「摘要压缩」而非简单截断。

官方原文："Soft limit on tokens for chat history, after which summarization begins"

这句是官方选项 --max-chat-history-tokens 的描述。

即超过软上限即开始摘要，摘要由 --weak-model 生成。

每个模型的上下文窗口与费用由 --model-metadata-file 提供。

会话内可用 /tokens 查看用量、/drop、/clear、/reset 腾空间。

默认不跨启动恢复（--restore-chat-history 默认 False）。

chat 历史默认写 .aider.chat.history.md。

权限与限制Permissions & limits

默认自动提交（--auto-commits 默认 True）。

这是它的一体化设计而非附加功能。

--dirty-commits（默认 True）会先把已有的未提交改动也提交。

撤销路径是 git 本身，不是工具提供的回滚功能。

官方原文："Use familiar git tools to easily diff, manage and undo AI changes."

会话内用 /undo。

存在确认环节：官方提供 --yes-always（别名 --yes）。

官方原文："Always say yes to every confirmation"

即默认会对某些操作询问，加此开关才全自动。

--dry-run 可不改文件地预演。

无沙箱机制：官方选项表没有任何沙箱项。

除你配置的 lint / 测试命令（--auto-lint / --auto-test）外，它不会自主执行任意 shell 命令（--suggest-shell-commands 只是建议）。

适合什么任务Best for

适合三类场景。

留在 git 里的改动：希望 AI 改动始终留在 git 版本控制里。

这样的改动可 diff、可撤销。

多模型接入：需要连接本地模型或多家云端模型的用户。

复用已有抽象：需要「写新代码时复用已有抽象」的人。

这也是 Repo Map 的第二个作用。

不适合需要活跃维护与新模型支持的场景（见下方维护状态）。

头号误解Top misconception

以为还在积极维护，最新 release 停在 2025-08-09，距采集日 13 个月Assuming it is still actively maintained — the latest release stopped at 2025-08-09, 13 months before collection
以为 README 推荐的模型是最新的，推列表仍停留在上一代Assuming the models the README recommends are current — the list is still on the previous generation
以为自动提交是副作用，实际这是它的核心设计，需要先熟悉 git 撤销流程Assuming auto-commit is a side effect — it is the core design, and you need to know git's undo workflow first

未知项清单Known unknowns

大仓库 Repo Map 的实际耗时与 token 开销（官方未给数字，待实测）
--yes-always 默认会就哪些具体操作询问（官方未逐项列举）

证据来源Evidence sources

判断可回到以下一手源复核。本站核验日Every judgement can be rechecked against the primary sources below. Verified on 2026-10-08，内容更新日content updated on 2026-10-08。

类型Type	名称Name	链接Link
repo	Aider · 仓库 README	https://github.com/Aider-AI/aider
changelog	Aider · Releases（v0.86.0 @ 2025-08-09 为最新）	https://github.com/Aider-AI/aider/releases
docs	Aider · 官方文档站	https://aider.chat/docs/
changelog	Aider · 变更历史	https://aider.chat/HISTORY.html
docs	Aider · 选项参考（--aiderignore/--auto-commits/--yes-always/--map-tokens/--max-chat-history-tokens）	https://aider.chat/docs/config/options.html
docs	Aider · Git 集成（自动提交、dirty 提交、/undo、默认跳过 pre-commit hook）	https://aider.chat/docs/git.html
docs	Aider · Linting and testing（--lint-cmd/--test-cmd/--auto-lint/--auto-test）	https://aider.chat/docs/usage/lint-test.html
docs	Aider · Scripting（--yes/--auto-commits/--dry-run 官方帮助文本）	https://aider.chat/docs/scripting.html

实测记录Measured runs

本站尚未完成实测。测试协议见 tasks/_protocol.md。

实测建议：重点放在「自动提交 + 撤销」这条链路是否顺畅。

因为这是它与其他工具最大的工作流差异。

⚠ 维护状态（本条目最重要的信息）

结论：这个项目已进入维护状态，不该按活跃项目看待。

依据如下。

指标	值	距采集日
最新 release	`v0.86.0`	2025-08-09（13 个月前）
上一个 release	`v0.85.0`	2025-06-27
最后 commit	扩充 ANTHROPIC_MODELS 名单	2026-05-22
star 数	49,249	—
PyPI 安装量	680 万	—

判断：lifecycle = maintenance

理由：

release 已 13 个月未更新
最后几次 commit 都是维护性改动（扩充模型名单），不是功能开发
README 的模型推荐仍停留在上一代（Claude 3.7 Sonnet 时代）

这不是"坏了"，但意味着：

新模型支持可能滞后
新语言 / 新框架适配可能滞后
遇到 bug 不一定能靠上游修复

引用本条目做选型时必须考虑这一点。

核心能力（README 官方描述）

能力	官方原文要点
云端与本地 LLM	可连接几乎任何 LLM，包括本地模型
Repo Map	为整个代码库生成结构图，帮助它在较大项目中工作
100+ 语言	python / javascript / rust / ruby / go / cpp / php / html / css 等
Git 集成	自动用合理 commit message 提交，可用 git 工具 diff、管理与撤销
IDE 内使用	在 IDE 里加注释提问，aider 去做

Repo Map 是它的差异化能力

官方原文："Aider makes a map of your entire codebase, which helps it work well in larger projects."

这与其他工具的"按需检索文件"是不同思路：先建全库结构图，再据此工作。

注意：A6.2 已核到 —— token 预算由 --map-tokens 控制（设为 0 即关闭），刷新频率由 --map-refresh（auto/always/files/manual）控制。

如何选文件进 map 的具体排序算法官方 docs/repomap.md 有说明。

本站未逐行核验，大仓库实际开销官方也未给数字。

Git 集成是设计的一部分，不是副作用

官方原文："Aider automatically commits changes with sensible commit messages. Use familiar git tools to easily diff, manage and undo AI changes."

这一点值得单独强调：很多工具需要用户自己管理 git。

Aider 把「自动提交 + 用 git 撤销」当作核心工作流。

这带来一个必须知道的前提：AI 的改动会直接进入提交历史。

如果你不熟悉 git 的撤销流程（git reset / git revert），建议先在小仓库试用。

官方自我评价的一个有趣指标

官方原文："Percentage of the new code in Aider's last release written by Aider itself"

官方徽章原文："🔄 Singularity — 88%"

即「上个版本的新代码里 88% 由 Aider 自己写」。

这是官方自述的自举程度，可作为参考但不必过度解读。

权限定级说明

confidence: partial 的原因：

✅ 已核验：仓库、许可（Apache-2.0）、最新版本与日期、维护状态、star、PyPI 安装量、README 全部能力描述
✅ A6.2 本轮新核：文件范围与忽略规则、自动提交/确认机制（--auto-commits/--yes-always）、lint/测试命令、上下文摘要压缩（--max-chat-history-tokens）、官方无 MCP 支持
⚠️ 官方未给数字：大仓库 Repo Map 的实际耗时与 token 开销

维护状态的不确定性来自"未来会不会更新"——这本身就是选型风险。