# Minecraft 风格管理工作台

## 设计范围

Web 控制台统一使用原创像素 SVG 图标、低对比石块/木板纹理、物品栏槽位、立体像素按钮和方块式面板。
导航使用草方块、玩家、绿宝石、红石、工作台、箱子、盾牌、书、命令方块、指南针、剑、时钟和地图等图形；
登录页采用方形太阳与分层方块地景。没有下载游戏材质、外部字体或增加运行时网络依赖。

正文保留系统中文字体，标题与指标使用等宽字体和克制的像素阴影。辅助文字、表单与表格保持可读尺寸，
主按钮普通/悬停文字对比分别约 5.21:1 / 4.82:1。焦点使用清晰描边，装饰图标对辅助技术隐藏；
保留减少动画和系统高对比模式支持。

侧栏经验条只是连接状态装饰：在线显示，非在线清空；顶栏状态点同时区分离线/连接中/降级。
它不表示玩家经验、服务器健康评分或任何未经采集的实时指标。

## 编辑体验与内容隔离

- 触发器和内容创作继续使用全宽工作区，专注编辑保留隐藏外侧导航和预设库的原有行为。
- 条件、动作与循环采用区分色；节点选中描边、分支连接线和内容预览保留。
- 节点双击/Enter 弹窗、富文本编辑、复制粘贴、撤销重做和权限检查不变。
- 用户创作的菜单画布保留原始配色 token 与内联尺寸/圆角，富文本正文不附加主题文字阴影，不覆盖用户文本颜色或格式。
- 小屏使用抽屉导航，程序和属性编辑按既有响应式规则排列；节点弹窗独立滚动、底部操作保持可见。

## 实现位置

- `web-ui/src/mc-theme.css`：在基础 `styles.css` 后加载的独立主题层。
- `web-ui/src/assets/mc-stone.svg`、`mc-planks.svg`：原创可重复像素材质。
- `web-ui/src/components/minecraft-icon.tsx`：16 个可复用像素图标。
- `web-ui/src/components/app-shell.tsx`、`pages/login.tsx`：全局外壳与登录页。

## 本地视觉复验

从仓库根目录执行：

```powershell
node tools/minecraft-ui-preview.mjs
```

使用打印出的本地地址，选择“玩家首次进入 · 欢迎与奖励”，检查程序树、专注编辑和双击消息节点弹窗。
侧栏可查看服务器概览、内容创作；退出登录可检查登录页。这个开发入口只使用内存模拟数据，
不连接管理接口、不启用 API 代理、不读取数据库、不启动 Minecraft，也不会进入发布资源。
不要输入真实密码。关闭预览进程后，服务停止；修改在刷新后消失。

2026-09-13 已用真实 React 页面进行浏览器视觉检查：1920×1080 触发器/专注模式/富文本节点弹窗，
1440×1000 概览/内容创作/登录，以及 390×844 手机弹窗、抽屉导航、概览和英文登录。
未发现这些路径的浏览器错误日志；自动测试不能替代所有浏览器和操作系统的实机验收。
Web 全量测试为 20 个文件、213 项通过；生产构建和独立预览 TypeScript 检查通过。
四个 Forge 版本均 `test assemble` 成功，每版 100 项测试无失败或跳过；根目录 `dist` 的四个 JAR
均验证内置 `web/assets/index-DeTd5O_3.js`、`web/assets/index-CtV9sIeP.css` 与生产 Web 构建逐字节一致，
并保留 `ContentBehaviorRouting` 放置行为修复。`SHA256SUMS` 已更新，未安装到运行目录或启动真实服务器。

更新对应 Forge JAR 并重启服务端后，浏览器使用 Ctrl+F5 强制刷新。
此主题只改变管理 Web UI，不改变玩家游戏内的材质包、原版菜单或自定义内容模型。