ys/GenericAgent
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update the readme

Browse Source
This commit is contained in:
Jinyi Han
2026-03-14 01:12:22 +08:00
parent 5a9736b7f0
commit 7977820500
1 changed files with 6 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
README.md
View File

@@ -99,7 +99,6 @@ Full guide: [WELCOME_NEW_USER.md](WELCOME_NEW_USER.md)
cd /sdcard/ga cd /sdcard/ga
python agentmain.py python agentmain.py
``` ```
--- ---
## 🤖 Bot Interfaces (Optional) ## 🤖 Bot Interfaces (Optional)
@@ -128,7 +127,6 @@ python launch.pyw --qq
> Create a bot at the [QQ Open Platform](https://q.qq.com) to get AppID / AppSecret. After the first message, user openid is logged in `temp/qqapp.log`. > Create a bot at the [QQ Open Platform](https://q.qq.com) to get AppID / AppSecret. After the first message, user openid is logged in `temp/qqapp.log`.
---
### Lark (Feishu) ### Lark (Feishu)
@@ -149,7 +147,6 @@ fs_allowed_users = ["ou_xxx"] # or ['*']
Full setup: [assets/SETUP_FEISHU.md](assets/SETUP_FEISHU.md) Full setup: [assets/SETUP_FEISHU.md](assets/SETUP_FEISHU.md)
---
### WeCom (Enterprise WeChat) ### WeCom (Enterprise WeChat)
@@ -165,8 +162,6 @@ wecom_allowed_users = ["your_user_id"]
wecom_welcome_message = "Hello, I'm online." wecom_welcome_message = "Hello, I'm online."
``` ```
---
### DingTalk ### DingTalk
```bash ```bash
@@ -180,7 +175,6 @@ dingtalk_client_secret = "your_app_secret"
dingtalk_allowed_users = ["your_staff_id"] # or ['*'] dingtalk_allowed_users = ["your_staff_id"] # or ['*']
``` ```
---
### Telegram Bot ### Telegram Bot
@@ -194,7 +188,6 @@ tg_allowed_users = [YOUR_USER_ID]
python tgapp.py python tgapp.py
``` ```
---
## 📊 Comparison with Similar Tools ## 📊 Comparison with Similar Tools
@@ -207,7 +200,6 @@ python tgapp.py
| **Self-Evolution** | Autonomous SOP growth | Plugin ecosystem | Stateless between sessions | | **Self-Evolution** | Autonomous SOP growth | Plugin ecosystem | Stateless between sessions |
| **Out of the Box** | 10 .py files + 5 SOPs | Hundreds of modules | Rich CLI toolset | | **Out of the Box** | 10 .py files + 5 SOPs | Hundreds of modules | Rich CLI toolset |
---
## 🧠 How It Works ## 🧠 How It Works
@@ -249,7 +241,6 @@ Via `code_run`, GenericAgent can dynamically install Python packages, write new
<br><em>GenericAgent Workflow Diagram</em> <br><em>GenericAgent Workflow Diagram</em>
</div> </div>
---
## ⭐ Support ## ⭐ Support
@@ -261,7 +252,7 @@ You're also welcome to join our **GenericAgent Community Group** for discussion,
<img src="assets/images/wechat_group.jpg" width="280"/> <img src="assets/images/wechat_group.jpg" width="280"/>
</div> </div>
---
## 📄 License ## 📄 License
@@ -279,7 +270,7 @@ MIT License — see [LICENSE](LICENSE)
<a name="chinese"></a> <a name="chinese"></a>
## 🌟 项目简介 ## 🌟 项目简介
**GenericAgent** 是一个极简、可自我进化的自主 Agent 框架。核心仅 **~3,300 行代码**，通过 **7 个原子工具 + 92 行 Agent Loop**，赋予任意 LLM 对本地计算机的系统级控制能力，覆盖浏览器、终端、文件系统、键鼠输入、屏幕视觉及移动设备（ADB）。 **GenericAgent** 是一个极简、可自我进化的自主 Agent 框架。核心仅 **~3,300 行代码**，通过 **7 个原子工具 + 92 行 Agent Loop**，赋予任意 LLM 对本地计算机的系统级控制能力，覆盖浏览器、终端、文件系统、键鼠输入、屏幕视觉及移动设备。
它的设计哲学是：**不预设技能，靠进化获得能力。** 它的设计哲学是：**不预设技能，靠进化获得能力。**
@@ -287,16 +278,12 @@ MIT License — see [LICENSE](LICENSE)
> **🤖 自举实证** — 本仓库的一切，从安装 Git、`git init` 到每一条 commit message，均由 GenericAgent 自主完成。作者全程未打开过一次终端。 > **🤖 自举实证** — 本仓库的一切，从安装 Git、`git init` 到每一条 commit message，均由 GenericAgent 自主完成。作者全程未打开过一次终端。
---
## 📋 核心特性 ## 📋 核心特性
- **自我进化**: 每次任务自动沉淀 SOP，能力随使用持续增长，形成专属技能树 - **自我进化**: 每次任务自动沉淀 SOP，能力随使用持续增长，形成专属技能树
- **极简架构**: ~3,300 行核心代码，Agent Loop 仅 92 行，无复杂依赖，部署零负担 - **极简架构**: ~3,300 行核心代码，Agent Loop 仅 92 行，无复杂依赖，部署零负担
- **强执行力**: 注入真实浏览器（保留登录态），7 个原子工具直接接管系统 - **强执行力**: 注入真实浏览器（保留登录态），7 个原子工具直接接管系统
- **高兼容性**: 支持 Claude / Gemini / Kimi 等主流模型，跨平台运行 - **高兼容性**: 支持 Claude / Gemini / Kimi 等主流模型，跨平台运行
---
## 🧬 自我进化机制 ## 🧬 自我进化机制
这是 GenericAgent 区别于其他 Agent 框架的根本所在。 这是 GenericAgent 区别于其他 Agent 框架的根本所在。
@@ -315,21 +302,17 @@ MIT License — see [LICENSE](LICENSE)
用几周后，你的 Agent 实例将拥有一套任何人都没有的专属技能树，全部从 3,300 行种子代码中生长而来。 用几周后，你的 Agent 实例将拥有一套任何人都没有的专属技能树，全部从 3,300 行种子代码中生长而来。
##### 🎯 实例展示 #### 🎯 实例展示
| 🧋 外卖下单 | 📈 量化选股 | | 🧋 外卖下单 | 📈 量化选股 |
|:---:|:---:| |:---:|:---:|
| <img src="assets/demo/order_tea.gif" width="100%" alt="Order Tea"> | <img src="assets/demo/selectstock.gif" width="100%" alt="Stock Selection"> | | <img src="assets/demo/order_tea.gif" width="100%" alt="Order Tea"> | <img src="assets/demo/selectstock.gif" width="100%" alt="Stock Selection"> |
| *"Order me a milk tea"* — 自动导航外卖 App，选品并完成结账 | *"Find GEM stocks with EXPMA golden cross, turnover > 5%"* — 量化条件筛股 | | *"Order me a milk tea"* — 自动导航外卖 App，选品并完成结账 | *"Find GEM stocks with EXPMA golden cross, turnover > 5%"* — 量化条件筛股 |
&nbsp;
| 🌐 自主网页探索 | 💰 支出追踪 | 💬 批量消息 | | 🌐 自主网页探索 | 💰 支出追踪 | 💬 批量消息 |
|:---:|:---:|:---:|
| <img src="assets/demo/autonomous_explore.png" width="100%" alt="Web Exploration"> | <img src="assets/demo/alipay_expense.png" width="100%" alt="Alipay Expense"> | <img src="assets/demo/wechat_batch.png" width="100%" alt="WeChat Batch"> | | <img src="assets/demo/autonomous_explore.png" width="100%" alt="Web Exploration"> | <img src="assets/demo/alipay_expense.png" width="100%" alt="Alipay Expense"> | <img src="assets/demo/wechat_batch.png" width="100%" alt="WeChat Batch"> |
| 自主浏览并定时汇总网页信息 | *"查找近 3 个月超 ¥2K 的支出"* — 通过 ADB 驱动支付宝 | 批量发送微信消息，完整驱动微信客户端 | | 自主浏览并定时汇总网页信息 | *"查找近 3 个月超 ¥2K 的支出"* — 通过 ADB 驱动支付宝 | 批量发送微信消息，完整驱动微信客户端 |
---
## 📅 最新动态 ## 📅 最新动态
@@ -401,8 +384,6 @@ python launch.pyw --qq
> 在 [QQ 开放平台](https://q.qq.com) 创建机器人获取 AppID / AppSecret。首次消息后，用户 openid 记录于 `temp/qqapp.log`。 > 在 [QQ 开放平台](https://q.qq.com) 创建机器人获取 AppID / AppSecret。首次消息后，用户 openid 记录于 `temp/qqapp.log`。
---
### 飞书（Lark） ### 飞书（Lark）
```bash ```bash
@@ -422,7 +403,6 @@ fs_allowed_users = ["ou_xxx"] # 或 ['*']
详细配置见 [assets/SETUP_FEISHU.md](assets/SETUP_FEISHU.md) 详细配置见 [assets/SETUP_FEISHU.md](assets/SETUP_FEISHU.md)
---
### 企业微信（WeCom） ### 企业微信（WeCom）
@@ -438,8 +418,6 @@ wecom_allowed_users = ["your_user_id"]
wecom_welcome_message = "你好，我在线上。" wecom_welcome_message = "你好，我在线上。"
``` ```
---
### 钉钉（DingTalk） ### 钉钉（DingTalk）
```bash ```bash
@@ -453,7 +431,6 @@ dingtalk_client_secret = "your_app_secret"
dingtalk_allowed_users = ["your_staff_id"] # 或 ['*'] dingtalk_allowed_users = ["your_staff_id"] # 或 ['*']
``` ```
---
### Telegram Bot ### Telegram Bot
@@ -467,9 +444,8 @@ tg_allowed_users = [YOUR_USER_ID]
python tgapp.py python tgapp.py
``` ```
---
## 📊 与同类产品的对比 ## 📊 与同类产品对比
| 特性 | GenericAgent | OpenClaw | Claude Code | | 特性 | GenericAgent | OpenClaw | Claude Code |
|------|:---:|:---:|:---:| |------|:---:|:---:|:---:|
@@ -480,7 +456,6 @@ python tgapp.py
| **自我进化** | 自主生长 SOP 和工具 | 插件生态 | 会话间无状态 | | **自我进化** | 自主生长 SOP 和工具 | 插件生态 | 会话间无状态 |
| **出厂配置** | 10 个 .py + 5 个 SOP | 数百模块 | 丰富 CLI 工具集 | | **出厂配置** | 10 个 .py + 5 个 SOP | 数百模块 | 丰富 CLI 工具集 |
---
## 🧠 工作机制 ## 🧠 工作机制
@@ -523,11 +498,10 @@ GenericAgent 通过**分层记忆 × 最小工具集 × 自主执行循环**完
<br><em>GenericAgent 工作流程图</em> <br><em>GenericAgent 工作流程图</em>
</div> </div>
---
## ⭐ 支持 ## ⭐ 支持
如果这个项目对你有帮助，欢迎点一个 **Star!** 🙏 如果这个项目对您有帮助，欢迎点一个 **Star!** 🙏
同时也欢迎加入我们的**GenericAgent体验交流群**，一起交流、反馈和共建 👏 同时也欢迎加入我们的**GenericAgent体验交流群**，一起交流、反馈和共建 👏
<div align="center"> <div align="center">
@@ -535,8 +509,6 @@ GenericAgent 通过**分层记忆 × 最小工具集 × 自主执行循环**完
</div> </div>
---
## 📄 许可 ## 📄 许可
MIT License — 详见 [LICENSE](LICENSE) MIT License — 详见 [LICENSE](LICENSE)