dsh-ollama-web-search
让 dsh 的 web_search 工具直连 Ollama 云搜索服务（ollama.com/api/web_search），替代 DeepSeek 官方搜索。
无需本地 Ollama、无需模型中间件，零模型开销——web_search 调用一次 HTTP 直接拿结果。
dsh 版本兼容性
要求 dsh ≥ 0.1.7-rc.1（已在 0.1.7-rc.1 实测通过）。
ctx.settings.register() 已移除（2026-09-24）：0.1.7 起配置不再经 settings namespace，Config 字段改标 .volatile()，直接以 config.<field>.get() 读取 —— loader 提交变更时写进运行中的引用对象，.get() 立即返回新值，无需 watch()、无需 ctx.inject(["settings"])。
背景
dsh 自带的 web_search 工具默认走 deepseek-official provider（DeepSeek 的 Anthropic 兼容 Messages API + web_search_20250305 服务端工具），需要 DeepSeek API key。
ollama launch dsh 官方集成 的做法是：本地 Ollama 当代理（模型生成查询词 → 中间件调 ollama.com/api/web_search → 模型总结 → 包装成 Anthropic web_search_tool_result）。这个方案：
- 需要安装并常驻本地 Ollama
- 每次搜索要 2 次模型推理（生成查询词 + 总结结果）
- 模型与搜索强耦合
本插件直连同一个搜索后端（ollama.com/api/web_search），去掉代理层与模型开销。
原理
web_search 工具 → ctx.web.search() → 按 searchProvider 配置选 provider
→ ollama-web-search provider
→ POST https://ollama.com/api/web_search {query, max_results}
→ {results: [{title, url, content}]}
→ 转成 dsh 的 sources 格式 [{url, title, snippet}] 返回给模型
认证用 OLLAMA_API_KEY（Bearer），不需要 Ollama 官方集成用的签名机制。
安装
dsh plugin --profile web add dsh-ollama-web-search@latest
或从源码：
git clone https://github.com/fatatalia/dsh-ollama-web-search
cd dsh-ollama-web-search
dsh plugin --profile web add .
装完重启 dsh web 生效。插件会：
- 注册
ollama-web-search 搜索 provider
- 把
web 服务的 searchProvider 切到 ollama-web-search
配置
凭据：~/.dsh/.credentials.yaml 或环境变量 OLLAMA_API_KEY（与 ollama 模型 provider 共用）。
可选的 settings 段（~/.dsh/settings.yaml）：
ollama-web-search:
apiKeyEnv: OLLAMA_API_KEY # 凭据引用
baseURL: https://ollama.com/api/web_search # 搜索端点
maxResults: 5 # 默认返回结果数上限
验证
装好后调用 web_search 工具即可：
web_search("DeepSeek 最新动态") → 返回多条来源（title/url/snippet）
也可直接 curl 验证端点：
curl -s -X POST https://ollama.com/api/web_search \
-H "Authorization: Bearer $OLLAMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"test","max_results":3}'
与 DeepSeek 官方搜索的差异
| 本插件 | DeepSeek 官方（deepseek-official） |
|---|
| 搜索后端 | ollama.com 云 | api.deepseek.com |
| 认证 | OLLAMA_API_KEY | DEEPSEEK_API_KEY |
| 模型调用 | 无（直出结果） | 1 次模型 turn（服务端搜索） |
| 依赖 | 无 | DeepSeek API |
许可
MIT
