Vane — 隐私优先的 AI 回答引擎
本地运行、支持多种 LLM、带引用来源的私密 AI 搜索与问答引擎。
证据显示：README 强调隐私保护，数据本地存储，但未提供权限最小化、用户确认、数据流透明等具体机制。依赖众多，但未提供安全审计或漏洞扫描证据。外部效果（如网络搜索）存在，但未说明用户确认或撤销机制。回滚机制未提及。来源归属有提及引用来源，但未详细说明。扣分原因：缺乏具体实现细节和证据。
证据显示：README 和 package.json 一致，功能描述与依赖基本匹配。依赖众多，但未提供可用性保证或镜像。故障信息有部分（如 Ollama 连接错误），但不够全面。扣分原因：依赖可用性未验证，故障信息不完整。
证据显示：README 描述了多种使用场景（本地、云端、搜索模式），能力边界有说明（支持多种提供商和搜索源），但触发精度（如搜索模式选择）未详细说明。环境适配有 Docker 和非 Docker 安装说明。扣分原因：触发精度和边界描述不够精确。
证据显示：README 结构清晰，安装说明详细，有示例（如 Docker 命令），但缺少已知限制和版本变更日志。许可证为 MIT，但维护责任未明确。扣分原因：缺少已知限制、版本变更日志和维护责任说明。
证据显示：输出可用性（引用来源、多种搜索模式）有描述，边际价值（隐私、本地运行）有体现，但成本效益（如资源消耗、API 费用）未讨论。扣分原因：成本效益未说明。
证据显示：README 声称功能，但未提供测试或验证证据。来源引用有提及，但未区分事实与推断。扣分原因：缺乏可验证的证据和事实/推断分离。
- 未提供安全审计或漏洞扫描证据，依赖众多，需自行评估供应链风险。
- 未提供用户确认机制，外部搜索可能自动执行，需注意隐私和合规。
- 未提供回滚机制，升级或配置错误可能难以恢复。
- 未提供版本变更日志，升级风险不透明。
这个 Agent 能做什么，适合哪些场景？
Vane 是一款可完全自托管的 AI 回答引擎，以隐私为核心，所有搜索请求仅在你的硬件上处理。它整合互联网知识，支持通过 Ollama 使用本地 LLM，也可接入 OpenAI、Anthropic Claude、Google Gemini、Groq 等云端提供商，生成带有引用来源的准确答案。内置的 SearxNG 搜索聚合让你在隐藏身份的同时访问多个搜索引擎。提供多种搜索模式、来源选择（网页、讨论、学术）、小部件（天气、计算等）、图片/视频搜索、文件上传与域限制搜索。所有搜索历史本地保存，通过简洁的前端界面提供。安装以 Docker 为主，一条命令即可启动，也支持手动安装。Vane 提供 API 供开发者集成。
接收用户的搜索查询后，根据所选模式（快速、均衡或深度）分派，利用 SearxNG 聚合搜索（JSON 格式、Wolfram Alpha 已启用）获取结果，结合 LLM 提供商（Ollama、OpenAI、Claude、Gemini、Groq）生成带引用的答案。支持文件上传（PDF、文本、图片）并基于内容问答。提供域限制搜索、智能搜索建议、发现页与本地保存的搜索历史。通过 Docker（docker run ... itzcrazykns1337/vane:latest）或非 Docker（npm i && npm run build && npm run start）方式部署，前端运行于 Next.js，端口 3000，并提供 HTTP API 供集成。
- 隐私敏感用户：使用本地 LLM 与 SearxNG 搜索，避免数据发送到云端。
- 深度研究者：选择学术来源与质量模式，获取引用充分的答案。
- 技术文档查询：使用域限制搜索限定在指定网站，快速查找 API 或配置。
- 离线环境：在无外网或内部网运行，借助本地模型与 SearxNG。
- 移动或桌面用户：通过浏览器将 Vane 设为默认搜索引擎。
- 开发者：将 Vane 的 API 集成到自己的应用中。
这个 Agent 有哪些优点和局限？
- 完全自托管，隐私由你掌控，所有数据处理在本地
- 支持多种 LLM 提供商，包括本地 Ollama 和主流云 API，灵活组合
- 自带 SearxNG 聚合搜索，屏蔽搜索记录
- 提供多种搜索模式（快速/均衡/深度）与来源选择
- 支持文件上传和 PDF/图片理解，应用范围广
- 有活跃社区和 Discord 支持
- 需要 Docker 或 Node.js 环境，技术门槛较高
- 初学者配置 Ollama 或 SearxNG 可能出现连接问题
- 本地模型对硬件资源要求高，影响速度
- 依赖 SearxNG 实例，需保证其 JSON 接口可用
- 部分功能（如 Tavily/Exa 集成）尚未完成，仍在路线图中
- 缺少身份验证，暴露到公网存在安全风险
如何安装或部署这个 Agent？
使用 Docker 快速开始：执行 docker run -d -p 3000:3000 -v vane-data:/home/vane/data --name vane itzcrazykns1337/vane:latest，随后访问 http://localhost:3000 配置 API 密钥与模型。若使用外部 SearxNG，可采用 itzcrazykns1337/vane:slim-latest 镜像并设置 SEARXNG_API_URL 环境变量。手动安装：克隆仓库，配置 SearxNG（启用 JSON 格式与 Wolfram Alpha），运行 npm i、npm run build、npm run start，同样访问本地 3000 端口进行设置。
如何使用这个 Agent？
安装并配置完成后，在浏览器打开 http://localhost:3000，在设置界面填入 API 密钥（Ollama 默认无需密钥，但留空会报错）并选择模型。直接输入问题，选择搜索模式（Speed/Balanced/Quality）和来源（网页/讨论/学术）。可使用文件上传和域限制功能。若作为网站搜索，在浏览器搜索引擎设置中添加 URL http://localhost:3000/?q=%s。开发者可调用 Vane 的 API（文档见 docs/API/SEARCH.md）。
这个 Agent 与同类方案有什么区别？
Vane 在功能上类似于 Perplexica（同为 AI 搜索工具），但 Vane 更强调隐私自托管，而 Perplexica 可能更注重即时可用性。相比传统搜索引擎，Vane 提供 AI 驱动的引用答案。具体性能对比未在文档中提供。
常见问题
Vane 是否支持中文搜索？
运行 Vane 需要哪些硬件配置？
Vane 能否集成到现有应用？
如何处理 Ollama 连接错误？
http://host.docker.internal:11434，Linux 使用宿主机私有 IP，并确保 Ollama 监听 0.0.0.0。