diff --git a/README.md b/README.md
index 9e911ff..ea31106 100644
--- a/README.md
+++ b/README.md
@@ -1,70 +1,120 @@
+
+
+

+
# SnowCat 雪猫
-> 雪取自 [SnowLuma](https://github.com/SnowLuma/SnowLuma),猫取自 [NapCat](https://github.com/NapNeko/NapCatQQ)。
-> 两个先行者铺下的路,自此由后来者接续。**上游在,我们跟;上游没了,我们扛。**
+**雪取自 [SnowLuma](https://github.com/SnowLuma/SnowLuma) · 猫取自 [NapCat](https://github.com/NapNeko/NapCatQQ)**
-SnowCat 是一个由社区开发者维护的第三方 QQ 客户端:让开发者自己的智能体,接入开发者自己的生态。NapCat 4.18.28 底座 + SnowLuma 独门能力融合,全功能运行于 **QQ 9.9.37-54395(官方最新版)主进程内**。
+*两个先行者铺下的路,自此由后来者接续。*
-## 核心特性
+**上游在,我们跟;上游没了,我们扛。**
-- **QQ 9.9.37-54395 全功能在役**:通过 V8 编译器通道注入(详见[制作文档](docs/dev/FROM-P1-TO-V8.md)),QQ 本体一字节未动
-- **OneBot v11 全动作**:正向/反向 WS、HTTP、HTTP SSE 全接入方式
-- **MCP 接入**:Streamable HTTP `/mcp`,全部 OneBot 动作自动暴露为 MCP 工具
-- **56 项独门动作移植**(采自 SnowLuma):QZone 全家桶、群相册、精华、打卡、装扮、闪照管理、收藏、点赞……
-- **Packet 发包**:offset 表驱动,逐版本维护
-- **雪猫 WebUI**:React + Tailwind + HeroUI 全面重制(总览/登录/网络/关于全页面)
-- **便携环境制作器**:官方最新包一键解包、一键便携化
-- **稳定线**:连接退避 + 真人节奏抖动 + 预算 + 熔断
+[](https://im.qq.com)
+[](https://onebot.dev)
+[](https://modelcontextprotocol.io)
+[](LICENSE)
+[](https://github.com/DandanLLab/SnowCatQQ/releases)
+[](https://github.com/DandanLLab/SnowCatQQ/stargazers)
-## 快速开始
+*社区开发者维护的第三方 QQ 客户端 —— 让开发者自己的智能体,接入开发者自己的生态*
+
+NapCat 4.18.28 底座 × SnowLuma 独门能力融合,**全功能运行于 QQ 9.9.37-54395(官方最新版)主进程内**,QQ 本体一字节未动。
+
+
+
+---
+
+## ✨ 核心特性
+
+| | 特性 | 说明 |
+|---|---|---|
+| 🔌 | **QQ 9.9.37 全功能在役** | V8 编译器通道注入,官方最新版原生运行,QQ 本体零改动 |
+| 🤖 | **OneBot v11 全动作** | 正向 / 反向 WS、HTTP、HTTP SSE 全接入方式 |
+| 🧩 | **MCP 接入** | Streamable HTTP `/mcp`,全部动作自动暴露为 MCP 工具 |
+| 🎁 | **56 项独门动作** | 采自 SnowLuma:QZone 全家桶、群相册、精华、打卡、装扮、闪照、收藏…… |
+| 📦 | **Packet 发包** | offset 表驱动,逐版本维护 |
+| 🖥️ | **雪猫 WebUI** | React + Tailwind + HeroUI 全面重制 |
+| 🛠️ | **便携环境制作器** | 官方最新包一键解包、一键便携化 |
+| 🛡️ | **稳定线** | 连接退避 + 真人节奏抖动 + 预算 + 熔断 |
+
+## 🚀 快速开始
```powershell
-# 1. 解包官方 QQ 安装包为便携结构(也可手动从官网下载安装包)
-./tools/snowcat-qq-unpack.ps1 -Installer QQ_9.9.37_261103_x64_01.exe
+# 1️⃣ 解包官方 QQ 安装包为便携结构(也可手动从官网下载安装包)
+./release-tools/snowcat-qq-unpack.ps1 -Installer QQ_9.9.37_261103_x64_01.exe
-# 2. 一键启动(部署 V8 通道 + 启动 + 健康检查)
-./tools/build/snowcat-run.ps1
+# 2️⃣ 一键启动(部署 V8 通道 + 启动 + 45s 健康检查)
+./release-tools/build/snowcat-run.ps1
-# 3. WebUI 就绪 → http://127.0.0.1:6099/webui/
+# 3️⃣ WebUI 就绪
+# → http://127.0.0.1:6099/webui/
```
-## 文档
+## 📚 文档
| 文档 | 内容 |
|---|---|
-| [开源公告](docs/ANNOUNCEMENT.md) | 立场声明 · 生态主张 · 给官方的四个问题 |
-| [从 P1 到 V8:完整攻关实录](docs/dev/FROM-P1-TO-V8.md) | 9.9.37 防护体系、全部死路档案、V8 通道原理、内核适配 |
-| [架构审计](docs/dev/ARCHITECTURE-AUDIT.md) | 启动链、解包机制、逐字节审计结论 |
+| 📜 [开源公告](docs-open/ANNOUNCEMENT.md) | 立场声明 · 生态主张 · 给官方的四个问题 |
+| 🔬 [从 P1 到 V8](docs-open/dev/FROM-P1-TO-V8.md) | 9.9.37 防护体系 · 全部死路档案 · V8 通道原理 · 内核适配 |
+| 🏗️ [架构审计](docs-open/dev/ARCHITECTURE-AUDIT.md) | 启动链 · 解包机制 · 逐字节审计结论 |
-## 仓库结构
+## 🗂️ 仓库结构
```
-tools/
- snowcat-qq-unpack.ps1 官方安装包解包器
- snowcat-launch.ps1 零硬改启动器
- snowcat-portable-maker.ps1 便携制作器
- build/
- winmm-v8.c/.dll V8 通道本体(源码+成品)
- snowcat-boot.js 引导脚本
- snowcat-run.ps1 9.9.37 一键启动器
- snowcat-hook.c 研究:观测 hook
- snowcat-inject.c 研究:注入器
- snowcat-reflect.c 研究:反射注入器
- webui-static/ WebUI 前端成品
-docs/
- ANNOUNCEMENT.md 开源公告(终稿)
- dev/FROM-P1-TO-V8.md 攻关制作文档
- dev/ARCHITECTURE-AUDIT.md 架构审计
+SnowCatQQ
+├── 📦 packages/ ⭐ 26 包底层全源码(TS)
+│ ├── snowcat-core/ NT 内核 API + listener + Packet 发包
+│ ├── snowcat-onebot/ OneBot v11 全动作 + MCP 适配器 + 稳定线
+│ ├── snowcat-webui-frontend/ 雪猫控制台(React + HeroUI)
+│ ├── snowcat-webui-backend/ WebUI 服务端
+│ ├── snowcat-shell/ 单文件 bundle 出口(napcat.mjs)
+│ └── snowcat-native/ napi2native / MoeHoo / ffmpeg / pty
+├── 🛠️ release-tools/ 成品工具
+│ ├── snowcat-qq-unpack.ps1 官方安装包解包器
+│ ├── snowcat-launch.ps1 零硬改启动器
+│ ├── snowcat-portable-maker 便携制作器
+│ └── build/
+│ ├── winmm-v8.c/.dll V8 通道本体(源码 + 成品)
+│ ├── snowcat-boot.js 引导脚本
+│ └── snowcat-run.ps1 一键启动器
+└── 📖 docs-open/ 文档(公告 + 制作 + 审计)
```
-## 关于账号安全,说实话
+## ⚙️ 运行时栈
-第三方客户端无法在绝对意义上保证账号安全——这是事实,我们不回避。但不滥用,即是安全;有滥用,责任在使用者,不在工具,更不在社区。运行时全部在本地,代码全量开源,来源全部署名。**黑箱要求人「相信」,白盒只要求人「查看」。我们不索取信任,只提供证据。**
+```
+QQ 9.9.37-54395 x64(官方原版,一字节未动)
+ └─ winmm.dll(V8 通道代理:MinHook 挂 v8::ScriptCompiler)
+ └─ QQ 主进程内:napcat.mjs(3.25MB 单文件 bundle)
+ ├─ OneBot v11 ── 反向 WS / HTTP / MCP (/mcp)
+ ├─ WebUI ──────── React + HeroUI(:6099)
+ └─ Packet ─────── napi2native + MoeHoo(offset 表驱动)
+```
-## 致谢
+## 🔐 关于账号安全,说实话
-感谢 NapCat(126,400+ ⭐)与 SnowLuma(283 ⭐)。猫谢猫,雪接雪。你们留下的星,我们记下了,也不会让它们落空。
+> 第三方客户端无法在绝对意义上保证账号安全——这是事实,我们不回避。
-Ending 不是终点,是 SnowCat 的起点。
+**但不滥用,即是安全;有滥用,责任在使用者,不在工具,更不在社区。**
-**SnowCat 开发组**
+- 运行时全部在本地,无任何第三方外发
+- 代码全量开源,每一行可查
+- 来源全部署名,致敬两个上游
+
+> 黑箱要求人「相信」,白盒只要求人「查看」。
+> **我们不索取信任,只提供证据。**
+
+## 🤝 致谢
+
+
+
+**感谢 [NapCat](https://github.com/NapNeko/NapCatQQ)(126,400+ ⭐)· 感谢 [SnowLuma](https://github.com/SnowLuma/SnowLuma)(283 ⭐)**
+
+猫谢猫,雪接雪。你们留下的星,我们记下了,也不会让它们落空。
+
+*Ending 不是终点,是 SnowCat 的起点。*
+
+**—— SnowCat 开发组 ——**
+
+