README: platform-aware launch steps, hCaptcha real-browser demo, EN/CN section polish

2026-06-10 14:49:13 +08:00
1 parent 1945b27a03
commit 79550d1175
@@ -47,6 +47,7 @@ Every time GenericAgent solves a new task, it automatically crystallizes the exe
 - [Demo Showcase](#-demo-showcase)
 - [Quick Start](#-quick-start)
 - [Usage](#-usage)
+- [Unlocking Advanced Capabilities](#-unlocking-advanced-capabilities)
 - [Architecture](#-architecture)
 - [Self-Evolution Mechanism](#-self-evolution-mechanism)
 - [Comparison](#-comparison)
@@ -73,8 +74,20 @@ Every time GenericAgent solves a new task, it automatically crystallizes the exe

 <table>
  <tr>
-    <td align="center" width="50%"><b>🧋 Food Delivery Order</b></td>
-    <td align="center" width="50%"><b>📈 Quantitative Stock Screening</b></td>
+    <td align="center" width="50%"><b>🛡️ Real-Browser CAPTCHA Survival</b></td>
+    <td align="center" width="50%"><b>🌐 Autonomous Web Exploration</b></td>
+  </tr>
+  <tr>
+    <td><img src="assets/demo/discord_hcaptcha_real_browser.gif" width="100%" alt="Discord hCaptcha passed in real browser"></td>
+    <td><img src="assets/demo/autonomous_explore.png" width="100%" alt="Web Exploration"></td>
+  </tr>
+  <tr>
+    <td><sub>While configuring a Discord bot, an hCaptcha <i>"Are you human?"</i> challenge pops up mid-task — GA's real browser session passes it and the task continues. See <a href="#browser-realness-of-ga-web-tools">Browser Realness</a>.</sub></td>
+    <td><sub>Autonomously browses and periodically summarizes web content.</sub></td>
+  </tr>
+  <tr>
+    <td align="center"><b>🧋 Food Delivery Order</b></td>
+    <td align="center"><b>📈 Quantitative Stock Screening</b></td>
  </tr>
  <tr>
    <td><img src="assets/demo/order_tea.gif" width="100%" alt="Order Tea"></td>
@@ -85,25 +98,16 @@ Every time GenericAgent solves a new task, it automatically crystallizes the exe
    <td><sub><i>"Find GEM stocks with EXPMA golden cross, turnover &gt; 5%"</i> — quantitative screening.</sub></td>
  </tr>
  <tr>
-    <td align="center"><b>🌐 Autonomous Web Exploration</b></td>
    <td align="center"><b>💰 Expense Tracking</b></td>
+    <td align="center"><b>💬 Batch Messaging</b></td>
  </tr>
  <tr>
-    <td><img src="assets/demo/autonomous_explore.png" width="100%" alt="Web Exploration"></td>
    <td><img src="assets/demo/alipay_expense.png" width="100%" alt="Alipay Expense"></td>
+    <td align="center"><img src="assets/demo/wechat_batch.png" width="65%" alt="WeChat Batch"></td>
  </tr>
  <tr>
-    <td><sub>Autonomously browses and periodically summarizes web content.</sub></td>
    <td><sub><i>"Find expenses over ¥2K in the last 3 months"</i> — drives Alipay via ADB.</sub></td>
-  </tr>
-  <tr>
-    <td align="center" colspan="2"><b>💬 Batch Messaging</b></td>
-  </tr>
-  <tr>
-    <td colspan="2" align="center"><img src="assets/demo/wechat_batch.png" width="50%" alt="WeChat Batch"></td>
-  </tr>
-  <tr>
-    <td colspan="2"><sub>Sends bulk WeChat messages, fully driving the WeChat client.</sub></td>
+    <td><sub>Sends bulk WeChat messages, fully driving the WeChat client.</sub></td>
  </tr>
 </table>

@@ -141,26 +145,21 @@ powershell -ExecutionPolicy Bypass -c "$env:GLOBAL=1; irm http://fudankw.cn:9000
 GLOBAL=1 bash -c "$(curl -fsSL http://fudankw.cn:9000/files/ga_install.sh)"
 ```

-After installation, launch the desktop app from:
+After installation, launch the desktop app:

-```text
-frontends/GenericAgent.exe
-```
+- **Windows** — double-click `frontends/GenericAgent.exe`
+- **Linux / macOS** — run `python launch.pyw` from the install directory

 #### Method 2 — Python install *(for developers)*

 ```bash
-git clone https://github.com/lsdefine/GenericAgent.git
-cd GenericAgent
-uv venv
-uv pip install -e ".[ui]"          # Core + UI dependencies
-cp mykey_template.py mykey.py      # Fill in your LLM API key
+git clone https://github.com/lsdefine/GenericAgent.git && cd GenericAgent
+uv venv && uv pip install -e ".[ui]"
+cp mykey_template_en.py mykey.py   # fill in your LLM API key
 python launch.pyw
 ```

-> 💡 GenericAgent is meant to grow its environment **through the Agent itself**, not by pre-installing every possible package.
-
-📖 Full guide: [`docs/GETTING_STARTED.md`](docs/GETTING_STARTED.md)
+> 💡 GenericAgent grows its environment **through the Agent itself** — don't pre-install everything. See [Unlocking Advanced Capabilities](#-unlocking-advanced-capabilities) below.

 ---

@@ -204,17 +203,15 @@ python launch.pyw

 ### Bot Interface (IM)

-GenericAgent also supports IM frontends such as Telegram, WeChat, QQ, Feishu / Lark, WeCom, and DingTalk.
+GenericAgent also supports IM frontends such as Telegram, Discord, and Lark.

 | Platform | Command |
 | :--- | :--- |
 | Telegram | `python frontends/tgapp.py` |
-| WeChat | `python frontends/wechatapp.py` |
-| QQ | `python frontends/qqapp.py` |
-| Feishu / Lark | `python frontends/fsapp.py` |
-| WeCom | `python frontends/wecomapp.py` |
-| DingTalk | `python frontends/dingtalkapp.py` |
+| Discord | `python frontends/dcapp.py` |
+| Lark / Feishu | `python frontends/fsapp.py` |

+> WeChat, QQ, WeCom and DingTalk are also supported — see the Chinese section below.
 > For detailed setup, ask GenericAgent itself.

 ### Common Chat Commands
@@ -227,6 +224,31 @@ GenericAgent also supports IM frontends such as Telegram, WeChat, QQ, Feishu / L

 ---

+## 🔓 Unlocking Advanced Capabilities
+
+In GA, advanced capabilities are unlocked by **instructing the agent**, not by reading
+docs or installing extras. Each instruction below makes GA read its pre-installed SOPs
+(battle-tested playbooks in its memory), install whatever is missing, adapt to your OS,
+and persist the result into its own memory.
+
+| Capability | Just tell GA |
+| :--- | :--- |
+| 🌐 Web automation | *"Set up your web automation capability."* — GA guides you through the one manual step: dragging the bundled Chrome extension into `chrome://extensions`. |
+| 🔤 OCR | *"Set up your OCR capability with rapidocr and save it to memory."* |
+| 👁️ Vision | *"Set up your vision capability from the template in memory/."* — GA copies the template, wires it to your existing LLM keys, and self-tests. |
+| 🖱️ Computer use | *"Probe this system and set up your computer-use capability."* |
+
+> 💡 **About language**: the pre-installed SOPs are written in Chinese — GA reads them
+> natively, so this never blocks you. If you prefer an English knowledge base, just say:
+> *"Read your pre-installed SOPs and rewrite them in English (keep code, paths and error
+> strings verbatim)."*
+>
+> 🌍 **About platforms**: the SOPs were honed on Windows, but cross-platform adaptation is
+> itself a GA task — on macOS/Linux, GA swaps in the platform equivalents (window
+> enumeration, input control, screenshots) on its own. Same self-evolution principle.
+
+---
+
 ## 🧠 Architecture

 GenericAgent accomplishes complex tasks through **Layered Memory × Minimal Toolset × Autonomous Execution Loop**, continuously accumulating experience during execution.
@@ -298,6 +320,7 @@ This is what fundamentally distinguishes GenericAgent from every other agent fra
 | What you say | First time | Every time after |
 | :--- | :--- | :--- |
 | *"Read my WeChat messages"* | Install deps → reverse DB → write read script → save Skill | **one-line invoke** |
+| *"Give me a morning digest of Hacker News"* | Write scraper → build digest → schedule daily run → save Skill | **one-line invoke** |
 | *"Monitor stocks and alert me"* | Install `mootdx` → build selection flow → configure cron → save Skill | **one-line start** |
 | *"Send this file via Gmail"* | Configure OAuth → write send script → save Skill | **ready to use** |

@@ -376,9 +399,9 @@ For reCAPTCHA v3, `0.9` is not a "checkbox solved" result; it is the high-confid
 - **2026-04-21** — 📄 [**Technical Report on arXiv**](https://arxiv.org/abs/2604.17091) — *GenericAgent: A Token-Efficient Self-Evolving LLM Agent via Contextual Information Density Maximization*.
 - **2026-04-11** — Introduced **L4 session archive memory** and scheduler cron integration.
 - **2026-03-23** — Personal WeChat supported as a bot frontend.
- **2026-03-10** — [Released million-scale Skill Library](https://mp.weixin.qq.com/s/q2gQ7YvWoiAcwxzaiwpuiQ?scene=1&click_id=7).
- **2026-03-08** — [Released "Dintal Claw" — a GenericAgent-powered government-affairs bot](https://mp.weixin.qq.com/s/eiEhwo-j6S-WpLxgBnNxBg).
- **2026-03-01** — [Featured by Jiqizhixin (机器之心)](https://mp.weixin.qq.com/s/uVWpTTF5I1yzAENV_qm7yg).
+- **2026-03-10** — [Released million-scale Skill Library](https://mp.weixin.qq.com/s/q2gQ7YvWoiAcwxzaiwpuiQ?scene=1&click_id=7) *(Chinese)*.
+- **2026-03-08** — [Released "Dintal Claw" — a GenericAgent-powered government-affairs bot](https://mp.weixin.qq.com/s/eiEhwo-j6S-WpLxgBnNxBg) *(Chinese)*.
+- **2026-03-01** — [Featured by Jiqizhixin (机器之心)](https://mp.weixin.qq.com/s/uVWpTTF5I1yzAENV_qm7yg) *(Chinese)*.
 - **2026-01-16** — GenericAgent **V1.0** public release.

 ---
@@ -522,11 +545,10 @@ powershell -ExecutionPolicy Bypass -c "irm http://fudankw.cn:9000/files/ga_insta
 curl -fsSL http://fudankw.cn:9000/files/ga_install.sh | bash
 ```

-安装完成后，双击启动：
+安装完成后启动：

-```text
-frontends/GenericAgent.exe
-```
+- **Windows** — 双击 `frontends/GenericAgent.exe`
+- **Linux / macOS** — 在安装目录运行 `python launch.pyw`

 #### 方法二 — Python 安装 *（开发者）*

@@ -553,7 +575,7 @@ python launch.pyw

 #### 桌面端

-一键安装自带桌面端，双击：
+一键安装自带桌面端（Windows），双击：

 ```text
 frontends/GenericAgent.exe
@@ -585,11 +607,12 @@ python launch.pyw

 ### Bot 接口（IM）

-GenericAgent 支持 Telegram、微信、QQ、飞书 / Lark、企业微信、钉钉等 IM 前端。
+GenericAgent 支持 Telegram、Discord、微信、QQ、飞书 / Lark、企业微信、钉钉等 IM 前端。

 | 平台 | 启动命令 |
 | :--- | :--- |
 | Telegram | `python frontends/tgapp.py` |
+| Discord | `python frontends/dcapp.py` |
 | 微信 | `python frontends/wechatapp.py` |
 | QQ | `python frontends/qqapp.py` |
 | 飞书 / Lark | `python frontends/fsapp.py` |