角色联网搜索：工具模式与预请求 Agent 模式
什么时候需要它
剧情写到主角要查一桩旧案、考据某个传说的出处、核对设定细节——纯靠模型记忆会编。搜索插件给角色接上真搜索引擎，查到的是实时网络资料，不是训练数据的模糊回忆。
两种工作模式
工具模式
搜索注册为写作模型的可调用工具。模型写到需要资料的地方，自己决定发起搜索、读结果、再继续写。灵活，但依赖模型自己的判断。
预请求 Agent 模式
正文生成之前，先跑一个独立的搜索 Agent：分析当前对话、判断要不要查、把结果整理成世界书条目写进专用的共享世界书。后续回合里这些条目按关键词正常注入——搜一次，全程可引用。
| 模式 | 谁决定搜 | 结果去哪 | 适合 |
|---|---|---|---|
| 工具模式 | 写作模型 | 直接进当前回合上下文 | 随用随查 |
| 预请求 Agent | 独立搜索 Agent | 固化为世界书条目 | 考据类长线剧情 |
两种可同时开，按剧情阶段切换。
支持的搜索引擎
默认 DuckDuckGo（无需登录），开箱即用。可换的还有：自托管的 SearXNG、Brave、Tavily、Exa、Serper、SerpApi、Z.AI 等——部分需要各自的 API Key。安全搜索选项对主流引擎生效。
配置与维护要点
- 搜索引擎在扩展面板「搜索工具」子项里配置，各引擎独立设置
- 预请求模式下，结果条目的关键词与激活方式会按信息性质自动设置，也可以自己调
- 消息被删除或编辑时，插件会自动维护内部状态一致；同回合内重复请求有结果复用，不重复烧搜索
- 误删条目有撤销提示
和其他功能的联动
- CardApp Studio——AI 开发卡内应用时可现查 API 文档，见CardApp 与 Studio
- 导演模式——默认 Director 预设自带搜索开关，见导演模式详解
- 记忆图——搜来的设定进世界书，剧情事实进记忆图，两层互不干扰