codeboy
免费、持续进化、支持私有服务器的 AI 编程助手 - 用自然语言控制浏览器、管理容器、分析代码！
🎯 这个扩展能做什么？
跟 AI 说一句话，它就能自动调用 MCP 工具帮你：
- 🌐 打开网页看内容 - "请使用 Playwright MCP 打开 https://www.bing.com"
- 🔍 提取页面信息 - "告诉我这个页面的标题"
- 📦 管理 Docker 容器 - "查看所有运行中的容器"
- 🐍 Python 代码分析 - "重构这段代码"
- ✨ 更多 MCP 工具 - 安装任何 MCP 扩展，AI 自动识别并使用
不需要写代码，不需要手动选择工具，说人话 AI 自动做！
🚀 快速开始
前置要求
1. 启动 vLLM 服务
python3 -m vllm.entrypoints.openai.api_server \
--model Qwen/Qwen2.5-3B-Instruct-AWQ \
--host 0.0.0.0 --port 8003 \
--dtype float16 --quantization awq \
--kv-cache-dtype fp8 \
--max-model-len 32768 \
--max-num-seqs 32 \
--gpu-memory-utilization 0.90 \
--enable-auto-tool-choice \
--tool-call-parser hermes
关键参数说明：
--enable-auto-tool-choice - 启用自动工具选择--tool-call-parser hermes - 使用 Hermes 格式解析工具调用
2. 安装 MCP 工具扩展
在 VS Code 扩展市场搜索并安装：
- Playwright MCP - 浏览器自动化
- Docker MCP - 容器管理
- Pylance MCP - Python 工具
- 或其他任何 MCP 扩展
1️⃣ 打开助手
安装完扩展后，有两种方式打开：
方法一：点击左侧边栏的扩展图标 🤖
方法二：按快捷键
- Windows/Linux:
Ctrl + Shift + P
- Mac:
Cmd + Shift + P
- 输入 "codeboy"，选择 "Open Chat"
2️⃣ 开始对话
在输入框输入你的需求，按回车发送。
AI 会自动：
- 🤔 分析你的需求
- 🔍 查找合适的 MCP 工具
- 🔧 自动调用工具执行任务
- ✅ 返回结果并继续对话
💬 怎么跟它说话？
🌟 新手推荐（简单任务）
这些任务成功率最高：
打开 example.com 看看有什么
访问 baidu.com 告诉我首页内容
打开豆瓣首页，看看有哪些推荐
这个页面的标题是什么
🔥 进阶尝试（复杂任务）
这些可能需要更好的后端配置：
搜索 Python 教程，告诉我前 5 个结果
在某网站填写表单
提示：复杂任务的成功率取决于后端服务的配置。建议先从简单任务开始！
🎛️ 界面说明
打开聊天窗口后，你会看到：
┌─────────────────────────────────────┐
│ [🧠 codeboy ▼] ⚙️ ↩️ ↪️ 🗑️ 🔄 │ ← 顶部工具栏
├─────────────────────────────────────┤
│ │
│ 💬 聊天历史显示在这里 │ ← 对话区域
│ │
├─────────────────────────────────────┤
│ 输入你的问题... [发送] │ ← 输入框
└─────────────────────────────────────┘
按钮功能：
- 🔧 MCP 工具 - 查看和使用已安装的 MCP 工具
- ⚙️ 设置 - 配置服务器地址（一般不用改）
- ↩️ 撤销 - 删除上一条对话
- ↪️ 重做 - 恢复刚删除的对话
- 🗑️ 清空 - 清除所有历史记录
- 🔄 重载 - 重启扩展
👀 执行过程
当你发送问题后，AI 会一步步告诉你它在做什么：
你：打开 example.com 看看有什么
AI：好的，正在处理...
→ 正在打开 example.com...
→ 正在读取页面内容...
→ 正在分析页面信息...
✓ 完成！
这是一个示例网站，页面标题是 "Example Domain"。
页面内容很简单，主要用于演示和测试。
🔧 使用 MCP 工具
什么是 MCP 工具？
MCP (Model Context Protocol) 工具是扩展功能的插件，可以让 AI 助手执行更多任务，比如：
- 🌐 浏览器自动化（Playwright MCP）
- 🐳 容器管理（Docker MCP）
- 📁 文件系统操作
- 🔍 搜索和数据提取
如何使用？
- 安装 MCP 工具扩展 - 在 VS Code 扩展市场搜索并安装 MCP 工具（如 Playwright MCP）
- 点击 🔧 按钮 - 点击工具栏的 🔧 MCP 工具 按钮
- 选择工具 - 在弹出的快速选择面板中搜索并选择工具（类似 Ctrl+Shift+P）
- 输入参数 - 根据提示输入 JSON 格式的参数
- 查看结果 - 工具执行完成后，可以在新文档查看或复制结果
示例：使用 Playwright MCP
- 点击 🔧 按钮
- 在快速选择面板输入 "browser_navigate" 搜索
- 选择
mcp_microsoft_pla_browser_navigate
- 输入参数：
{"url": "https://www.baidu.com"}
- 查看结果：页面导航成功，显示页面信息
⚙️ 需要改设置吗？
一般情况下不需要！ 默认配置就能用。
如果你需要连接自己的服务器：
- 点击右上角 ⚙️ 设置
- 看到两个选项：
- API Endpoint - 服务器地址（默认：
http://127.0.0.1:8004）
- Model - AI 模型名称（默认：
qwen2.5-3b-instruct-awq）
- 修改后点 Save Settings 保存
💡 使用技巧
✅ 适合做的事
- ✓ 打开网页查看内容
- ✓ 提取页面标题、文字
- ✓ 简单的 2 步操作（打开 → 查看）
⚠️ 可能不太行的
- ✗ 复杂的多步骤搜索
- ✗ 需要登录的网站操作
- ✗ 表单的精确填写（还在完善）
为什么？ AI 的能力取决于后端配置。默认配置适合简单任务，复杂任务需要更强大的 AI 模型。
�� 遇到问题？
问题 1：点了图标没反应
可能原因：后端服务没启动
解决办法：联系管理员或查看是否有提供的服务地址
问题 2：AI 回答乱七八糟
可能原因：任务太复杂了
解决办法：
- 把任务拆简单点，一步步来
- 用更明确的指令，比如 "打开某网站并告诉我标题"
问题 3：一直显示"正在思考"
可能原因：网络问题或服务器忙
解决办法：
- 等一会儿再试
- 点击右上角 🔄 重载扩展
- 检查网络连接
问题 4：想看详细错误信息
按 F12 打开开发者工具，查看 Console 标签的错误信息。
📝 示例对话
示例 1：查看网页
你：打开 example.com 看看
AI：✓ 这是一个示例网站，页面标题是 "Example Domain"
示例 2：提取信息
你：访问 baidu.com 告诉我能看到什么
AI：✓ 这是百度首页，可以看到搜索框和一些热门新闻链接
示例 3：多步任务
你：打开豆瓣读书，看看首页推荐了哪些书
AI：正在打开豆瓣读书...
✓ 找到了 5 本推荐的书：[书名列表]
🎯 开始使用吧！
第一次用？ 建议试试这个简单的指令：
打开 example.com 告诉我页面标题
成功后，你就知道怎么用了！然后可以试试更多有趣的任务 🚀
有疑问？ 在扩展页面提交 Issue 或联系开发者！
