aider 不只改代码：用终端 AI 助手安全地编辑配置文件、文档与各类文本

aider 不只改代码用终端 AI 助手安全地编辑配置文件、文档与各类文本【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aider导读aideraider的定位是「terminal 里的 AI 结对编程」但它的能力边界远不止于源代码Shell 配置、SSH 配置、Dockerfile、Git 配置、系统 hosts、编辑器配置、Markdown 文档乃至 XML 工程文件都是它擅长处理的文本对象。本文围绕 not-code.md 的十类真实案例完整演示如何用 aider 修改这些非代码文件并结合仓库源码剖析文件进入会话、只读/可编辑边界、git 协同等底层机制让你获得一份可以直接照做的「非代码文件 AI 编辑手册」。一、为什么「非代码文件」也值得交给 aider.bashrc、~/.ssh/config、Dockerfile、.gitconfig、/etc/hosts、.vimrc、settings.json、README.md、pom.xml……这些文件有一个共同点它们都是文本而 aider 的核心能力就是对任意文本文件做「阅读—理解—精确改写」。用自然语言描述意图比如「加一个别名」「开启保存时自动格式化」由模型生成符合文件既有语法风格的改动是这类文件维护中最省心的工作方式。从会话输出即可确认这一点——当你把某个文件交给 aider 时终端会打印Added 文件名 to the chat。这句提示在源码中正是文件被登记为「可编辑文件」的信号在 base_coder.py 中启动时会为每个在会话中的文件输出Added X to the chat.若是只读文件则输出Added X to the chat (read-only).在运行时通过/add或命令行传入时commands.py 在把路径加入coder.abs_fnames后同样会打印Added {fname} to the chat。也就是说只要能被人类用编辑器打开的文件aider 就能参与编辑无论后缀是.py、.md还是完全没有后缀的点文件。二、先学会把文件交给 aider命令行与 /add2.1 启动时指定文件最常见的做法是在启动命令后直接罗列要编辑的文件aider ~/.ssh/config aider Dockerfile docker-compose.yml aider /etc/hosts一个文件可以带上绝对路径、~展开路径多个文件用空格隔开。在 main.py 中args.files与--file追加的参数会被合并、统一做resolve()归一化后再传入 Coder。命令行还提供了两个可重复使用的开关见 args.py参数含义--file FILE指定一个要编辑的文件可多次使用--read FILE指定一个只读文件可多次使用仅供模型参考不参与改写--read特别适合「参考几个文档、只改其中一个」的场景只读文件不会出现在模型可改写的候选清单中从 base_coder.py 可以看到它们会以(read-only)后缀被标记并在/drop时单独管理。2.2 会话中使用 /add 追加启动时忘记带文件也没关系会话中随时输入/add追加文件即可。cmd_add 支持 glob 通配、路径中自动补全parse_quoted_filenames并且对「不存在的文件」会先询问是否新建No files matched ... Do you want to create ...确认后才创建空文件加入会话commands.py。2.3 哪些文件加不进来源码中有几类硬性限制编辑系统级配置时值得留意gitignore 拦截文件被.gitignore忽略时默认不允许加入会话除非显式开启--add-gitignore-filescommands.py。aiderignore、--subtree-only同样会影响文件可见性commands.py仓库外的文件与 auto-commits当启用了自动提交且目标文件不在当前 git 仓库根目录内如图片类文件除外时会被拒绝加入commands.py。这意味着编辑~/.bashrc、~/.ssh/config这类家目录文件时若你正处于某个 git 仓库中可能需要先cd到这些文件的目录或使用 git 仓库根目录外的工作方式再启动 aider图片与视觉模型图片只有在主模型支持视觉supports_vision时才能加入会话commands.py。提示编辑/etc/hosts等系统文件通常需要 root 权限正如官方示例注释# May need sudo所提醒的请以sudo方式启动命令或确保当前用户有写权限。三、实战九类配置与文本文件的 AI 编辑示例以下示例均来自 not-code.md 中的真实会话记录表示模型针对你的请求在该文件中插入的内容。你可以原样复制命令与提问语句进行验证。3.1 Shell 配置.bashrc$ aider .bashrc Added .bashrc to the chat.提问Add an alias ll that lists all files, with all details in human readable format. And update PATH to include uv installed tools. alias llls -alh export PATH$PATH:$HOME/.local/bin:$PATH3.2 SSH 配置~/.ssh/config$ aider ~/.ssh/config Added config to the chat.提问Create a Host entry my-server using bastion.example.com as JumpHost Host my-server HostName 192.168.1.100 User deploy Port 2222 IdentityFile ~/.ssh/deploy_key ProxyJump bastion.example.com3.3 Docker 配置Dockerfile docker-compose.yml一次把两个文件都加进会话$ aider Dockerfile docker-compose.yml Added Dockerfile and docker-compose.yml to the chat.提问Set non-root user and enable healthchecks USER appuser HEALTHCHECK --interval30s --timeout3s \ CMD curl -f http://localhost:8000/health || exit 1继续提问Expose port 5432 and add volume for postgres dataservices: postgres: image: postgres:15 ports: - 5432:5432 volumes: - pgdata:/var/lib/postgresql/data3.4 Git 配置.gitconfig$ aider .gitconfig Added .gitconfig to the chat.提问Set default push behavior to current branch and enable color UI [push] default current [color] ui auto3.5 系统配置/etc/hosts$ aider /etc/hosts # May need sudo Added hosts to the chat.提问Block tracking domains by pointing them to 127.0.0.1 127.0.0.1 ads.example.com 127.0.0.1 track.analytics.co3.6 编辑器配置.vimrc$ aider .vimrc Added .vimrc to the chat.提问Enable line numbers and set 4-space tabs for Python set number autocmd FileType python set tabstop4 shiftwidth4 expandtab3.7 VSCode 配置settings.json$ aider settings.json Added settings.json to the chat.提问Enable auto-format on save and set default formatter editor.formatOnSave: true, editor.defaultFormatter: esbenp.prettier-vscode3.8 Markdown 文档README.md$ aider README.md Added README.md to the chat.提问Add installation section with brew and pip options ## Installation # Homebrew brew install cool-app-10k # PyPI pipx install cool-app-10k 3.9 XML 配置pom.xml$ aider pom.xml Added pom.xml to the chat.提问Add JUnit 5 dependency with test scope dependency groupIdorg.junit.jupiter/groupId artifactIdjunit-jupiter-api/artifactId version5.9.2/version scopetest/scope /dependency四、纵深非代码编辑背后源码如何保障「改得稳」4.1 文件是会话的一等公民而非模型的「临时上下文」把配置文件与源代码同等对待意味着这些文本同样享受 aider 的 git 工作流。只要当前目录是 git 仓库aider 会先提交「脏工作区」的快照dirty_commits每次 AI 改动后用 git diff 校验可回滚、可对比base_coder.py 中auto_commits、dirty_commits、show_diffs等参数共同控制这套自动提交与差异展示行为。这也是编辑/etc/hosts、.bashrc这类「改错了影响环境」的文件时最值得依赖的安全网——每一步都有 git 痕迹可以回溯。4.2 会话管理随时查看与移除配置文件来回试改会占用上下文需要时可以/tokens查看上下文占用情况/drop移除文件以释放空间——cmd_drop 支持按子串或os.path.samefile精确匹配也能把只读文件与可编辑文件分开移除/clear清空会话重新聚焦到某个文件上再继续提问。4.3 结构型文本JSON/XML/YAML的小心机从settings.json、docker-compose.yml、pom.xml的示例可以看出aider 的 diff 输出能精确到行级插入每行以标注即使嵌套层级很深也能保持缩进正确。对这类对语法敏感的文件建议一次会话只聚焦一个明确目标如上面的示例都是「单条需求 一段 diff」改完立即让 aider 运行校验命令例如/run python -m json.tool settings.json或docker compose config确认文件可解析——项目中的--auto-test//run命令见 commands.py 的 run_cmd 相关实现正好可以把这些校验固化成例行检查。4.4 把非代码编辑扩展为仓库级工作流若你的仓库里有成体系的一批文档例如本仓库的 docs 目录还可以配合--watch模式watch.py实现「文件变更即自动提问」的持续文档维护或是参考 examples/update-docs.md、examples/complex-change.md 中的多文件文档改写会话。一句话总结这套方法论先小步验证单个配置文件再推广到批量文档维护永远让 git 站在你和 AI 之间。五、小结aider 之所以能高效处理非代码文件靠的是三点底层保障其一文件以统一身份可编辑/只读进入会话并被完整纳入 diff 展示见 base_coder.py其二/add、/drop提供完整的会话内文件生命周期管理见 commands.py其三git 仓库与自动提交机制为每一步改动兜底。按照 not-code.md 给出的这些案例从明天起你的.bashrc、SSH 配置和 README 都可以交给自然语言来维护了。想要了解 aider 更完整的用法可继续阅读 Usage 文档、编辑格式说明或在源码的 examples 中观看更多端到端的对话演示。【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aider创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考