From ac63a5dc55c3d7244009707e2036b282bbb7df35 Mon Sep 17 00:00:00 2001 From: Panniantong Date: Tue, 24 Feb 2026 15:38:57 +0100 Subject: [PATCH] =?UTF-8?q?docs:=20install.md=20=E6=81=A2=E5=A4=8D?= =?UTF-8?q?=E6=9C=89=E7=94=A8=E7=BB=86=E8=8A=82=EF=BC=8C=E4=BF=9D=E7=95=99?= =?UTF-8?q?=E7=AE=80=E6=B4=81=E6=8C=87=E4=BB=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 保留： - Cookie 配置步骤（需要用户操作，Agent 做不了） - 代理配置说明（含推荐服务商） - 完整命令参考表（12 条命令） - 自动安装说明 去掉的只有：9 行排错对照表（Agent 自己能搞定） --- docs/install.md | 43 ++++++++++++++++++++++++++++++++++++------- 1 file changed, 36 insertions(+), 7 deletions(-) diff --git a/docs/install.md b/docs/install.md index 308cfdb..12f3c73 100644 --- a/docs/install.md +++ b/docs/install.md @@ -16,28 +16,51 @@ Copy this to your AI Agent: Install Agent Reach and make sure **all channels are working**. Your user expects you to have full internet access capabilities when this is done — reading tweets, searching Reddit, watching YouTube, browsing GitHub, and more. -### Install +### Step 1: Install ```bash pip install https://github.com/Panniantong/agent-reach/archive/main.zip agent-reach install --env=auto ``` +This auto-installs system dependencies (gh CLI, Node.js, mcporter, birdx), configures Exa search, detects environment, and tests all channels. + **Read the output carefully**, then run: ```bash agent-reach doctor ``` -### Your Job +### Step 2: Fix what's broken `agent-reach doctor` shows you which channels are active and which aren't. -**Your goal is to get as many channels to ✅ as possible.** If something failed during install or shows as ❌/⚠️ in doctor, fix it yourself. You're a capable AI Agent — diagnose the problem, try alternative approaches, search for solutions, and iterate until it works. +**Your goal is to get as many channels to ✅ as possible.** If something failed during install or shows as ❌/⚠️ in doctor, fix it yourself. You're a capable AI Agent — diagnose the problem, try alternative approaches, and iterate until it works. -Only ask the user when you genuinely need their input — things like API keys, browser cookies, proxy credentials, or account passwords that you can't generate yourself. +Only ask the user when you genuinely need their input (see below). -When you're done, run `agent-reach doctor` one final time and report the results to your user. +### Step 3: Configure things that need user input + +Some channels need credentials only the user can provide. Based on the doctor output, ask for what's missing: + +**Twitter search & posting (server users):** +> "To unlock Twitter search, I need your Twitter cookies. Install the Cookie-Editor Chrome extension, go to x.com/twitter.com, click the extension → Export → Header String, and paste it to me." +> Extension: https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm + +```bash +agent-reach configure twitter-cookies "PASTED_STRING" +``` + +**Reddit & Bilibili full access (server users):** +> "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." + +```bash +agent-reach configure proxy http://user:pass@ip:port +``` + +### Step 4: Final check + +Run `agent-reach doctor` one final time and report the results to your user. --- @@ -45,9 +68,15 @@ When you're done, run `agent-reach doctor` one final time and report the results | Command | What it does | |---------|-------------| -| `agent-reach install --env=auto` | Full auto-setup | +| `agent-reach install --env=auto` | Full auto-setup (installs deps + configures) | | `agent-reach doctor` | Show channel status | +| `agent-reach configure twitter-cookies "..."` | Unlock Twitter search + posting | | `agent-reach configure proxy URL` | Unlock Reddit + Bilibili on servers | -| `agent-reach configure twitter-cookies "..."` | Unlock Twitter search | | `agent-reach read ` | Read any URL | | `agent-reach search "query"` | Search the web | +| `agent-reach search-reddit "query"` | Search Reddit | +| `agent-reach search-twitter "query"` | Search Twitter | +| `agent-reach search-github "query"` | Search GitHub | +| `agent-reach search-youtube "query"` | Search YouTube | +| `agent-reach search-bilibili "query"` | Search Bilibili | +| `agent-reach search-xhs "query"` | Search XiaoHongShu |