尧图网站建设 
从零搭建AI Agent本地知识中枢wigolo完全入门教程新手友好【免费下载链接】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 编程助手联网搜索、抓取网页、自动做研究却不想被 API 账单和云端依赖绑架开源项目wigolo是一个本地优先local-first的 AI Agent 网络智能中枢网页搜索、URL 抓取、站点爬取、结构化提取与深度研究全部运行在你自己的电脑上——无需 API key、无云端依赖、每次查询 0 元。本教程带新手从零搭建这套本地知识中枢5 分钟即可跑通第一条搜索。一、wigolo 是什么为什么叫AI Agent 本地知识中枢传统做法是给 Agent 挂一个云端搜索 API要注册、要 key、要按次付费数据还得离开你的机器。wigolo 换了个思路——把整套网络能力装进你本地的一个 Node 进程通过MCPModel Context Protocol标准协议直接挂在你的编程助手旁边联网层多引擎网页搜索18 个直接引擎适配器、分层抓取普通 HTTP → TLS 指纹 → 无头浏览器逐级升级、多页爬取本地模型层排序器reranker与语义向量embeddings全部在设备上运行不花一分钱知识缓存层Agent 见过的每个网页都存在~/.wigolo/下次提问直接命中缓存离线也能查下面这个演示里Claude Code 直接通过 wigolo 回答了一个实时网络问题全程没有任何 API key 核心实现位于src/tools/目录search、fetch、crawl、research 等各一个文件想了解内部机制可以从 docs/README.md 同目录下的文档看起。二、准备工作只需 3 个前提条件在动手之前确认你的机器满足以下条件都很常见一般已就绪条件说明Node.js ≥ 20运行node -v检查版本约 1.5 GB 磁盘空间用于无头浏览器引擎 设备端模型macOS / Linux / Windows三大平台全支持三、最快安装方法一条命令完成初始化打开终端执行npx wigolo init这一条命令会自动完成全部配置无交互、适合新手下载无头浏览器引擎和设备端 AI 模型逐项做健康检查health check输出逐组件报告——哪个组件没准备好会直接告诉你修复方法装完想确认一切正常随时运行npx wigolo doctor体检或用npx wigolo verify做一次端到端冒烟测试。四、把 wigolo 接入你常用的 AI 编程助手wigolo 支持自动接线在初始化时顺手把 MCP 配置和技能包写进你的 Agent一条命令搞定。npx wigolo init --agentsclaude-code,cursor--agents支持逗号分隔的任意组合目前已覆盖主流编码工具Agent参数值Claude Codeclaude-codeCursorcursorVS CodevscodeGemini CLIgemini-cliCodex / Zed / Windsurf / OpenCode / Antigravity同名小写值下面是一条命令接好 Claude Code的实际录屏效果接线成功后你的 Agent 会立刻获得 10 个网络工具并附带何时该用哪个工具的使用说明。不接 Agent 也没关系——任何支持 MCP 的客户端把npx -y wigolo写进自己的 MCP 配置即可具体配置块见docs/installation.md。五、10 个核心工具一次看懂这是 wigolo 的完整能力清单也是你的 Agent 接入后直接拥有的技能树工具一句话说明search多引擎网页搜索带排名融合、ML 重排序和可解释评分fetch抓取单个 URL自动升级到无头浏览器返回干净 Markdown️crawl多页爬取BFS/DFS/sitemap尊重 robots.txt 与速率限制extract从页面提取结构化数据表格、JSON-LD、任意自定义 Schemacache查询本地已见内容关键词 语义混合检索find_similar找出与某 URL 或概念相似的页面research拆解问题 → 扇出子查询 → 汇总成带引用的研究报告agent自主采集循环规划 → 搜索 → 抓取 → 提取 → 综合diff/ ⏱️watch页面变化检测可配 webhook 推送每个工具的完整参数与返回字段在docs/tools.md中有逐条说明可运行示例集中在examples/目录。六、终端也能玩一条命令完成搜索不想开 Agent所有工具同时是命令行工具。例如npx wigolo search css container queries --limit2会直接返回带评分的搜索结果引擎、耗时一目了然任何命令加--json就能输出机器可读结果方便管道处理。下面演示了终端里搜索、抓取与 JSON 输出的完整流程七、本地缓存同一个问题问两次第二次零成本这就是知识中枢最有价值的地方。wigolo 把每次响应都写进本地缓存关键词索引 向量索引存于~/.wigolo/第一次提问实时走公网搜索几秒返回之后任何会话再问同类问题直接查本地缓存近乎瞬时、零网络开销断网也能用cache工具还能做变更检测配合watch可以监控 changelog、价格页之类的动态页面。效果演示如下八、对比云端搜索工具为什么新手优先选 wigolowigolo 的定位不是云端服务的免费平替而是把搜索/提取质量做到同级、但成本和隐私完全不同。核心差异wigoloFirecrawlExaTavily需要 API key / 账号否是是是每次查询成本$0按量计费按量计费按量计费本地持久缓存离线可查✅———查询数据留在本机✅———逐条可解释评分✅———同一问题交给多个网络搜索工具横评时wigolo 会额外返回逐字节定位的原文摘录和引擎级遥测下方对比图来自真实录屏Agent 是爆发式提问的——一轮任务可能连发几十次搜索。按次计费的服务账单会随 Agent 的思考线性上涨而本地方案始终为零这是新手选 wigolo 最实际的理由。九、进阶玩法按需解锁可选搭好本地中枢后还有三种扩展方式都是顺手的事REST 服务wigolo serve启动本地 HTTP 服务任何脚本、n8n、自建 Agent 都能直接调 10 个工具完整契约见docs/rest-api.md官方 SDKTypeScript 装wigolo-sdkPython 装wigolo两行代码嵌入你自己的应用sdks/目录下有完整源码与测试框架集成LangChain、CrewAI、LlamaIndex、Vercel AI SDK 都有现成包装把 wigolo 的 10 个工具直接注册进你现有的 Agent 框架另外wigolo 自带 11 个技能包skills教会你的 Agent 如何更聪明地用这些工具——先查缓存再搜网如何读懂证据评分等。安装很简单npx wigolo skills add熟练后还可以把命令通过 NDJSON 管道串成自动化流水线效果如下十、新手常见问题FAQQ1核心功能真的完全免费吗是的。search、fetch、crawl、extract、cache、find-similar 六大工具无需任何 key成本为 $0/次。只有research/agent的合成式答案可选接 LLM——不接也能拿到原始证据简报接一个免费的 Gemini key或本地 Ollama即可升级为成品答案。Q2我的数据会上传到云端吗默认不会。缓存、向量、模型、配置全部在~/.wigolo/下除非你主动选择 LLM 合成否则没有任何内容离开你的机器。Q3初始化时某个组件下载失败怎么办init采用逐组件报告失败的组件不会中断安装它会在首次使用时自动重试报告里也写明了修复方法。npx wigolo doctor --fix还能自动修复常见故障。Q4想彻底卸载npx wigolo config --uninstall --yes一条命令清理干净所有痕迹。 到这里你就拥有了一个只属于自己 Agent 的本地知识中枢一条npx wigolo init起步搜索、抓取、爬取、研究、缓存全部就位不花一分钱、不留一条数据。下一步建议直接给research提一个你真正关心的问题感受本地中枢 公网实时信息组合起来的威力。【免费下载链接】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），仅供参考 从零搭建AI Agent本地知识中枢：wigolo完全入门教程（新手友好）
从零搭建AI Agent本地知识中枢wigolo完全入门教程新手友好【免费下载链接】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 编程助手联网搜索、抓取网页、自动做研究却不想被 API 账单和云端依赖绑架开源项目wigolo是一个本地优先local-first的 AI Agent 网络智能中枢网页搜索、URL 抓取、站点爬取、结构化提取与深度研究全部运行在你自己的电脑上——无需 API key、无云端依赖、每次查询 0 元。本教程带新手从零搭建这套本地知识中枢5 分钟即可跑通第一条搜索。一、wigolo 是什么为什么叫AI Agent 本地知识中枢传统做法是给 Agent 挂一个云端搜索 API要注册、要 key、要按次付费数据还得离开你的机器。wigolo 换了个思路——把整套网络能力装进你本地的一个 Node 进程通过MCPModel Context Protocol标准协议直接挂在你的编程助手旁边联网层多引擎网页搜索18 个直接引擎适配器、分层抓取普通 HTTP → TLS 指纹 → 无头浏览器逐级升级、多页爬取本地模型层排序器reranker与语义向量embeddings全部在设备上运行不花一分钱知识缓存层Agent 见过的每个网页都存在~/.wigolo/下次提问直接命中缓存离线也能查下面这个演示里Claude Code 直接通过 wigolo 回答了一个实时网络问题全程没有任何 API key 核心实现位于src/tools/目录search、fetch、crawl、research 等各一个文件想了解内部机制可以从 docs/README.md 同目录下的文档看起。二、准备工作只需 3 个前提条件在动手之前确认你的机器满足以下条件都很常见一般已就绪条件说明Node.js ≥ 20运行node -v检查版本约 1.5 GB 磁盘空间用于无头浏览器引擎 设备端模型macOS / Linux / Windows三大平台全支持三、最快安装方法一条命令完成初始化打开终端执行npx wigolo init这一条命令会自动完成全部配置无交互、适合新手下载无头浏览器引擎和设备端 AI 模型逐项做健康检查health check输出逐组件报告——哪个组件没准备好会直接告诉你修复方法装完想确认一切正常随时运行npx wigolo doctor体检或用npx wigolo verify做一次端到端冒烟测试。四、把 wigolo 接入你常用的 AI 编程助手wigolo 支持自动接线在初始化时顺手把 MCP 配置和技能包写进你的 Agent一条命令搞定。npx wigolo init --agentsclaude-code,cursor--agents支持逗号分隔的任意组合目前已覆盖主流编码工具Agent参数值Claude Codeclaude-codeCursorcursorVS CodevscodeGemini CLIgemini-cliCodex / Zed / Windsurf / OpenCode / Antigravity同名小写值下面是一条命令接好 Claude Code的实际录屏效果接线成功后你的 Agent 会立刻获得 10 个网络工具并附带何时该用哪个工具的使用说明。不接 Agent 也没关系——任何支持 MCP 的客户端把npx -y wigolo写进自己的 MCP 配置即可具体配置块见docs/installation.md。五、10 个核心工具一次看懂这是 wigolo 的完整能力清单也是你的 Agent 接入后直接拥有的技能树工具一句话说明search多引擎网页搜索带排名融合、ML 重排序和可解释评分fetch抓取单个 URL自动升级到无头浏览器返回干净 Markdown️crawl多页爬取BFS/DFS/sitemap尊重 robots.txt 与速率限制extract从页面提取结构化数据表格、JSON-LD、任意自定义 Schemacache查询本地已见内容关键词 语义混合检索find_similar找出与某 URL 或概念相似的页面research拆解问题 → 扇出子查询 → 汇总成带引用的研究报告agent自主采集循环规划 → 搜索 → 抓取 → 提取 → 综合diff/ ⏱️watch页面变化检测可配 webhook 推送每个工具的完整参数与返回字段在docs/tools.md中有逐条说明可运行示例集中在examples/目录。六、终端也能玩一条命令完成搜索不想开 Agent所有工具同时是命令行工具。例如npx wigolo search css container queries --limit2会直接返回带评分的搜索结果引擎、耗时一目了然任何命令加--json就能输出机器可读结果方便管道处理。下面演示了终端里搜索、抓取与 JSON 输出的完整流程七、本地缓存同一个问题问两次第二次零成本这就是知识中枢最有价值的地方。wigolo 把每次响应都写进本地缓存关键词索引 向量索引存于~/.wigolo/第一次提问实时走公网搜索几秒返回之后任何会话再问同类问题直接查本地缓存近乎瞬时、零网络开销断网也能用cache工具还能做变更检测配合watch可以监控 changelog、价格页之类的动态页面。效果演示如下八、对比云端搜索工具为什么新手优先选 wigolowigolo 的定位不是云端服务的免费平替而是把搜索/提取质量做到同级、但成本和隐私完全不同。核心差异wigoloFirecrawlExaTavily需要 API key / 账号否是是是每次查询成本$0按量计费按量计费按量计费本地持久缓存离线可查✅———查询数据留在本机✅———逐条可解释评分✅———同一问题交给多个网络搜索工具横评时wigolo 会额外返回逐字节定位的原文摘录和引擎级遥测下方对比图来自真实录屏Agent 是爆发式提问的——一轮任务可能连发几十次搜索。按次计费的服务账单会随 Agent 的思考线性上涨而本地方案始终为零这是新手选 wigolo 最实际的理由。九、进阶玩法按需解锁可选搭好本地中枢后还有三种扩展方式都是顺手的事REST 服务wigolo serve启动本地 HTTP 服务任何脚本、n8n、自建 Agent 都能直接调 10 个工具完整契约见docs/rest-api.md官方 SDKTypeScript 装wigolo-sdkPython 装wigolo两行代码嵌入你自己的应用sdks/目录下有完整源码与测试框架集成LangChain、CrewAI、LlamaIndex、Vercel AI SDK 都有现成包装把 wigolo 的 10 个工具直接注册进你现有的 Agent 框架另外wigolo 自带 11 个技能包skills教会你的 Agent 如何更聪明地用这些工具——先查缓存再搜网如何读懂证据评分等。安装很简单npx wigolo skills add熟练后还可以把命令通过 NDJSON 管道串成自动化流水线效果如下十、新手常见问题FAQQ1核心功能真的完全免费吗是的。search、fetch、crawl、extract、cache、find-similar 六大工具无需任何 key成本为 $0/次。只有research/agent的合成式答案可选接 LLM——不接也能拿到原始证据简报接一个免费的 Gemini key或本地 Ollama即可升级为成品答案。Q2我的数据会上传到云端吗默认不会。缓存、向量、模型、配置全部在~/.wigolo/下除非你主动选择 LLM 合成否则没有任何内容离开你的机器。Q3初始化时某个组件下载失败怎么办init采用逐组件报告失败的组件不会中断安装它会在首次使用时自动重试报告里也写明了修复方法。npx wigolo doctor --fix还能自动修复常见故障。Q4想彻底卸载npx wigolo config --uninstall --yes一条命令清理干净所有痕迹。 到这里你就拥有了一个只属于自己 Agent 的本地知识中枢一条npx wigolo init起步搜索、抓取、爬取、研究、缓存全部就位不花一分钱、不留一条数据。下一步建议直接给research提一个你真正关心的问题感受本地中枢 公网实时信息组合起来的威力。【免费下载链接】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），仅供参考