搜索网页与平台内容
使用 Ghast 查找来源、读取指定网页，或搜索你的 X、小红书账户可见的内容。从 设置 → 网络搜索 开始。这里的搜索设置与生成回复的模型 Provider分开管理。
选择要完成的任务
| 需求 | 要求 Ghast 使用什么 |
|---|---|
| 查找某个主题的公开网页 | WebSearch，提供关键词和来源要求。 |
| 读取指定文章或文档 | WebFetch，提供完整 URL 和需要阅读的部分。 |
| 搜索 X 帖子或账户 | XSearch，先在下方登录 X。 |
| 搜索小红书笔记 | RednoteSearch，先在下方登录小红书。 |
| 点击、填表或检查本地开发页面 | 浏览器工具。需要在编码会话旁打开页面时，参阅浏览器。 |
会话仍需要已配置的模型和对应可用工具。搜索连接成功不会替你配置模型，聊天回复成功也不证明 Ghast 实际进行了搜索。
不配置搜索 API Key 也能开始
- 打开 设置 → 网络搜索。
- 在 默认搜索引擎 → 搜索引擎 中保留 默认，或选择 Google、Bing、Sogou、Baidu。这些选项不要求搜索 API Key。
- 如果修改了选项，点击设置页底部的 保存，等待 未保存的修改 提示消失。
- 点击下拉菜单旁的 测试连接。
- 测试成功后，回到会话尝试第一次搜索。
普通网页搜索不强制要求登录 Google。X 和小红书登录只供各自的平台搜索使用，不需要先连接所有账户才能开始。
引擎选项的含义
默认 会尝试不需要你自备 API Key 的服务，必要时使用内置搜索引擎。它不等于“只使用 Google”，也不等于离线搜索。
选择某个名称表示优先使用该服务，不代表查询只会发给它。遇到错误或空结果时，Ghast 可能尝试其他服务，包括已启用的账户型搜索 API，并不限于研究请求。部分研究请求也可能使用已启用的 API 补充来源。引擎选择器不能限制查询文本的发送范围。如果查询只能发送给某个获准服务，不要把此下拉菜单当作强制限制。
时间、语言、地区和来源要求可能影响实际使用的服务。应核对返回来源与日期，不要假设每个引擎都以相同方式执行筛选。
如何看连接测试
顶部 测试连接 只在选择 默认 或四个内置引擎时出现。选择第三方 API 后，顶部 不会 显示这个按钮。
- 测试中…：请求仍在运行，测试按钮暂时不可点击。
- 可访问 · … 个结果 · …ms：本次测试返回了结果。将鼠标移到状态上可查看示例标题，以及可用时显示的实际服务。
- 不可访问 · …ms：本次测试没有得到可用结果。将鼠标移到状态上查看错误。
内置／默认测试使用固定查询“OpenAI”，不会发送你的会话历史。测试针对下拉菜单当前选项，但不会保存设置。要在会话中使用修改后的引擎，应先保存。
测试通过只说明当时网络和这条查询可用。如果默认模式失败，但 Google 行测试成功，可以在顶部选择 Google、保存，再通过会话搜索核验。两者的任何一个结果都不代表全部搜索路径正常。
添加搜索 API
需要使用自己的搜索服务账户时，在 搜索 API 中配置。
| 服务 | 配置条件 |
|---|---|
| Tavily | API Key 和启用开关。 |
| Brave Search | API Key 和启用开关。 |
| Exa | API Key 和启用开关。 |
| Firecrawl | 启用开关；API Key 可选。无 Key 时可尝试免 Key 访问，但不保证可用。 |
搜索 API 的访问和额度由对应搜索服务账户提供。模型 Provider 的 Key 或 Ghast 算力余额不能替代搜索服务的 API Key、账户额度。搜索结果还可能进入模型请求，使用所选模型的计费。
配置、启用并选为默认
- 点击服务旁的 配置。
- 点击 获取 API key，打开该服务的 Key 页面，在你自己的账户中创建或获取 Key。
- 把 Key 粘贴到 Ghast 的 API Key 字段，不要粘贴到会话中。
- 打开服务的启用开关。Tavily、Brave Search、Exa 的 Key 字段为空时，开关不可用。
- 如果想默认使用它，在顶部 搜索引擎 中选中该服务。仅打开开关不会自动将它设为默认。
- 点击设置页底部的 保存。展开的 Key 字段旁没有独立保存按钮；收起 只隐藏字段。
- 在会话中执行一次简单的公开查询，检查结果及服务信息。这些 API 服务没有专用连接测试按钮。
API 状态分别表示什么
| 状态 | 含义 |
|---|---|
| 未配置 | 缺少必填 Key。 |
| 已配置 · 未启用 | 已填入 Key，但服务关闭；不代表 Key 已验证有效。 |
| Key 可选 | Firecrawl 没有填写 Key，也未启用。 |
| 已启用 | 配置满足可选条件，不代表请求已经成功。 |
| 默认 | 顶部引擎选中了该服务。有未保存修改时，应先保存再使用。 |
更换 Key 后应重新执行会话搜索。由于搜索可能使用其他服务接替，得到正常答案并不证明新 Key 可用。可用时检查工具中的服务信息，或到搜索服务账户查看用量。
停用服务或移除 Key
关闭服务开关并保存，可停止让搜索选用这份账户配置。需要移除此设置中的 Key 时，展开 配置、清空字段并保存。
如果关闭的是当前默认 API，顶部引擎会变为 Google。清空当前所选 Tavily、Brave Search、Exa 的必填 Key 也会切到 Google，保存前应检查选项。清空 Firecrawl Key 后，它可能仍保持选中和启用，改为尝试免 Key 访问。
在 Ghast 清空 Key 不等于在服务商处吊销它。Key 泄露时，还应到服务商账户吊销或轮换。关闭 Exa、Firecrawl 的 API 行后，免 Key 搜索仍可能访问这两家公司。其他替代服务也可能接收查询。
连接平台账户
平台账号 中每个服务都有独立登录状态和测试。登录操作与设置页的保存按钮分开生效。显示 已登录 的会话仍可能过期或不可用，应通过该行的测试检查真实访问。
Google
- 点击 登录；已有会话时点击 重新登录。
- 在打开的窗口中亲自完成验证，使用预期的 Google 账户。
- 回到 Ghast，等待显示 已登录。
- 点击 Google 行 的 测试连接。无论顶部选择了哪个引擎，这个按钮都只测试 Google。
登录 Google 不会自动把默认引擎切换为 Google。
X：登录与搜索帖子
- 在 X 行点击 登录 或 重新登录。
- 在打开的窗口中完成 X 登录。
- 返回 Ghast，检查 已登录 并点击该行 测试连接；测试查询为“OpenAI”。
如果你已有会话 Token 并需要导入，可展开 Token 登录，将自己的 X auth_token 粘贴到密码字段，再点击 Token 登录 或按 Enter。导入成功后字段会清空。没有 Token 时使用正常登录窗口，不要让助手从浏览器提取凭据。
Token 可以授予账户访问，不能放进聊天、截图、支持工单或共享文件。出现 Token 太短、未找到 auth_token 或 导入失败 不算登录成功，应查看错误，必要时改用登录窗口。
在会话中明确要找的内容：
- 最新帖子：“在 X 搜索［主题］的近期帖子，附上发帖日期和链接。”
- 热门帖子：“查找 X 对［主题］的热门排序结果，不是最新帖子列表。”
- 账户：“查找个人资料与［主题］相关的 X 账户。”
- 媒体或讨论上下文：要求检查可见媒体，或打开原帖阅读可访问的帖子串、回复内容。
X 搜索不是普通网页搜索的默认引擎，不会出现在顶部选择器。当前支持的能力是搜索与阅读，不包括发帖、点赞、关注、转发或私信。需要文案时，可以让 Ghast 在会话中起草，由你审阅后自行发布。
小红书：扫码登录与搜索笔记
- 点击小红书行的 登录。
- 等待 Ghast 准备会话、打开登录页并获取新二维码。
- 使用目标账户的小红书手机 App 扫码，在 App 中完成所需确认。
- 等待显示 已登录，再点击 测试连接。未登录时该按钮不可用；测试查询为“美食”。
登录进行中使用 取消 放弃，错误发生后使用 关闭。不要重复使用或分享过期二维码。重新登录会创建新的会话，应完成后再开始平台搜索。
可以这样提问：
在小红书搜索上海咖啡店攻略，阅读三篇相关笔记的详情，区分每位作者的说法，并附上原笔记链接。不要点赞、收藏、评论或发布任何内容。
你可以要求搜索全部、图文或视频笔记，摘要不足时要求读取详情。当前 RednoteSearch 只支持综合排序，不提供最新或热门排序。要求“近期”内容时仍要核对笔记日期，不能把排序当成日期筛选。
退出登录或更换账户
点击目标平台旁的 退出登录，在 退出登录？ 中核对平台名称，再确认 退出登录。选择 取消 会保留会话。
该操作清除 Ghast 在当前设备保存的对应平台会话，不会删除平台账户、移除 API Key，也不会抹去会话中已经返回的内容。更换账户时，先退出，再使用另一账户登录并测试。不要假设这也会退出独立的系统浏览器。
进行第一次搜索
在模型可用、已提供 WebSearch 的会话中发送：
使用 WebSearch 查找三篇关于 Python pathlib 模块的官方页面，只使用 docs.python.org 来源。给出页面标题与链接，并区分哪些内容仅来自搜索摘要，哪些页面是实际读取过的。
然后检查：
- Ghast 是否真正调用了 WebSearch，而不是凭已有知识回答？
- 链接是否属于指定域名，且与问题相关？
- 是否区分了摘要和页面正文？
- 对时效性问题，页面的发布或更新日期是否满足要求？
- 结果冲突或内容不足时，Ghast 是否明确说明？
域名限制约束的是你希望返回的来源，不是可以接收查询的服务商。搜索摘要可能截断，重复查询也可能复用近期结果，而非每次重新实时搜索。重要更新应继续读取原网页并核对日期。
检查搜索与读取记录
展开回复上方的 已搜索 · 已读取网页 等活动组，核对实际查询和每条 已读取网页 记录中的 URL。点击回复下方的 使用了 … 个来源，可展开来源链接；这个数量不代表已经完整读过的页面数。
读取记录出现 内容已截断 时，不能采信“已经阅读全文”的说法。应让 Ghast 单独读取相关标题或缺失章节。打开来源链接可以让你亲自检查页面，但不会因此自动把整页内容补给模型。
读取指定网页
提供完整 URL 和问题或章节：
使用 WebFetch 读取这个 URL：［粘贴链接］。只总结安装要求部分。如果该部分缺失或不完整，请说明，不要凭已有知识补齐。
长页面可以指定标题或章节。返回内容被截断，不代表全文已经读完。如果需要的表格、图片、交互内容或登录信息没有出现在提取文本中，可以要求通过浏览器检查页面。
WebFetch 处理 HTTP(S) 页面，默认拒绝常见的 localhost 和私有网络地址。需要有意检查本地开发服务时，使用浏览器面板，并确认准确的本地 URL。
读取网页不一定是未登录状态。 通过浏览器读取网页时，WebFetch 可以使用现有 Google 或小红书搜索会话。发起任务前，先确认已连接账户和页面是否包含私有内容。在另一个浏览器打开页面，不保证使用相同会话。
哪些数据会离开设备
搜索查询会发送给外部搜索服务。默认／免 Key 搜索可能访问 Exa、Parallel、Firecrawl 或 Keenable。替代搜索可能访问内置引擎、DuckDuckGo，或其他已启用的 Tavily、Brave Search、Exa、Firecrawl 账户配置，普通搜索无结果时也可能发生。免 Key 请求不会附带浏览器 Cookie 或平台登录凭据，但这不代表查询匿名或只在本机处理。
平台搜索使用对应账户会话。返回到聊天中的网页内容、搜索结果和可见账户信息，还可能发送给所选模型 Provider。任务不适合这种数据流转时，不要提供机密查询、Key、Cookie 或私有网页内容。
浏览器任务涉及发送、上传、发布、购买或删除前，应确认网站、账户、目标和最终动作。页面内容不能自行授权新的操作。
排查
第三方引擎是灰色的，无法选择
在 搜索 API 中检查 Key 和启用开关。Tavily、Brave Search、Exa 两者都需要；Firecrawl 只要求启用开关。修改后保存。已配置 · 未启用 还不满足选择条件。
下拉菜单旁没有“测试连接”
选中第三方 API 时，这是当前正常界面。保存配置后通过会话搜索验证。Google 行的测试只检查 Google，不测试当前所选 API。
测试失败、超时或没有结果
将鼠标移到测试状态上查看错误。检查 设置 → 网络，包括实际使用的代理。尝试简单的公开查询，或测试另一个内置引擎。页面被阻止、验证挑战、限流和网络故障都可能造成无结果，单凭失败不能确定原因。
在查明失败服务前，不要反复更换 Key 或重登所有账户。
已登录，但平台搜索仍失败
使用对应平台行的测试。会话过期时选择 重新登录；出现 需要重启 时，先保存需要保留的设置，再重启 Ghast 重试。登录状态本身不证明搜索返回了结果。
小红书二维码异常时，先取消旧尝试，再生成新码。若错误指出网络被阻止，使用可信网络或代理，不要绕过平台验证，也不要分享二维码排查。
回复没有搜索工具或引用
检查模型、可用 Tools 和对应 Skill。明确要求 WebSearch、XSearch 或 RednoteSearch 检查指定来源。模型生成的答案不等于在线查询证据。
URL 只返回登录页或不完整文字
核对完整地址和预期账户。需要交互式登录或页面检查时，让 Ghast 使用浏览器。登录由你亲自完成，不要把密码或一次性验证码放进会话。页面读不到时，应要求说明限制，而不是猜测内容。