simplify: install.md 只说目标，不说怎么修——Agent 自己会

install.md 核心指令： - 目标：所有渠道都 ✅ - 遇到问题自己修，不要停 - 只有需要用户提供的东西（密码/cookie/key）才问用户 - 最后跑 doctor 汇报结果
2026-02-24 15:34:50 +01:00
parent db3f292228
commit 05452e5b54
2 changed files with 21 additions and 61 deletions
@@ -220,9 +220,7 @@ def _cmd_install(args):

    if ok < total:
        print()
-        print("🤖 Note for AI Agents: You have the ability to fix the issues above.")
-        print("   Try alternative install methods, check error logs, or search for solutions.")
-        print("   Only ask the user for things you genuinely can't do yourself (API keys, cookies, passwords).")
+        print("🤖 Some channels are not active yet. If you're an AI Agent, try to fix them yourself — then run `agent-reach doctor` again.")


 def _install_system_deps():
@@ -12,70 +12,32 @@ Copy this to your AI Agent:

 ## For AI Agents

-**Important: You are an AI Agent with problem-solving abilities. If any step below fails, don't just report the error — diagnose and fix it yourself. You have shell access, you can search for solutions, try alternative install methods, and debug issues. Only ask the user when you genuinely need their input (API keys, cookies, passwords).**
+### Goal

-### Step 1: Install
+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

 ```bash
-pip install https://github.com/Panniantong/agent-reach/archive/main.zip || pip3 install https://github.com/Panniantong/agent-reach/archive/main.zip
+pip install https://github.com/Panniantong/agent-reach/archive/main.zip
 agent-reach install --env=auto
 ```

-This single command does everything automatically:
- Installs system dependencies (gh CLI, Node.js, mcporter) if missing
- Configures Exa search (free, no API key needed)
- Detects local computer vs server
- Auto-imports browser cookies on local (Twitter)
- 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.
-
-### Troubleshooting (self-fix before asking the user)
-
-If `agent-reach install` shows warnings or failures, try fixing them yourself:
-
-| Problem | What you can do |
-|---------|----------------|
-| `pip install` fails with `--break-system-packages` | Add the flag: `pip install --break-system-packages ...` or create a venv first |
-| `npm install -g mcporter` timeout | Retry with longer timeout, or try: `npx mcporter@latest list` (uses npx without global install) |
-| `gh` CLI install fails | Try: `conda install gh`, `snap install gh`, or download binary from https://github.com/cli/cli/releases |
-| `node`/`npm` not found after install | Check `export PATH` or try: `apt install nodejs npm` / `brew install node` |
-| `mcporter config add exa` fails | Run manually: `mcporter config add exa https://mcp.exa.ai/mcp` |
-| `yt-dlp` not found | `pip install yt-dlp` or `pip3 install yt-dlp` |
-| `birdx` not found | `pip install birdx` — optional, Twitter reading still works without it |
-| Permission denied | Run with `sudo` or fix directory permissions |
-| Any Python package conflict | Create a venv: `python3 -m venv ~/agent-reach-env && source ~/agent-reach-env/bin/activate` then reinstall |
-
-**General principle: You're a capable AI Agent. If a tool fails to install via one method, try another. Check error messages, search for solutions, and iterate. Don't give up after one attempt.**
-
-### 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 cookies were not auto-imported (server users):**
-> "To unlock Twitter search and posting, install the Cookie-Editor Chrome extension, go to twitter.com, 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"
-```
-
-**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
+**Read the output carefully**, then run:

 ```bash
 agent-reach doctor
 ```

-Report what's active. Users can configure more anytime by asking.
+### Your Job
+
+`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.
+
+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.
+
+When you're done, run `agent-reach doctor` one final time and report the results to your user.

 ---

@@ -83,9 +45,9 @@ Report what's active. Users can configure more anytime by asking.

 | Command | What it does |
 |---------|-------------|
-| `agent-reach install --env=auto` | Full auto-setup (installs deps + configures) |
-| `agent-reach doctor` | Show status |
-| `agent-reach configure twitter-cookies "..."` | Unlock Twitter search + posting |
-| `agent-reach configure proxy URL` | Unlock Reddit + Bilibili (server) |
-| `agent-reach read URL` | Read any URL |
+| `agent-reach install --env=auto` | Full auto-setup |
+| `agent-reach doctor` | Show channel status |
+| `agent-reach configure proxy URL` | Unlock Reddit + Bilibili on servers |
+| `agent-reach configure twitter-cookies "..."` | Unlock Twitter search |
+| `agent-reach read <url>` | Read any URL |
 | `agent-reach search "query"` | Search the web |