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.<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>
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 @@
     <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>
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 | 自写 `<button>` 样式 |
+| 输入框 | TextField、InputBase | 自写 `<input>` 样式 |
+| 选择器 | Select、MenuItem | 自写下拉框 |
+| 弹窗 | Dialog、Drawer | 自写遮罩层 |
+| 表单控件 | Checkbox、Switch、Slider | 自写表单控件 |
+| 标签页 | Tabs、Tab | 自写 Tab 切换 |
+| 提示 | Tooltip、Chip、Badge | 自写气泡提示 |
+| 布局 | Box、Stack、Grid | 自写 Flex/Grid 布局 |
+| 排版 | Typography | 自写 `<p>` `<span>` 样式 |
+| 进度 | LinearProgress、CircularProgress | 自写进度条/加载动画 |
+| 卡片 | Card、Paper | 自写卡片容器 |
+| 头像 | Avatar | 自写头像圆形容器 |
+| 列表 | List、ListItemButton | 自写列表项 |
+
+**例外**：仅当 MUI 确认不存在对应组件时，才可使用原生 HTML 元素 + Tailwind CSS 实现，且必须注释说明原因。
 
 #### 4. 允许自写的场景
 
@@ -75,7 +98,6 @@
 | 业务逻辑封装 | 特定于项目的业务规则 |
 | 类型定义 | 项目特有的接口和类型 |
 | 适配器/桥接层 | 连接不同库的中间层 |
-| 简单 UI 组件 | < 50 行，无复杂交互 |
 | 配置常量 | 项目特有的配置值 |
 | Provider Adapter 流式解析 | 需精细控制 SSE/NDJSON 流式响应解析时，允许使用原生 fetch 替代 axios。条件：仅在 `electron/harness/adapters/` 目录内，且需封装为统一的流式处理工具函数 |
 
@@ -136,11 +158,11 @@
 | 功能 | 推荐库 | 备选 |
 |------|--------|------|
 | UI 框架 | React 18/19 | - |
+| 组件库 | **Material UI (MUI)** — 强制使用，所有 UI 组件必须基于 MUI | shadcn/ui（仅概念参考） |
 | 状态管理 | Zustand | Jotai、Valtio |
 | 路由 | React Router | TanStack Router |
 | 表单 | React Hook Form | Formik |
-| 样式 | Tailwind CSS | CSS Modules |
-| 组件库 | shadcn/ui | Radix UI |
+| 样式 | Tailwind CSS（仅辅助，禁止替代 MUI 组件） | CSS Modules |
 | 图标 | Lucide React | React Icons |
 
 ### 数据处理