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是一款本地優(yōu)先的 AI 編程代理網(wǎng)絡(luò)工具通過 MCP 協(xié)議為 AI 編程助手提供搜索、抓取、爬取和深度研究能力——無需 API Key、不依賴云端、每次查詢零成本。本教程帶你用一條命令把它接入 VS Code Copilot、Windsurf 和 Zed并詳解每個代理的配置位置與實用技巧。為什么要給編程代理接上 wigolo主流編輯器里的 AI 助手自帶 WebSearch / WebFetch但普遍存在三個痛點要配 Key內(nèi)置搜索往往綁定云廠商 API按次計費高頻查文檔、看 Issue 時成本疊加明顯結(jié)果質(zhì)量不穩(wěn)定無重排、無緩存同一問題反復(fù)查、反復(fù)慢。wigolo 的解法是「本地優(yōu)先 持久緩存 ML 重排」所有組件瀏覽器引擎、嵌入模型、重排模型都跑在你機(jī)器上搜索命中本地緩存時秒回且免費結(jié)果自帶evidence_score等可解釋評分字段代理拿到的證據(jù)更可靠。它原生支持 10 個代理的自動接線處理邏輯集中在 src/cli/agents/registry.ts每個代理一個獨立 handler互不干擾?？焖匍_始一條命令接入三個代理先安裝 wigolonpm、brew、Docker 或 sh 腳本均可見 docs/installation.md然后在終端執(zhí)行wigolo init --agentsvscode,windsurf,zed這條命令做了三件事檢測三個代理是否安裝自動寫入各自的 MCP 配置把 wigolo 的使用說明工具表 調(diào)用規(guī)則注入每個代理的指令文件下載并驗證瀏覽器引擎與本地模型打印逐組件報告。不想等下載可以加--no-warmup組件會在首次使用時懶加載。完整參數(shù)說明見 docs/cli.md。逐代理配置詳解下面逐一說明每個代理「寫了什么、寫在哪、為什么這么寫」。VS Code (Copilot)全局 mcp.json 項目級指令MCP 配置VS Code 從用戶級配置目錄讀取全局 MCP 服務(wù)器而不是~/.vscode/mcp.json寫錯位置的話擴(kuò)展面板 MCP Servers 里永遠(yuǎn)看不到 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寫入后在擴(kuò)展面板 MCP Servers中即可看到 wigolo無需額外操作。指令文件注入到當(dāng)前項目的.github/copilot-instructions.md內(nèi)容為 copilot-instructions.md.block——一張「任務(wù) → 工具 → 關(guān)鍵參數(shù)」速查表強(qiáng)制 Copilot 優(yōu)先走 wigolo 而非內(nèi)置搜索。Windsurfmcp_config.json 全局規(guī)則Windsurf 的配置集中在~/.codeium/windsurf/目錄src/cli/agents/windsurf.tsmcp_config.json在mcpServers.wigolo鍵下注冊 MCP 服務(wù)器說明文檔模板來自 mcp_config.json.block內(nèi)含完整的 10 工具速查表和 6 條調(diào)用規(guī)則。此外倉庫還附帶一份更完整的「升級階梯」規(guī)則 rules-global.mdcache → search → fetch → crawl → extract → find_similar → research → agent → diff → watch按任務(wù)復(fù)雜度逐級升級避免代理一上來就動用重型工具。Zedsettings.json 指令目錄Zed 使用context_servers機(jī)制配置位置為~/.config/zed/settings.jsonsrc/cli/agents/zed.ts在context_servers.wigolo鍵下注冊命令。指令文件寫入~/.config/zed/instructions/wigolo.md全局生效——Zed 打開任何項目時代理都知道該優(yōu)先調(diào)用 wigolo。5 條讓代理更好用的實用技巧這些規(guī)則都已內(nèi)置在注入的說明文檔中理解它們能讓你和代理配合得更順先查緩存再搜索——cache工具命中本地緩存是瞬間且免費的代理被訓(xùn)練為先 probe 再 search用關(guān)鍵詞數(shù)組而非自然語言問句——query支持?jǐn)?shù)組多角度關(guān)鍵詞比一句長問題召回更好框架/庫查詢加include_domains—— 鎖定官方文檔域避免 SEO 頁干擾控制預(yù)算用search_depth—— 秒級響應(yīng)需求用ultra-fast要最大信息量用deep要直接答案加format: answer—— 讓代理拿到的就是合成結(jié)論需要引用溯源則用默認(rèn)的 evidence 結(jié)構(gòu)。搜索響應(yīng)還附帶evidence_score、freshness_signal、response_time_ms等字段代理可以據(jù)此判斷該不該繼續(xù)深挖。配置驗證與卸載驗證是否接好wigolo status # 查看安裝狀態(tài)與已連接的代理 wigolo doctor # 逐項體檢數(shù)據(jù)目錄、瀏覽器引擎、本地模型、搜索后端 wigolo verify # 真實網(wǎng)絡(luò)冒煙測試全綠才放心doctor --fix還能自動修復(fù)已知故障詳見 docs/troubleshooting.md。卸載wigolo config --uninstall --yes會清理每個代理的 MCP 注冊條目和指令文件也可以只移除某個代理的接線如wigolo setup mcp --agentsvscode的反向操作由各 handler 的 uninstall 邏輯處理位置都在上文表格中。常見問題? VS Code 里看不到 wigolo十有八九是 mcp.json 寫到了~/.vscode/下。確認(rèn)它在用戶配置目錄見上文表格改完后重啟 VS Code 或在 MCP Servers 面板刷新。? 三個代理共用一個本地緩存嗎是的。緩存、向量庫都在 wigolo 自己的數(shù)據(jù)目錄哪個代理查過、另一個再查就是緩存命中——這正是「多代理接入」的隱藏福利。? 只想給一個項目用 VS Code 的指令Copilot 指令文件.github/copilot-instructions.md是項目級的提交到倉庫后團(tuán)隊成員的 Copilot 都能受益MCP 注冊本身是全局的一次接入、處處可用。一條wigolo init命令三個代理立刻獲得「零 Key、零成本、帶評分」的聯(lián)網(wǎng)能力——這就是本地優(yōu)先路線最直接的回報?！久赓M下載鏈接】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創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考