docs: bilingual README for v1.1 release

2026-03-11 00:16:00 +08:00
parent 022f4f1f9a
commit bdae129e44
1 changed files with 96 additions and 88 deletions
--- a/README.md
+++ b/README.md
@@ -2,165 +2,173 @@

 **Portable AI Agent — 插上就能用的 AI 助手**

+**Portable AI Agent — Double-click to run, no installation needed**
+
 > 像当年的雨林木风，把 AI 助手简化到"双击运行"。
+> Like the legendary YuLinMuFeng installer discs, but for AI.

 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

 ---

-## 为什么需要 U-Claw？
+## Why U-Claw? / 为什么需要 U-Claw？

-[OpenClaw](https://github.com/openclaw/openclaw) 是最强的开源 AI 助手框架，但在中国安装它是个噩梦：GitHub 访问不了、npm 超时、Node.js 下载慢。
+[OpenClaw](https://github.com/openclaw/openclaw) is the most powerful open-source AI assistant framework. But in China, installing it is a nightmare: GitHub blocked, npm timeout, Node.js download slow.

-**U-Claw 解决所有问题。** Node.js + OpenClaw + 所有依赖 + QQ 插件，全部打包好。双击即用。
+[OpenClaw](https://github.com/openclaw/openclaw) 是最强的开源 AI 助手框架，但在中国安装它是个噩梦。

-## 快速开始
+**U-Claw bundles everything.** Node.js + OpenClaw + all dependencies + QQ plugin, pre-built and ready to run.

-### 方法 1：从 Releases 下载（推荐）
+**U-Claw 全部打包好。** Node.js + OpenClaw + 所有依赖 + QQ 插件，双击即用。

-1. 下载 [U-Claw-v1.1.tar.gz](https://github.com/dongsheng123132/u-claw/releases)
-2. 解压到任意位置（U 盘、桌面、文档都行）
-3. Mac: 双击 `Mac-Start.command` / Windows: 双击 `Windows-Start.bat`
+## Quick Start / 快速开始

-### 方法 2：用 U 盘安装脚本
+### Option 1: Download Release / 从 Releases 下载（推荐）

-U 盘上有安装脚本，双击自动解压 + 启动：
+1. Download [U-Claw-v1.1.tar.gz](https://github.com/dongsheng123132/u-claw/releases)
+2. Extract anywhere (USB drive, Desktop, Documents)
+3. Mac: double-click `Mac-Start.command` / Windows: double-click `Windows-Start.bat`
+4. Browser opens automatically — configure your AI model and API key
+
+下载解压，双击启动，浏览器自动打开配置页面。
+
+### Option 2: USB Install Script / U 盘安装脚本
+
+USB drive has install scripts that auto-extract + launch:
 - Mac: `Mac-Install.command`
 - Windows: `Windows-Install.bat`

-### 方法 3：复制别人的
+### Option 3: Copy / 复制别人的

-直接把 `U-Claw/` 文件夹复制一份就行。
+Just copy the `U-Claw/` folder. That's it.

-## 目录结构
+直接复制 `U-Claw/` 文件夹就行。
+
+## Directory Structure / 目录结构

 ```
 U-Claw/                           (~2.3GB)
-├── Mac-Start.command             ← Mac 双击启动
-├── Windows-Start.bat             ← Windows 双击启动
-├── Mac-Menu.command              ← Mac 配置/维护菜单
-├── Windows-Menu.bat              ← Windows 配置/维护菜单
-├── U-Claw.html                   ← 导航页面
+├── Mac-Start.command             ← Mac: double-click to start
+├── Windows-Start.bat             ← Windows: double-click to start
+├── Mac-Menu.command              ← Mac: config & maintenance menu
+├── Windows-Menu.bat              ← Windows: config & maintenance menu
+├── U-Claw.html                   ← Navigation page / 导航页面
 ├── app/
-│   ├── core/                     ← OpenClaw + 依赖 + QQ 插件
+│   ├── core/                     ← OpenClaw + deps + QQ plugin
 │   └── runtime/
 │       ├── node-mac-arm64/       ← Mac Apple Silicon
 │       └── node-win-x64/         ← Windows 64-bit
-├── data/                         ← 用户数据（配置、记忆、备份）
-│   ├── .openclaw/
-│   ├── memory/
-│   └── backups/
+├── data/                         ← User data (config, memory, backups)
 └── system/
-    └── migrate.js                ← 配置迁移脚本
+    └── migrate.js                ← Config migration
 ```

-## 菜单功能
+## Menu / 菜单功能

-精简到 8 个选项：
+8 options, covering config and maintenance:

 ```
-[1] 配置向导（选模型、API Key）
-[2] 打开网页控制台
-[3] QQ 机器人（已预装，只需输入 ID）
-[4] 其他平台（飞书/Telegram/微信）
-[5] 诊断修复
-[6] 备份配置
-[7] 恢复备份
-[8] 系统信息
+[1] Setup wizard (model, API key) / 配置向导
+[2] Open web dashboard / 打开网页控制台
+[3] QQ Bot (pre-installed) / QQ 机器人（已预装）
+[4] Other platforms (Feishu/Telegram/WeChat) / 其他平台
+[5] Diagnostics / 诊断修复
+[6] Backup / 备份配置
+[7] Restore / 恢复备份
+[8] System info / 系统信息
 ```

-## 支持的 AI 模型
+## AI Models / 支持的 AI 模型

-### 国产模型（无需翻墙）
+### Chinese Models (no VPN) / 国产模型（无需翻墙）

-| 模型 | 推荐场景 |
-|------|----------|
-| DeepSeek | 编程，性价比首选 |
-| Kimi K2.5 | 长文档，256K 上下文 |
-| 通义千问 Qwen | 免费额度大 |
-| 智谱 GLM | 学术 |
-| MiniMax | 语音、多模态 |
-| 豆包 Doubao | 火山引擎 |
+| Model 模型 | Best for 推荐场景 |
+|------------|-------------------|
+| DeepSeek | Coding, best value / 编程首选 |
+| Kimi K2.5 | Long docs, 256K context / 长文档 |
+| Qwen 通义千问 | Large free tier / 免费额度大 |
+| GLM 智谱 | Academic / 学术 |
+| MiniMax | Voice, multimodal / 语音 |
+| Doubao 豆包 | Volcano Engine / 火山引擎 |

-### 国际模型
+### International Models / 国际模型

 Claude (Anthropic) · GPT (OpenAI) · Gemini (Google)

-## 聊天平台
+## Chat Platforms / 聊天平台

-| 平台 | 状态 | 说明 |
-|------|------|------|
-| QQ | ✅ **已预装** | 只需输入 AppID + AppSecret |
-| 飞书 | ✅ 内置 | 企业首选 |
-| Telegram | ✅ 内置 | 海外推荐 |
-| 微信 | ✅ 社区插件 | iPad 协议 |
-| Discord | ✅ 内置 | — |
-| WhatsApp | ✅ 内置 | — |
+| Platform 平台 | Status 状态 | Notes 说明 |
+|---------------|------------|------------|
+| QQ | ✅ **Pre-installed 已预装** | Just enter AppID + Secret |
+| Feishu 飞书 | ✅ Built-in 内置 | Enterprise / 企业首选 |
+| Telegram | ✅ Built-in 内置 | International / 海外推荐 |
+| WhatsApp | ✅ Built-in 内置 | Baileys protocol |
+| Discord | ✅ Built-in 内置 | — |
+| Slack | ✅ Built-in 内置 | — |
+| WeChat 微信 | ✅ Community plugin | iPad protocol |

-### QQ 接入（1 分钟）
+### QQ Setup (1 min) / QQ 接入（1 分钟）

-QQ 插件已预装！只需：
-1. 访问 q.qq.com 创建机器人，获取 AppID 和 AppSecret
-2. 双击 `Mac-Menu.command`，选 [3] QQ 机器人
-3. 输入 AppID 和 AppSecret，完成
+QQ plugin is pre-installed! Just:
+1. Visit q.qq.com, create a bot, get AppID and AppSecret
+2. Run `Mac-Menu.command`, choose [3] QQ Bot
+3. Enter AppID and AppSecret, done

-## 系统要求
+## System Requirements / 系统要求

 - **macOS**: Apple Silicon (M1-M4), macOS 12+
 - **Windows**: 10/11, 64-bit
- **内存**: 2GB+（推荐 4GB+）
- **存储**: 3GB+
+- **RAM**: 2GB+ (4GB+ recommended)
+- **Storage**: 3GB+

-## 升级
+## Upgrade / 升级

-下载新版 `app/` 目录替换旧的，`data/` 不动（用户配置和记忆保留）。
+Replace `app/` with new version. `data/` stays (config and memory preserved).

-## U 盘结构
+下载新版替换 `app/`，`data/` 不动。
+
+## USB Drive Structure / U 盘结构

 ```
-UCLAW (U盘)
-├── Mac-Install.command       ← 首次双击（解压+启动）
+UCLAW (USB Drive)
+├── Mac-Install.command       ← First run (extract + launch)
 ├── Windows-Install.bat
-├── U-Claw.tar.gz             ← 压缩包
-├── README.txt                ← 使用说明
-└── Toolkit/                  ← 工程师 DIY 素材包
+├── U-Claw.tar.gz             ← Compressed package (743MB)
+├── README.txt                ← Instructions
+└── Toolkit/                  ← Engineer DIY kit
    ├── node-v22-mac-arm64.pkg
    ├── node-v22-win-x64.msi
    ├── openclaw-source.tar.gz
    └── npm-cache.tar.gz
 ```

-## 仓库结构
-
-```
-u-claw/
-├── portable/          ← 脚本源码（打包进 U-Claw）
-├── uclaw-scripts/     ← U 盘安装脚本
-├── website/           ← 官网
-├── docs/              ← 文档
-└── README.md
-```
-
 ## FAQ

-**Q: 需要翻墙吗？**
-安装不需要。运行需要联网调 AI API，国产模型无需翻墙。
+**Q: Need VPN? / 需要翻墙吗？**
+No for installation. Runtime needs internet for AI APIs — Chinese models work without VPN.
+安装不需要。运行需要联网调 API，国产模型无需翻墙。

-**Q: 能分发吗？**
+**Q: Can I share it? / 能分发吗？**
+Yes, MIT license, copy freely.
 可以，MIT 协议，随便复制。

-**Q: Windows 需要 WSL 吗？**
+**Q: Windows needs WSL?**
+No. Bundled Windows Node.js runs natively.
 不需要，自带 Windows 版 Node.js。

+**Q: Mac says "unverified developer"?**
+Right-click the script → Open.
+右键点击脚本 → 打开。
+
 ## License

 [MIT](LICENSE)

-## 联系
+## Contact / 联系

- 微信: hecare888
+- WeChat 微信: hecare888
 - GitHub: [@dongsheng123132](https://github.com/dongsheng123132)
- 官网: [u-claw.org](https://u-claw.org)
+- Website 官网: [u-claw.org](https://u-claw.org)

 ---