# MiMo Web Search Plugin for Hermes Agent

将小米 MiMo 的**联网搜索**（server-side web search）接入 Hermes Agent 的 `web_search` 工具。

MiMo 在服务端执行搜索、浏览网页、提取内容，通过 Chat Completions API 的 `url_citation` 注释返回结构化结果。适合中文搜索场景。

## 工作原理

```
Hermes web_search 工具
    ↓
MiMoWebSearchProvider.search(query, limit)
    ↓
POST {base_url}/chat/completions
    tools: [{type: "web_search", force_search: true, ...}]
    ↓
MiMo 服务端搜索 → 返回 annotations: [{type: "url_citation", ...}]
    ↓
解析为 Hermes 标准格式: {title, url, description, position}
```

## 可选配置

在 Hermes 的 `config.yaml` 的 `web.mimo` 下可调整：

```yaml
web:
  search_backend: "mimo"
  mimo:
    model: "mimo-v2.5"       # 可选: mimo-v2.5-pro, mimo-v2.5, mimo-v2-flash 等
    max_keyword: 3            # 每轮搜索最大关键词数（影响调用次数和费用）
    timeout: 30               # 请求超时秒数
```

## 计费

- **联网搜索工具**：国内 ¥16/1000 次，海外 $5/1000 次
- **Token 消耗**：搜索结果拼入 prompt，按模型输入 token 标准价计费
- 每轮搜索可能触发 `max_keyword` 个关键词，每个关键词算一次调用

## API 参考

- [MiMo 联网搜索文档](https://mimo.mi.com/docs/zh-CN/guides/text-generation/web-search)
- [MiMo 平台](https://platform.xiaomimimo.com)
- [Hermes Web Search Provider 插件开发指南](https://hermes-agent.nousresearch.com/docs/developer-guide/web-search-provider-plugin)

## 文件说明

```
mimo-websearch-for-hermes/
├── README.md          # 本文档（介绍）
├── INSTALL.md         # 安装说明（给 Agent 看）
├── plugin.yaml        # Hermes 插件清单
├── setup.sh           # 安装/卸载脚本（仅供参考）
├── __init__.py        # 插件注册入口
├── provider.py        # WebSearchProvider 实现
└── test_search.py     # 独立测试脚本（可脱离 Hermes 使用）
```