5c62a21f32
全局重命名： - 包名: agent_eyes → agent_reach - CLI: agent-eyes → agent-reach - 类名: AgentEyes → AgentReach - 显示名: Agent Eyes → Agent Reach - GitHub: Panniantong/agent-eyes → Panniantong/Agent-Reach 所有 36 个测试通过，CLI/doctor/read/search 全部正常。
80 lines
2.4 KiB
Markdown
80 lines
2.4 KiB
Markdown
# Agent Reach — Installation Guide
|
||
|
||
## For Humans
|
||
|
||
Copy this to your AI Agent:
|
||
|
||
```
|
||
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
|
||
```
|
||
|
||
---
|
||
|
||
## For AI Agents
|
||
|
||
### Step 1: Install
|
||
|
||
```bash
|
||
pip install https://github.com/Panniantong/agent-reach/archive/main.zip || pip3 install https://github.com/Panniantong/agent-reach/archive/main.zip
|
||
agent-reach install --env=auto
|
||
```
|
||
|
||
This single command does everything automatically:
|
||
- Detects local computer vs server
|
||
- Auto-imports browser cookies on local (Twitter, XiaoHongShu, Bilibili)
|
||
- Auto-detects Exa API key if already in environment
|
||
- Tests all channels
|
||
- Shows what's working and what needs setup
|
||
|
||
**Read the output carefully.** It tells you exactly what happened and what's next.
|
||
|
||
### Step 2: Only if needed — configure what's missing
|
||
|
||
Based on the install output, you may need to configure one or two things.
|
||
Only ask the user for items the install output says are missing.
|
||
|
||
**If search is not configured:**
|
||
> "Want to unlock web search? Go to https://exa.ai → sign up (free) → send me the API key."
|
||
|
||
```bash
|
||
agent-reach configure exa-key THE_KEY
|
||
```
|
||
|
||
**If cookies were not auto-imported (server users):**
|
||
> "To unlock Twitter and XiaoHongShu, install the Cookie-Editor Chrome extension, go to the site, click 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"
|
||
agent-reach configure xhs-cookie "PASTED_STRING"
|
||
```
|
||
|
||
**If on server and wants Reddit/Bilibili full access:**
|
||
> "Reddit and Bilibili block server IPs. Get a proxy at https://webshare.io ($1/month) and send me the address."
|
||
|
||
```bash
|
||
agent-reach configure proxy http://user:pass@ip:port
|
||
```
|
||
|
||
### Step 3: Verify
|
||
|
||
```bash
|
||
agent-reach doctor
|
||
```
|
||
|
||
Report what's active. Users can configure more anytime by asking.
|
||
|
||
---
|
||
|
||
## Quick Reference
|
||
|
||
| Command | What it does |
|
||
|---------|-------------|
|
||
| `agent-reach install --env=auto` | Full auto-setup |
|
||
| `agent-reach doctor` | Show status |
|
||
| `agent-reach configure exa-key KEY` | Unlock search |
|
||
| `agent-reach configure twitter-cookies "..."` | Unlock Twitter |
|
||
| `agent-reach configure xhs-cookie "..."` | Unlock XiaoHongShu |
|
||
| `agent-reach configure proxy URL` | Unlock Reddit + Bilibili (server) |
|
||
| `agent-reach read URL` | Read any URL |
|
||
| `agent-reach search "query"` | Search the web |
|