docs(readme): full-pass audit — purge pre-v1.5 worldview from both READMEs

Two factual errors and a batch of stale-world copy found by auditing the full README against v1.5.0 reality: - "what install does" claimed twitter-cli/rdt-cli are installed by default — they never are (opt-in via --channels); now describes the real flow incl. the channel menu step - zero-config examples listed "read a tweet" — Twitter is tier 1, not zero-config; list now shows truly free channels (incl. bili search) - FAQ rewrites: xiaohongshu (OpenCLI-first, mcp for servers, xhs-cli as legacy fallback), Reddit (login mandatory, OpenCLI first, pinned rdt source), free-cost answer (tool list updated, proxy rescoped to restricted networks) - platform table stops advertising write ops (发推/Post·Comment·Like) — aligned with the skill's fetch-only boundary - bilibili pain-point line updated to the 412 reality - credits gain OpenCLI and xiaohongshu-mcp - README_en: same FAQ/table/doctor-sample fixes Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
docs(review): round-3 nits — last copy inconsistencies from Codex review
2026-06-11 20:23:00 +08:00 · 2026-06-11 18:09:38 +08:00 · 2026-06-11 18:01:47 +08:00 · 2026-06-11 17:53:37 +08:00 · 2026-06-11 17:14:57 +08:00 · 2026-06-11 16:30:56 +08:00
22 changed files with 897 additions and 621 deletions
@@ -3,7 +3,7 @@
 ## Project
 Agent Reach — Python CLI + library that gives AI agents read/search access to 13 internet platforms.
 Positioning: installer + doctor + config tool. NOT a wrapper — after install, agents call upstream tools directly.
-Repo: github.com/Panniantong/Agent-Reach | License: MIT | Version: 1.4.2
+Repo: github.com/Panniantong/Agent-Reach | License: MIT | Version: 1.5.0
 ## Commands
 - `pip install -e .` — Dev install
@@ -4,6 +4,10 @@
  <strong>给你的 AI Agent 一键装上互联网能力</strong>
 </p>
 <p align="center">
  当下最稳的接入方式，替你选好、装好、体检好——接入方式会换代，你不用操心
 </p>
 <p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.10+-green.svg?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.10+"></a>
@@ -24,7 +28,7 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去
 - 🐦 "帮我搜一下推特上大家怎么评价这个产品" → **搜不了**，Twitter API 要付费
 - 📖 "去 Reddit 上看看有没有人遇到过同样的 bug" → **403 被封**，服务器 IP 被拒
 - 📕 "帮我看看小红书上这个品的口碑" → **打不开**，必须登录才能看
- 📺 "B站上有个技术视频，帮我总结一下" → **连不上**，海外/服务器 IP 被屏蔽
+- 📺 "B站上有个技术视频，帮我总结一下" → **拿不到**，通用下载工具被 B站风控全面拦截
 - 🔍 "帮我在网上搜一下最新的 LLM 框架对比" → **没有好用的搜索**，要么付费要么质量差
 - 🌐 "帮我看看这个网页写了啥" → **抓回来一堆 HTML 标签**，根本没法读
 - 📦 "这个 GitHub 仓库是干嘛的？Issue 里说了什么？" → 能用，但认证配置很麻烦
@@ -56,7 +60,7 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去
 |---|---|
 | 💰 **完全免费** | 所有工具开源、所有 API 免费。唯一可能花钱的是服务器代理（$1/月），本地电脑不需要 |
 | 🔒 **隐私安全** | Cookie 只存在你本地，不上传不外传。代码完全开源，随时可审查 |
-| 🔄 **持续更新** | 底层工具（yt-dlp、twitter-cli、rdt-cli、Jina Reader 等）定期追踪更新到最新版，你不用自己盯 |
+| 🔄 **持续换代** | 每个平台都是「首选 + 备选」多后端路由。某个接入方式失效了，我们换下一个，你无感（2026-06 实例：yt-dlp 被 B站风控封死 → 已切换 bili-cli，用户零操作） |
 | 🤖 **兼容所有 Agent** | Claude Code、OpenClaw、Cursor、Windsurf……任何能跑命令行的 Agent 都能用 |
 | 🩺 **自带诊断** | `agent-reach doctor` 一条命令告诉你哪个通、哪个不通、怎么修 |
@@ -71,10 +75,10 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去
 | 📡 **RSS** | 阅读任意 RSS/Atom 源 | — | 无需配置 |
 | 🔍 **全网搜索** | — | 全网语义搜索 | 自动配置（MCP 接入，免费无需 Key） |
 | 📦 **GitHub** | 读公开仓库 + 搜索 | 私有仓库、提 Issue/PR、Fork | 告诉 Agent「帮我登录 GitHub」 |
