FreeAgent - 智能代码助手：Google Gemini AI 驱动的 VS Code 扩展

FreeAgent 是一款基于 Google Gemini AI 的 VS Code 扩展，为开发者提供智能的代码辅助功能。通过自然语言交互，FreeAgent 能够帮助开发者更好地理解、改进和维护他们的代码。

安装指南

您可以从 VS Code Marketplace 安装 FreeAgent：

• 扩展页面
• 发布者页面

主要功能

代码分析

• 解释代码：获取选中代码的详细解释
• 重构代码：获得代码改进建议
• 总结代码：获取代码功能的高级概述
• 查找错误：识别潜在的问题和错误
• 文档化代码：为您的代码生成文档
• 性能分析：获取代码性能和优化机会的见解

智能聊天界面

• 支持上下文感知的交互式聊天
• 能够理解您的工作空间的代码对话
• 支持多种 Gemini 模型
• 实时代码建议和解释
• 语法高亮的代码块
• 聊天历史管理

系统要求

• Visual Studio Code 版本 1.80.0 或更高
• Google Gemini API 密钥（从 Google AI Studio 获取）

设置步骤

1. 从 VS Code Marketplace 安装扩展
2. 设置您的 Gemini API 密钥：
   • 打开命令面板（Cmd/Ctrl Shift P）
   • 输入 "FreeAgent: Set API Key"
   • 提示时输入您的 API 密钥

使用方法

1. 在编辑器中选择代码
2. 右键点击并选择 FreeAgent 命令：
   • "FreeAgent > 解释代码"
   • "FreeAgent > 重构代码"
   • "FreeAgent > 总结代码"
   • "FreeAgent > 查找错误"
   • "FreeAgent > 文档化代码"
   • "FreeAgent > 分析性能"

或者，使用命令面板（Cmd/Ctrl Shift P）并输入 "FreeAgent:" 查看所有可用命令。

聊天界面功能

• 模型选择：在不同的 Gemini 模型之间选择
• 清除聊天：随时重置您的对话
• 代码上下文：自动包含相关文件和行信息
• 错误处理：对 API 问题或速率限制提供清晰反馈
• Markdown 支持：包括代码块的富文本格式
• Git 集成：在聊天中显示您的 Git 用户名

扩展设置

此扩展提供了以下设置：

• freeagent.apiKey：您的 Gemini API 密钥
• freeagent.model：使用的 Gemini 模型（默认：'gemini-1.5-pro'）
• freeagent.apiBaseUrl：API 基本 URL（默认：'https://generativelanguage.googleapis.com/v1beta'）
• freeagent.enableDebugLogs：启用调试日志以便于故障排除（默认：false）

启用调试日志

要启用调试日志以便于故障排除：

1. 打开 VS Code 设置（Cmd/Ctrl ,）
2. 搜索 "FreeAgent"
3. 勾选 "启用调试日志" 选项
   • 或者在 settings.json 中添加 "freeagent.enableDebugLogs": true
4. 打开输出面板（查看 > 输出）
5. 从下拉菜单中选择 "FreeAgent"

调试日志将显示：

• 服务初始化详情
• 配置加载
• API 请求和响应
• 聊天消息处理
• 错误详情和堆栈跟踪

这在以下情况下非常有用：

• 排查 API 问题
• 调试模型响应
• 了解聊天上下文流
• 调查性能问题

错误消息

常见错误消息及其解决方法：

• API 密钥错误：检查设置中的 API 密钥
• 网络错误：检查您的网络连接
• 速率限制：稍等片刻后重试
• 模型错误：尝试不同的模型
• 配额错误：检查您的 API 使用限制

架构

有关扩展架构的详细技术信息，请参阅 ARCHITECTURE.md。

贡献

1. 克隆仓库
2. 创建您的功能分支（git checkout -b feature/amazing-feature）
3. 提交您的更改（git commit -m 'feat: add amazing feature'）
4. 推送至分支（git push origin feature/amazing-feature）
5. 开启拉取请求

许可证

本项目在 MIT 许可证下发布 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• Google Gemini AI 提供了基础 AI 能力
• VS Code 扩展 API 支持丰富的集成
• 所有为改进此扩展做出贡献的贡献者