Onebird

# 核心引擎

Onebird 是一个轻量级、原生命令行的 AI 编程框架。它不会强迫你适应固定的工作流，而是顺应你的习惯。你可以使用 TypeScript 插件、自定义工具和动态提示词架构对其进行无尽地定制，然后将配置作为模块化包进行分享。

我们提供强大的基础功能，同时有意抛弃了像原生子智能体调度或死板的计划模式等臃肿功能。如果你需要它们，只需让 Onebird 为你编写代码实现——或者获取一个社区模块。

支持四种不同的操作范式：交互式 TUI、原生 JSON 流、RPC 端点或是变成化 SDK。

# 智能层

跨越 15+ 平台的无尽组合

即刻连接 OpenAI, Anthropic, Google, Mistral, xAI, Groq, Cerebras, Hugging Face, OpenRouter, Ollama 甚至更多平台。使用标准 API 密钥或 OAuth 流程无缝确保连接安全。

正在执行任务时需要不同的推理引擎？使用 /model 或 Ctrl+L 快捷键即可随心切换模型。使用 Ctrl+P 快速循环你固定收藏的偏好。

想要挂接一个本地或小众的 API 接口？在 models.json 中定义即可，或通过插件注入。

# 状态与历史

非线性、带有版本控制的对话

你的聊天历史不是一个扁平的日志——它是一棵分支树。使用 /tree 回跳至任意历史节点，进而分叉出一条新的路径。一切都被安全地保存在一个统一文件里。你可以轻松应用过滤机制或者在关键洞察上留下书签。

Onebird 中的分支树界面

使用 /export 轻松将你的整个会话渲染为静态 HTML 页面，或者通过 /share 瞬时将交互视图公开到 GitHub Gist。

# 语义感知引擎

精确的上下文工程

我们将控制权交给你。Onebird 极其精简的基础提示词（Base prompt），使你能完全按照你的构想来设计 AI 的上下文窗口。

• 工作区守则： 自动从你的根目录、父目录或全局目录加载 AGENTS.md 指令。
• 核心人格设定： 完全重写或通过 SYSTEM.md 为基础指令添加增补策略。
• 记忆压缩策略： 聪明的总结机制保证你的对话不超出 Tokens 上限。你也可以通过插件换入自己的分块（Chunking）逻辑或者专用化模型。
• 能力套件： 按需加载的模块化功能包。最大化效用的同时保护你的提示词缓存不再溢出。
• 预制片段： 存储可复用的 Markdown 查询结构。以 /name 为前缀瞬间展开它们。
• 动态上下文激活： 使用插件即时拦截查询、注入 RAG （检索增强生成）结果，或者对远期的向量存储进行实时读写。

# 执行流控制

异步操控体验

不要干等生成结果。随时敲击 Enter 瞬间改变 AI 的舵向（打断其接下来的行动并覆写方向），或者使用 Alt+Enter 排队一个有礼貌的跟进指令，等待它完成当前作业后再读取。

# 无极自定义

架构的本源基元

与其塞给你臃肿的自带功能，我们直接提供建筑原材料。插件是纯粹的 TypeScript 模块，深度享有 TUI 视层、事件循环、键位绑定以及内部工具结构的接入权限。

想要定制的 SSH 执行流、沙盒环境、极其严格的权限隔离栅栏、集成 MCP 服务器或构建错综复杂的子智能体网络生态？自己造吧。（是的，你甚至可以在上面运行毁灭战士 Doom）。

在 Onebird 运行自定义 TUI 浮层

不想亲自动手写代码？直接命令 Onebird 帮你敲出扩展应用，或者从几十个社区发行的实例中拉取。

# 指导准则理念

通过做减法做加法

我们的核心哲学是极致微小的干扰。能够由插件或脚本来推迟实现的带观点的功能集，我们坚决不放入核心二进制库。

• 没有原生 MCP 桥接： 保持简明扼要的 CLI 工具形态，如果你急需硬气的 MCP 桥接器请装载社区插件。
• 没有强绑定的子智能体： 使用 tmux 来管控并发进程，写你自己的编排脚本工具，或直接下载专用扩展包。
• 没有恼人的弹窗打扰： 用互相隔离的容器将你的安全考量硬编码，或者依循你的合规诉求编写出特定的 TUI 确认触发器。
• 没有僵化的项目规划 UI： 草拟你的架构文档即可，或者让社区插件接管任务进程的步进。
• 没有封闭式专属任务追溯： 老老实实采用极其通用的标准 TODO.md 就够了。
• 没有不可见的后台脚本暗箱操作： 在有着百分百可观测性的正规多路复用器（tmux/screen 等）里管理你的服务群。

去阅读我们的宣言以领教完整心智模型。