Mini AI Pilot
🌟 简介
Mini AI Pilot 是一个轻量级的 VS Code AI 助手，帮你更高效地编写代码。它能够理解你的项目上下文，回答代码问题，自动执行任务，并与 Git 工作流程无缝集成。
📦 安装
方法一：从 VS Code 市场安装（推荐）
- 打开 VS Code
- 按
Ctrl+Shift+X 打开扩展面板
- 搜索 "Mini AI Pilot"
- 点击 安装
方法二：手动安装
- 下载最新版本
- 在 VS Code 中按
Ctrl+Shift+P
- 输入 "Extensions: Install from VSIX"
- 选择下载的文件
🚀 快速开始
1. 首次配置
安装后，插件会自动创建配置文件模板。你需要：
- 按
Ctrl+Shift+P，输入 "Mini AI Pilot: 打开设置"
- 在配置文件中添加你的 AI 模型 API 密钥
- 保存配置文件
2. 开始使用
- 在活动栏中点击 Mini AI Pilot 图标
- 开始与 AI 助手对话
- 享受智能的代码辅助体验！
✨ 功能介绍
💬 智能对话
- 代码解释：选中代码，问"这段代码是做什么的？"
- 代码生成：输入"帮我写一个函数来..."
- 问题解答：询问编程问题，获得详细解答
- 多模型支持：兼容 GPT、Claude、Gemini 等主流模型
🛠️ 文件操作
- 文件读取：
读取 package.json 文件
- 文件修改：
在 README.md 中添加安装说明
- 代码搜索替换：
把所有 console.log 替换为 logger.info
🖥️ 命令执行
- 项目构建：
运行 npm run build
- 测试运行：
执行 npm test
- 依赖管理：
安装 lodash 包
- Git 操作：
查看当前分支状态
🔄 Git 智能助手
- 自动生成提交信息：在 Git 面板点击 ✨ 按钮
- 代码变更分析：自动理解你修改了什么
- 分支管理：支持多分支并行开发
📝 任务管理
- 创建待办：
创建一个待办事项：完成单元测试
- 进度跟踪：AI 会帮你管理任务状态
🖼️ 图像理解
- 截图分析：上传截图，询问"这个界面有什么问题？"
- UI 设计建议：获得界面改进建议
💡 使用技巧
高效对话技巧
# 代码相关
"优化这个 React 组件的性能"
"重构这段代码，使其更易读"
"解释这个算法的时间复杂度"
# 项目相关
"我的项目结构合理吗？"
"帮我添加 TypeScript 配置"
"创建一个 ESLint 配置文件"
# Git 相关
"查看我刚才改了哪些文件"
"生成一个符合规范的提交信息"
"如何合并这两个分支？"
快捷操作
| 操作 |
方法 |
| 聚焦 AI 助手 |
Ctrl+Shift+P → "Focus Mini AI Pilot" |
| 生成提交信息 |
Git 面板中的 ✨ 按钮 |
| 打开设置 |
AI 界面中的设置按钮 |
工作流程建议
日常开发
开始编码 → 遇到问题 → 询问 AI → 获得解答 → 继续开发
代码审查
完成功能 → 询问 AI 检查 → 根据建议优化 → 提交代码
学习新技术
看到新概念 → 询问 AI 解释 → 获取示例代码 → 实践应用
⚙️ 配置说明
配置文件路径
- 默认目录：
~/.mini（Windows 示例：C:\\Users\\<用户名>\\.mini），首次安装后自动生成模板。
- 主要文件：
chat.json（对话模型）、commit.json（提交信息模型）、settings.json（工具与白名单）、worktree.json（CLI 启动模板）、mcp.json（MCP 开关）、MINI.md（全局系统指令）。
chat.json（聊天模型示例）
{
"endpoints": [
{
"baseUrl": "https://api.openai.com/v1",
"key": "你的OpenAI密钥",
"model": "gpt-4o-mini",
"alias": "OpenAI",
"think": false
},
{
"baseUrl": "https://generativelanguage.googleapis.com/v1beta/openai",
"key": "your-api-key",
"model": "gemini-flash-latest",
"alias": "Gemini Flash",
"price": 0,
"options": {
"extra_body": {
"google": {
"thinking_config": {
"thinking_budget": -1,
"include_thoughts": false
}
}
}
}
}
]
}
alias 可自定义显示名称；如需透传厂商参数，可使用 provider 与 options 字段。
commit.json（提交信息模型）
{
"model": {
"baseUrl": "https://api.openai.com/v1",
"key": "你的OpenAI密钥",
"model": "gpt-4o-mini"
}
}
settings.json（运行与安全）
{
"mcpServers": { "my-mcp": true },
"tools": { "execute_bash": true, "read_file": true, "write_file": true },
"commands": ["pnpm lint"],
"maxToolTokens": 65536,
"allowedCommands": ["ls", "cat", "git", "npm", "python"],
"worktrees": 2
}
maxToolTokens 控制工具输出的 token 上限。allowedCommands 为 Bash 工具白名单，需根据安全策略调整。worktrees 指定自动创建的工作区数量。
worktree.json（CLI 启动模板）
{
"commands": [
{ "base": "codex", "prompt": "codex --full-auto {prompt}", "resume": "codex --full-auto resume" }
]
}
{prompt} 会被当前对话的指令替换，resume 用于继续任务。
MINI.md（系统指令）
- 位于
~/.mini/MINI.md，可填写全局提示（代码风格、审查要求等），对所有会话生效。
支持的 AI 模型
- OpenAI: GPT-3.5, GPT-4, GPT-4o/4o-mini
- Claude: Claude-3-sonnet, Claude-3-opus
- Gemini: Gemini-pro, Gemini-flash-latest/vision
- 其他兼容 OpenAI API 协议的模型
🛡️ 安全性
- 命令白名单：只允许执行安全的系统命令
- Git 保护：禁止执行会修改仓库的 git 命令
- 文件保护：防止误删除重要文件（如 .git 目录）
- 超时控制：命令执行有 5 分钟超时限制
📋 常见问题
Q: 为什么 AI 不能执行某些命令？
A: 为了安全，只允许执行预定义的安全命令。完整的支持命令列表请查看配置文件。
Q: 如何添加自定义 AI 模型？
A: 在设置配置中添加新的模型配置，确保 API 兼容 OpenAI 格式。
Q: 对话历史会保存吗？
A: 是的，插件会自动保存对话历史，你可以随时继续之前的对话。
Q: 支持哪些编程语言？
A: 支持所有编程语言，AI 会根据文件扩展名自动识别语言类型。
