Show HN: CodeTutor —— 专为 Emacs 设计的 AI 结对编程导师

背景

在当前的 AI 辅助编程生态中，大多数工具（如 GitHub Copilot、Cursor 等）倾向于直接生成代码、提供补全建议或自动修改文件。这种“代写”模式虽然高效，但往往剥夺了开发者深入理解代码逻辑、架构决策及最佳实践的机会，容易导致对 AI 的过度依赖以及技术成长的停滞。

Hacker News 上近期展示的一个名为 CodeTutor 的 Emacs 插件，提供了一种截然不同的思路。它不仅仅是一个代码生成器，更是一个旨在“边写代码边学习”的本地 AI 结对编程导师。CodeTutor 的核心设计理念是“辅助你编写代码，但不替你写代码”，它通过监听文件保存、收集项目上下文，并调用本地 AI 后端（如 Codex 或 Pi），以高级/资深工程师的口吻提供反馈、解释概念并推荐下一步行动。这种设计旨在模拟资深工程师的结对编程体验，强调概念理解和工程判断，而非简单的代码产出。

核心内容

CodeTutor 是一个早期开发的本地 Emacs 包，专为 Stock Emacs 和 Doom Emacs 设计。它通过右侧面板与用户交互，其核心功能围绕四个主要循环展开：启动评估、保存审查、手动提示和后续追问。

功能边界与定位

CodeTutor 明确划定了其能力边界：

• 它能做：审查保存后的代码变更、解释反馈背后的概念、展示紧凑的示例代码、推荐最佳下一步、回答 minibuffer 提示、基于近期对话回答后续问题，以及在 .codetutor/ARCHITECTURE.md 中持久化架构笔记。
• 它不能做：直接编辑你的源代码文件、生成补丁（patches）、替换整个文件，或提供完全准备好粘贴的完整实现。

工作流程详解

1. 启动评估 (Startup Assessment) 当用户运行 M-x codetutor-open 时，CodeTutor 会检测项目根目录，打开右侧面板，收集项目上下文，并向后端发起只读请求。面板会显示“Status: thinking”，随后展示最终答案。初始回答旨在指导用户从哪里开始、先学习什么，以及在写代码前需要注意的工程判断。

2. 保存审查 (Save Review) 当启用 codetutor-mode 和 codetutor-review-on-save 时，CodeTutor 会钩入 Emacs 的保存流程：

   • before-save-hook 读取磁盘上的当前文件内容。
   • 正常执行保存操作。
   • after-save-hook 比较保存前后的内容差异，构建统一 diff。
   • CodeTutor 将 diff 和项目上下文发送给后端。
   • 侧边栏显示“Status: thinking”，随后替换为最终的教学反馈。 审查内容与 diff 大小成正比，导师应聚焦于概念、风险、架构、测试以及一个具体的下一步行动。

3. 手动提示 (Manual Prompt) 通过 M-x codetutor-ask 从 minibuffer 发起提问。系统会整合当前文件、tree-sitter 或 imenu 大纲、项目上下文、架构记忆、项目文件索引以及最近的对话轮次。后端在支持的情况下，可以通过只读工具检查或搜索其他项目文件。

4. 后续追问 (Follow-up) 通过 M-x codetutor-follow-up 针对上一个答案提问。此功能不会在侧边栏显示提示文本，但会包含近期的私密对话轮次，允许用户询问“能否展示更小的示例？”或“测试结构应该是什么样？”。由于保留了当前文件和项目上下文，导师可以将 prior answer 与当前情境联系起来。

5. 下一步推荐 (What Next) 通过 M-x codetutor-what-next 让导师检查可用上下文并推荐一个最佳下一步。这在实现片段之间犹豫时特别有用，相当于寻求资深工程师的工程判断。

架构记忆与持久化

CodeTutor 允许导师在回答中包含持久的架构观察，格式为 fenced block：

- Boundary: The editor integration owns context gathering; the backend owns tutoring.

CodeTutor 会提取这些行并追加到项目根目录下的 .codetutor/ARCHITECTURE.md 文件中。这是 CodeTutor 唯一自动写入的项目文件。

后端集成与安全机制

CodeTutor 支持本地后端，目前主要支持 Codex 和 Pi。

• Codex 后端：使用 codex exec 非交互式运行。配置为只读沙箱、从不请求批准、临时会话、无终端颜色，并可选开启网页搜索。关键参数 --output-last-message 确保面板仅显示最终答案。
• Pi 后端：使用非交互式 print 模式，仅启用只读工具（read, grep, find, ls），确保只能检查文件而不能写入或编辑。

为了保持界面整洁，侧边栏被设计为非聊天转录模式。每次请求都会清空面板，显示思考状态，运行后端，提取最终答案（通常包裹在 <codetutor-answer> 标签中），然后再次清空并仅显示答案。面板不显示用户提示词、元数据、完整项目上下文或后端进度输出。

配置与限制

CodeTutor 提供了丰富的配置选项以控制上下文大小和模型行为，防止大会话淹没后端。例如：

• 项目上下文限制：80,000 字节
• 当前文件限制：50,000 字节
• Diff 限制：60,000 字节
• 最大打开缓冲区：12 个
• 最大对话轮次：8 轮

用户可以通过修改 codetutor-system-prompt 来自定义导师的行为，例如强调“你是我的只读 staff engineer 导师……”。

关键要点

• 教育优先，而非代写：CodeTutor 的核心价值在于“教”而非“写”。它通过解释概念、展示示例和推荐步骤，帮助用户理解代码背后的逻辑，模拟资深工程师的结对编程体验。
• 严格的安全边界：
  • 应用层：通过 prompt 指令禁止生成补丁、完整文件替换或直接编辑源码。
  • 系统层：后端配置为只读沙箱（Codex）或仅启用只读工具（Pi），确保 AI 无法意外修改项目文件。
  • 唯一例外：仅允许写入 .codetutor/ARCHITECTURE.md 用于持久化架构笔记。
• 上下文管理精细化：通过限制项目上下文、当前文件、diff 大小以及打开缓冲区的数量和大小，CodeTutor 有效控制了 LLM 的输入成本，避免上下文溢出或信息过载。
• 本地化与隐私：支持本地运行的 Codex 和 Pi 后端，数据无需上传至云端，适合对代码隐私有严格要求的开发者和企业环境。
• Emacs 原生集成：深度集成 Emacs 生态系统，支持 Stock Emacs 和 Doom Emacs，利用 tree-sitter（Emacs 29+）或 imenu 获取代码结构，提供符合 Emacs 用户习惯的操作流。
• 状态机式交互：侧边栏不保留聊天历史，每次交互都是独立的“请求-思考-回答”循环，但通过 follow-up 功能保留近期对话上下文，平衡了简洁性与连贯性。

意义与影响

CodeTutor 的出现反映了 AI 辅助编程工具正在从“效率工具”向“认知增强工具”演进的趋势。

1. 对抗 AI 依赖，促进技能成长：在 Copilot 等工具普及的背景下，开发者容易陷入“复制-粘贴”的舒适区，导致底层技能退化。CodeTutor 通过强制用户阅读、理解和应用反馈，而非直接获取代码，有助于维持和提升开发者的工程思维能力。
2. 重新定义“结对编程”：传统的结对编程需要真人参与，成本高且难以规模化。CodeTutor 提供了一种可扩展的、基于本地模型的“虚拟结对”方案，让每位开发者都能拥有随时在线的“资深导师”。