OpenPilot 是一个开源的 AI 智能体运行平台（agent harness），面向笔记本电脑用户，以本地桌面应用形式运行，采用对话优先（chat-first）的交互方式。其核心目标是让用户在不被单一供应商锁定的前提下，让智能体对真实的项目文件夹执行读取、编辑和工具调用操作。
用途与定位 OpenPilot 定位为本地 AI 智能体运行环境。用户自行选择模型提供方、工作空间和工具，API 密钥保留在用户自己的机器上。根据资料，OpenPilot 是开源项目，采用 MIT 许可证，代码可查看、可复刻（fork）、可贡献。
主要能力 自带模型（Bring your own model）：任何 OpenAI 兼容的端点都可以使用，包括 OpenAI、本地服务器、自定义网关等，用户自己持有密钥，不锁定于单一供应商。 本地 AI 运行平台：智能体在用户机器上、针对用户选定的文件夹运行，因此可以处理磁盘上的真实文件。 TinyFish 搜索（可选）：提供网页搜索和页面抓取能力，使智能体能够查询工作空间之外的当前文档、版本和事实信息。 开源：代码可检查、可复刻、可贡献，MIT 许可。
使用方式 安装方式：预构建安装包发布在 GitHub Releases 页面；已安装的应用可以从 GitHub Releases 自动更新。使用 npm start 从源码运行时不支持自动更新。 从源码快速开始：需要 Node.js 20+。首次启动时按引导（onboarding）操作：连接模型（填写 OpenAI 兼容的基础 URL 和 API Key，也可跳过，稍后在设置中添加）；选择工作空间（智能体工作的文件夹）；可选配置 TinyFish（在 agent.tinyfish.ai/api-keys 获取密钥以进行网页搜索）。如果依赖变更后原生模块出错，可运行 npm run rebuild 重建 better-sqlite3。 构建安装包：输出到 dist/ 目录，产物名称不含版本号（例如 OpenPilot-arm64.dmg、OpenPilot-Setup.exe），版本号显示在设置→关于中。macOS 构建默认未签名（identity: null）。从 macOS 构建 Windows 版本需要 Wine（brew install --cask wine-stable），建议使用 CI 或 Windows 机器生成 Windows 产物。 用户数据（以 macOS 为例）：应用数据位于 ~/Library/Application Support/OpenPilot/（包含 onecode.sqlite、secrets.key、mcp.json）；技能/记忆位于 ~/.onecode/。
适用场景 在本地笔记本电脑上使用自带 API Key 的 AI 智能体处理真实项目文件夹；需要对项目文件进行读取、编辑和工具调用；希望在无供应商锁定的前提下灵活切换模型的用户；需要联网检索最新文档或版本信息时可选用 TinyFish 搜索。
限制与注意事项 TinyFish 为可选项；使用需自行申请 API Key。 macOS 构建默认未签名；从 macOS 构建 Windows 产物需要 Wine，建议使用 CI 或 Windows 机器。 使用 npm start 从源码运行时不支持自动更新；已安装的发布版可自动更新咨询。 自动更新使用 zip（macOS）和 NSIS（Windows）产物；Release 必须为已发布（非草稿）状态客户端才能看到；macOS 自动更新在配合 Apple 代码签名和公证时更可靠。 OpenPilot 默认发送匿名使用数据（应用打开、模型/功能使用、token 计数），不包含聊天、文件、路径或 API 密钥；可在 Getting Started 期间或设置→关于中关闭。 贡献指南：从 main 分支创建分支（git checkout -b feat/your-change），本地安装运行（npm install → npm start），保持改动聚焦、PR 小而易审，向 main 提交 Pull Request 并附简短说明；提交 bug 时附复现步骤；遵循 src/ 现有代码风格，避免无关文件的大规模重构；不要提交密钥、API Key 或本地用户数据。报告问题时提供操作系统和 OpenPilot 版本（设置→关于）、使用的是发布版还是 npm start、复现步骤及相关日志/截图。 维护者发布流程：更新 package.json 版本，提交并推送到 main，打标签并推送（git tag v1.0.4；git push origin v1.0.4），GitHub Actions 会构建 macOS + Windows 并发布产物，安装版用户会收到更新提示。本地发布需要具有 repo 权限的 GH_TOKEN。
许可与链接 MIT 许可（见 package.json）。Releases：https://github.com/ibmshaikh/OpenPilot/releases；Issues：https://github.com/ibmshaikh/OpenPilot/issues；TinyFish API Keys：https://agent.tinyfish.ai/api-keys；TinyFish 文档：https://docs.tinyfish.ai。
