免费获取学习方案
ARTICLE DETAIL

资讯详情

深耕编程基础知识与建站技术分享的一线实战洞察。

3步把wigolo接入VS Code、Windsurf、Zed:逐代理配置详解与实用技巧

3步把wigolo接入VS Code、Windsurf、Zed:逐代理配置详解与实用技巧 3步把wigolo接入VS Code、Windsurf、Zed逐代理配置详解与实用技巧【免费下载链接】wigoloThe go-to web for your AI coding agent — local-first search, fetch, crawl research over MCP. No API keys, no cloud, $0/query. Public beta.项目地址: https://gitcode.com/GitHub_Trending/wi/wigolowigolo是一款本地优先的 AI 编程代理网络工具通过 MCP 协议为 AI 编程助手提供搜索、抓取、爬取和深度研究能力——无需 API Key、不依赖云端、每次查询零成本。本教程带你用一条命令把它接入 VS Code Copilot、Windsurf 和 Zed并详解每个代理的配置位置与实用技巧。为什么要给编程代理接上 wigolo主流编辑器里的 AI 助手自带 WebSearch / WebFetch但普遍存在三个痛点要配 Key内置搜索往往绑定云厂商 API按次计费高频查文档、看 Issue 时成本叠加明显结果质量不稳定无重排、无缓存同一问题反复查、反复慢。wigolo 的解法是「本地优先 持久缓存 ML 重排」所有组件浏览器引擎、嵌入模型、重排模型都跑在你机器上搜索命中本地缓存时秒回且免费结果自带evidence_score等可解释评分字段代理拿到的证据更可靠。它原生支持 10 个代理的自动接线处理逻辑集中在 src/cli/agents/registry.ts每个代理一个独立 handler互不干扰。快速开始一条命令接入三个代理先安装 wigolonpm、brew、Docker 或 sh 脚本均可见 docs/installation.md然后在终端执行wigolo init --agentsvscode,windsurf,zed这条命令做了三件事检测三个代理是否安装自动写入各自的 MCP 配置把 wigolo 的使用说明工具表 调用规则注入每个代理的指令文件下载并验证浏览器引擎与本地模型打印逐组件报告。不想等下载可以加--no-warmup组件会在首次使用时懒加载。完整参数说明见 docs/cli.md。逐代理配置详解下面逐一说明每个代理「写了什么、写在哪、为什么这么写」。VS Code (Copilot)全局 mcp.json 项目级指令MCP 配置VS Code 从用户级配置目录读取全局 MCP 服务器而不是~/.vscode/mcp.json写错位置的话扩展面板 MCP Servers 里永远看不到 wigolo。wigolo 按平台自动解析正确路径见 src/cli/agents/vscode.ts平台mcp.json 位置macOS~/Library/Application Support/Code/User/mcp.jsonWindows%APPDATA%/Code/User/mcp.jsonLinux~/.config/Code/User/mcp.json自动兼容 Flatpak/Snap写入后在扩展面板 MCP Servers中即可看到 wigolo无需额外操作。指令文件注入到当前项目的.github/copilot-instructions.md内容为 copilot-instructions.md.block——一张「任务 → 工具 → 关键参数」速查表强制 Copilot 优先走 wigolo 而非内置搜索。Windsurfmcp_config.json 全局规则Windsurf 的配置集中在~/.codeium/windsurf/目录src/cli/agents/windsurf.tsmcp_config.json在mcpServers.wigolo键下注册 MCP 服务器说明文档模板来自 mcp_config.json.block内含完整的 10 工具速查表和 6 条调用规则。此外仓库还附带一份更完整的「升级阶梯」规则 rules-global.mdcache → search → fetch → crawl → extract → find_similar → research → agent → diff → watch按任务复杂度逐级升级避免代理一上来就动用重型工具。Zedsettings.json 指令目录Zed 使用context_servers机制配置位置为~/.config/zed/settings.jsonsrc/cli/agents/zed.ts在context_servers.wigolo键下注册命令。指令文件写入~/.config/zed/instructions/wigolo.md全局生效——Zed 打开任何项目时代理都知道该优先调用 wigolo。5 条让代理更好用的实用技巧这些规则都已内置在注入的说明文档中理解它们能让你和代理配合得更顺先查缓存再搜索——cache工具命中本地缓存是瞬间且免费的代理被训练为先 probe 再 search用关键词数组而非自然语言问句——query支持数组多角度关键词比一句长问题召回更好框架/库查询加include_domains—— 锁定官方文档域避免 SEO 页干扰控制预算用search_depth—— 秒级响应需求用ultra-fast要最大信息量用deep要直接答案加format: answer—— 让代理拿到的就是合成结论需要引用溯源则用默认的 evidence 结构。搜索响应还附带evidence_score、freshness_signal、response_time_ms等字段代理可以据此判断该不该继续深挖。配置验证与卸载验证是否接好wigolo status # 查看安装状态与已连接的代理 wigolo doctor # 逐项体检数据目录、浏览器引擎、本地模型、搜索后端 wigolo verify # 真实网络冒烟测试全绿才放心doctor --fix还能自动修复已知故障详见 docs/troubleshooting.md。卸载wigolo config --uninstall --yes会清理每个代理的 MCP 注册条目和指令文件也可以只移除某个代理的接线如wigolo setup mcp --agentsvscode的反向操作由各 handler 的 uninstall 逻辑处理位置都在上文表格中。常见问题❓ VS Code 里看不到 wigolo十有八九是 mcp.json 写到了~/.vscode/下。确认它在用户配置目录见上文表格改完后重启 VS Code 或在 MCP Servers 面板刷新。❓ 三个代理共用一个本地缓存吗是的。缓存、向量库都在 wigolo 自己的数据目录哪个代理查过、另一个再查就是缓存命中——这正是「多代理接入」的隐藏福利。❓ 只想给一个项目用 VS Code 的指令Copilot 指令文件.github/copilot-instructions.md是项目级的提交到仓库后团队成员的 Copilot 都能受益MCP 注册本身是全局的一次接入、处处可用。一条wigolo init命令三个代理立刻获得「零 Key、零成本、带评分」的联网能力——这就是本地优先路线最直接的回报。【免费下载链接】wigoloThe go-to web for your AI coding agent — local-first search, fetch, crawl research over MCP. No API keys, no cloud, $0/query. Public beta.项目地址: https://gitcode.com/GitHub_Trending/wi/wigolo创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表