企业官网建设流程全解析

如果你在用 Markra 写研究笔记或技术文档，一定遇到过模型"不知道最新资料"的尴尬。Markra 是开源免费的 WYSIWYG Markdown 编辑器，内置原生 AI 对话面板，而它的**联网搜索（Web Search）**功能让 AI 能真正"上网查资料"——支持服务商原生搜索、免 Key 的本地 Bing 抓取，以及自建 SearXNG 元搜索引擎，结果数量和正文长度都可在设置中精细控制。

联网搜索是怎么工作的？

Markra 的联网搜索由三条路径组成，自动择优：

核心流程（实现见 web-search.ts）：

1. 发起查询：AI 调用web_search工具，按所选搜索服务发出请求；
2. 抓取正文：对每条结果用 Mozilla Readability 抽取正文，转成干净的 Markdown，并按"正文长度上限"截断；
3. 带引用作答：结果以[1] [2]编号喂给模型，回复中会自然引用来源（见 formatWebSearchToolResult）。

3 步开启联网搜索

第 1 步：在 AI 面板打开"联网搜索"开关

打开右侧Markra AI面板，在输入框底部找到Web search（联网搜索）按钮（实现见 AiAgentPanel.tsx），点一下即点亮 🌐。这个开关只影响 AI 对话，普通写作完全离线。

⚠️ 按钮呈灰色不可点？说明当前模型/服务商不支持联网搜索。只要服务商支持原生搜索、或所选模型支持 tools 工具调用，开关即可用（判断逻辑见 web-search-availability.ts）。

第 2 步：在设置里选择搜索服务

进入设置 → 联网（Web）分类，配置搜索服务：

• 启用联网搜索：总开关，默认开启；
• 搜索服务：本地 Bing（默认，开箱即用）或SearXNG；
• 选择 SearXNG 后会多出一行SearXNG 地址，例如http://localhost:8888，注意实例需启用 JSON 输出。

界面与交互见 WebSearchSettings.tsx，默认值与取值范围（结果数 1–20、正文 2000–40000 字符）见 web-search-settings.ts。

第 3 步：按需调整"最大结果数"与"正文长度上限"

默认每次搜索抓取5 条结果、每页正文保留12000 字符。如果你的任务偏资料综述，可以适当调大结果数；追求响应速度则调小。两项调整都会即时保存到本地设置。

SearXNG 模式：隐私优先的自建搜索

本地 Bing 零配置即可用，但对隐私敏感或想聚合 Google/Bing/DuckDuckGo 多引擎的用户，更推荐自建 SearXNG：

1. 部署一个 SearXNG 实例（支持本机localhost，也支持局域网地址）；
2. 在实例的settings.yml中启用formats: [html, json]，确保 JSON 接口开启；
3. 回到 Markra 设置，搜索服务选SearXNG，填入实例地址。

Markra 会请求<实例地址>/search?q=…&format=json&pageno=1，并按相关性评分排序取前 N 条（见 searchWithSearxng）。整个链路只连你自己的实例，数据来源完全自主可控——这一点也被 隐私政策 明确说明：联网数据仅发往你选择的搜索服务。

常见问题速查

写在最后

Markra 的联网搜索设计很克制：默认值开箱即用（本地 Bing 免 Key），进阶玩法（SearXNG）交给你自建，参数上限也防止 token 被超长网页吃满。配合它"本地优先、数据留在磁盘"的理念（见 PRODUCT.md），你可以在不牺牲隐私的前提下，让 AI 帮你查证最新资料、写带引用的研究摘要 🚀。

相关文件速览

• 搜索工具核心逻辑：web-search.ts
• 设置界面：WebSearchSettings.tsx
• 可用性判断：web-search-availability.ts
• 设置入口路由：SettingsWindow.tsx
• 官方隐私说明：docs/privacy.md