feat: 更新嵌入式文件系统逻辑，支持路径清理和静态资源请求处理，增强前端主题切换能力

2026-10-01 22:46:38 +08:00 · 2026-03-11 13:18:32 +08:00
parent 6eea676f8f
commit ad090c9c04
26 changed files with 465 additions and 81 deletions
@@ -30,7 +30,7 @@
 * TanStack Query
 * React Hook Form + Zod
 * Zustand（仅限轻量客户端状态）
-* Vitest + Testing Library + Playwright
+* Vitest + Testing Library

 要求：

@@ -39,6 +39,7 @@
 * 默认使用 App Router，不新建 Pages Router 结构
 * 默认使用 Tailwind CSS，不再引入新的大型样式框架
 * 默认使用 NextUI 作为统一视觉组件基础
+* 前端必须支持亮色 / 暗色模式切换，且主题切换能力应作为基础能力贯穿布局、组件与页面实现

 禁止：

@@ -310,6 +311,8 @@ tests/
 * Tailwind CSS 为布局、间距、响应式与业务样式扩展的基础方案
 * 样式通过设计 token、NextUI 主题能力与语义类组合实现
 * 页面视觉风格统一、留白一致、层级清晰
+* 所有新页面与基础组件必须同时兼容亮色与暗色主题，禁止只实现单一主题
+* 主题切换必须可由用户主动触发，并在路由切换和刷新后保持一致

 ### 9.2 设计 token

@@ -318,6 +321,7 @@ tests/
 * 主色、成功色、警告色、危险色
 * 边框色、背景色、弱文本色、强文本色
 * 圆角、阴影、间距、层级
+* 亮色 / 暗色两套语义 token 映射，以及主题切换所需的前景色、表面色、分隔色

 ### 9.3 组件外观要求

@@ -330,6 +334,7 @@ tests/
 * 大量硬编码颜色值
 * 在 JSX 中堆砌不可读的超长类名且不抽组件
 * 同一个状态在不同页面使用不同颜色语义
+* 仅在暗色或仅在亮色模式下校验视觉效果后直接交付

 ---