first commit

autonomous-ai-agents/hermes-agent/references/web-search-from-server.md

@@ -0,0 +1,51 @@
+# 服务器环境网络搜索指南
+
+## Playwright 浏览器启动（服务器/容器环境）
+
+服务器环境（Ubuntu 23.10+、容器、VM）需要 `--no-sandbox` 参数：
+
+```python
+from playwright.sync_api import sync_playwright
+
+with sync_playwright() as p:
+    browser = p.chromium.launch(
+        headless=True, 
+        args=['--no-sandbox', '--disable-setuid-sandbox']
+    )
+    page = browser.new_page()
+    page.goto('https://example.com', timeout=30000)
+    # ... 操作页面
+    browser.close()
+```
+
+注意：Hermes 内置的 `browser_navigate` 工具不支持传递启动参数，必须直接用 Playwright API。
+
+## 搜索引擎反爬情况（2026年测试）
+
+| 搜索引擎 | 状态 | 备注 |
+|----------|------|------|
+| 百度 | ❌ 验证码 | 滑块验证，无法绕过 |
+| 搜狗 | ❌ 验证码 | 图片点选验证 |
+| 必应(cn.bing.com) | ⚠️ 可用但质量差 | 中文搜索结果常偏离关键词 |
+| Google | ❌ 超时 | 服务器网络不可达 |
+| DuckDuckGo | ❌ 超时 | 服务器网络不可达 |
+
+**结论**：服务器环境下，主流搜索引擎基本不可用。必应是唯一能返回结果的，但质量不稳定。
+
+## mmx search 限制
+
+`mmx search` 需要 Token Plan 支持 `coding-plan-search` 模型。如果报错：
+```
+your current token plan not support model, coding-plan-search
+```
+说明当前计划不支持搜索功能，需要升级或使用其他方式。
+
+## MiMo 模型搜索能力
+
+MiMo (mimo-v2.5-pro) 可以声明 `web_search` 工具调用，但**实际上不会真正联网搜索**。它只能基于训练数据回答，无法获取实时信息。
+
+## 替代方案优先级
+
+1. Playwright + 必应（唯一可行的浏览器方案）
+2. 直接访问目标网站（如培训机构官网）
+3. 用户自行搜索后提供信息