docs: README 全篇精简 — 折叠分组 + 去重 + 英文降为次级

[SMNETSTUDIO]

两个 commit,先功能表、后其余各节。

现状

• 功能表 35 行平铺无分组。中文列 4697 字符,英文列 9703 —— 英文是中文的 2 倍,占全表 67% 体量。最长三行:🧮 内存配额 1362(上个 PR 我加的)、🔓 RCON 1107、🗀 文件管理器 1058
• 快速开始 4 个并列 H3(一行安装 / Docker / deploy.sh / 手动),读者要读完四种才知道用哪个
• 架构 里的 src/ 模块清单,和 仓库结构 一节,都在讲文件布局 —— 两处重复,且 ARCHITECTURE.md 有更详细的版本

改动

功能表 → 8 个 <details> 折叠组,标题带关键词概括:

🔐 账号与登录 · 📦 服务端与实例 · 💻 控制台·运行·网络 · 📊 可观测性 · 📁 文件·插件·配置 · 💾 备份 · 👥 多租户与配额 · ⚙ 面板自身

35 行内容逐字保留 —— 每条「它拒绝做什么」是这份 README 最值钱的部分,一句没删。用脚本按行号搬运而非手抄,集合比对验证 34/35 行 byte-identical。唯一改写的是 🧮 内存配额那行(ARCHITECTURE 已有完整的「内存配额的口径」一节,压成判断 + 指路)。

快速开始 → 主推一行安装 + 默认账户 + Java 说明,其余折进「其他安装方式」与「接下来做什么」。

架构 → 删掉 README 那份 src/ 清单(ARCHITECTURE「总览」每模块一行说明 + 依赖方向,更详细);保留顶层数据流图与权限模型图,那两张 ARCHITECTURE 没有。仓库结构并入折叠块,只留 ARCHITECTURE 没覆盖的(scripts/、Dockerfile、ecosystem.config.js、backups/ 增量链内部结构)。

英文统一降为 <sub> 次级样式,中文主、英文辅。

效果

	main	现在
折叠时首屏可见文字	18845 字	3507 字(-81%)
折叠时页面高度	—	2413 px(全展开 7554 px)
源文件	205 行 / 28462 字符	261 行 / 30211 字符

源文件反而变大了 —— <details> 标记本身有开销。减的是阅读负担,不是字节数。若你要的是真的砍内容,说一声,那需要另一种做法(把「为什么这么设计」抽成独立小节只留最精彩的 8-10 条,或中英拆两份文档)。

顺带两处

• 去掉「115 项冒烟回归」。实跑只有 73 项(无实例时跳过实例级用例),我无法确认 115 准不准 —— 与其保留一个验证不了的数字,不如不写。没有改成 73,因为那同样不是全量。
• 清掉 11 处行尾冗余 <br>:GitHub 本就把换行渲染成 <br>,显式再写会多出一个空行。第 14 行标题区那处是 main 上原有的,未动。

验证

全程用 GitHub 自己的 POST /markdown (mode=gfm) 渲染核对,不是靠眼看:

• 11 个 <details> / 8 个 <table> / 功能表数据行 35 / 6 个代码块,全部正确渲染
  (<details> 里的表格依赖 <summary> 后的空行,漏了会退化成纯文本 —— 必须实测)
• 对 main 原版做反引号标识符全集比对,确认删掉的内容都在 ARCHITECTURE.md 里有对应且更详细的表述;bin/java/ 一项确实只此一份,已补回运行时目录块
• 组标题 emoji 换成 Emoji 1.0 通用码位 —— 原先行内的 🗀(U+1F5C0)、⧉(U+29C9) 字体覆盖差,当行内小图标无所谓,提成组标题就露馅

🤖 Generated with Claude Code