Muicc AI Assistant
🤖 AI 驱动的智能编程助手，提供代码审查、智能补全、Bug 修复等功能，支持自然语言对话交互
✨ 特性
🎯 核心功能
- 🔍 智能代码审查 - 自动检测代码质量问题、潜在 Bug 和性能瓶颈
- 📖 AI 代码解释 - 用简体中文清晰解释复杂代码逻辑
- 🐛 Bug 自动修复 - 智能定位错误并提供修复方案
- ✨ 代码生成 - 根据需求自动生成高质量代码
- 💬 智能注释 - 为代码添加规范的中文文档注释
💬 AI 对话界面
- 自然语言交互 - 像与真人程序员对话一样交流
- 上下文感知 - 自动理解当前代码环境和选中内容
- 流式输出 - 实时显示 AI 思考过程，无需等待
- Markdown 渲染 - 完美支持代码高亮、表格、列表等格式
🛠️ 开发体验
- 右键菜单集成 - 选中代码即可快速调用 AI 功能
- 命令面板支持 - 通过
Ctrl+Shift+P 快速访问所有功能
- OpenAI 兼容 API - 支持所有符合 OpenAI 格式的 API 提供商
- 多语言支持 - TypeScript、JavaScript、Python、Java、C++、Go、Rust 等
📸 功能演示
AI 聊天界面
侧边栏聊天窗口，支持 Markdown 渲染和流式输出
代码审查
智能分析代码质量，提供详细的改进建议
Bug 修复
自动检测并修复代码中的错误
代码生成
根据自然语言描述生成完整代码
Markdown 渲染效果
完美支持表格、列表、代码块等 Markdown 格式
📦 安装
方法1：从市场安装（推荐）
- 打开 VSCode
- 按
Ctrl+Shift+X 打开扩展面板
- 搜索 "Muicc AI Assistant"
- 点击安装
方法2：手动安装
# 下载 .vsix 文件后
code --install-extension muicc-ai-assistant-1.0.0.vsix
⚙️ 配置
基本配置
在 VSCode 设置中（Ctrl+,）添加以下配置：
{
"muicc.apiKey": "your-api-key-here",
"muicc.apiUrl": "https://api.openai.com/v1",
"muicc.model": "gpt-4",
"muicc.maxTokens": 2000
}
支持的 AI 提供商
本插件支持所有 OpenAI API 兼容的服务商，包括：
| 提供商 |
API URL |
推荐模型 |
说明 |
| OpenAI |
https://api.openai.com/v1 |
gpt-4, gpt-3.5-turbo |
官方服务，最稳定 |
| Azure OpenAI |
https://your-resource.openai.azure.com/openai/deployments/your-deployment |
gpt-4, gpt-35-turbo |
企业级部署 |
| DeepSeek |
https://api.deepseek.com/v1 |
deepseek-chat |
国产大模型，性价比高 |
| 智谱 GLM |
https://open.bigmodel.cn/api/paas/v4 |
glm-4, glm-3-turbo |
清华智谱出品 |
| Moonshot |
https://api.moonshot.cn/v1 |
moonshot-v1 |
月之暗面出品 |
| 阿里云百炼 |
https://dashscope.aliyuncs.com/compatible-mode/v1 |
qwen-plus, qwen-turbo |
阿里通义千问 |
| 其他兼容服务 |
任意 OpenAI 格式 API |
- |
只要接口兼容即可使用 |
💡 提示：只要 API 端点支持 OpenAI 的 /chat/completions 接口格式，都可以使用本插件。国内很多厂商都提供兼容接口，无需翻墙即可使用。
高级配置
{
// 启用 AI 代码补全（可能与 Copilot 冲突）
"muicc.enableCompletion": true,
// 指定启用补全的语言
"muicc.completionLanguages": ["python", "go", "rust"],
// 最大响应 token 数
"muicc.maxTokens": 2000
}
获取 API Key
OpenAI（官方）
- 访问 platform.openai.com
- 注册账号并登录
- 进入 API Keys 页面
- 创建新的 API Key
- 复制并保存到安全位置
配置示例：
{
"muicc.apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
"muicc.apiUrl": "https://api.openai.com/v1",
"muicc.model": "gpt-4"
}
DeepSeek（推荐国内用户）
- 访问 platform.deepseek.com
- 注册并实名认证
- 在控制台创建 API Key
- 充值获得额度（新用户有免费额度）
配置示例：
{
"muicc.apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
"muicc.apiUrl": "https://api.deepseek.com/v1",
"muicc.model": "deepseek-chat"
}
智谱 GLM
- 访问 open.bigmodel.cn
- 注册并实名认证
- 创建 API Key
- 领取免费额度
配置示例：
{
"muicc.apiKey": "xxxxxxxxxxxxxxxxxxxxxxxx",
"muicc.apiUrl": "https://open.bigmodel.cn/api/paas/v4",
"muicc.model": "glm-4"
}
Moonshot（月之暗面）
- 访问 platform.moonshot.cn
- 注册并获取 API Key
- 新用户有免费试用额度
配置示例：
{
"muicc.apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
"muicc.apiUrl": "https://api.moonshot.cn/v1",
"muicc.model": "moonshot-v1-8k"
}
阿里云百炼（通义千问）
- 访问 dashscope.console.aliyun.com
- 使用阿里云账号登录
- 创建 API Key
- 开通 DashScope 服务
配置示例：
{
"muicc.apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
"muicc.apiUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"muicc.model": "qwen-plus"
}
Azure OpenAI（企业用户）
- 在 Azure Portal 创建资源
- 部署模型（如 gpt-4, gpt-35-turbo）
- 获取 Endpoint 和 API Key
- 注意：Azure 的 URL 格式特殊
配置示例：
{
"muicc.apiKey": "xxxxxxxxxxxxxxxxxxxxxxxx",
"muicc.apiUrl": "https://your-resource.openai.azure.com/openai/deployments/your-deployment",
"muicc.model": "gpt-4"
}
⚠️ 重要提示：
- 请妥善保管 API Key，不要提交到代码仓库
- 建议使用环境变量或密钥管理器存储
- 定期检查用量，避免超额消费
- 国内用户推荐使用 DeepSeek、智谱 GLM 等国产服务，无需翻墙且性价比高
🚀 使用指南
方法1：侧边栏聊天
- 点击活动栏的 Muicc 图标（紫色 M 字母）
- 在聊天窗口输入问题或需求
- 等待 AI 回复（支持流式输出）
示例对话：
用户: 帮我解释一下这段代码的作用
AI: [分析代码并给出详细解释]
用户: 如何优化这个函数的性能？
AI: [提供优化建议和示例代码]
方法2：右键菜单
- 在编辑器中选中代码或右键点击
- 选择 "Muicc AI Assistant" 子菜单
- 选择具体功能：
- 🔍 Review Code - 代码审查
- 📖 Explain Code - 解释代码
- 🐛 Fix Bugs - 修复 Bug
- ✨ Generate Code - 生成代码
- 💬 Generate Comments - 生成注释
方法3：命令面板
- 按
Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (Mac)
- 输入 "Muicc:"
- 选择相应命令
快捷操作
- 清空聊天:
Ctrl+L (Windows/Linux) 或 Cmd+L (Mac)
- 停止生成: 点击状态栏的 ⏹ 停止按钮
- 发送消息: 在输入框按
Enter
❓ 常见问题
Q1: 如何获取 API Key？
A: 本插件支持所有 OpenAI API 兼容的服务商，推荐使用：
国内用户（无需翻墙）：
国际用户：
详细配置方法请查看上方的"获取 API Key"章节。
Q2: 支持哪些编程语言？
A: 理论上支持所有主流编程语言，包括但不限于：
- 前端: TypeScript, JavaScript, HTML, CSS
- 后端: Python, Java, C#, Go, Rust, Ruby, PHP
- 系统: C, C++
- 数据: SQL, R, Julia
- 其他: Swift, Kotlin, Dart 等
AI 会根据文件扩展名和语法自动识别语言。
Q3: 会上传我的代码吗？数据安全吗？
A:
- ✅ 仅在主动触发时发送: 只有当你点击"审查代码"、"解释代码"等功能时，相关代码片段才会被发送到配置的 AI API
- ✅ 可控制范围: 你可以选择只发送选中的代码，而非整个文件
- ✅ 使用你自己的 API Key: 数据直接发送到你的 AI 提供商，不经过第三方服务器
- ⚠️ 注意: 避免发送敏感信息（密码、密钥、个人隐私数据）
建议在处理敏感项目时使用本地部署的 AI 模型。
Q4: 与其他 AI 插件（如 GitHub Copilot）冲突吗？
A:
- 聊天功能: 不会冲突，可以同时使用
- 代码补全: 可能冲突。如果同时启用多个 AI 补全插件，建议：
- 在设置中禁用
muicc.enableCompletion
- 或在
muicc.completionLanguages 中指定特定语言
推荐组合：
- Muicc AI Assistant（聊天 + 代码审查）+ GitHub Copilot（代码补全）
Q5: AI 生成的代码可以直接使用吗？
A:
- ✅ 可以作为参考: AI 生成的代码通常质量较高，但需要人工审查
- ⚠️ 必须测试: 运行前务必进行充分测试
- ⚠️ 注意边界情况: AI 可能未考虑所有边缘情况
- ✅ 学习价值: 即使不完全可用，也能提供很好的思路
最佳实践：
- 理解 AI 生成的代码逻辑
- 根据项目规范调整
- 编写单元测试验证
- 进行代码审查
Q6: 为什么有时候 AI 响应很慢？
A: 可能的原因：
- 网络延迟: 检查网络连接是否稳定
- API 限流: 免费账户可能有速率限制
- 请求过长: 减少发送的代码量或简化问题
- 模型负载: 高峰期响应可能变慢
优化建议：
- 使用更快的模型（如 gpt-3.5-turbo）
- 精简发送的代码上下文
- 明确具体的问题描述
Q7: 如何反馈问题或建议？
A:
- 🐛 报告 Bug: GitHub Issues
- 💡 功能建议: 同样在 GitHub Issues 中提出
- 📧 邮件联系: （如果有）
- ⭐ 点赞支持: 在市场给个好评吧！
Q8: 插件是免费的吗？
A:
- ✅ 插件本身免费: MIT 开源许可证
- ⚠️ AI API 费用: 使用 OpenAI、Claude 等服务需要付费
- 💰 成本控制: 你可以设置
maxTokens 限制每次消耗的 token 数
省钱技巧：
- 使用 gpt-3.5-turbo 代替 gpt-4（便宜 10-20 倍）
- 精简发送的代码上下文
- 合并相关问题，减少请求次数
🤝 贡献
欢迎提交 Issue 和 Pull Request！
开发环境搭建
# 克隆仓库
git clone https://github.com/muicc/muiccAssistant.git
cd muiccAssistant
# 安装依赖
npm install
# 编译
npm run compile
# 打包
npx vsce package
# 在 VSCode 中调试
# 按 F5 启动调试模式
贡献流程
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature)
- 提交更改 (
git commit -m 'Add some AmazingFeature')
- 推送到分支 (
git push origin feature/AmazingFeature)
- 开启 Pull Request
代码规范
- 使用 TypeScript 编写代码
- 遵循 ESLint 规则
- 添加必要的注释
- 保持代码简洁清晰
📝 更新日志
v1.0.0 (2026-06-09)
✨ 新增功能
- AI 驱动的聊天界面，支持自然语言对话
- 智能代码审查，检测质量问题和潜在 Bug
- AI 代码解释，用简体中文清晰说明代码逻辑
- Bug 自动修复，提供修复方案和示例代码
- 代码生成功能，根据需求自动生成代码
- 智能注释生成，添加规范的中文文档注释
- Markdown 渲染支持，完美显示代码块、表格、列表
- 右键菜单集成，快速访问常用功能
- 可配置的 AI 模型，支持多种提供商
🐛 问题修复
- 优化列表项间距，提升阅读体验
- 实现表格解析，支持 Markdown 表格渲染
- 修复侧边栏图标显示问题
- 优化会话状态管理，防止输入框卡死
🎨 界面优化
- 紫色主题设计，符合品牌调性
- 状态栏动态显示，实时反馈生成状态
- 卡片式消息布局，清晰的视觉层次
- 流式输出动画，提升交互体验
📄 许可证
MIT License - 详见 LICENSE 文件
🙏 致谢
感谢以下开源项目和工具：
感谢所有贡献者和用户的支持！❤️
Made with ❤️ by Muicc Team
