Flexpilot AI - 您的开源 AI 助手

“开源、原生，是 VS Code 的真正 GitHub Copilot 替代方案”

[!WARNING]
Flexpilot VS Code 扩展 已不再积极维护。我们仍会尝试解决任何问题或合并请求，但不会再添加新功能。

我们已创建 Flexpilot IDE 作为其继任者——它是 VS Code 的一个分支，预装了 Flexpilot 扩展，并配备了多文件编辑、在线 Web IDE 等强大新功能。

🚀 点击 这里 即可立即在线体验。

📥 点击 这里 下载最新版本的 Flexpilot Desktop IDE，以获得最佳体验。

Flexpilot 是您通往真正灵活的 AI 驱动开发的大门。与其他 AI 助手不同，Flexpilot 让 您 掌控一切，允许您直接在 VS Code 中使用自己偏好的 AI 提供商和模型。原生集成、无与伦比的灵活性以及开源自由——尽在一整套强大的工具中。

🚀 开始使用

1. 从 VS Code Marketplace 安装 Flexpilot，并在安装完成后重启 VS Code。
2. 按照官方文档中的说明配置您首选的语言模型提供商：点击此处。
3. 开始使用 AI 驱动的代码补全、聊天等功能进行编码吧！

✨ 为什么选择 Flexpilot？

• 🎯 100% 原生 VS Code 体验 —— 没有笨重的 WebView，只有纯粹的编码乐趣
• 🔑 您的密钥，您的控制 —— 使用您自己的 API 密钥连接顶级 AI 提供商
• 🎨 极致灵活性 —— 可针对不同任务混合搭配不同的 AI 模型
• 🌟 开源自由 —— 完全透明、可定制且由社区驱动
• 💎 兼容 GitHub Copilot —— 无缝利用您现有的技能

🛠️ 超级增强功能

🤖 代码补全

借助 AI 驱动的自动补全，您可以轻松编写代码，它会根据项目上下文提供有针对性的建议和自然语言指导。

💬 面板聊天

在您的 VSCode 工作区中直接体验 上下文感知的交互式 AI 对话。Flexpilot 的面板聊天让您专注于解决问题，而无需离开代码库。

✍️ 内联聊天

通过 内联聊天 进行重构、调试或快速获得清晰思路。无论您需要错误处理建议还是代码解释，Flexpilot 的内联聊天功能都允许您直接在编辑器中做出更改。

⚡ 快速聊天

使用 快速聊天 保持专注——只需一个快捷键即可获得 AI 助手的即时回复。无需再中断工作流程去寻找答案，只需指尖轻点即可获得快速解决方案。

🎯 智能变量

通过 智能变量 实现更精准的 AI 交互。Flexpilot 会引用您的代码和编辑器数据中的元素，从而为您提供更加贴合需求的帮助。

🎙️ 语音聊天

有问题？直接问吧！语音聊天 允许您直接与 AI 助手对话，并实时获取代码建议，让您在编码时解放双手。

📄 动态聊天标题

通过 动态聊天标题 保持 AI 辅助对话的清晰性。Flexpilot 会自动为每次聊天生成简洁、相关的标题，方便您随时回顾之前的对话。

💻 提交信息

简化您的工作流程，使用 AI 生成的提交信息 和 PR 描述。Flexpilot 会根据上下文生成详细且贴切的提交信息，使您的代码贡献更加清晰明了。

📊 Token 使用情况洞察

借助 Token 使用情况洞察 获得透明度。您可以实时跟踪所有 AI 交互中的 Token 消耗情况，帮助您更有效地管理使用量和成本。

🎯 支持的 AI 提供商

• Anthropic
• OpenAI
• Azure OpenAI
• Groq
• Google Gemini
• Mistral AI
• Ollama
• Anyscale
• KoboldCpp
• text-gen-webui
• FastChat
• LocalAI
• llama-cpp-python
• TensorRT-LLM
• vLLM
• 还有更多！

🗺️ 路线图

• ✨ 多文件聊天编辑 —— 无缝管理跨多个文件的 AI 辅助更改。
• 🧑‍💻 @Workspace Agent —— 为整个项目工作区提供上下文相关的 AI 支持。
• 🔌 扩展的 Copilot 扩展 —— 集成并利用 GitHub Copilot 扩展。
• 还有更多！

🤝 开源社区

Flexpilot 在 GNU GPLv3 许可证下自豪地开源。我们坚信：

• 🌟 社区优先开发
• 🛠️ 透明架构
• 🤝 协作创新
• 🚀 持续改进

🤝 如何贡献

我们非常欢迎各种形式的贡献，无论是：

