Aidermacs：在 Emacs 中实现 AI 配对编程

Aidermacs 通过集成 Aider，这款功能最强大的开源 AI 配对编程工具之一，将 AI 驱动的开发引入到 Emacs 中。如果你怀念 Cursor，但又更喜欢在 Emacs 中工作，那么 Aidermacs 就能提供类似的 AI 功能，同时保持与 Emacs 工作流一致。

核心特性

• 多后端智能模型选择
• 内置 Ediff 集成，用于处理 AI 生成的更改
• 从 Emacs 中增强的文件管理功能
• 极高的可定制性以及灵活的内容添加方式

社区评价

以下是社区对 Aidermacs 的评价：

“你在用 Aidermacs 吗？对我来说比 Cursor 更好。” - u/berenddeboer

“太棒了……每次我升级包时，都能看到你的新提交。我觉得这才是真正的 Emacs 版 Aider。” - u/wchmbo

“在 Aidermacs 和 Gptel 的加持下，Emacs 在这些前沿技术上的表现真是令人惊叹。我的工作单位正在探索 MCP 注册表，甚至那些炙手可热的工具（如 Cursor）也比不上我用 mcp.el 和 gptel 所能做到的。” - u/no_good_names_avail

“看起来太棒了……我一直使用 Ellama 结合本地 LLM，看来这里也能行。太厉害了！！” - u/lugpocalypse

“说实话，我是这个项目的超级粉丝。感谢你的更新！” - u/ieoa

快速入门

1. 系统要求

• Emacs ≥ 26.1
• Aider 或其社区分支 Aider Community Experimentation。
• Transient

2. 通过 Melpa 或 Non-GNU Elpa 下载 Aidermacs，或者手动克隆
3. 修改以下示例配置并将其放入你的 Emacs init.el 文件中：

(use-package aidermacs
  :bind (("C-c a" . aidermacs-transient-menu))
  :config
  ; 将 API_KEY 设置在 .bashrc 中，这样它会自动被 Aider 或者 elisp 拾取
  (setenv "ANTHROPIC_API_KEY" "sk-...")
  ; 为安全起见，请自行定义 my-get-openrouter-api-key 函数
  (setenv "OPENROUTER_API_KEY" (my-get-openrouter-api-key))
  :custom
  ; 参见下方的配置部分
  (aidermacs-default-chat-mode 'architect)
  (aidermacs-default-model "sonnet"))

4. 打开一个项目，然后运行 M-x aidermacs-transient-menu 或 SPC a a（或你选择的绑定键）。
5. 添加文件，开始与 AI 一起编码吧！

Spacemacs

对于 Spacemacs 用户：

1. 将 aidermacs 添加到你的 .spacemacs 文件中的 dotspacemacs-additional-packages 列表中：

dotspacemacs-additional-packages '(
  (aidermacs :variables
              aidermacs-default-chat-mode 'architect
              aidermacs-default-model "sonnet")
)

2. 在 .spacemacs 的 dotspacemacs/user-config 函数中添加快捷键绑定：

