概览
dsh-deepseek-search
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
这个插件不是“比官方搜索更强”的承诺,而是在官方搜索之外多给一套可调、可省 token、可多源交叉的方案。下面是明确的取舍。 | 限制 | 影响 | 插件里的应对 | |---|---|---| | 免费引擎靠 HTML 解析 | 搜索引擎改版、反爬、验证码会让结果变少或为空 | 多引擎并行、单引擎失败隔离、结果缓存;设置页显示“最近错误”;可切到 Tavily/Exa 等 API 引擎 | | 百度在无 Cookie 时结果少 | 中文结果覆盖不如预期 | 同时启用必应/搜狗/360;需要更稳时加 API 引擎 | | 搜狗/360 有跳转壳 | 不能直接拿到真实域名 | 自动解析 `/link` 跳转;解析失败的结果丢弃,避免返回垃圾链接 | | 查询会发给第三方 | 隐私边界从“只到 DeepSeek”变成“到多个搜索引擎” | 每个引擎可单独关闭;Key 只存本机;设置页明确数据流向;不想外发时只用官方提供方 | | 某些引擎在当前网络不可达 | DuckDuckGo/Google/Brave/SearXNG 可能超时 | 默认只开国内四引擎;直连失败时自动回退到 `ctx.web.fetch()`(可复用 DSH 代理);API 引擎 POST 不走该回退 | | 长文会占用上下文 | 多页正文可能很长 | `includeContent:false` 摘要模式、`maxPages`、每页字符上限、总输出上限;页面默认截断 | | 不支持 PDF/Office/音视频 | 这些链接会明确失败 | 用 `web_fetch` 打开可读页面;配置 `readerBaseURL` 走第三方阅读器;或换来源 | | 没有内部 LLM 总结 | `web_research` 只做检索和正文拼接,不做二次生成 | 主模型直接阅读带出处的资料;需要更短时用摘要模式;不额外消耗一次模型调用 | | 补丁会替换 `web` 配置 | 漏写 `fetchProvider` 会导致抓取提供方歧义 | `cordis.patch.yml` 同时固定 `searchProvider: deepseek-search` 和 `fetchProvider: http`;故障排查里有说明 | | 通过 `link:` 安装 | 移动/删除插件文件夹会让链接失效 | 安装脚本使用绝对路径;移动后重新执行安装;README 已注明 | | API Key 存在本机 JSON | 本机文件被读取时可能泄露 | 尽力设为 0600;优先用环境变量;设置页只显示后四位;不写入日志/工具输出 | **不是替代关系**:原生 `web_fetch` 仍然保留,`web_research`/`web_collect` 也复用它的安全抓取;如果只需要官方搜索,把 `web.searchProvider` 切回 `deepseek-official` 或卸载插件即可。 ---
