开源Oblivion AI：Python实现的免费AI编程助手

作为一名来自印度的计算机科学专业学生，我受够了不断切换上下文的痛苦：把 ChatGPT 浏览器标签页里的代码复制粘贴到 VS Code，发现少了一个函数，然后再重复这个循环。

Cursor、GitHub Copilot 和 Claude Code 等专有工具解决了这个工作流问题，但它们是闭源的，每月收费 10–20 美元，而且会将你的代码库锁定在第三方云基础设施上。

所以在过去的几个月里，我构建了 Oblivion AI 🔮——一个终端原生的开源 AI 结对编程工具，它生活在你的终端中，能够语义化理解你的本地代码库，以原子方式执行多文件编辑，并通过自然语音进行对话。

最棒的是：运行它完全不花钱。

🌟 Oblivion AI 有什么不同？ Oblivion AI 不仅仅是一个简单封装单个 API 的工具。它是一个完整的 Agentic Systems Architecture，使用 Python、Textual、ChromaDB 和 SQLite 构建。

⚡ 多模型弹性与自动回退 大多数 AI 编码工具在单个 API 提供商遇到速率限制或宕机时会完全失效。Oblivion 在 Ollama Cloud（Gemma 4 31B / Qwen 3 Coder 480B）、Google Gemini 2.5 Flash 和 Groq Llama 3.3 之间建立了一条自动化回退链。

如果某个提供商遇到速率限制，Oblivion 会静默切换到链中的下一个模型，并采用智能的、针对特定错误的冷却时间（例如，每日配额限制的冷却时间为 4 小时，而 RPM 限制的冷却时间为 1 分钟）。

🔍 三层混合搜索引擎（RAG） 当你问 Oblivion"身份验证在哪里处理？"时，它会并行查询三个搜索层：

第一层（AST 符号索引）：使用 Python 原生的 ast 模块在函数/类边界处对代码进行分块，并在 SQLite 中为其建立索引，以实现小于 1 毫秒的精确符号查找。 第二层（全文搜索）：使用 SQLite FTS5 进行精确文本和错误签名匹配。 第三层（向量嵌入）：使用 ChromaDB 配合 all-minilm 嵌入进行语义化的自然语言概念查询。 结果会被去重、合并和排序。精确符号匹配始终排在模糊语义猜测之前，获得第一名。

🔌 内置 MCP Server（Model Context Protocol） Oblivion 不仅仅是一个终端 UI——它还是一个 MCP Server。运行 oblivion mcp 可以通过 stdio 暴露 10 个只读代码智能工具。

这意味着 Claude Desktop、Cursor 或 Zed 等外部客户端可以直接插入 Oblivion 的本地 RAG 索引，而无需启动 TUI！

🎙️ 免提语音输入/输出与唤醒词 你可以自然地与 Oblivion 对话：

后台唤醒词：使用 openwakeword 监听"Hey Jarvis"（100% 在 CPU 上本地运行）。 静音自动停止：检测到 3 秒的语音停顿后自动停止录音并提交查询。 神经网络 TTS 回复：使用 8 种神经网络语音角色通过 edge-tts 或 ElevenLabs 进行语音回复。

🛡️ 三层安全与权限门禁 Oblivion 将所有 38 个内置工具分为三个安全层级：

🟢 读取层（23 个工具）：静默自动执行（read_file、search_code、git_status）。 🟡 变更层（14 个工具）：显示统一的彩色差异预览并请求明确批准（write_file、batch_edit、git_commit）。 🔴 破坏层（1 个工具）：高风险命令（带有 rm -rf 或 git push --force 的 run_bash）需要严格验证，绝不会自动批准。

🧰 38 个内置 Agent 工具 Oblivion 附带了一套完整的工具集，用于实际软件工程：

Git 套件：git_status、git_diff、git_log、git_commit、git_branch、git_undo。 原子批量编辑：batch_edit 可以在单个审批步骤中创建或修改跨项目的多个文件。 测试运行器集成：自动检测并运行 pytest、jest、vitest 或 npm test 套件，并提取结构化的失败信息。 网络搜索：集成 DuckDuckGo 搜索、网页抓取（fetch_page）、Stack Overflow 搜索以及 PyPI/npm registry 查询。 8085 CPU 模拟器：内置 Intel 8085 微处理器模拟器和两遍汇编器，用于计算机教育。

⚡ 快速入门 安装 Oblivion AI 只需不到 30 秒：

pip install "oblivion-agent[voice]"

oblivion

其他 CLI 子命令：

oblivion inspect

🔗 链接与社区 Oblivion AI 采用 MIT 许可证，100% 免费且开源。

🌐 网站：oblivion.run.place 🐙 GitHub 仓库：Rohith-s-hub/Oblivion-agent 📦 PyPI 包：oblivion-agent 💼 LinkedIn：Rohith Rajkumar

如果你觉得这个项目有用或有趣，请考虑在 GitHub 上点一颗 Star ⭐——作为独立学生开发者，这对我帮助很大！