(defun dotspacemacs/user-config ()
  ;; 设置 Aidermacs 的 leader 键
  (spacemacs/set-leader-keys "aa" 'aidermacs-transient-menu) ; 示例绑定 SPC a a
)

3. 打开一个项目，然后运行 M-x aidermacs-transient-menu 或 SPC a a（或你选择的绑定键）。
4. 添加文件，开始与 AI 一起编码吧！

使用方法

入门指南

Aidermacs 的主要界面是通过其瞬态菜单系统（类似于 Magit）。你可以通过以下命令访问：

M-x aidermacs-transient-menu

或者在你的配置中将其绑定到某个键上：

(global-set-key (kbd "C-c a") 'aidermacs-transient-menu)

一旦瞬态菜单打开，你就可以使用显示的按键来导航和执行命令。以下是主菜单结构的概览：

核心功能

• a: 开始/打开会话（自动检测项目根目录）
• .: 在当前目录开始（适用于 monorepo）
• l: 清除聊天历史
• s: 重置会话
• x: 退出会话

持久模式

• 1: 代码模式
• 2: 聊天/提问模式
• 3: 建筑师模式
• 4: 帮助模式

实用工具

• ^: 显示最近一次提交（如果启用了自动提交）
• u: 撤销最近一次提交（如果启用了自动提交）
• R: 刷新仓库地图
• h: 会话历史
• o: 更改主模型
• v: 发送语音命令
• W: 获取网页内容
• ?: Aider 元级别帮助

文件操作

• f: 添加文件（C-u: 只读）
• F: 添加当前文件
• d: 从目录添加（同类型）
• w: 从窗口添加
• m: 从 Dired 添加（已标记）
• j: 放置文件
• J: 放置当前文件
• k: 从 Dired 放置（已标记）
• K: 放置所有文件
• S: 创建会话草稿本
• G: 将文件添加到会话
• A: 列出已添加的文件

代码操作

• c: 代码更改
• e: 质问代码
• r: 建筑师更改
• q: 一般性问题
• p: 质问当前符号
• g: 接受建议的更改
• i: 实现 TODO
• t: 编写测试
• T: 修复测试
• !: 调试异常

“全部文件操作”和“全部代码操作”条目会打开包含更多专业命令的子菜单。请使用显示的按键来导航这些子菜单。

文件管理与 AI 交互

在使用 Aidermacs 时，您可以灵活地决定让 AI 阅读和编辑哪些文件。以下是一些指导原则：

• 可编辑文件：添加您希望 AI 可能编辑的文件。这将授予 AI 在必要时读取和修改这些文件的权限。
• 只读文件：如果您希望 AI 仅读取文件而不进行编辑，可以将其添加为只读文件。在 Aidermacs 中，所有添加文件的命令都可以加上 C-u 前缀来指定只读访问权限。
• 会话草稿板：使用会话草稿板（S）粘贴笔记或文档，这些内容将以只读方式提供给 AI。
• 外部文件：通过“将文件添加到会话”（G）命令，您可以包含当前项目之外的文件（或 .gitignore 中的文件），因为 Aider 不会自动将这些文件纳入其上下文。

AI 有时可以根据模型和代码库的上下文自行确定相关文件。然而，为了实现精确控制，尤其是在处理复杂项目时，手动指定文件通常更为有利。

Aider 鼓励采用协作式方法，类似于与人类同事合作的方式。有时 AI 需要明确的指导，而另一些时候它则能够自行推断出必要的上下文。

Prompt 文件次要模式

Aidermacs 提供了一个次要模式，方便您处理 prompt 文件及其他与 Aider 相关的文件。启用该模式后，将提供以下便捷的快捷键绑定：

• C-c C-n 或 C-<return>：逐行发送当前行或选区
• C-c C-c：整体发送块或选区
• C-c C-z：切换到 Aidermacs 缓冲区

该次要模式会自动为以下文件类型启用：

• .aider.prompt.org 文件（可通过 M-x aidermacs-open-prompt-file 创建）
• .aider.chat.md 文件
• .aider.chat.history.md 文件
• .aider.input.history 文件

配置

运行前钩子

您可以使用 aidermacs-before-run-backend-hook 来在启动 Aider 后端之前运行自定义的设置代码。这尤其适用于：

• 设置环境变量
• 注入密钥
• 执行其他运行前配置

例如，从密码存储中安全地设置 OpenAI API 密钥：

(add-hook 'aidermacs-before-run-backend-hook
          (lambda ()
            (setenv "OPENAI_API_KEY" (password-store-get "code/openai_api_key"))))

在运行钩子并启动 Aider 时，会使用 process-environment 的副本，以确保在钩子中设置的环境变量仅影响 Aider 后端。这种方法可以将敏感信息保留在您的 dotfiles 之外，同时仍可供 Aidermacs 使用。

默认模型选择

您可以自定义 Aidermacs 使用的默认 AI 模型。模型的选择按以下优先级顺序确定：

1. 如果您已设置 Emacs 变量 aidermacs-default-model（例如通过 setq），则使用该值。
2. 如果设置了 AIDER_MODEL 环境变量，则使用该值。
3. 使用内置的默认值（例如 "sonnet"）。

在 Emacs 中设置默认模型的方法如下：

(setq aidermacs-default-model "sonnet")

这样可以在不修改 aidermacs-extra-args 变量的情况下，轻松切换不同的 AI 模型。

注意：如果存在 .aider.conf.yml 文件，此配置将被覆盖（详见 使用配置文件覆盖配置）。

动态模型选择

Aidermacs 为单人（非 Architect）模式提供了智能的模型选择功能，能够自动检测并集成多个 AI 提供者：

• 自动从支持的提供商（OpenAI、Anthropic、DeepSeek、Google Gemini、OpenRouter）获取可用模型
• 缓存模型列表以便快速访问
• 支持流行的预配置模型以及动态发现的模型
• 自动从您的 .bashrc 中处理 API 密钥和身份验证
• 提供模型兼容性检查

动态模型选择功能仅适用于单人（非 Architect）模式。

要在单人模式下更改模型：

1. 使用 M-x aidermacs-change-model 或在瞬态菜单中按 o
2. 从以下选项中选择：
   • 流行的预配置模型（速度快）
   • 从所有支持的提供商动态获取的模型（全面）

系统会自动筛选出符合以下条件的模型：

• 您当前 Aider 版本支持的模型
• 您已配置的 API 密钥可用的模型
• 与您当前工作流程兼容的模型

Architect 模式——分离代码推理与编辑模型

Aidermacs 提供一种实验性模式，针对每个编码任务使用两种专门的模型：一个 Architect 模型用于推理，另一个 Editor 模型用于代码生成。这种方法已在 Aider 的代码编辑基准测试中取得了最先进的（SOTA）成果，详情请参阅这篇博客文章。

要使新会话默认以 Architect 模式启动，请将 aidermacs-default-chat-mode 设置为 'architect。

aidermacs-use-architect-mode 已被弃用，并将在未来的版本中移除。

architect 模式将默认使用 aidermacs-default-model。如果您在使用 architect 模式时希望使用不同的主模型，也可以配置 aidermacs-architect-model 变量来指定 Architect 角色使用的模型。

默认情况下，aidermacs-editor-model 与 aidermacs-default-model 相同。只有当您希望为 Editor 角色使用不同模型时，才需要设置 aidermacs-editor-model。该变量同样会遵循与 aidermacs-default-model 相同的优先级规则，尊重 AIDER_EDITOR_MODEL 环境变量。

(setq aidermacs-default-chat-mode 'architect)

您可以通过 M-x aidermacs-switch-to-architect-mode（在 aidermacs-transient-menu 中按 3）永久切换到该模式，或者通过 M-x aidermacs-architect-this-code（在 aidermacs-transient-menu 中按 r）临时切换。

您可以独立配置每个模型：

;; 默认模型，除非被覆盖
(setq aidermacs-default-model "sonnet")

;; 可选：为 Architect 推理设置特定模型
(setq aidermacs-architect-model "deepseek/deepseek-reasoner")

;; 可选：为代码生成设置特定模型
(setq aidermacs-editor-model "deepseek/deepseek-chat")

模型层次结构如下：

• 当 Architect 模式启用时：
  • Architect 模型负责高层次的推理和解决方案设计
  • Editor 模型执行实际的代码更改
• 当 Architect 模式禁用时，仅使用 aidermacs-default-model
• 您可以配置特定模型，也可以让它们自动使用默认模型。

模型会反映对 aidermacs-default-model 的更改，除非它们已被显式设置为不同的值。

注意：这些配置将被 .aider.conf.yml 文件的存在所覆盖（详见 使用配置文件覆盖配置）。

自定义弱模型

弱模型用于提交消息（如果您将 aidermacs-auto-commits 设置为 t）以及聊天历史摘要（默认值取决于 --model）。您可以通过 aidermacs-weak-model 变量对其进行自定义，该变量同样会尊重 AIDER_WEAK_MODEL 环境变量。

;; 默认为 nil
(setq aidermacs-weak-model "deepseek/deepseek-chat")

您可以在会话期间使用 C-u o（带有前缀参数的 aidermacs-change-model）来更改弱模型。在大多数情况下，您无需更改此设置，因为 Aider 会根据您的主模型自动选择合适的弱模型。

注意：这些配置会被 .aider.conf.yml 文件的存在所覆盖（详见 细节）。

架构模式确认

默认情况下，Aidermacs 在应用架构模式中提出的更改之前需要明确确认。这使您有机会在任何代码被修改之前审查 AI 的计划。

如果您希望自动接受所有架构模式更改而无需确认（类似于 Aider 的默认行为），可以启用以下设置：

(setq aidermacs-auto-accept-architect t)

注意：这些配置会被 .aider.conf.yml 文件的存在所覆盖（详见 细节）。

终端后端选择

通过设置 aidermacs-backend 来选择您偏好的终端后端：

vterm 提供更好的终端兼容性，而 comint 则提供一个简单、内置的选项，与 Aidermacs 完全兼容。

;; 使用 vterm 后端（默认为 comint）
(setq aidermacs-backend 'vterm)

可用的后端：

• comint（默认）：使用 Emacs 内置的终端仿真
• vterm：利用 vterm 提供更好的终端兼容性

Emacs 主题支持

vterm 后端会使用您当前激活的 Emacs 主题所定义的 face 来设置 Aider 的颜色。它会尝试根据您的主题猜测一些合理的颜色值。但在某些情况下，这可能无法完美工作；如果文本对您来说难以阅读，您可以按如下方式关闭此功能：

;; 不匹配 Emacs 主题颜色
(setopt aidermacs-vterm-use-theme-colors nil)

多行输入配置

您可以自定义多行输入的快捷键，该键允许您输入多行内容而不将命令发送给 Aider。正常按下 RET 键即可发送命令。

;; Comint 后端：
(setq aidermacs-comint-multiline-newline-key "S-<return>")
;; Vterm 后端：
(setq aidermacs-vterm-multiline-newline-key "S-<return>")

通过 Tramp 支持远程文件

Aidermacs 完全支持通过 Emacs 的 Tramp 模式处理远程文件。这使您能够通过 SSH、Docker 以及其他 Tramp 支持的协议，在远程服务器上托管的文件上使用 Aidermacs。

在处理远程文件时：

• 文件路径会自动本地化到远程系统
• 所有 Aidermacs 功能在本地和远程文件之间无缝运行
• 编辑会直接应用于远程文件
• 差异比较和更改审查按预期进行

使用示例：

;; 通过 SSH 打开远程文件
(find-file "/ssh:user@remotehost:/path/to/file.py")

;; 启动 Aidermacs 会话 - 它会自动检测远程环境
M-x aidermacs-transient-menu

提示选择与历史记录

Aidermacs 使您能够轻松地重复使用提示，方法如下：

1. 提示历史：您之前使用的提示会被保存，并可快速选择。
2. 常用提示：在 aidermacs-common-prompts 中定义的一组常用任务提示列表：

在输入提示时，您可以：

• 使用补全功能从历史记录或常用提示中选择
• 在需要时仍可输入自定义提示

提示历史和常用提示在所有会话中均可使用。

文件监控

通过设置 aidermacs-watch-files，您可以启用对仓库中 AI 编码指令的监控：

;; 启用文件监控
(setq aidermacs-watch-files t)

启用后，Aidermacs 将监控您仓库中的所有文件，并查找您使用喜爱的 IDE 或文本编辑器添加的任何 AI 编码指令。

具体而言，Aider 会寻找以 AI、AI! 或 AI? 开头或结尾的一行注释（无论语言支持何种注释风格），例如：

# 制作一个贪吃蛇游戏。AI!
# 这个方法的目的是什么 AI？

// 编写一个蛋白质折叠预测引擎。AI!

Aidermacs 会记录所有以 AI 开头或结尾的注释。包含感叹号的 AI! 或问号的 AI? 注释则较为特殊，它们会触发 Aider 收集所有 AI 注释，并将其用作您的指令。

• AI! 会触发 Aider 对您的代码进行更改。
• AI? 会触发 Aider 回答您的问题。

注意：此功能目前仅在 vterm 模式下可用。

注意：这些配置会被 .aider.conf.yml 文件的存在所覆盖（详见 细节）。

只读文件

您可以通过设置 aidermacs-global-read-only-files 和 aidermacs-project-read-only-files，将某些文件在每次启动 Aidermacs 会话时始终设为只读。

;; 始终将这些文件作为只读文件添加到所有 Aidermacs 会话中
;; 对于项目目录之外的文件
(setq aidermacs-global-read-only-files '("~/.aider/AI_RULES.md"))
;; 对于项目目录内的文件
(setq aidermacs-project-read-only-files '("CONVENTIONS.md" "README.md"))

当 Aidermacs 会话开始时，如果这些文件存在于项目中，它们将自动被添加为只读文件。这对于您希望 AI 了解但不希望其修改的文档或其他参考资料非常有用。

差异与更改审查

通过 aidermacs-show-diff-after-change 控制是否显示 AI 生成更改的差异：

;; 启用/禁用更改后显示差异（默认：t）
(setq aidermacs-show-diff-after-change t)

启用后，Aidermacs 将：

• 捕获 AI 编辑之前的文件状态
• 使用 Emacs 内置的 ediff 界面显示差异
• 允许您审查并接受/拒绝更改。

重新启用自动提交

Aider 默认会自动提交 AI 生成的更改。我们认为这种行为 非常 干扰，因此已将其禁用。您可以通过将 aidermacs-auto-commits 设置为 t 来重新启用自动提交：

;; 启用自动提交
(setq aidermacs-auto-commits t)

在禁用自动提交的情况下，您必须使用您偏好的 Git 工作流程手动提交更改。

注意：此配置会被 .aider.conf.yml 文件的存在所覆盖（详见 细节）。

控制退出时缓冲区的关闭

默认情况下，当你使用 aidermacs-exit（或临时菜单中的 x）退出 Aidermacs 会话时，Aidermacs 缓冲区会保持打开状态。如果你希望在退出会话时自动关闭该缓冲区，可以通过以下方式自定义行为：

;; 退出会话时关闭 Aider 缓冲区
(setq aidermacs-exit-kills-buffer t)

使用 aidermacs-extra-args 自定义 Aider 选项

如果上述配置仍无法满足需求，aidermacs-extra-args 变量允许你传递任何 Aider 支持的命令行选项。

完整的可用选项列表，请参阅 Aider 配置文档。

;; 设置日志详细程度：
(add-to-list 'aidermacs-extra-args "--verbose")

这些参数将在运行 Aider 命令时附加到命令行中。请注意，--model 参数由 aidermacs-default-model 自动处理，不应再添加到 aidermacs-extra-args 中。

使用配置文件覆盖设置

Aidermacs 支持通过 .aider.conf.yml 文件进行项目特定的配置。要启用此功能：

1. 在你的主目录、项目根目录或当前目录下创建一个 .aider.conf.yml 文件，并定义所需的设置。有关可用选项，请参阅 Aider 文档。

2. 通过以下两种方式之一告知 Aidermacs 使用该配置文件：

   ;; 在 Emacs 配置中设置 `aidermacs-config-file` 变量：
   (setq aidermacs-config-file "/path/to/your/project/.aider.conf.yml")
   ;; 或者，在 `aidermacs-extra-args` 中包含 `--config` 或 `-c` 标志：
   (setq aidermacs-extra-args '("--config" "/path/to/your/project/.aider.conf.yml"))
   

注意：你也可以依赖 Aider 的默认行为，即按主目录、项目根目录和当前目录的顺序自动搜索 .aider.conf.yml 文件。在这种情况下，无需设置 aidermacs-config-file 或在 aidermacs-extra-args 中包含 --config。

• 重要：配置优先级

当 Aidermacs 会话启动时，它会根据以下优先级层次确定使用哪些设置：

1. Aider 配置文件（.aider.conf.yml）： 如果找到配置文件（无论是在默认位置还是通过 aidermacs-config-file 或 aidermacs-extra-args 指定），则具有 最高优先级。Aidermacs 将 忽略 其自身的 Emacs 变量（如 aidermacs-default-model），并让 Aider 工具直接从该文件管理设置。随后，优先级由 Aider 自身决定（命令行参数优先于环境变量，而环境变量又优先于配置文件）。

2. Emacs 配置（未使用配置文件时）： 如果没有 .aider.conf.yml 文件，Aidermacs 将构建用于 Aider 的命令行参数。其使用的值按照以下优先级顺序确定： a. Emacs 变量（最高）： 你在 init.el 中设置的值（例如 (setq aidermacs-default-model "...")）。 b. 环境变量： 如果未设置 Emacs 变量，则采用相应的环境变量值（例如 AIDER_MODEL）。 c. 内置默认值（最低）： 如果以上两者均未设置，则使用硬编码的默认值。

为避免冲突： 当使用 .aider.conf.yml 文件时，应将所有设置都定义在该文件中。不要在 Emacs 中设置类似 aidermacs-default-model 的变量，也不要通过 aidermacs-extra-args 传递 --model 等参数，因为这些都会被忽略，反而可能导致混淆。

Claude Sonnet 3.7、4、4.5 思考标记

Aider 可以与 Sonnet 3.7 的 新思考标记 及该系列的更新模型一起使用。现在你可以通过以下方法更轻松地启用和配置思考标记：

1. 聊天内命令： 使用 /think-tokens 命令，后接所需的标记预算。例如：/think-tokens 8k 或 /think-tokens 10000。支持的格式包括 8096、8k、10.5k 和 0.5M。

2. 命令行参数： 在启动 Aidermacs 时设置 --thinking-tokens 参数。例如，可以将其添加到你的 aidermacs-extra-args 中：

   (setq aidermacs-extra-args '("--thinking-tokens" "16k"))
   

这些方法提供了一种更为简便的方式，无需手动配置 .aider.model.settings.yml 文件即可控制思考标记。

注意：如果你正在使用 .aider.conf.yml 文件，也可以在那里设置 thinking_tokens 选项。

使用提示文件

.aider.prompt.org 文件特别适用于：

• 存储常用提示
• 记录常见工作流程
• 快速访问复杂指令

你可以通过配置 aidermacs-auto-mode-files 来自定义哪些文件会自动启用该次要模式：

(setq aidermacs-auto-mode-files
      '(".aider.prompt.org"
        ".aider.chat.md"
        ".aider.chat.history.md"
        ".aider.input.history"
        "my-custom-aider-file.org"))  // 添加你自己的文件

常见问题解答

Aider 是什么？

有关 Aider 的相关问题，请查看 Aider 的常见问题解答。

我可以使用自己的 AI 模型吗？

可以！Aidermacs 支持任何兼容 OpenAI API 的端点。请参阅 Aider 关于 Ollama 和 LiteLLM 的文档。

我的代码会被发送给 AI 提供商吗？

是的，你添加到会话中的代码会被发送给 AI 提供商。请务必注意敏感代码。

为什么 Aider 不支持 Python 3.13？

目前 Aider 仅支持 Python 3.12。你可以使用 uv 安装 Aider：

uv tool install --force --python python3.12 aider-chat@latest

如果你遇到与代理相关的 问题，例如提示未安装 socksio 包的错误，请使用以下命令：

uv tool install --force --python python3.12 aider-chat@latest --with 'httpx[socks]'

并相应地调整 Aidermacs 程序路径：

(setq aidermacs-program (expand-file-name "~/.local/bin/aider"))

本地模型偏好英语，即使提示语言不同

某些本地模型在 Aider 中可能会默认使用英语，即便你在提示中使用了其他语言。为确保聊天语言符合你的偏好（例如俄语），请在 Emacs 配置中添加以下内容：

(add-to-list 'aidermacs-extra-args "--chat-language ru")

这将指示 Aider 使用俄语进行对话交互。

Aidermacs 或 Aider 在使用 Ollama 时会忽略命令行参数并提示选择提供商

如果 ~/.aider 目录存在（即使为空），Aidermacs 或 Aider 可能会静默地忽略命令行参数，并意外提示选择提供商（例如强制使用 OpenRouter），即便你的配置已正确设置为 Ollama 或其他提供商。

解决方法： 删除现有的 aider 目录并重启 Emacs：

rm -rf ~/.aider*

执行此操作后，Aidermacs 应该会按照预期使用你配置的提供商（例如 Ollama）启动。

Aidermacs、Aider CLI 和 aider.el 有何不同？

Aidermacs 的设计旨在提供更原生的 Emacs 使用体验，同时与 Aider CLI 集成。它最初是 aider.el 的一个分支，但后来为了优先考虑与 Emacs 工作流的集成而发生了显著分化，由 Emacs 用户为 Emacs 用户打造。

虽然 aider.el 试图模仿 Aider CLI 的行为，但 Aidermacs 则围绕 Emacs 特有的功能和范式构建。这种设计理念使你能够通过自然、原生的 Emacs 编程体验来充分利用 Aider 的强大功能。

使用 Aidermacs，你可以获得以下优势：

1. 内置 Ediff 集成，用于查看 AI 生成的更改

   • 无缝代码审查：自动使用 Emacs 强大的 ediff 界面显示所有由 AI 修改的文件差异。
   • 熟悉的界面：采用 Emacs 原生的 ediff 工作流程进行变更审查。
   • 交互式工作流：使用标准的 ediff 命令接受或拒绝更改。
   • 语法高亮：在比较过程中保持正确的语法高亮显示。
   • 安全的变更管理：保留原始文件状态，便于比较和回滚。

2. 智能模型选择

   • 自动发现来自多个提供商的可用模型。
   • 实时检查模型兼容性。
   • 无缝集成到你配置的 API 密钥中。
   • 缓存常用模型以实现快速访问。
   • 支持流行的预配置模型以及动态发现的模型。

3. 灵活的终端后端支持

   • Aidermacs 支持多种终端后端（comint 和 vterm），以提高兼容性和性能。
   • 轻松配置以选择你喜欢的终端模拟器。
   • 具有可扩展架构，可添加新的后端。

4. 更智能的语法高亮

   • AI 生成的代码在主流语言中会显示正确的语法高亮。
   • 无需额外配置即可确保清晰度和可读性。

5. 更好地支持多行输入

   • Aider 是一款基于命令行的程序，其多行输入受限于终端的能力。
   • 基于终端的工具需要特殊的语法或手动格式化才能处理多行输入，这往往繁琐且不直观。
   • Aidermacs 通过在 Emacs 内部原生处理多行提示，消除了这些限制，让你可以像输入普通文本一样轻松撰写复杂的 AI 请求。
   • 无论是粘贴代码块还是优化 AI 生成的回复，Aidermacs 中的多行交互都显得自然流畅。

6. 从 Emacs 提升文件管理能力

   • 使用 M-x aidermacs-list-added-files 列出当前聊天中的文件。
   • 使用 M-x aidermacs-drop-file 从聊天中移除特定文件。
   • 使用 M-x aidermacs-show-output-history 查看输出历史。
   • 使用 M-x aidermacs-add-files-interactively 交互式选择要添加的文件。
   • 使用 M-x aidermacs-add-file-to-session 将任意文件的内容添加到特定会话中。
   • 使用 M-x aidermacs-create-session-scratchpad 创建临时文件，用于向 Aider 会话添加代码片段或笔记。
   • 完全支持通过 Tramp 访问远程文件（SSH、Docker 等）。
   • 以及更多功能。

7. 更高的可配置性

   • Aidermacs 提供更多自定义选项，以根据你的偏好调整使用体验。

8. 精简的瞬态菜单选择

   • 瞬态菜单经过全新设计，兼顾功能性和易用性，优先考虑用户体验。

9. 多种灵活的内容添加方式

   • Aidermacs 提供多种方式将内容添加到 Aider 会话中，包括添加文件、创建临时草稿文件等。

10. 社区驱动的开发

    • Aidermacs 由社区积极开发和维护，不断吸纳用户反馈和贡献。
    • 我们优先考虑那些直接惠及 Emacs 用户的功能和改进，确保工具能够随着你的需求不断发展。

……未来还将带来更多新特性 🚀

视频演示

社区驱动的开发

Aidermacs 的发展离不开社区的参与。我们相信，通过与用户和贡献者协作开发，才能打造出最优秀的软件。我们鼓励你：

• 贡献代码：提交包含错误修复、新功能或现有功能改进的拉取请求。
• 报告问题：通过 GitHub Issues 向我们反馈任何 bug、异常行为或功能请求。
• 分享想法：参与讨论，提出让 Aidermacs 更加完善的建议。
• 改进文档：帮助我们使文档更加清晰、全面且易于使用。

你的贡献对于将 Aidermacs 打造成 Emacs 中最佳的 AI 配对编程工具至关重要！

Aidermacs 快速上手指南

Aidermacs 将强大的 AI 结对编程工具 Aider 集成到 Emacs 中。如果你习惯使用 Emacs 但渴望拥有类似 Cursor 的 AI 编程体验，Aidermacs 是最佳选择。

环境准备

在开始之前，请确保你的系统满足以下要求：

• Emacs: 版本 ≥ 26.1
• Aider: 必须预先安装主程序。
  • 推荐安装官方版本：pip install aider-chat
  • 或社区实验版：pip install aider-ce
• Emacs 依赖包:
  • transient (通常随 Magit 自动安装，若未安装需手动获取)
• API Key: 准备好你所用大模型服务商的 API Key (如 Anthropic, OpenAI, OpenRouter 等)。

安装步骤

你可以通过 MELPA 或 NonGNU ELPA 仓库直接安装，这是最推荐的方式。

1. 配置包管理器 (init.el)

确保你的 init.el 中已配置好 package-archives 包含 MELPA 和 NonGNU ELPA：

(require 'package)
(add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t)
(add-to-list 'package-archives '("nongnu" . "https://elpa.nongnu.org/nongnu/") t)
(package-initialize)

2. 安装 Aidermacs

在 Emacs 中执行 M-x package-refresh-contents 刷新列表，然后执行 M-x package-install 输入 aidermacs 进行安装。

或者直接在 init.el 中使用 use-package 进行声明式安装（推荐）：

(use-package aidermacs
  :ensure t
  :bind (("C-c a" . aidermacs-transient-menu)) ;; 绑定快捷键
  :config
  ;; 方式一：在 .bashrc 或 .zshrc 中设置环境变量（推荐，更安全）
  ;; export ANTHROPIC_API_KEY="sk-..."
  
  ;; 方式二：直接在 elisp 中设置（注意不要将密钥提交到代码仓库）
  ;; (setenv "ANTHROPIC_API_KEY" "sk-...")
  
  :custom
  (aidermacs-default-chat-mode 'architect) ;; 默认启用架构师模式（推理+编辑分离）
  (aidermacs-default-model "sonnet"))      ;; 默认模型

Spacemacs 用户： 在 .spacemacs 的 dotspacemacs-additional-packages 列表中添加 (aidermacs :variables ...)，并在 dotspacemacs/user-config 中绑定按键 (spacemacs/set-leader-keys "aa" 'aidermacs-transient-menu)。

基本使用

安装配置完成后，即可在项目中使用 AI 辅助编程。

1. 启动会话

打开你的项目目录，按下快捷键 C-c a (或你自定义的按键)，或者执行命令 M-x aidermacs-transient-menu。

这将打开一个类似 Magit 的 transient 菜单界面。

2. 添加文件

AI 需要知道哪些文件可以读取或修改。在菜单中：

• 按 F：添加当前缓冲区文件到会话（可编辑）。
• 按 f：选择添加其他文件。
• 提示：在添加文件前按 C-u 前缀，可将文件设为只读（AI 仅参考不修改）。

3. 与 AI 交互

在菜单中选择操作模式或直接输入指令：

• 代码模式 (1)：直接让 AI 修改代码。
• 问答模式 (2)：询问代码逻辑或架构问题。
• 架构师模式 (3)：(推荐) 先由“架构师”模型规划，再由“编辑”模型执行，适合复杂任务。

最简单的工作流示例：

1. 打开项目，按 C-c a 唤出菜单。
2. 按 F 将当前文件加入上下文。
3. 按 c (Code Change) 或直接输入自然语言指令，例如：“给这个函数添加错误处理”。
4. Aidermacs 会调用后端 Aider 生成代码变更。
5. 变更生成后，会自动触发 ediff 界面供你审查差异，确认无误后接受即可。

4. 常用快捷键速查

在 aidermacs-transient-menu 界面中：

• a: 开始/打开会话
• l: 清除聊天历史
• o: 切换主模型
• g: 接受提议的更改
• ?: 查看帮助信息

现在，你可以在 Emacs 中享受高效的 AI 结对编程体验了！