✨ 核心特性

• 🐋 开箱即用，免 Key 起步：无需繁琐申请 API Key，安装默认选用 Exa 免 Key 检索，同时内置 Firecrawl、Tavily 与 Tinyfish，安装即刻体验联网搜索。
• 🔀 搜索与聊天自由解耦：模型聊天与联网搜索互不干扰！无论你当前在与 Claude、GPT 还是本地模型对话，都可以随时为当前会话指定最擅长该领域的搜索引擎。
• 💬 会话级记忆与独立分支：每段对话都会记住各自选用的搜索服务与实时性偏好；Fork 分支对话互不冲突，各自独立调整。
• ⚡ 内容实时性自由掌控：在输入区一键切换「自动 / 优先新鲜 / 优先实时」，随心平衡网页检索速度与最新内容抓取。
• 🔐 安全优雅的凭据隔离：深度接入 DSH 原生 Credentials 体系，敏感 API Key 安全留存于凭据管理器中，绝不污染项目配置文件。
• 🎨 无缝融入原生界面：聊天输入框随手弹出的快捷切换胶囊 + 直观清爽的插件设置面板，自适应浅色/深色主题与移动端窄屏。

📸 界面预览

💬 会话快捷选择器（在聊天框随手切换）

在输入框工具栏轻轻一点，即可随时为当前会话切换搜索引擎与内容实时性，无需跳转设置，不打断对话灵感。

_{切换视图：桌面浅色（上图） · 桌面深色 · 移动窄屏}

⚙️ 统一插件设置中心

集中管理默认连接、免 Key / 个人 Key 访问模式、凭据引用与自定义模型端点。

_{切换视图：桌面浅色（上图） · 桌面深色 · 移动窄屏}

🚀 快速上手

环境要求

• DeepSeek Harness：≥ 0.2.0-rc.2
• Node.js：^22.19.0 || >=24.0.0

本版沿用 DSH 0.2.0-rc.2 基线，完善配置版本判定与逐版本自动迁移；现有 V2 配置和会话存储格式不变，显式 V1 与无版本旧模型配置可自动升级。详见配置版本设计。跟随模型仍要求 API Key；使用 pi-ai 内置 DeepSeek 目录时，请重新选择 deepseek-flash 并检查旧模型 overrides，本插件不会自动改名。详见0.2.0-rc.2 影响评估。升级前请备份 profile 和旧设置。

步骤 1：安装插件

方式 A：通过 GitHub Release 离线包安装（推荐）

当前版本为 0.1.7，最低支持 DSH 0.2.0-rc.2。发布后可从 Releases 下载对应版本安装包及 SHA256 校验文件；也可执行 pnpm install --frozen-lockfile && pnpm run check && pnpm pack 自行构建。使用绝对路径安装：

dsh plugin --profile web add /path/to/dsh-web-search-enhanced-0.1.7.tgz

方式 B：通过 npm 在线安装

该版本发布到 npm 后，也可直接安装：

dsh plugin --profile web add dsh-web-search-enhanced@0.1.7

已安装旧版时，DSH rc.2 不支持直接自动升级：先备份配置和存储，再通过插件管理器移除旧版并安装 0.1.7，核对 profile 补丁与会话选择。Desktop profile 需先启动过一次桌面端。完整步骤见升级指南。

步骤 2：生效与刷新

1. 重载插件或重启 DSH 服务端。
2. 刷新浏览器 Web 页面，确保前端客户端组件与后端服务同步更新。

步骤 3：立即提问体验

新建一段会话，输入框上方默认已为你准备好 Exa · 免 Key 搜索连接。直接向 AI 提问：

💡 提问示例：“搜索最近的 TypeScript 发布说明，总结最重要的几个变化并附上引用来源。”

AI 会自动通过 Web Search Enhanced 检索最新网络资料，并附带网页来源回答你！

🔍 选哪种搜索服务？

Web Search Enhanced 内置了多种主流检索服务与模型搜索能力，你可以按需随心选择：

💡 关于免 Key 访问： 免 Key 模式走的是上游提供的公共接入通道，省去了新用户申请注册 API Key 的繁琐步骤。 公共通道可能因高峰期并发或网络 IP 受限；如遇限流，可以在输入框临时切换到其他免 Key 连接（如 Tavily / Firecrawl），或者在设置中配置自己的专属 API Key。

⏱️ 内容实时性说明

在聊天输入框的搜索菜单中，你可以为当前会话设置内容实时性：

• 自动 (Auto)：采用搜索引擎默认的缓存与检索策略，响应快速。
• 优先新鲜 (Fresh)：优先使用不超过 24 小时的较新网页缓存（Firecrawl / Exa 个人 Key 支持）。
• 优先实时 (Realtime)：发起重新爬取，获取页面当前时刻的最新内容（适合突发新闻、最新行情等时效极高的场景）。

注：实时抓取可能会稍微增加检索耗时与额度消耗；对于不支持实时性控制的连接，系统会自动保留偏好并优雅回退至默认检索。

⚙️ 进阶配置与个人 Key

如果你拥有各平台专属的 API Key，或想要自定义专用搜索模型，只需打开 设置 → 插件 → Web Search Enhanced：

1. 绑定个人 API Key：
   • 找到目标连接（例如 Firecrawl 或 Tavily）。
   • 点击目标连接行上的“配置 Key”，在行内展开的输入框中填写 API Key 并保存（将自动存入 DSH Credentials，安全可靠）。
   • 将“访问方式”从“免 Key”切换为“个人 Key”。OpenAlex 的个人 Key 会按官方要求通过 api_key 查询参数发送。
2. 配置 OpenAlex 礼貌邮箱（可选）：
   • 在 OpenAlex 连接行点击“礼貌邮箱”，行内填写联系邮箱；清空后保存即可恢复默认公共标识。
3. 设置新会话默认连接：
   • 在“新会话默认连接”下拉框中选择你最常用的引擎，新创建的对话将自动应用该偏好。
4. 添加自定义模型或端点：
   • 支持添加任意兼容 OpenAI 或 Anthropic 服务端搜索协议的模型端点。

完整配置语法与高级参数白名单，请参阅 📖 详细配置指南。

❓ 常见问题 (FAQ)

📖 想了解更多？

💬 问题反馈

如果在使用过程中遇到问题，欢迎前往 GitHub Issues 提交反馈。
提示：提 issue 时请附上 DSH 版本、插件版本及报错简述，并请注意脱敏，切勿粘贴个人 API Key 或私密对话内容。

🤝 致谢与许可

• 本项目代码遵循 MIT 开源协议。
• 衷心感谢 DeepSeek Harness 团队及各搜索服务（Exa、Firecrawl、Tavily、Tinyfish 等）的开发者。
• 关于横幅形象：Banner 中的 DeepSeek 鲸鱼娘形象来源于 上善无形原创角色与 ZipZipPipe 二创；本项目横幅基于用户提供的参考图经 AI 辅助创作。角色与参考作品的著作权利均归原作者所有，不因本项目代码的 MIT 许可而获得再授权，亦不代表官方背书。