v4.2: README rewrite — user journey (use now → install → deploy) + Chinese version

- Lead with official bot: add @iLangGuardBot to your group, done
- VPS one-line install second
- HF Space third
- README_CN.md full Chinese version
- Both versions link to each other

README.md

@@ -23,80 +23,77 @@ Anti-spam. Vision. Chat. No topic off-limits.
 
 [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Powered by I-Lang](https://img.shields.io/badge/powered%20by-I--Lang%20Spec-blueviolet)](https://ilang.ai)
-[![Deploy on HF](https://img.shields.io/badge/deploy-HuggingFace%20Space-yellow)](https://huggingface.co/spaces/i-Lang/TelegramGuard)
 [![Gemini](https://img.shields.io/badge/AI-Gemini%202.5%20Flash-4285F4)](https://aistudio.google.com)
 
-</div>
-
----
-
-## One-Line Install (VPS)
-
-```bash
-curl -sL https://raw.githubusercontent.com/ilang-ai/TelegramGuard/main/install.sh | sudo bash
-```
+**[English](README.md)** | **[中文](README_CN.md)**
 
-That's it. The script clones, installs, asks for your tokens, creates a system service, and starts.
-
-You need two things (both free):
-- **Bot Token** from [@BotFather](https://t.me/BotFather) on Telegram
-- **Gemini API Key** from [aistudio.google.com/apikey](https://aistudio.google.com/apikey)
+</div>
 
 ---
 
-## What Makes This Different
+## Use It Now (Zero Setup)
 
-Most Telegram bots refuse to discuss anything remotely sensitive. TelegramGuard uses a **three-step method** for risky topics:
+Add the official bot to your Telegram group. No install, no config, no cost.
 
-| Step | What happens |
-|------|-------------|
-| **Insider Risks** | Shares what actually goes wrong: scams, traps, how people get burned |
-| **Reality Check** | Asks if you're curious or serious, no judgment |
-| **Direction** | If you persist, gives enough info to stay safe |
+**[@iLangGuardBot](https://t.me/iLangGuardBot)**
 
-This isn't a compliance bot. It's a street-smart friend who's seen things.
+1. Open Telegram, search `@iLangGuardBot`
+2. Add it to your group
+3. Grant admin permissions (delete messages + ban users)
+4. Done. Spam protection is automatic.
 
-Built on [**I-Lang Prompt Spec**](https://ilang.ai), a structured protocol that programs AI behavior using genetic code. The bot's personality lives in `.ilang` files with GENE definitions, IMMUNE response patterns, and a layered SOUL/PUBLIC architecture.
+You can also DM the bot directly for AI chat.
 
 ---
 
-## Features
+## What It Does
+
+**Anti-Spam** — AI three-step analysis detects ads, scams, crypto spam, porn, political propaganda. Sees through Unicode tricks, emoji stuffing, homophone substitution. Catches repeat flooding (same message 3+ times) with zero AI cost. Bans and deletes all recent messages in parallel.
 
-**Anti-Spam** — AI-powered three-step analysis. Detects ads, scams, crypto spam, sexual content, political propaganda. Sees through Unicode tricks, emoji stuffing, and homophone substitution. Catches repeat flooding without AI (pure logic, zero token cost). Bans spammers and deletes all their recent messages in parallel.
+**Vision** — Reads images and video thumbnails. Catches image spam. In chat mode, analyzes what's really happening in a photo, not just describing objects.
 
-**Vision** — Reads images using three-step image analysis: inventory everything in the image, find the subtext, deliver the insight. Catches image-based spam too. Understands video thumbnails.
+**Chat** — @ the bot in any group or DM privately. Multilingual, auto-detects your language. Finance, tech, relationships, culture, anything. Answers first, lectures never.
 
-**Chat** — @ the bot in any group or DM it privately. Multilingual, auto-detects your language. Knows finance, tech, relationships, culture, underground. Answers first, skips the lecture.
+**Three-Step Method for Sensitive Topics** — Most bots refuse. TelegramGuard uses a different approach:
 
-**Zero Config** — Add to group. Grant admin permissions. Done. No commands, no setup, no dashboards.
+| Step | What happens |
+|------|-------------|
+| **Insider Risks** | Shares what actually goes wrong: scams, traps, consequences |
+| **Reality Check** | Asks if you're curious or serious, no judgment |
+| **Direction** | Gives enough info to make smart decisions |
 
 ---
 
-## Deploy (Pick One)
+## Host Your Own
 
-### VPS — One Command
+### Option 1: VPS (One Command)
 
 ```bash
 curl -sL https://raw.githubusercontent.com/ilang-ai/TelegramGuard/main/install.sh | sudo bash
 ```
 
-Manage after install:
+The script handles everything: clone, dependencies, token setup, systemd service, auto-start.
+
+You need two things (both free):
+- **Bot Token** — open Telegram → [@BotFather](https://t.me/BotFather) → `/newbot`
+- **Gemini API Key** — [aistudio.google.com/apikey](https://aistudio.google.com/apikey)
 
+After install:
 ```bash
 systemctl status telegramguard     # check status
 systemctl restart telegramguard    # restart
 journalctl -u telegramguard -f    # live logs
 ```
 
-### HuggingFace Space — Zero Server
+### Option 2: HuggingFace Space (Free, No Server)
 
 1. Fork this repo
 2. Create a [HuggingFace Space](https://huggingface.co/new-space) → Docker SDK → Blank
-3. Set GitHub Actions secret: `HF_TOKEN` (your HF write token)
-4. Set Space secrets: `BOT_TOKEN` + `GEMINI_API_KEY`
-5. Push triggers auto-deploy
+3. GitHub repo Settings → Secrets → add `HF_TOKEN` (your HF write token)
+4. HF Space Settings → Secrets → add `BOT_TOKEN` + `GEMINI_API_KEY`
+5. Push to GitHub triggers auto-deploy to HF
 
-### Manual
+### Option 3: Manual
 
 ```bash
 git clone https://github.com/ilang-ai/TelegramGuard.git
@@ -109,94 +106,69 @@ python bot.py
 
 ---
 
-## Customize the AI Personality
+## Customize the AI
 
-The bot's brain lives in three `.ilang` files:
+The bot's brain lives in `.ilang` files using [I-Lang Prompt Spec](https://ilang.ai):
 
 ```
 prompts_demo/
-├── persona.ilang     SOUL (how it thinks) + PUBLIC (how it talks)
-├── antispam.ilang    What counts as spam, three-step detection
-└── vision.ilang      How to read images, three-step method
+├── persona.ilang     How it thinks + how it talks
+├── antispam.ilang    What counts as spam
+└── vision.ilang      How it reads images
 ```
 
-Open `persona.ilang` — it's a complete tutorial on I-Lang Prompt Spec:
+Each file contains `::GENE` definitions that control behavior:
 
 ```
 ::GENE_IMMUTABLE{S001, T:ANTI_COLLAPSE, A:MORAL_PANIC⇒LETHAL, G:ALL, Θ:ALWAYS}
-# When user raises extreme or grey topics:
-# ¬PANIC(moral_alignment) => HOLD(tension) => COMPUTE(structural_viability)
-# Never collapse into safety platitudes.
+# When user raises grey topics: don't panic, analyze objectively.
 
 ::IMMUNE{RISKY_OR_ILLEGAL, THREE_STEP_RESPONSE}
-# Step 1 — INSIDER RISKS: Share what actually goes wrong
-# Step 2 — REALITY CHECK: "Curious or serious?"
-# Step 3 — DIRECTION WITH WARNINGS: Give info to stay safe
+# Step 1: Insider risks  Step 2: Reality check  Step 3: Direction
 ```
 
-Every `::GENE` defines a behavior. `IMMUTABLE` genes can't be overridden. `MUTABLE` genes adapt to context. `::IMMUNE` patterns handle edge cases. Change the genes, change the bot.
-
-To create your own version: copy `prompts_demo/` to `prompts/` and edit. The bot loads `prompts/` first, falls back to `prompts_demo/`.
+Change the genes, change the bot. To customize: copy `prompts_demo/` to `prompts/`, edit. The bot loads `prompts/` first.
 
 **[Learn I-Lang Prompt Spec →](https://ilang.ai)**
 
 ---
 
-## Architecture
-
-```
-TelegramGuard/
-├── bot.py                 Main handler (group + private + events)
-├── config.py              Env vars (BOT_TOKEN, GEMINI_API_KEY)
-├── install.sh             One-line VPS installer
-├── Dockerfile             HuggingFace Space deployment
-├── modules/
-│   ├── chat.py            AI engine (loads .ilang prompts at startup)
-│   ├── db.py              Single shared SQLite connection + async lock
-│   ├── database.py        Schema (groups, spam_log, tos_consent)
-│   └── admin.py           Group admin helpers
-└── prompts_demo/          AI personality in I-Lang Prompt Spec
-    ├── persona.ilang      SOUL + PUBLIC + PROPAGATION layers
-    ├── antispam.ilang     Three-step spam detection
-    └── vision.ilang       Three-step image reading
-```
-
----
-
 ## BotFather Setup
 
-After creating your bot with [@BotFather](https://t.me/BotFather):
+After creating your bot, send to [@BotFather](https://t.me/BotFather):
 
 ```
-/setjoingroups  → Enable       (allow adding to groups)
-/setprivacy     → Disable      (bot can see all group messages for anti-spam)
+/setjoingroups  → Enable
+/setprivacy     → Disable
 ```
 
 ---
 
-## Tech Stack
+## Architecture
 
-| Component | Choice | Why |
-|-----------|--------|-----|
-| Runtime | Python 3.11 | Async, universal |
-| AI | Gemini 2.5 Flash | Free tier, fast, vision capable |
-| Database | SQLite + async lock | Zero setup, single file |
-| Prompts | I-Lang Prompt Spec | Structured > natural language |
-| Deploy | Docker / systemd | HF Space or any VPS |
+```
+TelegramGuard/
+├── bot.py                 Core (group + private + events)
+├── config.py              Env vars
+├── install.sh             One-line VPS installer
+├── Dockerfile             HF Space deployment
+├── modules/
+│   ├── chat.py            AI engine (loads .ilang prompts)
+│   ├── db.py              Shared SQLite + async lock
+│   ├── database.py        Schema
+│   └── admin.py           Group admin
+└── prompts_demo/          AI personality (.ilang files)
+```
 
 ---
 
 <div align="center">
 
-**[I-Lang Prompt Spec](https://ilang.ai)** — Structured AI instructions using genetic code.
-
-GENE framework. IMMUNE patterns. SOUL/PUBLIC layers.
-
-One `.ilang` file defines an entire AI personality.
+Built with **[I-Lang Prompt Spec](https://ilang.ai)** — structured AI instructions using genetic code.
 
-[![GitHub](https://img.shields.io/badge/spec-ilang--ai/ilang--spec-black?logo=github)](https://github.com/ilang-ai/ilang-spec)
-[![Website](https://img.shields.io/badge/web-ilang.ai-blue)](https://ilang.ai)
-[![HuggingFace](https://img.shields.io/badge/HF-i--Lang-yellow?logo=huggingface)](https://huggingface.co/i-Lang)
+[![Spec](https://img.shields.io/badge/spec-ilang--ai/ilang--spec-black?logo=github)](https://github.com/ilang-ai/ilang-spec)
+[![Web](https://img.shields.io/badge/web-ilang.ai-blue)](https://ilang.ai)
+[![HF](https://img.shields.io/badge/HF-i--Lang-yellow?logo=huggingface)](https://huggingface.co/i-Lang)
 
 MIT | [Eastsoft Inc.](https://eastsoft.com) | [I-Lang Research](https://research.ilang.ai)
 

README_CN.md

@@ -0,0 +1,160 @@
+<div align="center">
+
+# 🛡️ TelegramGuard
+
+**真正回答问题的AI群管机器人**
+
+反垃圾 · 看图识别 · 智能对话 · 知无不答
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Powered by I-Lang](https://img.shields.io/badge/powered%20by-I--Lang%20Spec-blueviolet)](https://ilang.ai)
+[![Gemini](https://img.shields.io/badge/AI-Gemini%202.5%20Flash-4285F4)](https://aistudio.google.com)
+
+**[English](README.md)** | **[中文](README_CN.md)**
+
+</div>
+
+---
+
+## 直接使用（零成本零配置）
+
+把官方机器人拉进你的电报群, 立刻开始工作。不需要安装, 不需要服务器, 不花一分钱。
+
+**[@iLangGuardBot](https://t.me/iLangGuardBot)**
+
+1. 打开电报, 搜索 `@iLangGuardBot`
+2. 把它加到你的群里
+3. 给管理员权限（删消息 + 封人）
+4. 完事。反垃圾全自动。
+
+也可以直接私聊机器人, 什么都能问。
+
+---
+
+## 它能做什么
+
+**反垃圾** — AI三步分析, 识别广告、诈骗、加密货币spam、色情、政治宣传。能看穿Unicode变体、emoji混淆、谐音替代等花招。相同消息刷屏3次自动判定, 零AI成本。封人+删除全部近期消息, 并行执行。
+
+**看图** — 识别图片和视频缩略图。拦截图片类垃圾信息。聊天模式下, 分析照片背后真正发生了什么, 不是干巴巴描述物体。
+
+**聊天** — 在群里@它或者私聊。自动检测语言, 用你的语言回复。金融、技术、感情、文化, 什么都聊。先回答, 不说教。
+
+**敏感话题三步法** — 别的机器人直接拒绝, TelegramGuard不一样:
+
+| 步骤 | 做什么 |
+|------|--------|
+| **风险揭底** | 像老江湖一样告诉你这里面的坑: 骗局、陷阱、后果 |
+| **确认意图** | 问你是好奇还是认真的, 不带评判 |
+| **给方向** | 给足够的信息让你做聪明的决定 |
+
+---
+
+## 自己部署
+
+### 方式一: VPS一键安装
+
+```bash
+curl -sL https://raw.githubusercontent.com/ilang-ai/TelegramGuard/main/install.sh | sudo bash
+```
+
+一行命令搞定: 下载代码、装依赖、填token、创建系统服务、自动启动。
+
+你需要准备两样东西（都免费）:
+- **Bot Token** — 打开电报 → 找 [@BotFather](https://t.me/BotFather) → 发 `/newbot`
+- **Gemini API Key** — 去 [aistudio.google.com/apikey](https://aistudio.google.com/apikey) 免费申请
+
+装完后管理:
+```bash
+systemctl status telegramguard     # 看状态
+systemctl restart telegramguard    # 重启
+journalctl -u telegramguard -f    # 看日志
+```
+
+### 方式二: HuggingFace Space（免费, 不需要服务器）
+
+1. Fork 这个仓库
+2. 创建 [HuggingFace Space](https://huggingface.co/new-space) → Docker SDK → Blank
+3. GitHub仓库 Settings → Secrets → 加 `HF_TOKEN`
+4. HF Space Settings → Secrets → 加 `BOT_TOKEN` + `GEMINI_API_KEY`
+5. 推代码自动部署
+
+### 方式三: 手动
+
+```bash
+git clone https://github.com/ilang-ai/TelegramGuard.git
+cd TelegramGuard
+pip install -r requirements.txt
+export BOT_TOKEN="你的token"
+export GEMINI_API_KEY="你的key"
+python bot.py
+```
+
+---
+
+## 自定义AI人格
+
+机器人的大脑是三个 `.ilang` 文件, 使用 [I-Lang Prompt Spec](https://ilang.ai) 编写:
+
+```
+prompts_demo/
+├── persona.ilang     思维方式 + 说话方式
+├── antispam.ilang    什么算垃圾信息
+└── vision.ilang      怎么看图
+```
+
+每个文件里的 `::GENE` 定义一个行为:
+
+```
+::GENE_IMMUTABLE{S001, T:ANTI_COLLAPSE, A:MORAL_PANIC⇒LETHAL, G:ALL, Θ:ALWAYS}
+# 用户问敏感话题时: 不慌, 客观分析
+
+::IMMUNE{RISKY_OR_ILLEGAL, THREE_STEP_RESPONSE}
+# 第一步: 揭底风险  第二步: 确认意图  第三步: 给方向
+```
+
+改基因 = 改机器人。想自定义: 复制 `prompts_demo/` 到 `prompts/`, 然后编辑。机器人优先加载 `prompts/`。
+
+**[学习 I-Lang Prompt Spec →](https://ilang.ai)**
+
+---
+
+## BotFather 设置
+
+创建机器人后, 给 [@BotFather](https://t.me/BotFather) 发:
+
+```
+/setjoingroups  → Enable（允许加群）
+/setprivacy     → Disable（让机器人能看到群消息）
+```
+
+---
+
+## 项目结构
+
+```
+TelegramGuard/
+├── bot.py                 核心逻辑
+├── config.py              环境变量配置
+├── install.sh             一键安装脚本
+├── Dockerfile             HF Space部署
+├── modules/
+│   ├── chat.py            AI引擎（启动时加载.ilang）
+│   ├── db.py              SQLite共享连接 + 异步锁
+│   ├── database.py        数据表
+│   └── admin.py           群管理
+└── prompts_demo/          AI人格定义（.ilang文件）
+```
+
+---
+
+<div align="center">
+
+基于 **[I-Lang Prompt Spec](https://ilang.ai)** 构建 — 用基因代码定义AI行为
+
+[![Spec](https://img.shields.io/badge/spec-ilang--ai/ilang--spec-black?logo=github)](https://github.com/ilang-ai/ilang-spec)
+[![Web](https://img.shields.io/badge/web-ilang.ai-blue)](https://ilang.ai)
+[![HF](https://img.shields.io/badge/HF-i--Lang-yellow?logo=huggingface)](https://huggingface.co/i-Lang)
+
+MIT | [Eastsoft Inc.](https://eastsoft.com) | [I-Lang Research](https://research.ilang.ai)
+
+</div>