docs: 开发规范和设计文档明确 MUI 为强制 UI 组件库

- standard/开发规范.md:
  新增 §3.1 UI组件铁律: 所有UI组件必须使用MUI,列表枚举12类禁止自写
  移除 §4 中「简单UI组件」自写例外
  更新 §附录: MUI明确为强制组件库,Tailwind仅辅助
- docs/UI UX设计集成方案: 组件树前增加MUI强制使用说明
- docs/架构与交互设计: Renderer进程说明补充MUI,Hero技术栈加入MUI
This commit is contained in:
thzxx
2026-06-27 22:15:47 +08:00
parent a6397f07db
commit d6bc30b540
3 changed files with 31 additions and 5 deletions
@@ -493,6 +493,10 @@ MeToast.<span class="hl-fn">warning</span>(<span class="hl-str">'操作已取消
<section class="api-section" id="component-tree">
<h2>&#x1F332; 组件树</h2>
<div class="note-box">
<strong>&#x1F3A8; UI 组件库:</strong>所有 UI 交互组件强制使用 <strong>Material UI (MUI)</strong><code>@mui/material</code>)。按钮、输入框、弹窗、选择器、表单控件、标签页、提示、布局、进度条、卡片等均使用 MUI 组件。除非 MUI 确认不存在对应组件,否则<strong>禁止自写 UI 组件</strong>。Tailwind CSS 仅作为 MUI 的辅助样式补充(间距、颜色变量),不可替代 MUI 组件。
</div>
<div class="arch-diagram">
<pre>
<span class="hl-cm">AppLayout</span>
@@ -168,7 +168,7 @@
<p>基于「生产级通用 AI Agent 桌面应用构建指南」+「Metona 内部 IR 标准」,定义完整的系统架构、9 个基础工具、4 个用户级磁盘文件、工作空间机制、数据库配置规范及全链路可追踪日志体系。</p>
<div class="hero-meta">
<span><span class="dot dot-cyan"></span> 版本: <strong>v1.0.0</strong></span>
<span><span class="dot dot-green"></span> 技术栈: <strong>React + Electron + SQLite</strong></span>
<span><span class="dot dot-green"></span> 技术栈: <strong>React + Material UI (MUI) + Electron + SQLite</strong></span>
<span><span class="dot dot-amber"></span> 日期: <strong>2026-06-26</strong></span>
</div>
<div class="note-box" style="margin-top:16px">
@@ -229,7 +229,7 @@
<tr><th>进程</th><th>运行时</th><th>职责</th></tr>
<tr><td class="f-name">Main Process</td><td class="f-type">Node.js</td><td>Agent 引擎、工具调度、数据库、MCP 管理、配置加载</td></tr>
<tr><td class="f-name">Preload Script</td><td class="f-type">沙箱 Node</td><td>通过 contextBridge 安全暴露 API 给渲染进程</td></tr>
<tr><td class="f-name">Renderer</td><td class="f-type">Chromium</td><td>React UI:聊天界面、Agent 监控、设置面板、Trace Viewer</td></tr>
<tr><td class="f-name">Renderer</td><td class="f-type">Chromium</td><td>React + Material UI (MUI) 界面:聊天、Agent 监控、设置面板、Trace Viewer。所有 UI 组件强制使用 MUI,禁止自写。</td></tr>
</table>
<h3>四层 Harness 架构</h3>