Upload README.zh-CN.md with huggingface_hub

README.zh-CN.md

@@ -1,62 +1,92 @@
-# Zero Token
+## 你的 Agent 断过吗？
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![OpenClaw Skill](https://img.shields.io/badge/OpenClaw-Skill-blue.svg)](https://openclaw.ai)
-[![I-Lang Protocol](https://img.shields.io/badge/I--Lang-v3.0-green.svg)](https://ilang.ai)
+API 欠费。DeepSeek 限流。OpenAI 挂了。你的 Agent 刚完成 80%，然后——沉默。
 
-🌐 [English](README.md)
+用户不会理解。他们只知道「这玩意儿又不行了」。三次之后，你不会再有第四次机会。
 
-**零成本。高级输出。永不掉线。**
+---
 
-token 用完了。DeepSeek API 挂了。你的 agent 在跑一个重要任务。怎么办？
+## Zero Token 做的事
 
-Zero Token 给你的 agent 两样东西：
-1. 人格——跟 Poor Man's Opus 同款的 `::GENE{}` 行为基因
-2. 安全网——主模型挂了自动切免费提供商
+不是「备用方案」。不是「降级容忍」。是**无感接管**。
 
-一条命令装好，agent 永远有保底。
+主模型挂掉的那一秒，13 个免费 LLM 已经顶上。同一个 Agent 人格，同一个决策逻辑，同一个语气。你的用户连波动都看不到。
 
-## 三步装好
+**0 元。0 中断。0 察觉。**
+
+---
+
+## 两行命令，一分钟
 
 ```bash
-# 1. 装技能
 openclaw skills install zero-token
-
-# 2. 跑配置脚本
 bash ~/.openclaw/workspace/skills/zero-token/scripts/setup.sh
+```
 
-# 3. 去拿一个免费 API key（30 秒）：
-#    - Gemini: https://aistudio.google.com/apikey
-#    - Groq: https://console.groq.com/keys
+[Free-Way](https://github.com/GoDiao/Free-Way) 网关聚合 13+ 免费 LLM 提供商，你给一组免费 key，它给你一个 `/v1` 端点。OpenClaw 配成 fallback。主模型炸了 → 自动切。代理接着跑。
 
-# 4. 在 Free-Way 控制台贴上 key：
-#    http://localhost:8787 → API Keys
+---
 
-# 5. 重启。agent 有免费保底了。
-```
+## 两种模式
+
+| 模式 | 触发条件 | 效果 |
+|------|---------|------|
+| 🆓 免费模式 | 无付费 API key | Agent 完全跑在免费模型上，SOUL 人格完整保留 |
+| 🛡️ 接管模式 | 主模型挂了 / token 耗尽 | 自动切免费提供商，工作继续，用户无感 |
+
+---
+
+## 零成本 ≠ 垃圾模型
+
+免费模型裸输出一般。但 `::GENE{}` 行为 DNA 叠上去之后——同一个人格，同一种决策，同一种语气。用户分不清现在跑的是 DeepSeek V4 Pro 还是 Llama 3.3 70B。
+
+---
 
-## 两个场景
+## 凭什么免费
 
-| 场景 | 用哪个 |
-|------|--------|
-| 新手想试 agent 技能 | **Zero Token** — 免费、立刻 |
-| 主力生产 | **Poor Man's Opus** — DeepSeek V4 Pro |
-| API 挂了 / token 用完了 | **Zero Token** — 自动切免费模型 |
+Free-Way + Zero Token 开源。每个提供商都有免费额度：
 
-## 升级路径
+| 提供商 | 免费额度 | 推荐模型 |
+|--------|---------|---------|
+| Groq | 1000 req/天 | Llama 3.3 70B |
+| Gemini Flash | 1500 req/天 | Gemini 2.5 Flash |
+| Cerebras | 1700 req/天 | Llama 3.3 70B |
+| Cloudflare | 1万 neurons/天 | Llama 3.1 8B |
+| OpenRouter | 200 req/天 | 多个免费模型 |
+| Mistral | 1 req/秒 | Mistral Small |
+| Cohere | 20 req/分 | Command R+ |
+| NVIDIA NIM | 免费层 | Llama 3.3 70B |
 
-装好 Zero Token 觉得不错？升级：
+注册每个 key 30 秒。setup 脚本带你一步步走。
+
+---
+
+## 对比
+
+| | 主流方案 | Zero Token |
+|---|---|---|
+| 模型费用 | $0.14–$15.00/M tokens | **$0.00** |
+| 模型中断 | 彻底停摆 | 无感切换 |
+| 备用模型数 | 0 | 13+ |
+| Agent 人格 | 主模型挂了就丢 | 始终一致 |
+| 设置成本 | 半天（配负载均衡） | 1 分钟 |
+
+---
+
+## 什么时候升级
+
+Zero Token 保证不掉线。如果追求最佳输出——DeepSeek V4 Pro + 完整基因组，Opus 3% 价格：
 
 ```bash
 openclaw skills install poor-mans-opus
 ```
 
-DeepSeek V4 Pro + 完整 SOUL = Opus 3% 的价格。
+---
 
 ## 链接
 
 - [Free-Way 网关](https://github.com/GoDiao/Free-Way)
-- [Poor Man's Opus](https://github.com/mtmpss/poor-mans-opus)
 - [I-Lang 协议](https://ilang.ai)
-
-MIT License
+- [OpenClaw](https://github.com/openclaw/openclaw)
+- [Poor Man's Opus](https://github.com/mtmpss/poor-mans-opus)
+- [ClawHub](https://clawhub.ai/mtmpss/zero-token)