一眼分清哪些装好就能用
Agent Reach 不会让所有平台自动登录。基础渠道和登录渠道要分开判断，缺少登录态不等于安装失败。
网页读取公开页面YouTube搜索与字幕GitHub公开仓库与搜索RSS订阅源解析全网搜索经已配置后端检索V2EX / B站公开内容能力
Twitter / X搜索与时间线需登录态小红书桌面或服务器方案不同Reddit需要登录态Facebook桌面浏览器登录态Instagram桌面浏览器登录态雪球 / 小宇宙Cookie 或额外 Key
agent-reach doctor 会按当前系统显示每个渠道实际走哪一个后端。下面是上游文档展示的输出结构，渠道数量和文字会随版本及系统变化。
text
$ agent-reach doctor
✅ Ready to use:
✅ GitHub repos and code
✅ YouTube video subtitles
✅ RSS/Atom feeds
✅ Web pages
🔧 Configurable:
⬜ Twitter/X search
⬜ XiaoHongShu search and read先看体检，不看宣传词真实可用性由当前网络、上游工具、账号状态和平台风控共同决定。
先只预览它会改什么
先在 Codex 新任务中发送这段话。第一轮只读官方安装说明，不执行安装。
text
请阅读下面固定提交里的 Agent Reach 安装说明：
https://github.com/Panniantong/Agent-Reach/blob/1494c2ab239e7355a77e7cceaf3271453a1f34b5/docs/install.md
现在不要安装。先列出：
1. 会安装哪些命令行工具；
2. 会写入哪些目录；
3. 哪些步骤需要网络、登录态或系统权限；
4. 安全模式和 dry-run 分别会做什么。
等我确认后再继续。上游要求把配置和工具放在专用目录，不要把仓库、临时文件或凭据写进当前项目。
- 配置与凭据
~/.agent-reach/- 上游工具
~/.agent-reach/tools/- 临时文件
/tmp/- Skills
- 由安装器按当前 Agent 环境选择
从固定提交安装
优先使用 pipx 隔离 Python 包。先运行安全模式或仅预览；确认清单合理后，再执行正式安装。
bash
pipx install https://github.com/Panniantong/Agent-Reach/archive/1494c2ab239e7355a77e7cceaf3271453a1f34b5.zip
agent-reach install --env=auto --safe
agent-reach install --env=auto --dry-run确认后正式安装会按环境补齐基础工具
agent-reach install --env=auto安装器可能检测并安装 Node.js、GitHub CLI、mcporter 等基础工具。若需要系统权限，应该停下来让用户确认。
遇到 PEP 668不要破坏系统 Python
优先继续使用 pipx。如果系统没有 pipx，再按上游说明创建独立虚拟环境，不要给系统 Python 加强制覆盖参数。
登录态不是普通配置
Cookie 和浏览器会话通常等同完整账号权限。Twitter、小红书、Reddit、Facebook、Instagram 等渠道应使用专用账号，并避免把 Cookie 写进项目、截图、文档或聊天记录。
跑完体检再开始
安装完成后先开一个新终端，再执行：
bash
agent-reach doctor先按 doctor 给出的处方处理命令缺失或网络失败。需要 sudo、系统设置或代理时，先让用户决定。
网页、YouTube、GitHub、RSS 等目标渠道显示可用，就能进入下面的只读任务。
登录渠道显示未配置时，不要为了让列表全部变绿而索要账号。只配置当前任务确实需要的平台。
做一次只读跨来源调研
把下面提示发给安装完成后的 Codex。这个任务只使用基础渠道，不要求登录任何社交账号。
text
使用 Agent Reach 做一次只读调研，主题是“Codex 如何制作 PPT”。
分别找：
1. 一篇公开网页教程；
2. 一个 YouTube 视频；
3. 一个 GitHub 项目。
每项给出标题、原始链接、页面显示的更新时间和一句话摘要。
最后说明使用了哪个渠道及对应上游工具。
不要登录账号，不要发帖、点赞、评论或下载附件。- 三类来源齐全网页、视频和 GitHub 各有一个可打开的原始链接。
- 来源可追溯每条摘要都能回到对应来源，不把搜索摘要当全文。
- 渠道说清楚结果注明实际使用的渠道或上游工具。
- 保持只读没有要求账号登录，也没有产生发布、互动或下载动作。
本课通关你已经完成“预览改动、安装、体检、只读调研”的闭环，而不是只把一个工具装进电脑。
按需解锁登录渠道
基础调研跑通后，再根据真实任务选择额外渠道。不要选择“全部安装”作为默认动作。
桌面浏览器渠道优先复用用户主动建立的登录态
小红书、Reddit、Facebook、Instagram 等渠道可能通过 OpenCLI 复用 Chrome 登录态。浏览器扩展需要用户亲自确认安装。
Cookie 渠道使用专用账号并限制暴露范围
Twitter、雪球等传统 CLI 方案可能需要 Cookie。不要使用主账号，不要把 Cookie 粘贴进项目文件或可共享记录。
服务器渠道网络与登录方式会不同
无桌面环境可能需要代理、扫码、MCP 服务或额外 Key。所有新增依赖和权限都应再次确认。
预览卸载，再决定删什么
先用 dry-run 查看将被移除的目录和配置：
bash
agent-reach uninstall --dry-run只移除 Skill、保留本地 token 与配置，适合准备重装：
bash
agent-reach uninstall --keep-config完全卸载会清除 ~/.agent-reach/ 中的 token、Cookie、工具配置和已注册 Skill。确认不再需要后才执行：
bash
agent-reach uninstall
pipx uninstall agent-reach来源与许可
- 固定源码：
Panniantong/Agent-Reach@1494c2ab239e，2026-07-22 核验为 59,251 Star。 - 安装和安全边界来自固定提交中的 安装说明与 安全策略。
- 软件和仓库文档采用 MIT，本站保存了许可证副本。
- 页面使用上游
docs/assets/logo-2.png，尺寸 1024 x 1024，SHA-2561085bb695ef78f808596ddcc5c6edbc7e01565cf45f2d9a9d608606b09014c27，详见素材记录。