优化前端控制台样式并更新文档

README.md

@@ -3,8 +3,8 @@
 Common Agent 是一个规划中的通用 Agent 平台，技术路线基于 Java、Spring Boot 和 Spring AI。
 项目目标是建设一套完整的前后端系统，支持 Agent 编排、工具调用、会话管理、RAG 知识库和平台管理能力。
 
-当前项目处于基础工程阶段。后端骨架、PostgreSQL 配置、MyBatis-Plus、Lombok 和多环境配置文件已经完成；
-Agent 运行时、RAG 索引、前端页面和管理功能会在后续阶段逐步实现。
+当前项目处于基础工程阶段。后端骨架、PostgreSQL 配置、MyBatis-Plus、Lombok、多环境配置文件和前端控制台基础页面已经完成；
+Agent 运行时、RAG 索引和更多管理功能会在后续阶段逐步实现。
 
 ## 项目愿景
 
@@ -31,6 +31,11 @@ Common Agent 希望成为一个可复用的企业级 AI 应用基础平台：
 
 ```text
 common_agent
+├── frontend
+│   ├── src/layouts
+│   ├── src/pages
+│   ├── src/router
+│   └── src/styles
 ├── src/main/java/com/bruce
 │   └── CommonAgentApplication.java
 ├── src/main/resources
@@ -99,10 +104,30 @@ npm run dev
 
 ```powershell
 cd frontend
+npm run test:unit
 npm run type-check
 npm run build
 ```
 
+## 前端控制台
+
+前端控制台位于 `frontend` 目录，当前使用 Vue 3、Vite、Pinia、Vue Router 和 Element Plus。
+
+当前已有页面：
+
+- 工作台
+- 系统枚举
+- 附件管理
+- 知识库
+- 知识文档
+
+当前 UI 规范：
+
+- 左侧为固定管理导航，右侧为主内容区。
+- 主内容区不再额外渲染外层页面标题，标题由各业务页面面板自行展示。
+- 全局样式集中在 `frontend/src/styles/global.css`，页面专属样式优先放在对应 `.vue` 文件的 scoped style 中。
+- 后台页面以清晰、克制、便于扫描为优先目标，避免营销式大面积装饰。
+
 ## 规划模块
 
 - `agent-core`：Agent 执行模型、工具注册、记忆和编排能力。