Agent Reach — 更新指南¶

面向人类¶

将此内容复制给你的 AI 代理：

帮我更新 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

或者使用英文：

Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/update.md

面向 AI 代理¶

⚠️ 工作区规则¶

切勿在代理工作区中创建文件、克隆仓库或运行命令。 临时工作请使用 /tmp/，持久化数据请使用 ~/.agent-reach/。

目标¶

将 Agent Reach 更新到最新版本，刷新上游工具，从已退役的后端迁移，并验证一切正常工作。用户不应需要手动执行任何操作（除了只有人类才能做的事情，例如点击浏览器扩展安装按钮）。

步骤 1：检查当前版本¶

agent-reach check-update

如果显示“已是最新版本”，请跳到步骤 4（验证）。否则继续。

步骤 2：更新 Agent Reach 包¶

pip install --upgrade https://github.com/Panniantong/agent-reach/archive/main.zip

如果 pip 报告 externally-managed-environment（PEP 668）错误，说明用户 最初是通过 pipx 或 venv 安装的——请使用对应的命令： pipx install --force https://github.com/Panniantong/agent-reach/archive/main.zip 或先激活 ~/.agent-reach-venv。

步骤 3：刷新上游工具¶

运行以下命令以保持已安装工具为最新。只升级已经安装的工具——不要安装用户从未要求的新工具（唯一例外：桌面端 OpenCLI，见下文）。

# 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 install --force 'yt-dlp[default]' 2>/dev/null || uv tool install --force 'yt-dlp[default]' 2>/dev/null || python -m pip install -U 'yt-dlp[default]' 2>/dev/null; }

# rdt-cli is pinned to a git source (PyPI lags upstream) — same pin as the code's _RDT_GIT_SOURCE
which rdt >/dev/null 2>&1 && pipx install --force 'git+https://github.com/public-clis/rdt-cli.git@5e4fb3720d5c174e976cd425ccc3b879d52cac66' 2>/dev/null

# npm-based
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

没有 OpenCLI 的桌面用户：自 v1.5.0 起，OpenCLI 是小红书/Reddit 的首选后端（并新增 B站 字幕）。请主动提供一次。对于小红书，OpenCLI 只能使用用户明确控制的现有 Chrome 会话。更新过程绝不能让用户登录或读取浏览器 Cookie：

"这次更新引入了 OpenCLI 后端。要装吗？装完只需你在 Chrome 商店点一次 『添加扩展』。小红书 OpenCLI 只使用你已有的 Chrome 会话；如果没有现成 会话，我不会自动登录，会改用 Cookie-Editor 配置 MCP / 存量工具。"

如果同意：运行 agent-reach install --system --channels opencli，并引导他们完成扩展点击操作。如果不同意，所有功能将继续在现有后端上运行。

步骤 4：共存（请勿卸载旧工具）¶

切勿卸载用户已有的工具。 已退役的后端（例如 yt-dlp 不再支持 Bilibili；xhs-cli 不再默认安装）在仍可用的地方会继续作为回退方案工作。Agent Reach 会自动绕过它们——是否移除由用户决定，而不是由你决定。

步骤 5：验证¶

agent-reach version
agent-reach doctor

运行 agent-reach doctor（文本模式）还会确保在检测到的代理技能目录中存在 Agent Reach 技能。如果用户那里已有技能，doctor 会保留它，而不是覆盖本地自定义设置。当你明确想要刷新捆绑的技能文件时，请使用 agent-reach skill --install。

检查 doctor 输出：

• 每个通道都显示 ✅ / [!] 并带有清晰消息，多后端通道（小红书/Reddit/B站/Twitter）会报告 当前后端：…
• 如果之前可用的通道现在显示 [X]/错误，消息中会包含确切修复方法（例如 venv 重装说明）——运行它，然后重新检查
• --json 以机器可读方式提供相同数据（每个通道的 active_backend）

步骤 6：向用户报告¶

告知用户：

1. 他们当前使用的版本（agent-reach version）
2. 有多少通道可用，以及每个多后端平台正在使用哪个后端（来自 doctor）
3. 任何需要他们操作的事项（例如点击 Chrome 扩展，或当 XiaoHongShu 使用 MCP / 旧工具时手动导出 Cookie-Editor 数据）
4. 本次更新中的变更（check-update 显示的发布说明）

完成。