-| 🐦 **Twitter/X** | 读单条推文 | 搜索推文、浏览时间线、发推 | 告诉 Agent「帮我配 Twitter」 |
+| 🐦 **Twitter/X** | 读单条推文 | 搜索推文、浏览时间线、读长文 | 告诉 Agent「帮我配 Twitter」 |
-| 📺 **B站** | 本地：字幕提取 + 搜索 | 服务器也能用 | 告诉 Agent「帮我配代理」 |
+| 📺 **B站** | 搜索 + 视频详情（bili-cli，无需登录） | 字幕（OpenCLI） | 告诉 Agent「帮我配 B站」 |
-| 📖 **Reddit** | 搜索 + 读帖子和评论（通过 rdt-cli） | Cookie | 需要登录认证（`rdt login`），详见 [rdt-cli](https://github.com/public-clis/rdt-cli) |
+| 📖 **Reddit** | —（没有零配置路径：匿名接口已被封） | 搜索 + 读帖子和评论 | 桌面装 OpenCLI 用浏览器登录态；或 rdt-cli + Cookie |
-| 📕 **小红书** | — | 阅读、搜索、发帖、评论、点赞 | 告诉 Agent「帮我配小红书」 |
+| 📕 **小红书** | — | 搜索、阅读、评论 | 桌面装 OpenCLI（刷过小红书即可用）；服务器用 xiaohongshu-mcp 扫码 |
 | 💼 **LinkedIn** | Jina Reader 读公开页面 | Profile 详情、公司页面、职位搜索 | 告诉 Agent「帮我配 LinkedIn」 |
 | 💻 **V2EX** | 热门帖子、节点帖子、帖子详情+回复、用户信息 | — | 无需配置 |
 | 📈 **雪球** | 股票行情、搜索股票、热门帖子、热门股票排行 | — | 告诉 Agent「帮我配雪球」 |
@@ -123,13 +127,14 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去
 <details>
 <summary>它会做什么？（点击展开）</summary>
-1. **安装 CLI 工具** — `pip install` 装好 `agent-reach` 命令行
+1. **安装 CLI 工具** — `pip install` 装好 `agent-reach` 命令行（自带 yt-dlp、feedparser）
-2. **安装系统依赖** — 自动检测并安装 Node.js、gh CLI、mcporter、twitter-cli、rdt-cli 等
+2. **安装系统基建** — 自动检测并安装 Node.js、gh CLI、mcporter
 3. **配置搜索引擎** — 通过 MCP 接入 Exa（免费，无需 API Key）
 4. **检测环境** — 判断是本地电脑还是服务器，给出对应的配置建议
-5. **注册 SKILL.md** — 在 Agent 的 skills 目录安装使用指南，以后 Agent 遇到"搜推特"、"看视频"这类需求，会自动知道该调哪个上游工具
+5. **注册 SKILL.md** — 在 Agent 的 skills 目录安装使用指南，以后 Agent 遇到"全网调研"、"搜推特"、"看视频"这类需求，会自动知道该调哪个上游工具
 6. **问你要不要更多** — 默认只激活 6 个零配置渠道；小红书、Twitter、Reddit 这些需要登录的，Agent 会列菜单问你要哪些，点名才装
-安装完之后，`agent-reach doctor` 一条命令告诉你每个渠道的状态。
+安装完之后，`agent-reach doctor` 一条命令告诉你每个渠道的状态、当前走哪条路。
 </details>
 ---
@@ -140,62 +145,60 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去
 - "帮我看看这个链接" → `curl https://r.jina.ai/URL` 读任意网页
 - "这个 GitHub 仓库是做什么的" → `gh repo view owner/repo`
- "这个视频讲了什么" → `yt-dlp --dump-json URL` 提取字幕
+- "这个 YouTube 视频讲了什么" → `yt-dlp` 提取字幕
- "帮我看看这条推文" → `twitter tweet URL`
+- "B站搜一下 AI 教程" → `bili search`（无需登录）
 - "全网搜一下 LLM 框架对比" → Exa 语义搜索
 - "订阅这个 RSS" → `feedparser` 解析
 - "搜一下 GitHub 上有什么 LLM 框架" → `gh search repos "LLM framework"`
-**不需要记命令。** Agent 读了 SKILL.md 之后自己知道该调什么。
+**不需要记命令。** Agent 读了 SKILL.md 之后自己知道该调什么。需要登录的平台（小红书、Twitter、Reddit），告诉 Agent「帮我配 XXX」即可解锁。
 ---
 ## 设计理念
-**Agent Reach 是一个脚手架（scaffolding），不是框架。**
+**Agent Reach 是一个能力层（capability layer），不是又一个工具。**
-你给一个新 Agent 装环境的时候，总要花时间去找工具、装依赖、调配置——Twitter 用什么读？Reddit 怎么绕封？YouTube 字幕怎么提取？每次都要重新踩一遍。
+它比任何具体实现高一层——负责**选型、安装、体检、路由**，不负责底层读取本身。读取由 Agent 直接调用上游工具完成，没有包装层。
-Agent Reach 做的事情很简单：**帮你把这些选型和配置的活儿做完了。**
+你给一个新 Agent 装环境的时候，总要花时间去找工具、装依赖、调配置——Twitter 用什么读？Reddit 怎么登录？小红书的 CLI 停更了换什么？每次都要重新踩一遍。Agent Reach 做的事情很简单：**当下最稳的接入方式，我们替你选好、装好、体检好。接入方式会换代（2026 年 3 月一批单平台 CLI 集体停更，我们换了路由），你不用操心。**
-安装完成后，Agent 直接调用上游工具（twitter-cli、rdt-cli、xhs-cli、yt-dlp、mcporter、gh CLI 等），不需要经过 Agent Reach 的包装层。
+### 🔌 每个平台 = 首选 + 备选的有序后端列表
-### 🔌 每个渠道都是可插拔的
+换接入方式 = 调整列表顺序，不是重写代码。`agent-reach doctor` 会告诉你每个平台**当前在用哪个后端**。
 每个平台背后是一个独立的上游工具。**不满意？换掉就行。**
 ```
 channels/
-├── web.py          → Jina Reader     ← 可以换成 Firecrawl、Crawl4AI……
+├── web.py          → Jina Reader
-├── twitter.py      → twitter-cli       ← 可以换成官方 API……
+├── twitter.py      → twitter-cli ▸ OpenCLI ▸ bird
-├── youtube.py      → yt-dlp          ← 可以换成 YouTube API、Whisper……
+├── youtube.py      → yt-dlp
-├── github.py       → gh CLI          ← 可以换成 REST API、PyGithub……
+├── github.py       → gh CLI
-├── bilibili.py     → yt-dlp          ← 可以换成 bilibili-api……
+├── bilibili.py     → bili-cli ▸ OpenCLI ▸ 搜索 API（yt-dlp 已被 B站风控封死，退役）
-├── reddit.py       → rdt-cli         ← 搜索+阅读，需 Cookie 认证
+├── reddit.py       → OpenCLI ▸ rdt-cli（无零配置路径，必须登录态）
-├── xiaohongshu.py  → mcporter MCP    ← 可以换成其他 XHS 工具……
+├── xiaohongshu.py  → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
-├── linkedin.py     → linkedin-mcp    ← 可以换成 LinkedIn API……
+├── linkedin.py     → linkedin-mcp ▸ Jina Reader
-├── rss.py          → feedparser      ← 可以换成 atoma……
+├── rss.py          → feedparser
-├── exa_search.py   → mcporter MCP    ← 可以换成 Tavily、SerpAPI……
+├── exa_search.py   → Exa via mcporter
 └── __init__.py     → 渠道注册（doctor 检测用）
 ```
-每个渠道文件只负责检测对应上游工具是否可用（`check()` 方法），给 `agent-reach doctor` 提供状态信息。实际的读取和搜索由 Agent 直接调用上游工具完成。
+每个渠道文件按序**真实探测**各候选后端（不只是看命令存不存在），第一个完整可用的当选；坏掉的会给出修复处方。实际的读取和搜索由 Agent 直接调用上游工具完成。
 ### 当前选型
-| 场景 | 选型 | 为什么选它 |
+| 场景 | 首选 | 备选 | 为什么这么选 |
-|------|------|-----------|
+|------|------|------|-----------|
-| 读网页 | [Jina Reader](https://github.com/jina-ai/reader) | 9.8K Star，免费，不需要 API Key |
+| 读网页 | [Jina Reader](https://github.com/jina-ai/reader) | — | 免费，不需要 API Key |
-| 读推特 | [twitter-cli](https://github.com/public-clis/twitter-cli) | 2.1K Star，Cookie 登录，搜索/读推文/时间线/长文 |
+| 读推特 | [twitter-cli](https://github.com/public-clis/twitter-cli) | [OpenCLI](https://github.com/jackwener/opencli) | 实测搜索稳定；OpenCLI 走浏览器登录态兜底 |
-| Reddit | [rdt-cli](https://github.com/public-clis/rdt-cli) | 304 Star，Cookie 认证，搜索+全文+评论 |
+| Reddit | [OpenCLI](https://github.com/jackwener/opencli)（桌面） | [rdt-cli](https://github.com/public-clis/rdt-cli) | 匿名接口已被封、官方 API 审批制——只剩登录态路线 |
-| 视频字幕 + 搜索 | [yt-dlp](https://github.com/yt-dlp/yt-dlp) | 154K Star，YouTube + B站 + 1800 站通吃 |
+| YouTube 字幕 + 搜索 | [yt-dlp](https://github.com/yt-dlp/yt-dlp) | — | 154K Star，YouTube 仍是最佳（注意：不再用于 B站） |
-| B站增强 | [bili-cli](https://github.com/public-clis/bilibili-cli) | 590 Star，热门/排行/搜索/动态 |
+| B站 | [bili-cli](https://github.com/public-clis/bilibili-cli) | OpenCLI ▸ 搜索 API | yt-dlp 被 B站风控 412 封死（2026-06 实测），bili-cli 无登录可搜可读 |
-| 搜全网 | [Exa](https://exa.ai) via [mcporter](https://github.com/nicobailon/mcporter) | AI 语义搜索，MCP 接入免 Key |
+| 搜全网 | [Exa](https://exa.ai) via [mcporter](https://github.com/nicobailon/mcporter) | — | AI 语义搜索，MCP 接入免 Key |
-| GitHub | [gh CLI](https://cli.github.com) | 官方工具，认证后完整 API 能力 |
+| GitHub | [gh CLI](https://cli.github.com) | — | 官方工具，认证后完整 API 能力 |
-| 读 RSS | [feedparser](https://github.com/kurtmckee/feedparser) | Python 生态标准选择，2.3K Star |
+| 读 RSS | [feedparser](https://github.com/kurtmckee/feedparser) | — | Python 生态标准选择 |
-| 小红书 | [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) | 1.5K Star，pipx 一行安装，搜索/阅读/评论/发帖 |
+| 小红书 | [OpenCLI](https://github.com/jackwener/opencli)（桌面） | [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)（服务器）▸ xhs-cli | xhs-cli 作者已转投 OpenCLI（24K Star）；浏览器登录态零摩擦 |
-| LinkedIn | [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server) | ⭐1.2K，MCP 服务，浏览器自动化 |
+| LinkedIn | [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server) | Jina Reader | MCP 服务，浏览器自动化 |
-> 📌 这些都是「当前选型」。不满意？换掉对应文件就行。这正是脚手架的意义。
+> 📌 这些都是「当前选型」，基于真机实测定期复核。某条路失效了我们换下一条——`agent-reach doctor` 永远告诉你现在走的是哪条。
 ---
@@ -290,7 +293,7 @@ Agent Reach uses twitter-cli with cookie auth — zero API fees. Install with `p
 <details>
 <summary><strong>Reddit 返回 403 怎么办？</strong></summary>
-Agent Reach 使用 [rdt-cli](https://github.com/public-clis/rdt-cli) 访问 Reddit。Reddit 自 2024 年起要求认证，安装后需运行 `rdt login` 登录。安装：`pipx install 'git+https://github.com/public-clis/rdt-cli.git'`（PyPI 版本暂时落后，从 GitHub 装），然后 `rdt login`（自动从浏览器提取 Cookie）。之后 Agent 可以用 `rdt search "关键词"` 搜索、`rdt read POST_ID` 读帖子全文和评论。
+Reddit 所有访问都需要登录态（匿名接口已被全面封锁，官方 API 需人工审批）。桌面首选 **OpenCLI**：浏览器里登录过 reddit.com 即可直接 `opencli reddit search "关键词"`。备选 [rdt-cli](https://github.com/public-clis/rdt-cli)：`pipx install 'git+https://github.com/public-clis/rdt-cli.git@5e4fb3720d5c174e976cd425ccc3b879d52cac66'`（与代码同一钉定版本，PyPI 落后），然后 `rdt login`。中国大陆网络访问 Reddit 需要代理。
 </details>
 <details>
@@ -302,7 +305,7 @@ Agent Reach 使用 [rdt-cli](https://github.com/public-clis/rdt-cli) 访问 Redd
 <details>
 <summary><strong>怎么让 AI Agent 读小红书？</strong></summary>
-安装 `pipx install xiaohongshu-cli`，然后 `xhs login`（自动从浏览器提取 Cookie）。之后 Agent 就能用 `xhs search "关键词"` 搜索笔记、`xhs read NOTE_ID` 阅读详情、`xhs comments NOTE_ID` 查看评论了。不需要 Docker。
+桌面电脑首选 **OpenCLI**（`agent-reach install --channels opencli`）——它复用你浏览器里的登录态，平时刷过小红书就直接能用，零配置；装完在 Chrome 商店点一次「添加扩展」即可。之后 Agent 用 `opencli xiaohongshu search "关键词"` 搜索、`opencli xiaohongshu note URL` 读笔记。服务器上用 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)（自带无头浏览器，扫码登录）。已装过 xhs-cli 的老用户不受影响，它仍是备选后端（上游 2026-03 起停更，不推荐新装）。
 </details>
 <details>
@@ -316,14 +319,14 @@ Yes! Agent Reach is an installer + configuration tool — any AI coding agent th
 <details>
 <summary><strong>Is this free? Any API costs?</strong></summary>
-100% free. All backends are open-source tools (twitter-cli, rdt-cli, xhs-cli, yt-dlp, Jina Reader, Exa, etc.) that don't require paid API keys. The only optional cost is a residential proxy (~$1/month) if you need Bilibili access from an overseas server.
+100% free. All backends are open-source tools (OpenCLI, twitter-cli, bili-cli, rdt-cli, yt-dlp, Jina Reader, Exa, xiaohongshu-mcp, etc.) that don't require paid API keys. The only optional cost is a residential proxy (~$1/month) if your network blocks Reddit/Twitter (e.g. mainland China).
 </details>
 ---
 ## 致谢
-[twitter-cli](https://github.com/public-clis/twitter-cli) · [rdt-cli](https://github.com/public-clis/rdt-cli) · [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) · [bili-cli](https://github.com/public-clis/bilibili-cli) · [yt-dlp](https://github.com/yt-dlp/yt-dlp) · [Jina Reader](https://github.com/jina-ai/reader) · [Exa](https://exa.ai) · [mcporter](https://github.com/nicobailon/mcporter) · [feedparser](https://github.com/kurtmckee/feedparser) · [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server)
+[OpenCLI](https://github.com/jackwener/opencli) · [twitter-cli](https://github.com/public-clis/twitter-cli) · [rdt-cli](https://github.com/public-clis/rdt-cli) · [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) · [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) · [bili-cli](https://github.com/public-clis/bilibili-cli) · [yt-dlp](https://github.com/yt-dlp/yt-dlp) · [Jina Reader](https://github.com/jina-ai/reader) · [Exa](https://exa.ai) · [mcporter](https://github.com/nicobailon/mcporter) · [feedparser](https://github.com/kurtmckee/feedparser) · [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server)
 ## 联系
@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 """Agent Reach — Give your AI Agent eyes to see the entire internet."""
-__version__ = "1.4.2"
+__version__ = "1.5.0"
 __author__ = "Neo Reid"
 from agent_reach.core import AgentReach
@@ -1,8 +1,15 @@
 # -*- coding: utf-8 -*-
-"""Bilibili — video via yt-dlp, search/browse via bili-cli or API."""
+"""Bilibili — multi-backend: bili-cli / OpenCLI / search API.
 yt-dlp was REMOVED from this channel (live-verified 2026-06): bilibili's
 risk control 412-blocks yt-dlp's requests in every configuration we
 tried — latest version, direct, proxied, with warmed cookies — while
 bili-cli keeps working (search/hot/video detail without login) and
 OpenCLI covers subtitles through the browser session. yt-dlp remains the
 YouTube backend; it just no longer serves bilibili.
 """
 import json
 import os
 import urllib.request
 from agent_reach.probe import probe_command
@@ -28,7 +35,7 @@ def _search_api_ok() -> bool:
 class BilibiliChannel(Channel):
    name = "bilibili"
    description = "B站视频、字幕和搜索"
-    backends = ["yt-dlp", "bili-cli (可选)", "B站搜索 API"]
+    backends = ["bili-cli", "OpenCLI", "B站搜索 API"]
    tier = 1
    def can_handle(self, url: str) -> bool:
@@ -37,49 +44,76 @@ class BilibiliChannel(Channel):
        return "bilibili.com" in d or "b23.tv" in d
    def check(self, config=None):
        """Probe candidates in order; first fully-usable backend wins."""
        self.active_backend = None
        findings = []
-        # 真跑 yt-dlp --version，区分 未装 / 断链 / 异常（which 命中不等于能用）
+        for backend in self.ordered_backends(config):
-        yt = probe_command("yt-dlp", ["--version"], timeout=10, package="yt-dlp")
+            if backend == "bili-cli":
-        if yt.status == "missing":
+                result = self._check_bili_cli()
-            return "off", "yt-dlp 未安装。安装：pip install yt-dlp"
+            elif backend == "OpenCLI":
-        if yt.status == "broken":
+                result = self._check_opencli()
            return "error", "yt-dlp 已安装但无法执行\n" + yt.hint
        if not yt.ok:
            detail = yt.hint or yt.output or yt.status
            return "error", f"yt-dlp 探测失败（{yt.status}）：{detail}"
        self.active_backend = "yt-dlp"
        proxy = (config.get("bilibili_proxy") if config else None) or os.environ.get("BILIBILI_PROXY")
        # 真跑 bili --version——断链时旧的 which 检测会误报"bili-cli 可用"
        bili = probe_command("bili", ["--version"], timeout=10, package="bilibili-cli")
        parts = []
        # 视频读取状态
        if proxy:
            parts.append("视频读取：yt-dlp（代理已配置）")
        else:
            parts.append("视频读取：yt-dlp")
        # bili-cli 增强
        if bili.ok:
            parts.append("搜索/热门/排行：bili-cli 可用")
            status = "ok"
        else:
            if bili.status == "broken":
                parts.append("bili-cli 已安装但无法执行，不计为可用\n" + bili.hint)
            elif bili.status in ("timeout", "error"):
                parts.append(f"bili-cli 探测失败（{bili.status}），不计为可用")
            # 降级走搜索 API；只探测一次，message 和 status 共用结果
            api_ok = _search_api_ok()
            if api_ok:
                parts.append("搜索：B站 API 可用")
            else:
-                parts.append("搜索：B站 API 不可达")
+                result = self._check_search_api()
-            if bili.status == "missing":
+            if result is None:
-                parts.append("提示：安装 bili-cli 可解锁热门/排行/动态：pipx install bilibili-cli")
+                continue
-            status = "ok" if api_ok else "warn"
+            findings.append((backend, *result))
-        return status, "。".join(parts)
+        # 有后端断链时，即使别的候选兜底成功也要把处方带出来
        broken_notes = [m for _, s, m in findings if s == "error"]
        for wanted in ("ok", "warn"):
            for backend, status, message in findings:
                if status == wanted:
                    self.active_backend = backend
                    if broken_notes:
                        message += "\n[备选后端异常] " + "；".join(broken_notes)
                    return status, message
        if findings:
            return "error", "\n".join(m for _, _, m in findings)
        return "off", (
            "没有可用的 B站后端（搜索 API 也不可达，可能是网络问题）。推荐：\n"
            "  pipx install bilibili-cli（搜索/热门/视频详情，无需登录）\n"
            "  或桌面装 OpenCLI（额外解锁字幕）：agent-reach install --channels opencli"
        )
    def _check_bili_cli(self):
        """bili-cli candidate. None = not installed."""
        probe = probe_command("bili", ["--version"], timeout=10, package="bilibili-cli")
        if probe.status == "missing":
            return None
        if probe.status == "broken":
            return "error", "bili 命令存在但无法执行\n" + probe.hint
        if not probe.ok:
            return "warn", f"bili-cli 探测失败（{probe.status}），运行 `bili status` 查看详情"
        return "ok", (
            "bili-cli 可用（搜索/热门/排行/视频详情/音频，无需登录；"
            "字幕需 OpenCLI。上游 2026-03 起停更）"
        )
    def _check_opencli(self):
        """OpenCLI candidate. None = not installed."""
        from agent_reach.backends import opencli_status
        st = opencli_status()
        if not st.installed:
            return None
        if st.broken:
            return "error", st.hint
        if st.ready:
            return "ok", (
                "OpenCLI 可用（复用浏览器登录态）。用法："
                "opencli bilibili search/video/subtitle/ranking -f yaml"
            )
        return "warn", st.hint
    def _check_search_api(self):
        """Zero-dependency search API fallback. None = unreachable."""
        if not _search_api_ok():
            return None
        return "ok", (
            "B站搜索 API 可达（仅搜索，curl 直连）。"
            "完整功能建议安装 bili-cli：pipx install bilibili-cli"
        )
@@ -1,9 +1,12 @@
 # -*- coding: utf-8 -*-
-"""Reddit — search and read via rdt-cli (public-clis/rdt-cli).
+"""Reddit — multi-backend: OpenCLI / rdt-cli. Login is mandatory.
-NOTE: Reddit requires authentication since 2024. All API requests
+Honest tiering (live-verified 2026-06): there is NO zero-config path.
-(including public subreddit reads) return HTTP 403 without a valid
+Anonymous .json endpoints are blocked (403 anti-bot, all variants), and
-session cookie. Run `rdt login` after installation to authenticate.
+the official API closed self-service registration in 2025-11 (manual
 approval, individual scripts rarely granted — PRAW is only an option for
 users who already hold credentials). Every working backend rides a
 logged-in session: OpenCLI reuses the browser's, rdt-cli imports cookies.
 """
 import json
@@ -32,8 +35,8 @@ _RDT_BROKEN_HINT = (
 class RedditChannel(Channel):
    name = "reddit"
    description = "Reddit 帖子和评论"
-    backends = ["rdt-cli"]
+    backends = ["OpenCLI", "rdt-cli"]
-    tier = 1  # Reddit requires login since 2024 (rdt login) — not zero-config
+    tier = 1  # no zero-config path exists — see module docstring
    def can_handle(self, url: str) -> bool:
        from urllib.parse import urlparse
@@ -42,19 +45,59 @@ class RedditChannel(Channel):
        return "reddit.com" in d or "redd.it" in d
    def check(self, config=None):
        """Probe candidates in order; first fully-usable backend wins."""
        self.active_backend = None
        findings = []
        for backend in self.ordered_backends(config):
            if backend == "OpenCLI":
                result = self._check_opencli()
            else:
                result = self._check_rdt()
            if result is None:
                continue
            findings.append((backend, *result))
        for wanted in ("ok", "warn"):
            for backend, status, message in findings:
                if status == wanted:
                    self.active_backend = backend
                    return status, message
        if findings:
            return "error", "\n".join(m for _, _, m in findings)
        return "off", (
            "未安装任何 Reddit 后端。注意：Reddit 没有零配置路径"
            "（匿名 .json 已被封，官方 API 需人工审批），必须用登录态。推荐：\n"
            "  桌面：agent-reach install --channels opencli\n"
            "       （复用 Chrome 登录态，登录过 reddit.com 即可用）\n"
            f"  服务器/存量：pipx install '{_RDT_GIT_SOURCE}'\n"
            "       然后 `rdt login` 或手动写入 Cookie（见 doctor 提示）\n"
            "中国大陆访问 Reddit 需要代理"
        )
    def _check_opencli(self):
        """OpenCLI candidate. None = not installed."""
        from agent_reach.backends import opencli_status
        st = opencli_status()
        if not st.installed:
            return None
        if st.broken:
            return "error", st.hint
        if st.ready:
            return "ok", (
                "OpenCLI 可用（复用浏览器登录态）。用法："
                "opencli reddit search/read/subreddit/hot -f yaml"
            )
        return "warn", st.hint
    def _check_rdt(self):
        """rdt-cli candidate. None = not installed."""
        rdt = shutil.which("rdt")
        if not rdt:
-            return "off", (
+            return None
                "需要安装 rdt-cli。PyPI 版本可能暂时落后，推荐直接从 GitHub 安装：\n"
                f"  pipx install '{_RDT_GIT_SOURCE}'\n"
                "如已确认 PyPI 版本已更新，也可使用：\n"
                "  pipx install rdt-cli\n"
                "  uv tool install rdt-cli\n"
                "最新源码：https://github.com/public-clis/rdt-cli\n"
                "安装后运行 `rdt login` 登录（需先在浏览器登录 reddit.com）"
            )
        # 不走 probe_command：实测 `rdt status --json` 成功时（rc=0）也会向 stderr
        # 打网络重试日志，probe 把 stdout+stderr 合并后 JSON 解析必炸。
@@ -83,9 +126,7 @@ class RedditChannel(Channel):
            tail = detail[-1] if detail else "无输出"
            return "error", f"rdt 异常退出（exit {r.returncode}）：{tail}。运行 `rdt status` 查看详情"
-        # 进程正常退出 → rdt 本身是活的（无论登录与否），后端即为可用
+        # 进程正常退出 → rdt 本身是活的（无论登录与否）
        self.active_backend = "rdt-cli"
        try:
            data = json.loads(r.stdout or "")
        except json.JSONDecodeError:
@@ -101,7 +142,10 @@ class RedditChannel(Channel):
        if authenticated:
            suffix = f"（已登录：{username}）" if username else ""
-            return "ok", (f"rdt-cli 可用{suffix}（搜索帖子、阅读全文、查看评论）")
+            return "ok", (
                f"rdt-cli 可用{suffix}（搜索帖子、阅读全文、查看评论；"
                "上游 2026-03 起停更，桌面用户建议迁移到 OpenCLI）"
            )
        return "warn", (
            "rdt-cli 已安装但未登录。Reddit 自 2024 年起要求认证，"
@@ -8,7 +8,7 @@ from agent_reach.probe import probe_command
 class TwitterChannel(Channel):
    name = "twitter"
    description = "Twitter/X 推文"
-    backends = ["twitter-cli", "bird CLI (legacy)"]
+    backends = ["twitter-cli", "OpenCLI", "bird CLI (legacy)"]
    tier = 1
    def can_handle(self, url: str) -> bool:
@@ -17,31 +17,38 @@ class TwitterChannel(Channel):
        return "x.com" in d or "twitter.com" in d
    def check(self, config=None):
-        """按 backends 顺序真实探测，第一个活着的后端即为 active_backend。"""
+        """Probe candidates in order; first fully-usable backend wins.
        与其他多后端渠道同一套两段式：先收集全部候选状态，第一个 ok 获胜；
        没有 ok 才轮到第一个 warn——否则「装了但未登录」的 twitter-cli
        会把排在后面、完整可用的 OpenCLI 挡在门外。
        """
        self.active_backend = None
-        failures = []
+        findings = []
        for backend in self.ordered_backends(config):
            if backend == "twitter-cli":
                result = self._check_twitter_cli()
            elif backend == "OpenCLI":
                result = self._check_opencli()
            elif backend == "bird CLI (legacy)":
                result = self._check_bird()
            else:
                continue
            if result is None:
-                continue  # 未安装——继续尝试下一个后端
+                continue  # 未安装——不参与候选
            findings.append((backend, *result))
-            status, message = result
+        for wanted in ("ok", "warn"):
-            if status in ("ok", "warn"):
+            for backend, status, message in findings:
-                # 工具本身是活的（含已装但未登录的 warn）
+                if status == wanted:
-                self.active_backend = backend
+                    self.active_backend = backend
-                return status, message
+                    return status, message
-            # broken/timeout —— 记下处方，继续尝试下一个后端
+
-            failures.append(message)
+        if findings:  # 只剩 broken/timeout 候选
            return "error", "\n".join(m for _, _, m in findings)
        if failures:
            return "error", "\n".join(failures)
        return "warn", (
            "Twitter CLI 未安装。安装方式：\n"
            "  pipx install twitter-cli\n"
@@ -84,6 +91,22 @@ class TwitterChannel(Channel):
            "  twitter -v status 查看详细信息"
        )
    def _check_opencli(self):
        """OpenCLI candidate. None = not installed."""
        from agent_reach.backends import opencli_status
        st = opencli_status()
        if not st.installed:
            return None
        if st.broken:
            return "error", st.hint
        if st.ready:
            return "ok", (
                "OpenCLI 可用（复用浏览器登录态）。用法："
                "opencli twitter search/article/user-posts -f yaml"
            )
        return "warn", st.hint
    def _check_bird(self):
        """探测 bird/birdx（legacy 回退）。返回 None 表示均未安装，否则返回 (status, message)。"""
        last_failure = None
@@ -66,7 +66,8 @@ def main():
    p_install.add_argument("--env", choices=["local", "server", "auto"], default="auto",
                           help="Environment: local, server, or auto-detect")
    p_install.add_argument("--proxy", default="",
-                           help="Residential proxy for Reddit/Bilibili (http://user:pass@ip:port)")
+                           help="Network proxy saved for agents to export as HTTP(S)_PROXY "
                                "in restricted networks (http://user:pass@ip:port)")
    p_install.add_argument("--safe", action="store_true",
                           help="Safe mode: skip automatic system changes, show what's needed instead")
    p_install.add_argument("--dry-run", action="store_true",
@@ -226,10 +227,11 @@ def _cmd_install(args):
    # Apply explicit flags
    if args.proxy:
        if dry_run:
-            print(f"[dry-run] Would configure proxy for Bilibili")
+            print(f"[dry-run] Would save network proxy")
        else:
-            config.set("bilibili_proxy", args.proxy)
+            config.set("proxy", args.proxy)
-            print(f"✅ Proxy configured for Bilibili")
+            config.set("bilibili_proxy", args.proxy)  # legacy key
            print(f"✅ 代理已保存（Agent 访问受限网络时使用）")
    # ── Install core system dependencies (lightweight, always) ──
    print()
@@ -298,9 +300,9 @@ def _cmd_install(args):
    # Environment-specific advice
    if env == "server":
        print()
-        print("Tip: Bilibili may block server IPs.")
+        print("Tip: 部分平台对服务器 IP 有风控。")
-        print("   Reddit: rdt-cli works without proxy (pipx install rdt-cli).")
+        print("   Reddit 必须登录态（rdt-cli + Cookie，见 doctor 提示），中国大陆网络还需代理。")
-        print("   For Bilibili full access: agent-reach configure proxy http://user:pass@ip:port")
+        print("   保存代理供 Agent 使用：agent-reach configure proxy http://user:pass@ip:port")
        print("   Cheap option: https://www.webshare.io ($1/month)")
    # Test channels
@@ -774,7 +776,24 @@ def _install_opencli_deps():
 def _install_reddit_deps():
-    """Install rdt-cli for Reddit search + reading."""
+    """Set up Reddit — desktop prefers OpenCLI, rdt-cli for servers/legacy.
    No zero-config path exists (anonymous .json blocked, official API
    approval-gated since 2025-11) — every backend needs a logged-in session.
    """
    if _detect_environment() != "server":
        _install_opencli_deps()
        print("  Reddit 走 OpenCLI（浏览器里登录过 reddit.com 即可用）")
        import shutil
        if shutil.which("rdt"):
            print("  ✅ 检测到存量 rdt-cli，将作为备选后端继续可用")
        return
    _install_rdt_cli()
 def _install_rdt_cli():
    """Install rdt-cli (pinned git source — PyPI lags upstream)."""
    import shutil
    import subprocess
@@ -1019,9 +1038,14 @@ def _cmd_configure(args):
        return
    if args.key == "proxy":
        # Generic network proxy for restricted environments. Nothing reads
        # this key at runtime — agents read it back and export HTTP(S)_PROXY
        # before invoking upstream tools (see docs/install.md). The legacy
        # bilibili_proxy key is kept in sync for older configs.
        config.set("proxy", value)
        config.set("bilibili_proxy", value)
-        print(f"✅ Proxy configured for Bilibili!")
+        print("✅ 代理已保存（供 Agent 在访问 Reddit/Twitter 等需要代理的网络时设置 HTTP_PROXY/HTTPS_PROXY）")
-        print("  Note: Reddit 已改为通过 rdt-cli 访问，无需代理。")
+        print("  Note: B站走 bili-cli，国内网络无需代理。")
    elif args.key == "twitter-cookies":
        # Accept two formats:
@@ -1370,7 +1394,10 @@ def _cmd_uninstall(args):
                print(f"[dry-run] Would remove {platform_name} skill: {skill_path}")
            else:
                try:
-                    shutil.rmtree(skill_path)
+                    if os.path.islink(skill_path):
                        os.unlink(skill_path)
                    else:
                        shutil.rmtree(skill_path)
                    print(f"  Removed {platform_name} skill: {skill_path}")
                    removed_any = True
                except Exception as e:
@@ -1500,9 +1527,9 @@ def _cmd_setup():
    print()
    # Step 3: Reddit — rdt-cli
-    print("【信息】Reddit — 通过 rdt-cli 搜索和阅读，无需配置")
+    print("【信息】Reddit — 必须登录态（无零配置路径）。桌面推荐 OpenCLI；或 rdt-cli：")
    print(f"  安装：pipx install '{_RDT_GIT_SOURCE}'")
-    print("  然后运行：rdt login")
+    print("  然后运行：rdt login（需先在浏览器登录 reddit.com）")
    print()
    # Step 4: Groq (Whisper)
@@ -1618,6 +1645,35 @@ def _github_get_with_retry(url, timeout=10, retries=3, sleeper=time.sleep):
    return None, "unknown", retries
 #: Full update = package + upstream tools + skill. The one-liner walks an
 #: agent through all three (docs/update.md); bare pip only updates the package.
 _UPDATE_INSTRUCTIONS = (
    "更新方式（推荐，复制这句话给你的 AI Agent，会完整更新本体+上游工具+skill）：\n"
    "  帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md\n"
    "仅更新本体（不含上游工具和 skill）：\n"
    "  pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip"
 )
 def _is_newer_version(remote: str, local: str) -> bool:
    """True if remote is strictly newer than local (semantic compare).
    A plain != would tell users "update available" when their local build is
    AHEAD of the latest release (e.g. installed from main during a release
    window) — and walk them into a downgrade.
    """
    def parse(v):
        try:
            return tuple(int(x) for x in v.strip().split("."))
        except ValueError:
            return None
    r, l = parse(remote), parse(local)
    if r is None or l is None:
        return remote != local  # unparseable — fall back to old behavior
    return r > l
 def _cmd_check_update():
    """Check for newer versions on GitHub."""
    from agent_reach import __version__
@@ -1637,7 +1693,7 @@ def _cmd_check_update():
        latest = data.get("tag_name", "").lstrip("v")
        body = data.get("body", "")
-        if latest and latest != __version__:
+        if latest and _is_newer_version(latest, __version__):
            print(f"最新版本: v{latest} ← 有更新！")
            if body:
                print()
@@ -1646,8 +1702,7 @@ def _cmd_check_update():
                for line in body.strip().split("\n")[:20]:
                    print(f"  {line}")
            print()
-            print("更新命令:")
+            print(_UPDATE_INSTRUCTIONS)
            print("  pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip")
            return "update_available"
        print(f"✅ 已是最新版本")
        return "up_to_date"
@@ -1669,8 +1724,7 @@ def _cmd_check_update():
        date = commit.get("commit", {}).get("committer", {}).get("date", "")[:10]
        print(f"最新提交: {sha} ({date}) {msg}")
        print()
-        print("更新命令:")
+        print(_UPDATE_INSTRUCTIONS)
        print("  pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip")
        return "unknown"
    commit_err = _classify_github_response_error(resp2)
@@ -1718,7 +1772,7 @@ def _cmd_watch():
    if not err and resp and resp.status_code == 200:
        data = resp.json()
        latest = data.get("tag_name", "").lstrip("v")
-        if latest and latest != __version__:
+        if latest and _is_newer_version(latest, __version__):
            update_available = True
            new_version = latest
            release_body = data.get("body", "")
@@ -1743,7 +1797,8 @@ def _cmd_watch():
        if release_body:
            for line in release_body.strip().split("\n")[:10]:
                print(f"    {line}")
-        print(f"  更新: pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip")
+        print("  更新（一句话发给 Agent 即可完整更新）：")
        print("    帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md")
 if __name__ == "__main__":
@@ -19,15 +19,18 @@ def check_all(config: Config) -> Dict[str, dict]:
    for ch in get_all_channels():
        try:
            status, message = ch.check(config)
            active = getattr(ch, "active_backend", None)
        except Exception as e:  # noqa: BLE001 — doctor must survive any channel
-            status, message = "error", f"体检异常：{e}"
+            # Channels are registry singletons: a stale active_backend from a
            # previous check must not leak into an errored result.
            status, message, active = "error", f"体检异常：{e}", None
        results[ch.name] = {
            "status": status,
            "name": ch.description,
            "message": message,
            "tier": ch.tier,
            "backends": ch.backends,
-            "active_backend": getattr(ch, "active_backend", None),
+            "active_backend": active,
        }
    return results
@@ -53,6 +53,10 @@ def probe_command(
 ) -> ProbeResult:
    """Actually execute `cmd *args` and classify the result.
    Intended for SIDE-EFFECT-FREE health probes only (version/status
    commands): retries re-run the command verbatim with no backoff, so a
    non-idempotent command would repeat its effect.
    package: pip/pipx package name used in the broken-install hint
             (defaults to cmd).
    """
@@ -1,19 +1,27 @@
 ---
 name: agent-reach
 description: >
-  MUST USE when user asks to search, browse, read, or interact with content from any of these platforms:
+  MUST USE when user wants to 调研/research/搜索/search/查/找/look up anything
-  小红书/xiaohongshu/xhs, Twitter/推特/X, B站/bilibili,
+  on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X / 搜搜 X /
-  V2EX, Reddit, LinkedIn/领英, YouTube, GitHub code search,
+  看看大家怎么评价 X / X 上有什么讨论 / research this topic。
  小宇宙播客, 雪球/股票行情, RSS feeds, or any web URL.
-  Also MUST USE for: web搜索/搜/查/找/look up/research, 招聘/求职/jobs, 分享的链接/URL.
+  Also MUST USE when user mentions any platform or shares any URL/链接:
-  Routes to CLI tools: xhs-cli, twitter-cli, rdt-cli, gh, yt-dlp, curl+Jina, mcporter.
+  小红书/xiaohongshu/xhs, Twitter/推特/X, B站/bilibili, Reddit, V2EX,
-  13 platforms. Zero config for 6 channels.
+  LinkedIn/领英/招聘/求职/jobs, YouTube, GitHub code search, 小宇宙播客,
  雪球/股票行情, RSS feeds, or any web URL.
  13 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs).
  Zero config for 6 channels. Run `agent-reach doctor --json` to see which
  backend serves each platform right now.
  NOT for: 写报告/数据分析/翻译等内容加工（本 skill 只负责从互联网获取内容）；
  发帖/评论/点赞等写操作；已有专门 skill 的平台（先用专门 skill）。
  【路由方式】SKILL.md 包含路由表和常用命令，复杂场景需按需阅读对应分类的 references/*.md。
  分类：search / social (小红书/推特/B站/V2EX/Reddit) / career(LinkedIn) / dev(github) / web(网页/文章/RSS) / video(YouTube/B站/播客)。
 triggers:
-  - search: 搜/查/找/search/搜索/查一下/帮我搜
+  - research: 调研/全网调研/帮我调研/研究一下/research/深入了解
  - search: 搜/查/找/search/搜索/查一下/帮我搜/看看大家怎么说
  - social:
    - 小红书: xiaohongshu/xhs/小红书/红书
    - Twitter: twitter/推特/x.com/推文
@@ -30,9 +38,22 @@ metadata:
    homepage: https://github.com/Panniantong/Agent-Reach
 ---
-# Agent Reach — 路由器
+# Agent Reach — 互联网能力路由器
-13 平台工具集合。根据用户意图选择对应分类。
+13 平台、多后端。**本 skill 存在时必须用它访问这些平台，不要自己发明方案。**
 ## 常驻规则（全程适用）
 1. **动手前先体检**：多后端平台（小红书/Reddit/B站/Twitter）先跑
   `agent-reach doctor --json`，按各平台 `active_backend` 字段选命令组。
 2. **声明你在用什么**：开始干活前说一句「使用 agent-reach 的 X 平台 / Y 后端」。
 3. **失败按 references 里的重试链处理**，不要瞎猜命令。
 4. **全网调研类任务**：组合多平台（Exa 搜索 + Twitter/Reddit 看讨论 + 小红书/B站看中文场景），并行收集再汇总。
 5. **替用户盯版本**：完成一次较大的调研/多平台任务后，顺手跑
   `agent-reach check-update`（很快，一个 API 调用）。有新版就在收尾汇报里附一句：
   「Agent Reach 有新版 vX.Y.Z，复制这句话给我即可更新：帮我更新 Agent Reach：
   https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md」。
   不要中断当前任务去更新，也不要重复提醒同一个版本。
 ## 路由表
@@ -57,30 +78,35 @@ curl -s "https://r.jina.ai/URL"
 # GitHub 搜索
 gh search repos "query" --sort stars --limit 10
-# Twitter 搜索
+# YouTube 字幕（注意：B站不要用 yt-dlp，见 video.md）
 twitter search "query" -n 10
 # YouTube/B站字幕
 yt-dlp --write-sub --skip-download -o "/tmp/%(id)s" "URL"
 # Reddit 搜索
 rdt search "query" --limit 10
 # Reddit 读帖 + 评论
 rdt read POST_ID
 # V2EX 热门
 curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
 # B站搜索（bili-cli，无需登录）
 bili search "query" --type video -n 5
 ```
 ## 需登录态的平台（按 doctor 的 active_backend 选命令）
 ```bash
 # Twitter 搜索（twitter-cli 首选；失败重试链见 social.md）
 twitter search "query" -n 10
 # Reddit（无零配置路径：OpenCLI 或 rdt-cli，必须登录态）
 opencli reddit search "query" -f yaml   # 桌面
 rdt search "query" --limit 10            # 存量/服务器
 # 小红书（桌面首选 OpenCLI）
 opencli xiaohongshu search "query" -f yaml
 ```
 ## 环境检查
 ```bash
-# 检查可用 channel
+# 检查可用 channel 与每个平台当前激活的后端
-agent-reach doctor
+agent-reach doctor --json
 # 查看所有 MCP 服务
 mcporter_list_servers()
 ```
 ## 工作区规则
@@ -92,7 +118,7 @@ mcporter_list_servers()
 根据用户需求，阅读对应的详细文档：
 - [搜索工具](references/search.md) — Exa AI 搜索
- [社交媒体](references/social.md) — 小红书, Twitter, B站, V2EX, Reddit
+- [社交媒体](references/social.md) — 小红书, Twitter, B站, V2EX, Reddit（多后端命令组）
 - [职场招聘](references/career.md) — LinkedIn
 - [开发工具](references/dev.md) — GitHub CLI
 - [网页阅读](references/web.md) — Jina Reader, RSS
@@ -1,246 +1,125 @@
 ---
 name: agent-reach
 description: >
-  MUST USE when user asks to search, browse, read, or interact with content from any supported platform:
+  MUST USE when user wants to research/search/look up/find anything on the
  internet — e.g. "research this topic", "do a deep dive on X", "search the
  web for X", "see what people say about X", "look this up".
  Also MUST USE when user mentions any platform or shares any URL/link:
  Twitter/X, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu,
-  Xiaoyuzhou Podcast, LinkedIn, V2EX, Xueqiu (stocks), RSS, or any web URL.
+  Xiaoyuzhou Podcast, LinkedIn/jobs/recruiting, V2EX, Xueqiu (stocks), RSS.
-  Also MUST USE for: web search, look up, research, find, share a URL/link, jobs/recruiting.
+  13 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs).
-  Routes to CLI tools: xhs-cli, twitter-cli, rdt-cli, gh, yt-dlp, curl+Jina, mcporter.
+  Zero config for 6 channels. Run `agent-reach doctor --json` to see which
-  13 platforms, zero config for 6 channels.
+  backend serves each platform right now.
-  Triggers: "search twitter", "search xiaohongshu", "watch this video",
+  NOT for: writing reports/analysis/translation (this skill only FETCHES
-  "search the web", "look this up", "research", "youtube transcript",
+  internet content); posting/commenting/liking (write operations); platforms
-  "search reddit", "read this link", "bilibili", "V2EX",
+  that already have a dedicated skill installed (prefer that skill).
  "xiaoyuzhou", "podcast", "xueqiu", "stock quote", "雪球", "股票".
 metadata:
  openclaw:
    homepage: https://github.com/Panniantong/Agent-Reach
 ---
-# Agent Reach — Usage Guide
+# Agent Reach — internet capability router
-Upstream tools for 13 platforms. Call them directly.
+13 platforms, multiple backends each. **When this skill exists, use it for
 these platforms — do not invent your own approach.**
-Run `agent-reach doctor` to check which channels are available.
+## Standing rules (apply for the whole session)
-## ⚠️ Workspace Rules
+1. **Health-check before acting**: for multi-backend platforms (XiaoHongShu /
   Reddit / Bilibili / Twitter), run `agent-reach doctor --json` first and
   pick the command group matching each platform's `active_backend`.
 2. **Announce what you use**: say "using agent-reach, platform X via backend Y"
   before starting.
 3. **On failure, follow the retry chains in references/** — never guess
   commands.
 4. **For broad research tasks**: combine platforms (Exa for web search +
   Twitter/Reddit for discussions + XiaoHongShu/Bilibili for Chinese
   perspectives), collect in parallel, then synthesize.
 5. **Watch versions for the user**: after finishing a substantial
   multi-platform task, run `agent-reach check-update` (fast, one API call).
   If a new version exists, append one line to your wrap-up: "Agent Reach
   vX.Y.Z is available — paste this to me to update: 帮我更新 Agent Reach：
   https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md".
   Never interrupt the current task to update; never nag about the same version twice.
-**Never create files in the agent workspace.** Use `/tmp/` for temporary output and `~/.agent-reach/` for persistent data.
+## Routing table
-## Web — Any URL
+| User intent | Category | Details |
-
+|---------|------|---------|
-```bash
+| Web / code search | search | [references/search.md](references/search.md) |
-curl -s "https://r.jina.ai/URL"
+| XiaoHongShu / Twitter / Bilibili / V2EX / Reddit | social | [references/social.md](references/social.md) |
-```
+| Jobs / LinkedIn | career | [references/career.md](references/career.md) |
-
+| GitHub / code | dev | [references/dev.md](references/dev.md) |
-## Web Search (Exa)
+| Web pages / articles / RSS | web | [references/web.md](references/web.md) |
 | YouTube / Bilibili / podcast transcripts | video | [references/video.md](references/video.md) |
 ## Zero-config quick commands
 ```bash
 # Exa web search
 mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'
 mcporter call 'exa.get_code_context_exa(query: "code question", tokensNum: 3000)'
 ```
-## Twitter/X (twitter-cli)
+# Read any web page
 curl -s "https://r.jina.ai/URL"
-```bash
+# GitHub search
 twitter -c search "query" -n 10            # search (-c = compact JSON, LLM-friendly)
 twitter -c tweet URL_OR_ID                 # read tweet + replies (supports /status/ URLs)
 twitter -c article URL_OR_ID               # read a Twitter Article
 twitter -c user-posts @username -n 20      # user timeline
 twitter -c feed -n 20                      # home timeline
 ```
 > Binary is `twitter` (`pipx install twitter-cli`, ≥ 0.8.5). The `bird` name in older docs has been retired. If `search` returns 404, run `pipx upgrade twitter-cli`.
 ## YouTube (yt-dlp)
 ```bash
 yt-dlp --dump-json "URL"                     # video metadata
 yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --skip-download -o "/tmp/%(id)s" "URL"
                                             # download subtitles, then read the .vtt file
 yt-dlp --dump-json "ytsearch5:query"         # search
 ```
 ## Bilibili (yt-dlp)
 ```bash
 yt-dlp --dump-json "https://www.bilibili.com/video/BVxxx"
 yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --convert-subs vtt --skip-download -o "/tmp/%(id)s" "URL"
 ```
 > Server IPs may get 412. Use `--cookies-from-browser chrome` or configure a proxy.
 ## Reddit
 ```bash
 curl -s "https://www.reddit.com/r/SUBREDDIT/hot.json?limit=10" -H "User-Agent: agent-reach/1.0"
 curl -s "https://www.reddit.com/search.json?q=QUERY&limit=10" -H "User-Agent: agent-reach/1.0"
 ```
 > Server IPs may get 403. Search via Exa instead, or configure a proxy.
 ## GitHub (gh CLI)
 ```bash
 gh search repos "query" --sort stars --limit 10
 gh repo view owner/repo
 gh search code "query" --language python
 gh issue list -R owner/repo --state open
 gh issue view 123 -R owner/repo
 ```
-## XiaoHongShu (mcporter)
+# YouTube subtitles (NOTE: never use yt-dlp for Bilibili — see video.md)
 yt-dlp --write-sub --skip-download -o "/tmp/%(id)s" "URL"
-```bash
+# V2EX hot topics
 mcporter call 'xiaohongshu.search_feeds(keyword: "query")'
 mcporter call 'xiaohongshu.get_feed_detail(feed_id: "xxx", xsec_token: "yyy")'
 mcporter call 'xiaohongshu.get_feed_detail(feed_id: "xxx", xsec_token: "yyy", load_all_comments: true)'
 mcporter call 'xiaohongshu.publish_content(title: "Title", content: "Body text", images: ["/path/img.jpg"], tags: ["tag"])'
 ```
 > Requires login. Use Cookie-Editor to import cookies.
 > **Tip: Clean bloated output.** The XHS API returns large JSON with many unused fields.
 > Pipe through the formatter to save context:
 > ```bash
 > mcporter call 'xiaohongshu.search_feeds(keyword: "query")' | agent-reach format xhs
 > ```
 > This keeps only: title, content, author, engagement counts, image URLs, and tags.
 ## Xiaoyuzhou Podcast (groq-whisper + ffmpeg)
 ```bash
 # Transcribe a single podcast episode (outputs text to /tmp/)
 ~/.agent-reach/tools/xiaoyuzhou/transcribe.sh "https://www.xiaoyuzhoufm.com/episode/EPISODE_ID"
 ```
 > Requires `ffmpeg` and a Groq API key (free).
 > Configure the key with `agent-reach configure groq-key YOUR_KEY`.
 > On first run, install the tools with `agent-reach install --env=auto`.
 > Run `agent-reach doctor` to check status.
 > Output Markdown files are saved to `/tmp/` by default.
 ## LinkedIn (mcporter)
 ```bash
 mcporter call 'linkedin.get_person_profile(linkedin_url: "https://linkedin.com/in/username")'
 mcporter call 'linkedin.search_people(keyword: "AI engineer", limit: 10)'
 ```
 Fallback: `curl -s "https://r.jina.ai/https://linkedin.com/in/username"`
 ## V2EX (public API)
 ```bash
 # Hot topics
 curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: agent-reach/1.0"
-# Topics in a node (node_name examples: python, tech, jobs, qna)
+# Bilibili search (bili-cli, no login needed)
-curl -s "https://www.v2ex.com/api/topics/show.json?node_name=python&page=1" -H "User-Agent: agent-reach/1.0"
+bili search "query" --type video -n 5
 # Topic details (extract topic_id from URLs like https://www.v2ex.com/t/1234567)
 curl -s "https://www.v2ex.com/api/topics/show.json?id=TOPIC_ID" -H "User-Agent: agent-reach/1.0"
 # Topic replies
 curl -s "https://www.v2ex.com/api/replies/show.json?topic_id=TOPIC_ID&page=1" -H "User-Agent: agent-reach/1.0"
 # User profile
 curl -s "https://www.v2ex.com/api/members/show.json?username=USERNAME" -H "User-Agent: agent-reach/1.0"
 ```
-Python example (`V2EXChannel`):
+## Login-backed platforms (pick by doctor's active_backend)
-```python
+```bash
-from agent_reach.channels.v2ex import V2EXChannel
+# Twitter search (twitter-cli preferred; retry chain in social.md)
 twitter search "query" -n 10
-ch = V2EXChannel()
+# Reddit (NO zero-config path — OpenCLI or rdt-cli, login required)
 opencli reddit search "query" -f yaml   # desktop
 rdt search "query" --limit 10            # legacy/server
-# Get hot topics (default 20 items)
+# XiaoHongShu (desktop prefers OpenCLI)
-# Returned fields: id, title, url, replies, node_name, node_title, content(first 200 chars), created
+opencli xiaohongshu search "query" -f yaml
 topics = ch.get_hot_topics(limit=10)
 for t in topics:
    print(f"[{t['node_title']}] {t['title']} ({t['replies']} replies) {t['url']}")
    print(f"  id={t['id']} created={t['created']}")
 # Get latest topics for a specific node
 # Returned fields: id, title, url, replies, node_name, node_title, content(first 200 chars), created
 node_topics = ch.get_node_topics("python", limit=5)
 for t in node_topics:
    print(t["id"], t["title"], t["url"])
 # Get one topic plus replies
 # Returned fields: id, title, url, content, replies_count, node_name, node_title,
 #                  author, created, replies (list of {author, content, created})
 topic = ch.get_topic(1234567)
 print(topic["title"], "—", topic["author"])
 for r in topic["replies"]:
    print(f"  {r['author']}: {r['content'][:80]}")
 # Get user info
 # Returned fields: id, username, url, website, twitter, psn, github, btc, location, bio, avatar, created
 user = ch.get_user("Livid")
 print(user["username"], user["bio"], user["github"])
 # Search (not supported by the public V2EX API; returns guidance instead)
 result = ch.search("asyncio")
 print(result[0]["error"])  # Use built-in site search or the Exa channel instead
 ```
-> No auth required. Results are public JSON. V2EX node names are listed at https://www.v2ex.com/planes
+## Environment check
-## Xueqiu (public API)
+```bash
-
+# Channel availability + which backend serves each platform
-```python
+agent-reach doctor --json
 from agent_reach.channels.xueqiu import XueqiuChannel
 ch = XueqiuChannel()
 # Get stock quotes (symbol examples: SH600519 mainland China, SZ000858 Shenzhen, AAPL US, 00700 HK)
 # Returned fields: symbol, name, current, percent, chg, high, low, open, last_close,
 #                  volume, amount, market_capital, turnover_rate, pe_ttm, timestamp
 quote = ch.get_stock_quote("AAPL")
 print(f"{quote['name']} ({quote['symbol']}): {quote['current']} ({quote['percent']}%)")
 # Search stocks
 # Returned fields: symbol, name, exchange
 stocks = ch.search_stock("Apple", limit=5)
 for s in stocks:
    print(f"{s['name']} ({s['symbol']}) - {s['exchange']}")
 # Hot posts
 # Returned fields: id, title, text(first 200 chars), author, likes, url
 posts = ch.get_hot_posts(limit=10)
 for p in posts:
    print(f"{p['author']}: {p['text'][:50]}... ({p['likes']} likes)")
 # Hot stocks (stock_type=10 popularity ranking, stock_type=12 watchlist ranking)
 # Returned fields: symbol, name, current, percent, rank
 hot = ch.get_hot_stocks(limit=10, stock_type=10)
 for s in hot:
    print(f"#{s['rank']} {s['name']} ({s['symbol']}): {s['current']} ({s['percent']}%)")
 ```
-> No login required. Agent Reach auto-fetches session cookies, and all public APIs can be used directly.
+## Workspace rules
-## RSS (feedparser)
+**Never create files in the agent workspace.** Use `/tmp/` for temporary
 output and `~/.agent-reach/` for persistent data.
-```python
+## Detailed references
 python3 -c "
 import feedparser
 for e in feedparser.parse('FEED_URL').entries[:5]:
    print(f'{e.title} — {e.link}')
 "
 ```
-## Troubleshooting
+Read the matching file when you need specifics (commands above cover the
 common cases; references hold per-backend command groups, caveats, retry
 chains — note: reference docs are written in Chinese, commands are universal):
- **Channel not working?** Run `agent-reach doctor` — it shows status and fix instructions.
+- [Search](references/search.md) — Exa AI search
- **Twitter fetch failed?** Ensure `undici` is installed: `npm install -g undici`. Configure a proxy if needed: `agent-reach configure proxy URL`.
+- [Social](references/social.md) — XiaoHongShu, Twitter, Bilibili, V2EX, Reddit (multi-backend groups)
 - [Career](references/career.md) — LinkedIn
 - [Dev](references/dev.md) — GitHub CLI
 - [Web](references/web.md) — Jina Reader, RSS
 - [Video](references/video.md) — YouTube, Bilibili, Xiaoyuzhou
-## Setting Up a Channel ("help me configure XXX")
+## Configure a channel
-If a channel needs setup (cookies, Docker, etc.), fetch the install guide:
+If a channel needs setup, fetch the install guide:
 https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
-The user only provides cookies. Everything else is your job.
+The user only provides cookies / one extension click; the agent does the rest.
@@ -89,12 +89,18 @@ twitter user @username
 ```bash
 # 搜索推文（Twitter 频繁改 GraphQL 端点，可能 404）
 twitter search "query" -n 10
 # 如果 search 返回 404，升级 twitter-cli：pipx upgrade twitter-cli
 # likes（2024 年后只能看自己的，平台限制）
 twitter likes
 ```
 ### search 失败时的重试链（按序执行，成功即停）
 1. 直接重试一次（偶发失败常见）：`twitter search "query" -n 10`
 2. 升级后再试：`pipx upgrade twitter-cli && twitter search "query" -n 10`
 3. 换 OpenCLI 备选（桌面，复用浏览器登录态）：`opencli twitter search "query" -f yaml`
 4. 都不行就改用 `twitter feed` / `twitter user-posts @somebody` 等稳定命令绕路
 ### 重要注意事项
 > **安装**: `pipx install twitter-cli`（确保 v0.8.5+）
@@ -103,21 +109,25 @@ twitter likes
 >
 > **IP 风控**: 不要在 VPS/数据中心 IP 上频繁调用，尤其是 followers/following，有封号风险。使用住宅代理或本地环境。
 >
-> **search 可能失效**: Twitter 频繁修改 GraphQL API，search 命令可能随时返回 404。如遇到，先 `pipx upgrade twitter-cli`。如果最新版仍不行，说明上游还没跟上 Twitter 的改动，用 `twitter feed` 替代。
+> **OpenCLI 备选**: 桌面装了 OpenCLI 的话，`opencli twitter search/article/user-posts -f yaml` 全套可用（浏览器登录态，无需 cookie 环境变量）。
 >
 > **输出格式**: 建议用 `--yaml` 或 `--json` 获得结构化输出，对 AI agent 更友好。
 ## B站 / Bilibili
-```bash
+> ⚠️ **不要用 yt-dlp 读 B站**（风控已全面 412 拦截，实测无解）。用 bili-cli / OpenCLI。
 # 获取视频元数据
 yt-dlp --dump-json "https://www.bilibili.com/video/BVxxx"
-# 下载字幕
+```bash
-yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --convert-subs vtt --skip-download -o "/tmp/%(id)s" "URL"
+# 搜索 / 热门 / 视频详情（bili-cli，只读无需登录）
 bili search "query" --type video -n 5
 bili hot -n 10
 bili video BVxxx
 # 字幕（OpenCLI，需桌面 Chrome）
 opencli bilibili subtitle BVxxx
 ```
-> **注意**: 服务器 IP 可能遇到 412 错误。使用 `--cookies-from-browser chrome` 或配置代理。
+> 详细命令（音频转写、API 直连兜底）见 [references/video.md](video.md)。
 ## V2EX (公开 API)
@@ -180,25 +190,43 @@ user = ch.get_user("Livid")
 > **节点列表**: https://www.v2ex.com/planes
-## Reddit (rdt-cli)
+## Reddit（多后端，必须登录态）
 **Reddit 没有零配置路径**：匿名 `.json` 端点已被封（403），官方 API 自 2025-11 起人工审批基本不批。两个后端都靠登录态，先跑 `agent-reach doctor --json` 看 reddit 的 `active_backend`。中国大陆访问需代理。
 ### 后端 A：OpenCLI（桌面首选，复用浏览器登录态）
 ```bash
 # 搜索帖子
-rdt search "query" --limit 10
+opencli reddit search "query" -f yaml
 # 读帖子全文 + 评论
-rdt read POST_ID
+opencli reddit read POST_ID -f yaml
-# 浏览 subreddit
+# 浏览 subreddit / 热门 / Popular
-rdt sub python --limit 20
+opencli reddit subreddit LocalLLaMA -f yaml
 opencli reddit hot -f yaml
 opencli reddit popular -f yaml
-# 浏览热门
+# subreddit 元信息（订阅数、简介）
-rdt popular --limit 10
+opencli reddit subreddit-info LocalLLaMA -f yaml
 # 浏览 /r/all
 rdt all --limit 10
 ```
-> **安装**: `pipx install 'git+https://github.com/public-clis/rdt-cli.git'`（PyPI 版本暂时落后，需从 GitHub 装 v0.4.2+）。需要先登录（`rdt login`）才能搜索和阅读。
+> 要求 Chrome 打开且浏览器里登录过 reddit.com。
-> 需要登录的功能：`rdt feed --subs-only`（订阅列表）、`rdt saved`（收藏）。
+
 ### 后端 B：rdt-cli（存量/服务器备选，上游 2026-03 起停更）
 ```bash
 rdt search "query" --limit 10   # 搜索帖子
 rdt read POST_ID                # 读帖子全文 + 评论
 rdt sub python --limit 20       # 浏览 subreddit
 rdt popular --limit 10          # 浏览热门
 rdt all --limit 10              # 浏览 /r/all
 ```
 > **安装**: `pipx install 'git+https://github.com/public-clis/rdt-cli.git'`（PyPI 版本落后，需从 GitHub 装 v0.4.2+）。先 `rdt login` 才能搜索和阅读（服务器无浏览器时手动写 Cookie，见 doctor 提示）。
 > 建议使用 `--yaml` 输出，对 AI agent 更友好。
 ### 高级选项：官方 API + PRAW（仅限已有凭证的用户）
 2025-11 前注册过 Reddit script app（持有 client_id/client_secret）的用户可以用 PRAW 走官方 API（100 QPM 免费）。新申请需人工审批且个人项目基本不批，**不要推荐新用户走这条路**。
@@ -50,35 +50,48 @@ agent-reach transcribe ./local_audio.mp3 -o /tmp/transcript.txt
 > 需要先配置 key：`agent-reach configure groq-key gsk_xxx`（免费，console.groq.com）
 > 或 `agent-reach configure openai-key sk-xxx`。默认 auto 模式：groq 失败自动降级 openai。
-## B站 / Bilibili (yt-dlp + bili-cli)
+## B站 / Bilibili（bili-cli 为主，OpenCLI 补字幕）
-### 视频元数据 (yt-dlp)
+> ⚠️ **不要用 yt-dlp 读 B站**：B站风控已全面 412 拦截 yt-dlp（实测最新版、直连/代理/带 Cookie 全部无效）。yt-dlp 只用于 YouTube。
 ### 视频详情/搜索/热门/排行 (bili-cli，只读无需登录)
 ```bash
-yt-dlp --dump-json "https://www.bilibili.com/video/BVxxx"
+# 视频详情（标题/UP主/时长/播放互动数据/字幕可用性）
-```
+bili video BVxxx
 ### 字幕 (yt-dlp)
 ```bash
 yt-dlp --write-sub --write-auto-sub --sub-lang "zh-Hans,zh,en" --convert-subs vtt --skip-download -o "/tmp/%(id)s" "URL"
 ```
 ### 搜索/热门/排行 (bili-cli)
 ```bash
 # 搜索视频
 bili search "query" --type video -n 5
-# 热门视频
+# 热门视频 / 排行榜
 bili hot -n 10
 # 排行榜
 bili rank -n 10
 # 下载音频并切分为 ASR-ready WAV（无字幕时配合 agent-reach transcribe 转写）
 bili audio BVxxx
 ```
-> **412 风控**: 海外 IP 必须提供 Cookie（`--cookies-from-browser chrome` 或 `--cookies /path/to/cookies.txt`），国内 IP 一般不受影响。
+### 字幕 (OpenCLI，需要桌面 Chrome)
-> **安装 bili-cli**: `pipx install bilibili-cli`，然后 `bili login` 扫码登录。
+
 ```bash
 # 字幕逐句带时间轴
 opencli bilibili subtitle BVxxx
 # OpenCLI 也能搜索/读视频元数据（备选）
 opencli bilibili search "query" -f yaml
 opencli bilibili video BVxxx -f yaml
 ```
 ### 零配置兜底：搜索 API 直连
 ```bash
 UA="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"
 curl -s -c /tmp/bili_ck.txt -o /dev/null -A "$UA" "https://www.bilibili.com/"
 curl -s -b /tmp/bili_ck.txt -A "$UA" -e "https://www.bilibili.com/" \
  "https://api.bilibili.com/x/web-interface/search/all/v2?keyword=QUERY&page=1"
 ```
 > **安装 bili-cli**: `pipx install bilibili-cli`（上游 2026-03 起停更但实测健康；只读场景无需登录，`bili login` 扫码可解锁动态/收藏等个人功能）。
 ## 小宇宙播客 / Xiaoyuzhou Podcast
@@ -111,6 +124,7 @@ agent-reach doctor
 | 场景 | 推荐工具 |
 |-----|---------|
 | YouTube 字幕 | yt-dlp |
-| B站字幕 | yt-dlp |
+| B站视频详情/搜索 | bili-cli |
 | B站字幕 | opencli bilibili subtitle |
 | 播客转录 | 小宇宙 transcribe.sh |
-| 无字幕音视频 | agent-reach transcribe |
+| 无字幕音视频 | agent-reach transcribe（B站音频先 `bili audio`） |
@@ -58,9 +58,16 @@ def _require(binary: str) -> None:
        raise MissingDependency(f"{binary} not found in PATH")
-def _run(cmd: List[str]) -> None:
+def _run(cmd: List[str], timeout: int = 600) -> None:
-    """Run a subprocess, raising TranscribeError on nonzero exit."""
+    """Run a subprocess, raising TranscribeError on nonzero exit or timeout.
-    proc = subprocess.run(cmd, capture_output=True, text=True)
+
    cmd carries user-supplied URLs/paths into yt-dlp/ffmpeg — a stalled
    network read or a hung probe must not block the CLI forever.
    """
    try:
        proc = subprocess.run(cmd, capture_output=True, text=True, timeout=timeout)
    except subprocess.TimeoutExpired:
        raise TranscribeError(f"{cmd[0]} timed out after {timeout}s")
    if proc.returncode != 0:
        raise TranscribeError(
            f"{cmd[0]} failed (exit {proc.returncode}): {proc.stderr.strip()[:300]}"
@@ -82,7 +89,8 @@ def download_audio(url: str, out_dir: Path) -> Path:
            "-o",
            str(template),
            url,
-        ]
+        ],
        timeout=1800,  # long podcasts over slow networks — generous but bounded
    )
    files = sorted(out_dir.glob("source.*"))
    if not files:
@@ -4,6 +4,10 @@
  <strong>Give your AI Agent one-click access to the entire internet</strong>
 </p>
 <p align="center">
  The most reliable access path for each platform — chosen, installed, and health-checked for you. Backends come and go; you won't notice.
 </p>
 <p align="center">
  <a href="../LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a>
  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.10+-green.svg?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.10+"></a>
@@ -51,7 +55,7 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma
 |---|---|
 | 💰 **Completely free** | All tools are open source, all APIs are free. The only possible cost is a server proxy ($1/month) — local computers don't need one |
 | 🔒 **Privacy safe** | Cookies stay local. Never uploaded. Fully open source — audit anytime |
-| 🔄 **Kept up to date** | Upstream tools (yt-dlp, twitter-cli, rdt-cli, Jina Reader, etc.) are tracked and updated regularly |
+| 🔄 **Kept up to date** | Every platform routes through a primary + fallback backend list. When an access path dies, we switch to the next — you won't notice (June 2026: Bilibili 412-blocked yt-dlp → switched to bili-cli, zero action on your side) |
 | 🤖 **Works with any Agent** | Claude Code, OpenClaw, Cursor, Windsurf… any Agent that can run commands |
 | 🩺 **Built-in diagnostics** | `agent-reach doctor` — one command shows what works, what doesn't, and how to fix it |
@@ -63,7 +67,7 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma
 |----------|-------------|:-----:|-------|
 | 🌐 **Web** | Read | Zero config | Any URL → clean Markdown ([Jina Reader](https://github.com/jina-ai/reader) ⭐9.8K) |
 | 🐦 **Twitter/X** | Read · Search | Cookie | Cookie unlocks search, timeline, tweet reading, articles ([twitter-cli](https://github.com/public-clis/twitter-cli)) |
-| 📕 **XiaoHongShu** | Read · Search · **Post · Comment · Like** | Cookie | `pipx install xiaohongshu-cli` + `xhs login` ([xhs-cli](https://github.com/jackwener/xiaohongshu-cli)) |
+| 📕 **XiaoHongShu** | Read · Search · Comments | OpenCLI / MCP | Desktop: [OpenCLI](https://github.com/jackwener/opencli) (reuses browser session); Server: [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) (QR login); legacy xhs-cli still works |
 | 💼 **LinkedIn** | Jina Reader (public pages) | Full profiles, companies, job search | Tell your Agent "help me set up LinkedIn" |
 | 💻 **V2EX** | Hot topics · Node topics · Topic detail + replies · User profile | Zero config | Public JSON API, no auth required. Great for tech community content |
 | 📈 **Xueqiu (雪球)** | Stock quotes · Search · Hot posts · Hot stocks | Browser cookie | Tell your Agent "help me set up Xueqiu" |
@@ -71,9 +75,9 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma
 | 🔍 **Web Search** | Search | Auto-configured | Auto-configured during install, free, no API key ([Exa](https://exa.ai) via [mcporter](https://github.com/nicepkg/mcporter)) |
 | 📦 **GitHub** | Read · Search | Zero config | [gh CLI](https://cli.github.com) powered. Public repos work immediately. `gh auth login` unlocks Fork, Issue, PR |
 | 📺 **YouTube** | Read · **Search** | Zero config | Subtitles + search across 1800+ video sites ([yt-dlp](https://github.com/yt-dlp/yt-dlp) ⭐148K) |
-| 📺 **Bilibili** | Read · **Search** | Zero config / Proxy | Video info + subtitles + search. Local works directly, servers need a proxy ([yt-dlp](https://github.com/yt-dlp/yt-dlp)) |
+| 📺 **Bilibili** | Read · **Search** | Zero config | Search + video detail via [bili-cli](https://github.com/public-clis/bilibili-cli) (no login needed); subtitles via [OpenCLI](https://github.com/jackwener/opencli). yt-dlp is 412-blocked by Bilibili and no longer used here |
 | 📡 **RSS** | Read | Zero config | Any RSS/Atom feed ([feedparser](https://github.com/kurtmckee/feedparser) ⭐2.3K) |
-| 📖 **Reddit** | Search · Read | Cookie | Requires auth since 2024 — `rdt login` after install ([rdt-cli](https://github.com/public-clis/rdt-cli)) |
+| 📖 **Reddit** | Search · Read | OpenCLI / Cookie | No zero-config path (anonymous endpoints blocked). Desktop: [OpenCLI](https://github.com/jackwener/opencli) via browser session; or [rdt-cli](https://github.com/public-clis/rdt-cli) + cookie |
 > **Setup levels:** Zero config = install and go · Auto-configured = handled during install · mcporter = needs MCP service · Cookie = export from browser · Proxy = $1/month
@@ -160,11 +164,11 @@ Don't use it? Don't configure it. Every step is optional.
 Tell your Agent "help me configure Twitter cookies" — it'll guide you through exporting from your browser. Local computers can auto-import.
-### 🌐 Proxy — $1/month, servers only
+### 🌐 Proxy — $1/month, restricted networks only
-Bilibili blocks server IPs. Get a proxy ([Webshare](https://webshare.io) recommended, $1/month) and send the address to your Agent.
+Most users need no proxy. If your network blocks Reddit/Twitter (e.g. mainland China) get one ([Webshare](https://webshare.io) recommended, $1/month) and send the address to your Agent — it saves it and exports HTTP(S)_PROXY when calling those tools.
-> Reddit now works free via rdt-cli without any proxy. Local computers don't need a proxy for Bilibili either.
+> Reddit needs a logged-in session either way — OpenCLI rides your browser session, or rdt-cli after `rdt login`. Bilibili works via bili-cli without a proxy.
 ---
@@ -180,7 +184,7 @@ $ agent-reach doctor
  ✅ GitHub repos and code — public repos readable and searchable
  ✅ Twitter/X tweets — readable. Cookie unlocks search and posting
  ✅ YouTube video subtitles — yt-dlp
-  ⚠️  Bilibili video info — server IPs may be blocked, configure proxy
+  ✅ Bilibili search & video detail — bili-cli (subtitles via OpenCLI)
  ✅ RSS/Atom feeds — feedparser
  ✅ Web pages (any URL) — Jina Reader API
@@ -188,8 +192,8 @@ $ agent-reach doctor
  ⬜ Web semantic search — sign up at exa.ai for free key
 🔧 Configurable:
-  ✅ Reddit posts and comments — search and read via rdt-cli (free, no proxy)
+  ⬜ Reddit posts and comments — needs login: rdt-cli after `rdt login`, or OpenCLI browser session
-  ⬜ XiaoHongShu notes — needs cookie. Export from browser
+  ⬜ XiaoHongShu notes — desktop: OpenCLI (browser session); server: xiaohongshu-mcp (QR)
 Status: 6/9 channels available
 ```
@@ -198,52 +202,50 @@ Status: 6/9 channels available
 ## Design Philosophy
-**Agent Reach is a scaffolding tool, not a framework.**
+**Agent Reach is a capability layer, not yet another tool.**
-Every time you spin up a new Agent, you spend time finding tools, installing deps, and debugging configs — what reads Twitter? How do you bypass Reddit blocks? How do you extract YouTube subtitles? Every time, you re-do the same work.
+It sits one level above any specific implementation — it handles **selection, installation, health checks, and routing**, not the reading itself. Reading is done by your Agent calling upstream tools directly; there is no wrapper layer.
-Agent Reach does one simple thing: **it makes those tool selection and configuration decisions for you.**
+Every time you spin up a new Agent, you spend time finding tools, installing deps, and debugging configs — what reads Twitter? How do you log into Reddit? What replaces a discontinued XiaoHongShu CLI? Every time, you re-do the same work. Agent Reach does one simple thing: **the most reliable access path for each platform, chosen, installed, and health-checked for you. Access paths come and go (in March 2026 a batch of single-platform CLIs went unmaintained — we re-routed), so you don't have to care.**
-After installation, your Agent calls the upstream tools directly (twitter-cli, rdt-cli, xhs-cli, yt-dlp, mcporter, gh CLI, etc.) — no wrapper layer in between.
+### 🔌 Every platform = an ordered backend list (primary + fallbacks)
-### 🔌 Every Channel is Pluggable
+Switching access paths means reordering the list, not rewriting code. `agent-reach doctor` tells you **which backend each platform is currently using**.
 Each platform maps to an upstream tool. **Don't like one? Swap it out.**
 ```
 channels/
-├── web.py          → Jina Reader     ← swap to Firecrawl, Crawl4AI…
+├── web.py          → Jina Reader
-├── twitter.py      → twitter-cli      ← swap to official API…
+├── twitter.py      → twitter-cli ▸ OpenCLI ▸ bird
-├── youtube.py      → yt-dlp          ← swap to YouTube API, Whisper…
+├── youtube.py      → yt-dlp
-├── github.py       → gh CLI          ← swap to REST API, PyGithub…
+├── github.py       → gh CLI
-├── bilibili.py     → yt-dlp          ← swap to bilibili-api…
+├── bilibili.py     → bili-cli ▸ OpenCLI ▸ search API (yt-dlp retired, 412-blocked)
-├── reddit.py       → rdt-cli          ← search + read, cookie auth required
+├── reddit.py       → OpenCLI ▸ rdt-cli (no zero-config path, login required)
-├── xiaohongshu.py  → mcporter MCP    ← swap to other XHS tools…
+├── xiaohongshu.py  → OpenCLI ▸ xiaohongshu-mcp ▸ xhs-cli
-├── linkedin.py     → linkedin-mcp    ← swap to LinkedIn API…
+├── linkedin.py     → linkedin-mcp ▸ Jina Reader
-├── rss.py          → feedparser      ← swap to atoma…
+├── rss.py          → feedparser
-├── exa_search.py   → mcporter MCP    ← swap to Tavily, SerpAPI…
+├── exa_search.py   → Exa via mcporter
 └── __init__.py     → Channel registry (for doctor checks)
 ```
-Each channel file only checks whether its upstream tool is installed and working (`check()` method for `agent-reach doctor`). The actual reading and searching is done by calling the upstream tools directly.
+Each channel file **actually probes** its candidate backends in order (not just checking that a command exists) — the first fully working one becomes the active backend, and broken ones come with a fix prescription. The actual reading and searching is done by the Agent calling the upstream tools directly.
 ### Current Tool Choices
-| Scenario | Tool | Why |
+| Scenario | Primary | Fallback | Why |
-|----------|------|-----|
+|----------|---------|----------|-----|
-| Read web pages | [Jina Reader](https://github.com/jina-ai/reader) | 9.8K stars, free, no API key needed |
+| Read web pages | [Jina Reader](https://github.com/jina-ai/reader) | — | Free, no API key needed |
-| Read tweets | [twitter-cli](https://github.com/public-clis/twitter-cli) | 2.1K stars, cookie auth, search/read/timeline/articles |
+| Read tweets | [twitter-cli](https://github.com/public-clis/twitter-cli) | [OpenCLI](https://github.com/jackwener/opencli) | Reliable search in real-world tests; OpenCLI falls back on your browser session |
-| Reddit | [rdt-cli](https://github.com/public-clis/rdt-cli) | 304 stars, cookie auth, search + full posts + comments |
+| Reddit | [OpenCLI](https://github.com/jackwener/opencli) (desktop) | [rdt-cli](https://github.com/public-clis/rdt-cli) | Anonymous endpoints blocked, official API gated — logged-in sessions are the only route left |
-| Video subtitles + search | [yt-dlp](https://github.com/yt-dlp/yt-dlp) | 154K stars, YouTube + Bilibili + 1800 sites |
+| YouTube subtitles + search | [yt-dlp](https://github.com/yt-dlp/yt-dlp) | — | 154K stars, still the best for YouTube (no longer used for Bilibili) |
-| Bilibili enhanced | [bili-cli](https://github.com/public-clis/bilibili-cli) | 590 stars, hot/rank/search/feed |
+| Bilibili | [bili-cli](https://github.com/public-clis/bilibili-cli) | OpenCLI ▸ search API | yt-dlp is 412-blocked by Bilibili (verified June 2026); bili-cli searches and reads without login |
-| Search the web | [Exa](https://exa.ai) via [mcporter](https://github.com/nicobailon/mcporter) | AI semantic search, MCP integration, no API key |
+| Search the web | [Exa](https://exa.ai) via [mcporter](https://github.com/nicobailon/mcporter) | — | AI semantic search, MCP integration, no API key |
-| GitHub | [gh CLI](https://cli.github.com) | Official tool, full API after auth |
+| GitHub | [gh CLI](https://cli.github.com) | — | Official tool, full API after auth |
-| Read RSS | [feedparser](https://github.com/kurtmckee/feedparser) | Python ecosystem standard, 2.3K stars |
+| Read RSS | [feedparser](https://github.com/kurtmckee/feedparser) | — | Python ecosystem standard |
-| XiaoHongShu | [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) | 1.5K stars, pipx install, search/read/comment/post |
+| XiaoHongShu | [OpenCLI](https://github.com/jackwener/opencli) (desktop) | [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) (server) ▸ xhs-cli | The xhs-cli author moved to OpenCLI (24K stars); browser sessions mean zero friction |
-| LinkedIn | [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server) | 1.2K stars, MCP server, browser automation |
+| LinkedIn | [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server) | Jina Reader | MCP server, browser automation |
-| Xiaoyuzhou Podcast | `transcribe.sh` | `bash ~/.agent-reach/tools/xiaoyuzhou/transcribe.sh <URL>` |
+| Xiaoyuzhou Podcast | `transcribe.sh` | — | `bash ~/.agent-reach/tools/xiaoyuzhou/transcribe.sh <URL>` |
-> 📌 These are the *current* choices. Don't like one? Swap out the file. That's the whole point of scaffolding.
+> 📌 These are the *current* choices, re-verified regularly on real machines. When a path dies we switch to the next — `agent-reach doctor` always tells you which one is active.
 ---
@@ -276,7 +278,7 @@ Agent Reach uses [twitter-cli](https://github.com/public-clis/twitter-cli) with
 <details>
 <summary><strong>Reddit returns 403 from server / datacenter IP blocked?</strong></summary>
-Agent Reach uses [rdt-cli](https://github.com/public-clis/rdt-cli) for Reddit. Since 2024, Reddit requires authentication for all API requests. Install with `pipx install rdt-cli`, then run `rdt login` (auto-extracts cookies from your browser). Your agent can then search with `rdt search "query"` and read full posts + comments with `rdt read POST_ID`.
+Reddit requires a logged-in session for everything (anonymous endpoints are blocked, and official API registration has been approval-gated since 2025-11). On desktop, the preferred path is OpenCLI riding your browser's reddit.com session. Otherwise install rdt-cli from the pinned git source (`pipx install 'git+https://github.com/public-clis/rdt-cli.git'` — PyPI lags), then `rdt login`. Your agent can then search with `rdt search "query"` and read full posts + comments with `rdt read POST_ID`.
 </details>
 <details>
@@ -288,7 +290,7 @@ Yes! Agent Reach is an installer + configuration tool. Any AI coding agent that
 <details>
 <summary><strong>Is Agent Reach free? Any API costs?</strong></summary>
-100% free and open source. All backends (twitter-cli, rdt-cli, xhs-cli, yt-dlp, Jina Reader, Exa) are free tools that don't require paid API keys. The only optional cost is a residential proxy (~$1/month) if you need Bilibili access from a server. Reddit works free via rdt-cli without any proxy.
+100% free and open source. All backends (twitter-cli, rdt-cli, xhs-cli, yt-dlp, Jina Reader, Exa) are free tools that don't require paid API keys. The only optional cost is a residential proxy (~$1/month) for some server scenarios. Reddit costs nothing but needs a logged-in session (rdt-cli after `rdt login`, or OpenCLI reusing your browser session).
 </details>
 <details>
@@ -300,7 +302,7 @@ Agent Reach uses twitter-cli which accesses Twitter via cookie auth — same as
 <details>
 <summary><strong>How to read XiaoHongShu / 小红书 content programmatically?</strong></summary>
-Install `pipx install xiaohongshu-cli`, then `xhs login` (auto-extracts cookies from browser). Your agent can then use `xhs search "query"` to search notes, `xhs read NOTE_ID` to read details, `xhs comments NOTE_ID` to view comments. No Docker needed.
+On desktop, prefer **OpenCLI** (`agent-reach install --channels opencli`) — it reuses your browser's logged-in session, so if you've browsed XiaoHongShu you're set; one Chrome Web Store click installs the extension. Then `opencli xiaohongshu search "query"` / `opencli xiaohongshu note URL`. On servers use [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) (bundled headless browser, QR login). Existing xhs-cli installs keep working as a fallback backend (upstream unmaintained since 2026-03, not recommended for new setups).
 </details>
 ---
@@ -20,7 +20,7 @@ Copy this to your AI Agent:
 ### Goal
-Install Agent Reach and all upstream tools so your user's agent has full internet access. After installation, you'll use the upstream tools directly (twitter-cli, rdt-cli, xhs-cli, yt-dlp, mcporter, gh CLI, etc.) — Agent Reach is just the installer and health checker.
+Install Agent Reach and all upstream tools so your user's agent has full internet access. After installation, you'll use the upstream tools directly (OpenCLI, twitter-cli, bili-cli, rdt-cli, yt-dlp, mcporter, gh CLI, etc.) — Agent Reach is the selector, installer, health checker and router, never a wrapper.
 ### ⚠️ Boundaries
@@ -96,12 +96,13 @@ After installing the basics, **ask the user** which additional channels they nee
 >
 > 还有这些可选渠道，你需要哪些？
 >
 > - 🌟 **OpenCLI**（桌面推荐）— 一次安装，小红书/Reddit/B站字幕/Twitter 备选全解锁（复用浏览器登录态，零配置；只需在 Chrome 商店点一次"添加扩展"）
 > - 🐦 **Twitter/X** — 搜推文、看时间线（需要登录 Cookie）
 > - 📈 **雪球** — 股票行情、热门帖子（需要登录 Cookie）
 > - 🎙️ **小宇宙播客** — 音频转文字（需要免费 Groq Key）
-> - 📕 **小红书** — 阅读、搜索、发帖（需要登录）
+> - 📕 **小红书** — 搜索、阅读、评论（桌面走 OpenCLI；服务器用 xiaohongshu-mcp 扫码）
-> - 📖 **Reddit** — 搜索和阅读帖子
+> - 📖 **Reddit** — 搜索和阅读帖子（必须登录态：桌面 OpenCLI 或 rdt-cli + Cookie）
-> - 📺 **B站完整版** — 热门、排行、搜索
+> - 📺 **B站完整版** — 热门、排行、搜索、视频详情（bili-cli，无需登录）
 > - 💼 **LinkedIn** — Profile、职位搜索
 >
 > 告诉我你要哪些，比如"帮我装小红书和 Twitter"。或者说"全部装"。
@@ -109,11 +110,11 @@ After installing the basics, **ask the user** which additional channels they nee
 Based on the user's choice, run:
 ```bash
-agent-reach install --env=auto --channels=twitter,xiaohongshu   # Example: user chose Twitter + XHS
+agent-reach install --env=auto --channels=opencli,xiaohongshu   # Example: desktop user chose XHS (OpenCLI-backed)
 agent-reach install --env=auto --channels=all              # User wants everything
 ```
-Supported channel names: `twitter`, `xiaoyuzhou`, `xueqiu`, `xiaohongshu`, `reddit`, `bilibili`, `linkedin`, `all`
+Supported channel names: `opencli`, `twitter`, `xiaoyuzhou`, `xueqiu`, `xiaohongshu`, `reddit`, `bilibili`, `linkedin`, `all`
 ### Step 3: Fix what's broken
@@ -159,44 +160,44 @@ agent-reach configure twitter-cookies "PASTED_STRING"
 >
 > 如果用户报告 "fetch failed"，参考 [troubleshooting.md](troubleshooting.md)
-**Reddit & Bilibili full access (server users):**
+**Reddit (login is mandatory — no zero-config path):**
-> "Reddit and Bilibili block server IPs. To unlock full access, I need a residential proxy. You can get one at https://webshare.io ($1/month). Send me the proxy address."
+> Reddit 的匿名接口已被封、官方 API 需人工审批。桌面用户首选 OpenCLI（浏览器里登录过 reddit.com 即可用）；服务器/存量用户用 rdt-cli：
 ```bash
-agent-reach configure proxy http://user:pass@ip:port
+# PyPI 落后，从 GitHub 装（与代码内 _RDT_GIT_SOURCE 同一钉定版本）
 pipx install 'git+https://github.com/public-clis/rdt-cli.git@5e4fb3720d5c174e976cd425ccc3b879d52cac66'
 rdt login   # 自动提取浏览器 Cookie；服务器无浏览器时按 doctor 提示手动写 Cookie
 ```
-**XiaoHongShu / 小红书 (xhs-cli):**
+> 中国大陆访问 Reddit 需要代理；服务器 IP 被风控时可配住宅代理（如 https://webshare.io，约 $1/月）：
 > "小红书通过 xhs-cli 访问，pipx 一行安装，不需要 Docker。"
 ```bash
 pipx install xiaohongshu-cli
 xhs login
 ```
 > `xhs login` 会自动从浏览器提取 Cookie。如果自动提取失败，可以手动导入：
 >
 > **手动导入 Cookie（Cookie-Editor 方式）：**
 > 1. 用户在自己的浏览器登录小红书 (xiaohongshu.com)
 > 2. 用 [Cookie-Editor](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm) 插件导出 Cookie（JSON 或 Header String 格式均可）
 > 3. 把 Cookie 字符串发给 Agent
 > 4. Agent 运行命令完成登录：
 >
 > ```bash
-> # JSON 格式（Cookie-Editor → Export → JSON）
+> agent-reach configure proxy http://user:pass@ip:port
 > agent-reach configure xhs-cookies '[{"name":"web_session","value":"xxx","domain":".xiaohongshu.com",...}]'
 >
 > # 或 Header String 格式（Cookie-Editor → Export → Header String）
 > agent-reach configure xhs-cookies "key1=val1; key2=val2; ..."
 > ```
 **XiaoHongShu / 小红书（多后端，按环境选）:**
 > **桌面电脑（推荐 OpenCLI）：**
 > "小红书走 OpenCLI——复用你浏览器里的登录态，平时刷过小红书就直接能用，零配置。"
 ```bash
 agent-reach install --channels opencli
 ```
 > 装完后引导用户做唯一一步手动操作（Chrome 安全限制，无法代劳）：
 > 1. 打开 https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk
 > 2. 点「添加至 Chrome」
 > 3. 运行 `opencli doctor` 验证（显示 Extension: connected 即成功）
 >
-> **注意：** 推荐使用 Cookie-Editor 导出方式，不要依赖 QR 扫码登录。
+> **服务器 / 无桌面环境（xiaohongshu-mcp）：**
 > 1. 从 https://github.com/xpzouying/xiaohongshu-mcp/releases 下载对应平台 binary 到 `~/.agent-reach/tools/`
 > 2. 启动服务（首次运行会自动下载约 150MB 无头浏览器，耐心等完成）
 > 3. 让用户扫码登录（agent 调 `get_login_qrcode` 工具取二维码）
 > 4. 接入：`mcporter config add xiaohongshu http://localhost:18060/mcp`
 > 5. 调用时务必带 `--timeout 120000`
 >
-> **备选方案：Docker MCP**
+> **存量用户（xhs-cli）：** 已装好的 xhs-cli 继续作为备选后端工作（上游 2026-03 起停更，不推荐新装）。`xhs login` 自动提取浏览器 Cookie；失败时用 Cookie-Editor 导出后：
 > 如果你已经在使用 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) Docker 方案，它也能正常工作：
 > ```bash
-> docker run -d --name xiaohongshu-mcp -p 18060:18060 xpzouying/xiaohongshu-mcp
+> agent-reach configure xhs-cookies "key1=val1; key2=val2; ..."
 > mcporter config add xiaohongshu http://localhost:18060/mcp
 > ```
 **雪球 / Xueqiu (股票行情 + 热门帖子):**
@@ -292,7 +293,7 @@ If the user agrees, create a **cron job** (daily, `sessionTarget: "isolated"`, `
 运行 agent-reach watch 命令。
 如果输出包含"全部正常"，不需要通知用户，静默结束。
 如果输出包含问题（❌ ⚠️）或新版本（🆕），把完整报告发给用户，并建议修复方案。
-如果有新版本可用，问用户是否要升级（升级命令：pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip）。
+如果有新版本可用，问用户是否要升级（把这句话发给用户的 Agent 即可完整更新：帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md）。
 ```
 If the user wants a different agent to handle it, let them choose.
@@ -312,21 +313,23 @@ If the user wants a different agent to handle it, let them choose.
 | `agent-reach watch` | Quick health + update check (for scheduled tasks) |
 | `agent-reach check-update` | Check for new versions |
 | `agent-reach configure twitter-cookies "..."` | Unlock Twitter search + posting |
-| `agent-reach configure proxy URL` | Unlock Reddit + Bilibili on servers |
+| `agent-reach configure proxy URL` | 保存代理地址（Agent 访问 Reddit/Twitter 等受限网络时读取它设置 HTTP_PROXY/HTTPS_PROXY，不是自动解锁开关） |
 | `agent-reach configure groq-key gsk_xxx` | Unlock Xiaoyuzhou podcast transcription |
 After installation, use upstream tools directly. See SKILL.md for the full command reference:
 | Platform | Upstream Tool | Example |
 |----------|--------------|---------|
-| Twitter/X | `twitter` | `twitter search "query" -n 10` |
+| Twitter/X | `twitter`（备选 `opencli`） | `twitter search "query" -n 10` |
 | YouTube | `yt-dlp` | `yt-dlp --dump-json URL` |
-| Bilibili | `yt-dlp` + `bili` | `bili hot` / `bili search "query" --type video` |
+| Bilibili | `bili`（字幕走 `opencli`） | `bili search "query" --type video` / `opencli bilibili subtitle BVxxx` |
-| Reddit | `rdt` | `rdt search "query"` / `rdt read POST_ID` |
+| Reddit | `opencli`（备选 `rdt`） | `opencli reddit search "query" -f yaml` / `rdt read POST_ID` |
 | GitHub | `gh` | `gh search repos "query"` |
 | Web | `curl` + Jina | `curl -s "https://r.jina.ai/URL"` |
 | Exa Search | `mcporter` | `mcporter call 'exa.web_search_exa(...)'` |
-| 小红书 | `mcporter` | `mcporter call 'xiaohongshu.search_feeds(...)'` |
+| 小红书 | `opencli`（服务器 `mcporter`） | `opencli xiaohongshu search "query" -f yaml` |
 | 小宇宙播客 | `transcribe.sh` | `bash ~/.agent-reach/tools/xiaoyuzhou/transcribe.sh <URL>` |
 | LinkedIn | `mcporter` | `mcporter call 'linkedin.get_person_profile(...)'` |
 | RSS | `feedparser` | `python3 -c "import feedparser; ..."` |
 > 多后端平台以 `agent-reach doctor --json` 的 `active_backend` 为准。
@@ -24,7 +24,7 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma
 ### Goal
-Update Agent Reach to the latest version, install any new upstream tools, migrate from deprecated tools, and verify everything works. The user should not need to do anything manually.
+Update Agent Reach to the latest version, refresh upstream tools, migrate from retired backends, and verify everything works. The user should not need to do anything manually (except things only a human can do, like clicking a browser-extension install button).
 ### Step 1: Check current version
@@ -32,7 +32,7 @@ Update Agent Reach to the latest version, install any new upstream tools, migrat
 agent-reach check-update
 ```
-If it says "已是最新版本", skip to Step 5 (verify). Otherwise continue.
+If it says "已是最新版本", skip to Step 4 (verify). Otherwise continue.
 ### Step 2: Update Agent Reach package
@@ -40,40 +40,47 @@ If it says "已是最新版本", skip to Step 5 (verify). Otherwise continue.
 pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip
 ```
-### Step 3: Install / migrate upstream tools
+> If pip complains about `externally-managed-environment` (PEP 668), the user
 > originally installed via pipx or a venv — use the matching command:
 > `pipx install --force https://github.com/Panniantong/agent-reach/archive/main.zip`
 > or activate `~/.agent-reach-venv` first.
-Run these commands to ensure all upstream CLI tools are installed. Skip any that are already installed.
+### Step 3: Refresh upstream tools
 Run these to keep installed tools current. **Only upgrade what is already
 installed — do not install new tools the user never asked for** (the one
 exception: OpenCLI on desktop, see below).
 ```bash
-# === Required tools (core functionality) ===
+# Python-based CLIs the user already has (upgrade keeps signatures fresh)
 which twitter >/dev/null 2>&1 && { pipx upgrade twitter-cli 2>/dev/null || uv tool upgrade twitter-cli 2>/dev/null; }
 which bili    >/dev/null 2>&1 && { pipx upgrade bilibili-cli 2>/dev/null || uv tool upgrade bilibili-cli 2>/dev/null; }
 which xhs     >/dev/null 2>&1 && { pipx upgrade xiaohongshu-cli 2>/dev/null || uv tool upgrade xiaohongshu-cli 2>/dev/null; }
 which yt-dlp  >/dev/null 2>&1 && { pipx upgrade yt-dlp 2>/dev/null || uv tool upgrade yt-dlp 2>/dev/null || pip install -U yt-dlp 2>/dev/null; }
-# Twitter/X — twitter-cli (replaces deprecated bird CLI)
+# rdt-cli is pinned to a git source (PyPI lags upstream) — same pin as the code's _RDT_GIT_SOURCE
-which twitter >/dev/null 2>&1 || pipx install twitter-cli 2>/dev/null || uv tool install twitter-cli 2>/dev/null
+which rdt >/dev/null 2>&1 && pipx install --force 'git+https://github.com/public-clis/rdt-cli.git@5e4fb3720d5c174e976cd425ccc3b879d52cac66' 2>/dev/null
-# Reddit — rdt-cli (replaces Exa-based approach; PyPI lags, install from GitHub)
+# npm-based
-which rdt >/dev/null 2>&1 || pipx install 'git+https://github.com/public-clis/rdt-cli.git' 2>/dev/null || uv tool install --from 'git+https://github.com/public-clis/rdt-cli.git' rdt-cli 2>/dev/null
+which mcporter >/dev/null 2>&1 && npm update -g mcporter 2>/dev/null
-
+which opencli  >/dev/null 2>&1 && npm update -g @jackwener/opencli 2>/dev/null
 # XiaoHongShu — xhs-cli (replaces Docker MCP)
 which xhs >/dev/null 2>&1 || pipx install xiaohongshu-cli 2>/dev/null || uv tool install xiaohongshu-cli 2>/dev/null
 # === Optional enhancements ===
 # Bilibili — bili-cli (adds hot/rank/search on top of yt-dlp)
 which bili >/dev/null 2>&1 || pipx install bilibili-cli 2>/dev/null || uv tool install bilibili-cli 2>/dev/null
 # mcporter + Exa (for WeChat, web search)
 which mcporter >/dev/null 2>&1 || npm install -g mcporter 2>/dev/null
 # yt-dlp (YouTube + Bilibili video)
 which yt-dlp >/dev/null 2>&1 || pip install yt-dlp 2>/dev/null
 # gh CLI (GitHub)
 which gh >/dev/null 2>&1 || echo "GitHub CLI not installed — see https://cli.github.com"
 ```
 **Desktop users without OpenCLI**: since v1.5.0 OpenCLI is the preferred
 backend for 小红书/Reddit (and adds B站 subtitles) by riding the user's
 browser session. Offer it once:
 > "这次更新引入了 OpenCLI 后端（复用你的浏览器登录态，小红书/Reddit 零配置）。要装吗？装完只需你在 Chrome 商店点一次『添加扩展』。"
 If yes: `agent-reach install --channels opencli` and guide them through the
 extension click. If no, everything keeps working on existing backends.
 ### Step 4: Coexistence (DO NOT uninstall old tools)
-**IMPORTANT: Never uninstall any existing tools the user already has installed.** Old tools (bird, browser_cookie3, miku_ai, etc.) may still be working on the user's machine even if their upstream repos are archived or deleted. Agent Reach supports both old and new tools as fallback. Only install new tools alongside existing ones.
+**Never uninstall tools the user already has.** Retired backends (e.g. yt-dlp
 no longer serves Bilibili; xhs-cli is no longer installed by default) keep
 working as fallbacks where they still function. Agent Reach routes around
 them automatically — removal is the user's call, not yours.
 ### Step 5: Verify
@@ -82,51 +89,27 @@ agent-reach version
 agent-reach doctor
 ```
 Running `agent-reach doctor` (text mode) also auto-syncs the bundled skill
 (SKILL.md + references) into every detected agent skill directory — no
 separate skill-update step is needed.
 Check the doctor output:
 - All channels should show ✅ or ⚠️ (with clear instructions)
 - If any channel that was working before now shows ❌, investigate:
  - Twitter: needs `twitter-cli` + browser cookies (run `xhs login` pattern)
  - Reddit: needs `rdt-cli` (should be installed in Step 3)
  - XiaoHongShu: needs `xhs-cli` + login (run `xhs login`)
  - WeChat: should work via Exa (zero config)
-### Step 6: Update SKILL.md (if installed)
+- Every channel shows ✅ / [!] with a clear message, and multi-backend
  channels (小红书/Reddit/B站/Twitter) report `当前后端：…`
 - If a previously-working channel now shows [X]/error, the message contains
  the exact fix (e.g. a venv-reinstall prescription) — run it, then re-check
 - `--json` gives the same data machine-readably (`active_backend` per channel)
-```bash
+### Step 6: Report to user
 agent-reach install --skill-only 2>/dev/null || python3 -c "
 import importlib.resources, os
 try:
    skill_pkg = importlib.resources.files('agent_reach').joinpath('skill')
 except Exception:
    from pathlib import Path
    skill_pkg = Path(os.path.dirname(os.path.abspath(__file__))).parent / 'agent_reach' / 'skill'
 skill_md = skill_pkg.joinpath('SKILL.md').read_text(encoding='utf-8')
 refs_pkg = skill_pkg.joinpath('references')
 for base in [os.path.expanduser('~/.openclaw/skills/agent-reach'),
             os.path.expanduser('~/.claude/skills/agent-reach'),
             os.path.expanduser('~/.agents/skills/agent-reach')]:
    if os.path.isdir(base):
        with open(os.path.join(base, 'SKILL.md'), 'w', encoding='utf-8') as f:
            f.write(skill_md)
        refs_dir = os.path.join(base, 'references')
        os.makedirs(refs_dir, exist_ok=True)
        for ref in refs_pkg.iterdir():
            name = ref.name if hasattr(ref, 'name') else str(ref).split('/')[-1]
            if name.endswith('.md'):
                with open(os.path.join(refs_dir, name), 'w', encoding='utf-8') as f:
                    f.write(ref.read_text(encoding='utf-8'))
        print(f'✅ Updated skill: {base}')
 "
 ```
 ### Step 7: Report to user
 Tell the user:
-1. What version they're now on (`agent-reach version`)
+
-2. How many channels are available (count ✅ in doctor output)
+1. What version they're on now (`agent-reach version`)
-3. Any channels that need their action (e.g., `xhs login` for XiaoHongShu, browser cookies for Twitter)
+2. How many channels are available, and which backend each multi-backend
-4. What changed in this update (major: Twitter/Reddit/XiaoHongShu upstream tools migrated for better stability)
+   platform is using (from doctor)
 3. Anything that needs their action (e.g. Chrome extension click, `xhs login`,
   QR scan for xiaohongshu-mcp on servers)
 4. What changed in this update (release notes shown by `check-update`)
 Done.
@@ -1,6 +1,6 @@
 [project]
 name = "agent-reach"
-version = "1.4.2"
+version = "1.5.0"
 description = "Give your AI Agent eyes to see the entire internet. Search + Read 10+ platforms."
 readme = "README.md"
 license = {text = "MIT"}
@@ -647,17 +647,36 @@ class TestXueqiuChannel:
 class TestRedditChannel:
-    def test_reports_off_when_not_installed(self, monkeypatch):
+    """多后端：OpenCLI > rdt-cli，没有零配置路径。"""
    @staticmethod
    def _isolate(monkeypatch, opencli=None):
        """隔离 OpenCLI 候选（None = 未安装），聚焦 rdt-cli 路径。"""
        from agent_reach.channels.reddit import RedditChannel
        monkeypatch.setattr(RedditChannel, "_check_opencli", lambda self: opencli)
    def test_reports_off_when_nothing_installed(self, monkeypatch):
        self._isolate(monkeypatch)
        monkeypatch.setattr(shutil, "which", lambda _: None)
        from agent_reach.channels.reddit import RedditChannel
        status, msg = RedditChannel().check()
        assert status == "off"
-        assert "rdt-cli" in msg
+        # 诚实口径：明说没有零配置路径，推荐 OpenCLI + rdt git 源
-        assert "public-clis/rdt-cli" in msg
+        assert "零配置" in msg
        assert "opencli" in msg
        assert "git+https://github.com/public-clis/rdt-cli.git" in msg
-        assert "rdt-cli>=0.4.2" not in msg
+
    def test_opencli_ready_wins(self, monkeypatch):
        self._isolate(monkeypatch, opencli=("ok", "OpenCLI 可用（复用浏览器登录态）"))
        monkeypatch.setattr(shutil, "which", lambda _: None)
        from agent_reach.channels.reddit import RedditChannel
        ch = RedditChannel()
        status, msg = ch.check()
        assert status == "ok"
        assert ch.active_backend == "OpenCLI"
    def test_reports_ok_when_authenticated(self, monkeypatch):
        self._isolate(monkeypatch)
        monkeypatch.setattr(shutil, "which", lambda _: "/usr/local/bin/rdt")
        fake_output = json.dumps({
            "ok": True,
@@ -677,6 +696,7 @@ class TestRedditChannel:
        assert ch.active_backend == "rdt-cli"
    def test_reports_warn_when_not_authenticated(self, monkeypatch):
        self._isolate(monkeypatch)
        monkeypatch.setattr(shutil, "which", lambda _: "/usr/local/bin/rdt")
        fake_output = json.dumps({
            "ok": True,
@@ -701,6 +721,7 @@ class TestRedditChannel:
    def test_reports_error_when_status_check_fails(self, monkeypatch):
        """rdt 非零退出且输出不可解析 → 工具异常（error），不再算 warn。"""
        self._isolate(monkeypatch)
        monkeypatch.setattr(shutil, "which", lambda _: "/usr/local/bin/rdt")
        def fake_run(cmd, **kwargs):
@@ -716,6 +737,7 @@ class TestRedditChannel:
    def test_reports_error_with_reinstall_hint_when_broken(self, monkeypatch):
        """which 命中但 exec 抛 FileNotFoundError（venv 断链）→ error + 重装处方。"""
        self._isolate(monkeypatch)
        monkeypatch.setattr(shutil, "which", lambda _: "/usr/local/bin/rdt")
        def fake_run(cmd, **kwargs):
@@ -733,6 +755,7 @@ class TestRedditChannel:
    def test_reports_error_with_reinstall_hint_on_exit_127(self, monkeypatch):
        """退出码 127（找到但跑不动）同样按断链处理。"""
        self._isolate(monkeypatch)
        monkeypatch.setattr(shutil, "which", lambda _: "/usr/local/bin/rdt")
        def fake_run(cmd, **kwargs):
@@ -923,9 +946,60 @@ class TestXiaoHongShuChannel:
 class TestBilibiliChannel:
-    def test_reports_error_with_reinstall_hint_when_ytdlp_broken(self, monkeypatch):
+    """多后端：bili-cli > OpenCLI > 搜索 API。yt-dlp 已退出 B站（412 实锤）。"""
-        """yt-dlp which 命中但 exec 失败（venv 断链）→ error + 重装处方。"""
+
-        monkeypatch.setattr(shutil, "which", lambda _: "/usr/local/bin/yt-dlp")
+    @staticmethod
    def _isolate(monkeypatch, opencli=None, api_ok=False):
        import agent_reach.channels.bilibili as bilibili_mod
        monkeypatch.setattr(
            bilibili_mod.BilibiliChannel, "_check_opencli", lambda self: opencli
        )
        monkeypatch.setattr(bilibili_mod, "_search_api_ok", lambda: api_ok)
    def test_bili_cli_ok_is_active_backend(self, monkeypatch):
        self._isolate(monkeypatch)
        monkeypatch.setattr(
            shutil, "which",
            lambda cmd: "/usr/local/bin/bili" if cmd == "bili" else None,
        )
        def fake_run(cmd, **kwargs):
            return subprocess.CompletedProcess(cmd, 0, "bili, version 0.6.2", "")
        monkeypatch.setattr(subprocess, "run", fake_run)
        from agent_reach.channels.bilibili import BilibiliChannel
        ch = BilibiliChannel()
        status, msg = ch.check()
        assert status == "ok"
        assert "bili-cli 可用" in msg
        assert ch.active_backend == "bili-cli"
    def test_bili_broken_falls_back_to_api_with_hint_kept(self, monkeypatch):
        """bili 断链 → API 兜底获胜，但重装处方必须保留在消息里。"""
        self._isolate(monkeypatch, api_ok=True)
        monkeypatch.setattr(
            shutil, "which",
            lambda cmd: "/usr/local/bin/bili" if cmd == "bili" else None,
        )
        def fake_run(cmd, **kwargs):
            raise FileNotFoundError(cmd[0])
        monkeypatch.setattr(subprocess, "run", fake_run)
        from agent_reach.channels.bilibili import BilibiliChannel
        ch = BilibiliChannel()
        status, msg = ch.check()
        assert status == "ok"  # 搜索 API 兜底
        assert ch.active_backend == "B站搜索 API"
        assert "备选后端异常" in msg
        assert "pipx reinstall bilibili-cli" in msg
    def test_bili_broken_and_no_fallback_reports_error(self, monkeypatch):
        self._isolate(monkeypatch, api_ok=False)
        monkeypatch.setattr(
            shutil, "which",
            lambda cmd: "/usr/local/bin/bili" if cmd == "bili" else None,
        )
        def fake_run(cmd, **kwargs):
            raise FileNotFoundError(cmd[0])
@@ -935,48 +1009,36 @@ class TestBilibiliChannel:
        ch = BilibiliChannel()
        status, msg = ch.check()
        assert status == "error"
-        assert "无法执行" in msg
+        assert "uv tool install --force bilibili-cli" in msg
        assert "uv tool install --force yt-dlp" in msg
        assert "pipx reinstall yt-dlp" in msg
        assert ch.active_backend is None
-    def test_active_backend_set_when_ytdlp_and_bili_ok(self, monkeypatch):
+    def test_opencli_serves_when_bili_missing(self, monkeypatch):
-        monkeypatch.setattr(
+        self._isolate(monkeypatch, opencli=("ok", "OpenCLI 可用（字幕）"), api_ok=True)
-            shutil, "which",
+        monkeypatch.setattr(shutil, "which", lambda _: None)
            lambda cmd: f"/usr/local/bin/{cmd}" if cmd in ("yt-dlp", "bili") else None,
        )
        def fake_run(cmd, **kwargs):
            return subprocess.CompletedProcess(cmd, 0, "2026.06.09", "")
        monkeypatch.setattr(subprocess, "run", fake_run)
        from agent_reach.channels.bilibili import BilibiliChannel
        ch = BilibiliChannel()
        status, msg = ch.check()
        assert status == "ok"
-        assert "bili-cli 可用" in msg
+        assert ch.active_backend == "OpenCLI"
        assert ch.active_backend == "yt-dlp"
-    def test_bili_broken_does_not_count_as_available(self, monkeypatch):
+    def test_api_only_still_ok_with_install_nudge(self, monkeypatch):
-        """bili-cli 断链时不计为可用，降级走搜索 API；yt-dlp 仍是 active_backend。"""
+        self._isolate(monkeypatch, api_ok=True)
-        monkeypatch.setattr(
+        monkeypatch.setattr(shutil, "which", lambda _: None)
-            shutil, "which",
+        from agent_reach.channels.bilibili import BilibiliChannel
-            lambda cmd: f"/usr/local/bin/{cmd}" if cmd in ("yt-dlp", "bili") else None,
+        ch = BilibiliChannel()
        )
        def fake_run(cmd, **kwargs):
            if "yt-dlp" in cmd[0]:
                return subprocess.CompletedProcess(cmd, 0, "2026.06.09", "")
            raise FileNotFoundError(cmd[0])
        monkeypatch.setattr(subprocess, "run", fake_run)
        import agent_reach.channels.bilibili as bilibili_mod
        monkeypatch.setattr(bilibili_mod, "_search_api_ok", lambda: True)
        ch = bilibili_mod.BilibiliChannel()
        status, msg = ch.check()
-        assert status == "ok"  # 搜索 API 兜底
+        assert status == "ok"
-        assert "不计为可用" in msg
+        assert ch.active_backend == "B站搜索 API"
-        assert ch.active_backend == "yt-dlp"
+        assert "bilibili-cli" in msg
    def test_off_when_everything_unreachable(self, monkeypatch):
        self._isolate(monkeypatch, api_ok=False)
        monkeypatch.setattr(shutil, "which", lambda _: None)
        from agent_reach.channels.bilibili import BilibiliChannel
        ch = BilibiliChannel()
        status, msg = ch.check()
        assert status == "off"
        assert ch.active_backend is None
 class TestYouTubeChannel:
@@ -60,7 +60,7 @@ class TestCLI:
        assert auth_token == "token123"
        assert ct0 == "ct0abc"
-    def test_install_reddit_deps_prefers_github_source(self, monkeypatch, capsys):
+    def test_install_rdt_cli_prefers_github_source(self, monkeypatch, capsys):
        state = {"rdt_installed": False}
        commands = []
@@ -79,12 +79,28 @@ class TestCLI:
        monkeypatch.setattr(shutil, "which", fake_which)
        monkeypatch.setattr(subprocess, "run", fake_run)
-        cli._install_reddit_deps()
+        cli._install_rdt_cli()
        out = capsys.readouterr().out
        assert commands == [["pipx", "install", cli._RDT_GIT_SOURCE]]
        assert "✅ rdt-cli installed" in out
    def test_install_reddit_deps_routes_by_environment(self, monkeypatch):
        """桌面 → OpenCLI;服务器 → rdt-cli(钉 git 源)。"""
        calls = []
        monkeypatch.setattr(cli, "_install_opencli_deps", lambda: calls.append("opencli"))
        monkeypatch.setattr(cli, "_install_rdt_cli", lambda: calls.append("rdt"))
        monkeypatch.setattr(shutil, "which", lambda _: None)
        monkeypatch.setattr(cli, "_detect_environment", lambda: "local")
        cli._install_reddit_deps()
        assert calls == ["opencli"]
        calls.clear()
        monkeypatch.setattr(cli, "_detect_environment", lambda: "server")
        cli._install_reddit_deps()
        assert calls == ["rdt"]
 class TestCheckUpdateRetry:
    def test_retry_timeout_classification(self):
@@ -132,7 +148,7 @@ class TestCheckUpdateRetry:
        sequence = [
            R(429, headers={"Retry-After": "3"}),
-            R(200, payload={"tag_name": "v1.4.2"}),
+            R(200, payload={"tag_name": "v1.5.0"}),
        ]
        with patch("requests.get", side_effect=sequence):
@@ -167,3 +183,42 @@ class TestCheckUpdateRetry:
        assert result == "error"
        assert "网络超时" in captured.out
        assert "已重试 3 次" in captured.out
 class TestVersionCompare:
    def test_newer_remote_triggers_update(self):
        assert cli._is_newer_version("1.5.0", "1.4.2") is True
    def test_equal_versions_no_update(self):
        assert cli._is_newer_version("1.5.0", "1.5.0") is False
    def test_local_ahead_of_release_no_downgrade_prompt(self):
        """发版窗口期本地装了 main(更新)时,不能提示"有更新"诱导降级。"""
        assert cli._is_newer_version("1.4.2", "1.5.0") is False
    def test_unparseable_falls_back_to_inequality(self):
        assert cli._is_newer_version("2026.06-beta", "1.5.0") is True
        assert cli._is_newer_version("1.5.0", "1.5.0-dev") is True
 class TestWatchVersionCompare:
    def test_watch_does_not_prompt_downgrade(self, monkeypatch, capsys):
        """watch 与 check-update 同语义:本地领先远端 release 时不提示更新。"""
        class R:
            status_code = 200
            headers = {}
            @staticmethod
            def json():
                return {"tag_name": "v1.4.2", "body": ""}
        monkeypatch.setattr(cli, "_github_get_with_retry", lambda *a, **k: (R(), None, 1))
        monkeypatch.setattr(
            "agent_reach.doctor.check_all",
            lambda config: {"web": {"status": "ok", "name": "任意网页", "message": "ok",
                            "tier": 0, "backends": ["Jina Reader"], "active_backend": "Jina Reader"}},
        )
        cli._cmd_watch()
        out = capsys.readouterr().out
        assert "新版本可用" not in out
        assert "全部正常" in out
@@ -104,3 +104,23 @@ class TestDoctor:
        assert "1/3 个渠道可用" in plain
        # Inactive optional channels should be summarized in one line
        assert "可选渠道可以解锁" in plain
 def test_stale_active_backend_does_not_leak_into_errored_result(monkeypatch):
    """渠道单例上一轮的 active_backend 不得泄漏进本轮异常结果(Codex review 发现)。"""
    from agent_reach import doctor
    class _ExplodingChannel:
        name = "boom"
        description = "爆炸渠道"
        tier = 0
        backends = ["a", "b"]
        active_backend = "a"  # 上一轮成功的残留
        def check(self, config=None):
            raise RuntimeError("boom")
    monkeypatch.setattr(doctor, "get_all_channels", lambda: [_ExplodingChannel()])
    results = doctor.check_all(config=None)
    assert results["boom"]["status"] == "error"
    assert results["boom"]["active_backend"] is None
@@ -152,3 +152,33 @@ def test_check_twitter_cli_broken_falls_back_to_bird():
    assert status == "ok"
    assert "bird" in message
    assert channel.active_backend == "bird CLI (legacy)"
 def test_unauthenticated_twitter_cli_does_not_block_working_opencli():
    """warn 候选不得屏蔽排在后面的 ok 候选(Codex review 发现)。"""
    channel = TwitterChannel()
    with patch.object(
        TwitterChannel, "_check_twitter_cli",
        return_value=("warn", "twitter-cli 已安装但未认证"),
    ), patch.object(
        TwitterChannel, "_check_opencli",
        return_value=("ok", "OpenCLI 可用（复用浏览器登录态）"),
    ), patch.object(TwitterChannel, "_check_bird", return_value=None):
        status, msg = channel.check()
    assert status == "ok"
    assert channel.active_backend == "OpenCLI"
 def test_all_warn_falls_back_to_first_warn():
    channel = TwitterChannel()
    with patch.object(
        TwitterChannel, "_check_twitter_cli",
        return_value=("warn", "twitter-cli 未认证"),
    ), patch.object(
        TwitterChannel, "_check_opencli",
        return_value=("warn", "扩展未连接"),
    ), patch.object(TwitterChannel, "_check_bird", return_value=None):
        status, msg = channel.check()
    assert status == "warn"
    assert channel.active_backend == "twitter-cli"
    assert "未认证" in msg
Author	SHA1	Message	Date
Pnant	f65526cbaa	docs(readme): full-pass audit — purge pre-v1.5 worldview from both READMEs ci / test (3.10) (push) Has been cancelled Details ci / test (3.11) (push) Has been cancelled Details ci / test (3.12) (push) Has been cancelled Details ci / test (3.13) (push) Has been cancelled Details ci / wheel-gate (push) Has been cancelled Details Two factual errors and a batch of stale-world copy found by auditing the full README against v1.5.0 reality: - "what install does" claimed twitter-cli/rdt-cli are installed by default — they never are (opt-in via --channels); now describes the real flow incl. the channel menu step - zero-config examples listed "read a tweet" — Twitter is tier 1, not zero-config; list now shows truly free channels (incl. bili search) - FAQ rewrites: xiaohongshu (OpenCLI-first, mcp for servers, xhs-cli as legacy fallback), Reddit (login mandatory, OpenCLI first, pinned rdt source), free-cost answer (tool list updated, proxy rescoped to restricted networks) - platform table stops advertising write ops (发推/Post·Comment·Like) — aligned with the skill's fetch-only boundary - bilibili pain-point line updated to the 412 reality - credits gain OpenCLI and xiaohongshu-mcp - README_en: same FAQ/table/doctor-sample fixes Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-06-11 20:23:00 +08:00
Pnant	5e6fc45785	docs(review): round-3 nits — last copy inconsistencies from Codex review - install --proxy help text: generic network-proxy wording (was "Reddit/Bilibili") - setup wizard: Reddit line no longer claims 无需配置 right before demanding rdt login - README_en: bilibili proxy-era claims replaced with bili-cli reality (proxy section rescoped to restricted networks, doctor sample updated) - install.md: rdt-cli example pinned to the same SHA as _RDT_GIT_SOURCE Codex final verdict across 3 rounds: SHIP (all earlier fixes verified, remaining items were these non-blocking nits). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-06-11 18:09:38 +08:00
Pnant	e570d08772	fix(review): round-2 findings — dead proxy key, unbounded transcribe, doc pins - configure proxy: the bilibili_proxy key lost its only reader when yt-dlp exited the bilibili channel (PR5), leaving docs promising an unlock that did nothing. Now saves a generic `proxy` key (legacy key kept in sync), and every wording — CLI output, server tip, install.md quick reference — says what it really is: a saved address agents read to export HTTP(S)_PROXY, not an unlock switch - transcribe: subprocess calls get timeouts (yt-dlp download 1800s, ffmpeg 600s) so a stalled network read can't hang the CLI forever - docs/update.md: rdt-cli install uses the same pinned git SHA as the code's _RDT_GIT_SOURCE instead of floating HEAD - probe.py: documented as side-effect-free-probes-only (retries re-run verbatim with no backoff) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-06-11 18:01:47 +08:00
Pnant	cc90e10b19	fix(review): four findings from adversarial Codex review round 1 - twitter: align backend selection with the two-phase findings pattern — an unauthenticated twitter-cli (warn) no longer blocks a fully-working OpenCLI (ok) further down the candidate list - watch: use _is_newer_version like check-update (the != comparison kept the downgrade prompt this branch fixed elsewhere) - uninstall: third copy of the skill-dir removal also gets the symlink guard (full `agent-reach uninstall` path) - doctor: a stale active_backend from a previous check on the singleton channel no longer leaks into an errored result +4 regression tests (162 total). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-06-11 17:53:37 +08:00
Pnant	fc24fb699b	feat(experience): one-liner install/update docs catch up + version-watching skill The one-liner entry docs were untouched by the backend upgrade — new users following "帮我安装 Agent Reach" would still get the old world. Now: - docs/install.md: xiaohongshu section rewritten (desktop OpenCLI with the one manual extension click / server xiaohongshu-mcp with QR + 150MB first-run warning / legacy xhs-cli kept as fallback); Reddit section says plainly there is no zero-config path; optional-channel menu gains OpenCLI; upstream table matches the new routing with a doctor --json pointer - docs/update.md: full rewrite — upgrade-only-what-exists tool refresh (incl. npm update for OpenCLI/mcporter, pinned git source for rdt-cli), one-time OpenCLI offer for desktops, skill sync now rides doctor's auto-sync instead of an inline python blob, WeChat-era content removed - check-update / watch: "update available" now leads with the one-liner (帮我更新 Agent Reach：<update.md>) which updates package + tools + skill; bare pip stays as the package-only alternative - fix: version compare was `!=` — a local build AHEAD of the latest release (installed from main during a release window) was told to "update" into a downgrade; now semantic tuple compare with fallback (+4 tests) - skill (zh+en): description gains a NOT-for boundary (fetch-only, no write ops, defer to dedicated skills); new standing rule — after substantial tasks run check-update and append a one-liner update hint to the wrap-up, never interrupting or nagging - SKILL_en.md restructured to the same three-layer skeleton as the Chinese version (124-line body, shared references/) instead of a 263-line everything-inline page Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-06-11 17:14:57 +08:00
Pnant	380cfd565d	feat(identity): capability-layer positioning + skill rewrite, v1.5.0 SKILL.md (per the skill-writing guide): - description rewritten trigger-first: 调研/全网调研/帮我调研/research lead the text (the owner's own phrasing "去全网调研" previously had NO matching trigger word — the exact undertrigger the guide warns about); platform keywords front-loaded against the 1536-char truncation - standing rules added: probe `doctor --json` active_backend before acting on multi-backend platforms, announce which skill/backend is in use, follow the documented retry chains, compose multi-platform research - quick commands updated to the new reality: bili-cli for bilibili search, Reddit/xiaohongshu moved to a "login-backed platforms" section - SKILL_en.md: same description surgery + the actively harmful stale advice removed (anonymous reddit .json curl, yt-dlp for bilibili) README / README_en: - tagline gains the capability-layer subline: backends are chosen, installed and health-checked for us to swap — the user never notices - "设计理念" reframed from scaffolding to capability layer (selection / install / doctor / routing); channels diagram now shows ordered backend lists; selection table split into primary + fallback columns with the live-test rationale per row - platform table: honest rows for bilibili (bili-cli, yt-dlp retired), Reddit (no zero-config path), xiaohongshu (OpenCLI / mcp / legacy) Version 1.5.0 across pyproject / __init__ / CLAUDE.md / test fixture. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-06-11 16:30:56 +08:00
Pnant	2c766af477	feat(bilibili,twitter): yt-dlp exits bilibili; OpenCLI joins both bilibili: - live-verified 2026-06: bilibili 412-blocks yt-dlp in every configuration (latest version, direct, proxied, warmed cookies) while bili-cli works fine without login — so yt-dlp no longer serves this channel (it remains the YouTube backend) - backends = [bili-cli, OpenCLI, B站搜索 API]: bili-cli covers search/hot/rank/video-detail/audio, OpenCLI adds subtitles through the browser session, the search API is the zero-dependency fallback - when a broken candidate is bypassed by a working fallback, its reinstall prescription is appended to the winning message instead of being swallowed - skill docs (social.md + video.md): "do NOT use yt-dlp for bilibili" warning, bili-cli/OpenCLI command groups, curl fallback recipe, B站 audio transcription path via `bili audio` + agent-reach transcribe twitter: - OpenCLI joins as the middle candidate [twitter-cli, OpenCLI, bird] - social.md: explicit 4-step search retry chain (retry → upgrade → OpenCLI → stable-command detour) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-06-11 16:18:00 +08:00
Pnant	d7551bf19d	feat(reddit): honest tiering — OpenCLI / rdt-cli, no zero-config path - live-verified 2026-06: anonymous .json endpoints are 403-blocked (all variants) and the official API closed self-service registration in 2025-11 — so the channel now says plainly: every Reddit backend needs a logged-in session, mainland China needs a proxy - backends = [OpenCLI, rdt-cli]: OpenCLI rides the browser session (desktop preferred); rdt-cli stays for servers and existing installs (upstream unmaintained since 2026-03, noted in the ok message) - install: desktop routes to OpenCLI, server installs rdt-cli from the pinned git source (split out as _install_rdt_cli) - skill/references/social.md: Reddit section rewritten as two backend command groups + a PRAW note scoped to users who already hold pre-2025-11 credentials (explicitly not recommended for new users) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-06-11 16:10:04 +08:00