1. 项目定位与用途
CodePilot 是一个多模型 AI 代理桌面客户端，基于 Electron 和 Next.js 开发，提供跨平台（macOS、Windows、Linux）的统一 AI 聊天界面。其核心定位是连接各类 AI 提供商，扩展 AI 能力，并实现远程控制，使用户能够在一个应用中访问多种 AI 模型，并通过 MCP 和技能系统自定义工作流。主要用途包括日常对话、编码辅助、图像生成、任务自动化等，旨在成为用户的个性化 AI 助手。
项目档案应用项目
CodePilot 多模型 AI 代理桌面客户端：连接 17+ AI 提供商，支持 MCP 扩展与远程控制，下载安装即用
op7418/CodePilot：CodePilot 是一个基于 Electron 和 Next.js 的多模型 AI 代理桌面客户端，支持连接 17+ AI 提供商，提供统一聊本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
CodePilot 是一个基于 Electron 和 Next.js 的多模型 AI 代理桌面客户端，支持连接 17+ AI 提供商，提供统一聊天界面，并可通过 MCP 扩展和远程桥接实现个性化、可扩展的 AI 助手体验。
中文项目介绍
CodePilot 是一款多模型 AI 代理桌面客户端，旨在为用户提供统一的接口来访问多种 AI 服务。它支持连接 17+ AI 提供商，包括 Anthropic、OpenAI、Google、AWS Bedrock 以及国内模型如智谱 GLM、Kimi 等，并允许在对话中无缝切换模型而不丢失上下文。
项目解决了用户在多个 AI 平台间切换的繁琐、AI 能力受限（如无法操作本地文件或执行终端命令）以及无法远程控制桌面 AI 代理的问题。通过统一的聊天界面、扩展机制（MCP 服务器和技能系统）和跨平台桥接（Telegram、微信等），CodePilot 提供了个性化、可扩展的 AI 助手体验。
适用场景包括日常 AI 对话与编码辅助、跨平台统一访问多种 AI 模型、远程控制桌面 AI 代理 via 手机消息应用、AI 图像生成与批量处理、定时任务执行与通知，以及个性化 AI 助手配置与工作流学习。
技术层面，CodePilot 基于 Electron 和 Next.js 构建，采用双运行时架构（Native Runtime 和 SDK Runtime），支持会话级并发控制、任务调度器自动启动、桥接管理器统一管理，并通过数据库持久化会话和配置。它提供生成式 UI、助手工作区（持久记忆、persona）、媒体工作室等功能，支持 macOS、Windows 和 Linux 平台。
详细信息与使用说明
2. 解决的问题
CodePilot 解决了三个主要问题：一是用户需要在多个 AI 平台（如 Claude、ChatGPT、国内模型）间频繁切换，导致体验碎片化；二是 AI 能力受限，无法直接操作本地文件、执行终端命令或发送消息到外部平台；三是缺乏远程控制能力，无法通过手机等设备管理桌面 AI 代理。通过统一接口、MCP 扩展机制和远程桥接系统，CodePilot 提供了无缝、可扩展的 AI 交互体验。
3. 适用场景
CodePilot 适用于多种场景：日常 AI 对话与编码辅助，用户可与多种模型聊天并获得代码帮助；跨平台统一访问，无需切换应用即可使用不同 AI 提供商；远程控制，通过 Telegram、微信等消息平台从手机发送指令并接收响应；AI 图像生成，支持批量任务和画廊管理；定时任务执行，使用 cron 表达式或间隔调度自动化任务；个性化配置，通过助手工作区设置 persona、持久记忆和每日签到，让 AI 学习用户偏好。
4. 安装方式
安装 CodePilot 有两种方式：下载发行版：访问 GitHub Releases 页面，根据平台下载安装包（macOS 的 .dmg、Windows 的 .exe、Linux 的 AppImage/.deb/.rpm），然后运行安装程序。源码构建：确保已安装 Node.js 18+ 和 npm 9+，克隆仓库后执行 npm install 安装依赖，然后运行 npm run dev 启动浏览器模式（localhost:3000）或 npm run electron 启动 Electron 应用。开发模式下可使用 npm run electron:dev 同时启动 Next.js 和 Electron。
5. 使用方式
启动 CodePilot 后，首先在 Settings > Providers 中添加 AI 提供商的 API 密钥以配置服务。配置完成后即可开始对话。如需高级功能如文件编辑、终端命令或 git 操作，建议安装 Claude Code CLI（npm install -g @anthropic-ai/claude-code）。其他功能包括：使用 Assistant Workspace 创建 persona 文件和设置持久记忆；通过 Bridge 功能连接 Telegram、Feishu 等消息平台实现远程控制；在 Media Studio 中进行 AI 图像生成和批量处理；使用 Task Scheduler 设置定时任务。应用还支持会话倒回、分屏对话、token 使用跟踪等日常使用特性。
6. 实现特点
CodePilot 采用 Next.js API Routes 构建后端服务，运行时为 Node.js。核心架构包括双运行时设计：Native Runtime 直接控制应用，SDK Runtime 作为子进程运行，由 lib/runtime 和 lib/conversation-registry 管理。会话级并发控制通过数据库锁（acquireSessionLock）防止并行请求冲突。任务调度器在首次 API 调用时自动启动（ensureSchedulerRunning）。桥接系统通过 bridgeManager 统一管理，支持频道绑定和状态查询。数据流经过 API 路由、数据库操作、提供商解析和 MCP 服务加载。媒体文件上传至媒体库，消息中的 base64 数据在获取时被剥离。项目使用 npm workspaces 管理 monorepo，包含 apps 和 packages 目录。
思维导图
CodePilot
聊天系统
消息收发
会话管理
MCP集成
提供商管理
多提供商支持
模型切换
自定义端点
助手工作区
Persona文件
持久记忆
每日签到
生成式UI
交互式仪表板
实时渲染
远程桥接
消息平台
频道绑定
手机控制
MCP与技能
MCP服务器
技能市场
媒体工作室
AI图像生成
批量处理
任务调度
定时任务
通知机制
常见问题
CodePilot 支持哪些 AI 提供商？
CodePilot 支持 17+ AI 提供商，包括 Anthropic、OpenRouter、AWS Bedrock、Google Vertex AI、Zhipu GLM（国内/全球）、Kimi、Moonshot、MiniMax（国内/全球）、Volcengine Ark（Doubao）、Xiaomi MiMo、Aliyun Bailian（Qwen）、Ollama、LiteLLM，以及任何 Anthropic 兼容或 OpenAI 兼容的自定义端点。Google Gemini 还支持图像生成。
如何安装和启动 CodePilot？
安装方式有两种：下载发行版：从 GitHub Releases 页面获取对应平台的安装包（macOS .dmg、Windows .exe、Linux AppImage/.deb/.rpm）并运行安装。源码构建：需 Node.js 18+ 和 npm 9+，克隆仓库后执行 npm install，然后运行 npm run dev（浏览器模式）或 npm run electron（Electron 模式）。开发时可用 npm run electron:dev 同时启动前后端。
如何配置 AI 提供商并开始使用？
启动应用后，进入 Settings > Providers，添加所需 AI 提供商的 API 密钥即可配置。配置完成后即可在聊天界面开始对话。如需文件编辑、终端命令或 git 操作等高级功能，建议额外安装 Claude Code CLI（npm install -g @anthropic-ai/claude-code）。
CodePilot 有哪些扩展能力和远程控制功能？
扩展能力包括：集成 MCP 服务器（stdio/sse/http）并运行时监控；定义可重用技能或从 skills.sh 市场安装；使用生成式 UI 创建交互式仪表板；在媒体工作室中进行 AI 图像生成和批量处理；设置定时任务。远程控制通过 Bridge 系统实现，可连接 Telegram、Feishu、Discord、QQ、WeChat 等平台，从手机发送消息并在桌面接收响应。
CodePilot 的许可证和成本情况如何？
项目采用 BUSL-1.1 许可证（仓库中显示为 BSL-1.1），具体使用条款需参考 LICENSE 文件。应用本身开源免费，但所连接的 AI 提供商服务可能产生 API 调用费用，用户需自行承担。