From d6bc30b54031d3c6c78cbe698367d5f853654fa1 Mon Sep 17 00:00:00 2001 From: thzxx Date: Sat, 27 Jun 2026 22:15:47 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BC=80=E5=8F=91=E8=A7=84=E8=8C=83?= =?UTF-8?q?=E5=92=8C=E8=AE=BE=E8=AE=A1=E6=96=87=E6=A1=A3=E6=98=8E=E7=A1=AE?= =?UTF-8?q?=20MUI=20=E4=B8=BA=E5=BC=BA=E5=88=B6=20UI=20=E7=BB=84=E4=BB=B6?= =?UTF-8?q?=E5=BA=93?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - standard/开发规范.md: 新增 §3.1 UI组件铁律: 所有UI组件必须使用MUI，列表枚举12类禁止自写 移除 §4 中「简单UI组件」自写例外 更新 §附录: MUI明确为强制组件库，Tailwind仅辅助 - docs/UI UX设计集成方案: 组件树前增加MUI强制使用说明 - docs/架构与交互设计: Renderer进程说明补充MUI，Hero技术栈加入MUI --- docs/MetonaAI-Desktop UI UX 设计集成方案.html | 4 +++ docs/MetonaAI-Desktop 架构与交互设计.html | 4 +-- standard/开发规范.md | 28 +++++++++++++++++-- 3 files changed, 31 insertions(+), 5 deletions(-) diff --git a/docs/MetonaAI-Desktop UI UX 设计集成方案.html b/docs/MetonaAI-Desktop UI UX 设计集成方案.html index c643f5a..3c01a5f 100644 --- a/docs/MetonaAI-Desktop UI UX 设计集成方案.html +++ b/docs/MetonaAI-Desktop UI UX 设计集成方案.html @@ -493,6 +493,10 @@ MeToast.warning('操作已取消

🌲 组件树

+
+ 🎨 UI 组件库：所有 UI 交互组件强制使用 Material UI (MUI)（@mui/material）。按钮、输入框、弹窗、选择器、表单控件、标签页、提示、布局、进度条、卡片等均使用 MUI 组件。除非 MUI 确认不存在对应组件，否则禁止自写 UI 组件。Tailwind CSS 仅作为 MUI 的辅助样式补充（间距、颜色变量），不可替代 MUI 组件。 +
+ 
 AppLayout
diff --git a/docs/MetonaAI-Desktop 架构与交互设计.html b/docs/MetonaAI-Desktop 架构与交互设计.html
index 30ad962..1eafd24 100644
--- a/docs/MetonaAI-Desktop 架构与交互设计.html	
+++ b/docs/MetonaAI-Desktop 架构与交互设计.html	
@@ -168,7 +168,7 @@
     
基于「生产级通用 AI Agent 桌面应用构建指南」+「Metona 内部 IR 标准」，定义完整的系统架构、9 个基础工具、4 个用户级磁盘文件、工作空间机制、数据库配置规范及全链路可追踪日志体系。

     

          版本: v1.0.0
-         技术栈: React + Electron + SQLite
+         技术栈: React + Material UI (MUI) + Electron + SQLite
          日期: 2026-06-26
     

     

@@ -229,7 +229,7 @@
         进程运行时职责
         Main ProcessNode.jsAgent 引擎、工具调度、数据库、MCP 管理、配置加载
         Preload Script沙箱 Node通过 contextBridge 安全暴露 API 给渲染进程
-        RendererChromiumReact UI：聊天界面、Agent 监控、设置面板、Trace Viewer
+        RendererChromiumReact + Material UI (MUI) 界面：聊天、Agent 监控、设置面板、Trace Viewer。所有 UI 组件强制使用 MUI，禁止自写。
     
 
     
四层 Harness 架构

diff --git a/standard/开发规范.md b/standard/开发规范.md
index 8d915c3..75896f0 100644
--- a/standard/开发规范.md
+++ b/standard/开发规范.md
@@ -64,6 +64,29 @@
 | WebSocket | ws、socket.io | 需要重连、心跳、二进制支持 |
 | 任务队列 | bull、bee-queue | 需要持久化、重试、优先级 |
 | 配置管理 | dotenv、convict | 需要类型安全、环境变量、默认值 |
+| UI 组件 | Material UI (MUI) @mui/material | 按钮、输入框、弹窗、选择器、表单、表格等所有 UI 组件 |
+
+#### 3.1 UI 组件铁律
+
+**所有前端 UI 组件必须使用 Material UI (MUI)**，禁止自写任何 UI 交互组件。
+
+| 组件类型 | MUI 组件 | 禁止自写 |
+|---------|----------|----------|
+| 按钮 | Button、IconButton | 自写 `