docs: update all remaining files for v1.4.0 upstream migrations

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

agent_reach/guides/setup-xiaohongshu.md

@@ -1,51 +1,36 @@
 # 小红书配置指南
 
 ## 功能说明
-读取和搜索小红书笔记。通过 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) 实现（⭐9K+，Go 语言，内置 Chrome 浏览器）。
+读取和搜索小红书笔记。通过 [xhs-cli](https://github.com/jackwener/xiaohongshu-cli)（⭐1.5K，pipx 一行安装）实现。
 
 ## 前置条件
-- Docker（用来运行 xiaohongshu-mcp 服务）
-- mcporter CLI（MCP 协议桥接工具）
+- Python 3.10+（pipx 安装）
+- 浏览器已登录 xiaohongshu.com（用于导出 Cookie）
 
 ## Agent 可自动完成的步骤
 
-### 1. 安装 mcporter
+### 1. 安装 xhs-cli
 ```bash
-npm install -g mcporter
+pipx install xiaohongshu-cli
 ```
 
-### 2. 启动 xiaohongshu-mcp 服务
+### 2. 登录（从浏览器提取 Cookie）
 ```bash
-docker run -d \
-  --name xiaohongshu-mcp \
-  -p 18060:18060 \
-  xpzouying/xiaohongshu-mcp
+xhs login
 ```
 
-> 如需代理（服务器部署推荐）：
-> ```bash
-> docker run -d \
->   --name xiaohongshu-mcp \
->   -p 18060:18060 \
->   -e XHS_PROXY=http://user:pass@ip:port \
->   xpzouying/xiaohongshu-mcp
-> ```
+> 这会自动从浏览器提取 Cookie。如果自动提取失败，可以手动导入（见下方）。
 
-### 3. 注册到 mcporter
-```bash
-mcporter config add xiaohongshu http://localhost:18060/mcp
-```
-
-### 4. 验证
+### 3. 验证
 ```bash
 agent-reach doctor
 ```
 
-应该看到小红书显示为 ✅ 或 ⚠️（MCP 已连接但未登录）。
+应该看到小红书显示为 ✅。
 
 ## 需要用户手动做的步骤
 
-如果 doctor 显示"MCP 已连接但未登录"，需要导入 cookies：
+如果 `xhs login` 自动提取失败，需要手动导入 cookies：
 
 > **推荐方式：Cookie-Editor 浏览器导出（最可靠）**
 >
@@ -54,43 +39,47 @@ agent-reach doctor
 > 3. 点击 Cookie-Editor 图标 → Export → Header String
 > 4. 把导出的字符串发给 Agent，运行：`agent-reach configure xhs-cookies "导出的cookie字符串"`
 >
-> **注意**：`http://localhost:18060` 根路径可能返回 404，这是正常的——MCP 服务在 `/mcp` 路径。
-> 不要依赖 QR 扫码登录，Docker 容器内的 QR 登录页面不一定可用，且 cookies 不会自动共享到 MCP 服务。
+> **注意**：不要依赖 QR 扫码登录，Cookie-Editor 导出方式最简单可靠。
+
+## 使用示例
+
+搜索笔记：
+```bash
+xhs search "关键词"
+```
+
+阅读笔记详情：
+```bash
+xhs read NOTE_ID
+```
+
+查看评论：
+```bash
+xhs comments NOTE_ID
+```
 
 ## 常见问题
 
-**Q: Docker 容器重启后 cookie 丢了？**
-A: 挂载数据卷持久化：
+**Q: Cookie 过期了？**
+A: 重新运行 `xhs login` 或通过 Cookie-Editor 重新导出。
+
+**Q: 小红书提示 IP 风险？**
+A: 推荐使用住宅代理：`export HTTP_PROXY="http://user:pass@ip:port"`。
+
+**Q: xhs-cli 不支持我的系统？**
+A: 确保 Python 3.10+ 和 pipx 已安装。运行 `pipx install xiaohongshu-cli` 即可。
+
+## 备选方案：Docker MCP
+
+如果你已经在使用 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) Docker 方案，它也能正常工作：
+
 ```bash
 docker run -d \
   --name xiaohongshu-mcp \
   -p 18060:18060 \
-  -v xhs-data:/app/data \
   xpzouying/xiaohongshu-mcp
+
+mcporter config add xiaohongshu http://localhost:18060/mcp
 ```
 
-**Q: 服务器上小红书提示 IP 风险？**
-A: 加代理参数 `-e XHS_PROXY=http://user:pass@ip:port`，推荐住宅代理。
-
-**Q: Docker 镜像不支持 ARM64 / Apple Silicon？**
-A: 上游镜像暂无 ARM64 版本，两种解决办法：
-
-方法一：使用 Rosetta 模拟运行（推荐，最简单）
-```bash
-docker run -d \
-  --name xiaohongshu-mcp \
-  -p 18060:18060 \
-  --platform linux/amd64 \
-  xpzouying/xiaohongshu-mcp
-```
-
-方法二：从源码编译原生 ARM64 版本
-```bash
-git clone https://github.com/xpzouying/xiaohongshu-mcp
-cd xiaohongshu-mcp
-docker build -t xiaohongshu-mcp .
-docker run -d --name xiaohongshu-mcp -p 18060:18060 xiaohongshu-mcp
-```
-
-**Q: 我不想用 Docker？**
-A: 可以从源码编译：https://github.com/xpzouying/xiaohongshu-mcp
+xhs-cli 是当前推荐方案，不需要 Docker，安装更简单。