• 🐛 错误报告
• ✨ 功能请求
• 📝 文档编写
• 💻 代码贡献

请查看我们的 贡献指南，开始参与吧！

📜 许可证

Flexpilot 根据 GNU GPLv3 许可证 开源。

🌟 在 GitHub 上为我们点赞！

如果您喜欢 Flexpilot，请到 这里 给我们点个赞吧！每颗星都是对我们继续改进 Flexpilot 的巨大鼓励。

由开发者为开发者用心打造 ❤️
© 2024 Flexpilot AI Inc.

Flexpilot AI 快速上手指南

⚠️ 重要提示：Flexpilot VS Code 扩展插件目前已停止主动维护（不再新增功能），官方推荐使用其继任者 Flexpilot IDE（基于 VS Code 定制的独立桌面版，预装插件并支持多文件编辑等高级功能）。

• 🌐 在线体验：点击此处立即试用
• 💻 下载桌面版：获取最新 Flexpilot Desktop IDE

若您仍希望使用旧的 VS Code 扩展版本，请参考以下指南。

1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows, macOS, 或 Linux。
• 核心软件：已安装 Visual Studio Code (建议最新版本)。
• AI 服务凭证：由于 Flexpilot 允许用户自带密钥（Bring Your Own Key），您需要提前准备好至少一个支持的 AI 提供商 API Key（如 OpenAI, Anthropic, Azure OpenAI, Groq, Google Gemini, Ollama 等）。
  • 注：国内开发者若使用海外模型，请确保网络环境通畅；或使用本地部署模型（如 Ollama）以避免网络限制。

2. 安装步骤

方法一：通过 VS Code 市场安装（推荐）

1. 打开 VS Code。
2. 点击左侧活动栏的 扩展 (Extensions) 图标（或按 Ctrl+Shift+X / Cmd+Shift+X）。
3. 在搜索框中输入 Flexpilot。
4. 找到 Flexpilot AI (发布者：flexpilot)，点击 安装 (Install)。
5. 安装完成后，重启 VS Code 以激活插件。

方法二：离线安装（适用于网络受限环境）

1. 访问 VS Code Marketplace 下载 .vsix 安装包。
2. 在 VS Code 中，点击扩展面板右上角的 ... 菜单，选择 从 VSIX 安装 (Install from VSIX...)。
3. 选择下载好的文件进行安装并重启。

3. 基本使用

安装重启后，请按以下步骤配置并开始使用：

第一步：配置 AI 模型提供商

Flexpilot 不会内置默认密钥，您需要手动配置以连接您喜欢的 AI 服务。

1. 打开 VS Code 设置 (Ctrl+, / Cmd+,)。
2. 搜索 Flexpilot 相关配置项，或按照官方配置文档指引。
3. 在设置中填入您的 API Key 和选择的 Model Provider（例如 openai, anthropic, ollama 等）。
   • 示例配置逻辑（具体字段请以设置界面为准）：

     {
       "flexpilot.apiKey": "YOUR_API_KEY_HERE",
       "flexpilot.provider": "openai", 
       "flexpilot.model": "gpt-4o"
     }
     

第二步：体验核心功能

配置完成后，您可以通过以下方式立即使用 AI 辅助编程：

• 代码自动补全 (Code Completions)

  • 直接在编辑器中编写代码，Flexpilot 会根据上下文提供灰色的行内建议。
  • 按 Tab 键接受建议，按 Esc 键拒绝。

• 侧边栏对话 (Panel Chat)

  • 点击左侧活动栏的 Flexpilot 图标打开聊天面板。
  • 输入自然语言问题（如：“解释当前文件的功能”或“如何优化这段代码”），AI 将结合项目上下文回答。

• 行内对话 (Inline Chat)

  • 选中一段代码，按下快捷键（通常为 Ctrl+I 或 Cmd+I，具体可在快捷键设置中查看）。
  • 直接输入指令（如：“添加错误处理”或“重构为异步函数”），AI 将直接在编辑器中修改代码。

• 快速问答 (Quick Chat)

  • 使用全局快捷键唤起浮窗，快速获取无需上下文的简短答案，不中断编码流。

• 语音交互 (Voice Chat)

  • 点击聊天面板中的麦克风图标，直接通过语音向 AI 提问或下达指令。

第三步：查看用量与提交信息

• Token 统计：在聊天面板底部可实时查看当前的 Token 消耗情况，便于管理成本。
• 智能提交：在源代码管理 (Source Control) 面板中，Flexpilot 可自动生成详细的 Commit Message 和 PR 描述。

---

Flexpilot 基于 GNU GPLv3 协议开源，致力于为用户提供透明、可控的 AI 编程体验。