feat: 迁移前端构建从 Bun fullstack 到 Vite

前端性能问题根因在于 Bun bundler 无法有效 code split、CSS
tree-shake 和产出优化的前端资源。经多轮 Bun 原生优化尝试
均无明显效果后，决定将前端构建迁回 Vite。

主要变更：

- 前端构建：从 Bun HTML import bundling 切换为 Vite build
  （Rolldown code splitting、vendor chunk、CSS 优化）
- 开发模式：从 Bun fullstack 单进程 HMR 切换为 Vite dev
  server + Bun API server 双进程（:5173 + :3000）
- 生产构建：三步流水线（Vite build → code generation →
  Bun compile），通过 `import with { type: "file" }` 嵌入前端资源
- 静态资源服务：从 Bun HTML import manifest 切换为自定义
  serveStaticAsset 函数，支持 SPA fallback 和正确的 Cache-Control
- Server 接口：BootstrapOptions 和 StartServerOptions 增加
  staticAssets? 可选参数
- 文档更新：DEVELOPMENT.md 和 README.md 反映新的开发模式，
  主 specs 同步 delta 变更

新增能力：
- static-asset-embedding: 构建时资源扫描与 code generation、
  运行时静态资源服务
- vite-frontend-bundling: Vite 构建配置、code splitting 策略、
  CSS 处理

openspec/specs/bun-fullstack-routing/spec.md

@@ -5,16 +5,16 @@
 ## Requirements
 
 ### Requirement: 声明式路由注册
-系统 SHALL 使用 Bun.serve 的 `routes` 对象以声明式方式注册所有 HTTP 路由，包括 HTML 页面路由和 API 端点路由。
-
-#### Scenario: HTML 页面路由注册
-- **WHEN** server 启动时
-- **THEN** 系统 SHALL 通过 HTML import 将前端入口注册到 `routes` 对象的 `"/*"` 通配符路径
+系统 SHALL 使用 Bun.serve 的 `routes` 对象以声明式方式注册 API 端点路由，非 API 请求由 `fetch` fallback 处理。
 
 #### Scenario: API 端点路由注册
 - **WHEN** server 启动时
 - **THEN** 系统 SHALL 将所有 API 端点以 method handler 对象形式注册到 `routes` 对象
 
+#### Scenario: 非 API 请求处理
+- **WHEN** 请求路径不匹配任何 `routes` 中注册的路由
+- **THEN** `fetch` fallback SHALL 将请求交给静态资源服务处理（production）或返回提示文本（development）
+
 ### Requirement: 路径参数支持
 系统 SHALL 使用 routes 对象的 `:param` 语法声明路径参数，替代手动 regex 匹配。
 
@@ -38,12 +38,12 @@
 - **THEN** `/api/*` 通配符 SHALL 返回 JSON 格式的 404 错误响应
 
 ### Requirement: Fetch Fallback 处理
-系统 SHALL 使用 `fetch` handler 作为兜底，理论上不应被触发（所有路径都被 routes 通配符覆盖）。
+系统 SHALL 使用 `fetch` handler 作为非 API 请求的入口，负责静态资源服务和 SPA fallback。
 
-#### Scenario: 未匹配的 API 路由
-- **WHEN** 请求路径以 `/api/` 开头但未在具体 API 路由中注册
-- **THEN** `/api/*` 通配符 SHALL 返回 JSON 格式的 404 错误响应
+#### Scenario: Production 模式 fetch fallback
+- **WHEN** production 模式下请求未匹配 routes 中的 API 路由
+- **THEN** `fetch` handler SHALL 调用 `serveStaticAsset` 返回对应静态资源或 SPA fallback
 
-#### Scenario: 未匹配的非 API 路由
-- **WHEN** 请求路径不以 `/api/` 开头且未在具体路由中注册
-- **THEN** `"/*": homepage` 通配符 SHALL 返回前端入口 HTML 文档（带 HMR 注入）
+#### Scenario: Development 模式 fetch fallback
+- **WHEN** development 模式下请求未匹配 routes 中的 API 路由
+- **THEN** `fetch` handler SHALL 返回提示文本，引导开发者通过 Vite dev server 访问前端

openspec/specs/frontend-development-workflow/spec.md

@@ -1,41 +1,45 @@
 ## Purpose
 
-定义 Bun.serve fullstack + React + TypeScript 前端开发工作流、开发期 API 访问和共享契约的行为要求。
+定义基于 Vite dev server + Bun API server 的前端开发工作流、开发期 API 访问和共享契约的行为要求。
 
 ## Requirements
 
 ### Requirement: Vite React 开发服务器
-系统 SHALL 提供基于 Bun.serve fullstack 模式的前端开发工作流，并支持热模块替换和 React Fast Refresh。
+系统 SHALL 提供基于 Vite dev server 的前端开发工作流，支持热模块替换和 React Fast Refresh。
 
 #### Scenario: 启动前端开发服务器
 - **WHEN** 开发者启动开发命令
-- **THEN** 前端 SHALL 由 Bun.serve 的 HTML import 机制提供服务，并通过 `development: { hmr: true, console: true }` 启用 HMR、React Fast Refresh 和浏览器 console 回显
+- **THEN** 前端 SHALL 由 Vite dev server 提供服务，支持 HMR 和 React Fast Refresh，监听 :5173 端口
 
 #### Scenario: 构建前端静态资源
 - **WHEN** 开发者运行前端生产构建命令
-- **THEN** 系统 SHALL 通过 Bun.build 的 HTML import ahead-of-time bundling 产出可由 Bun 后端服务的前端静态资源
+- **THEN** 系统 SHALL 通过 Vite build（Rolldown）产出优化的前端静态资源到 `dist/web/`
 
 ### Requirement: 前端开发期 API 代理
-前端开发服务器 SHALL 在本地开发期间无需代理配置即可访问后端 API，因为前后端运行在同一进程同一端口。
+前端开发服务器 SHALL 通过 Vite proxy 配置将 API 请求转发到后端 server。
 
 #### Scenario: 前端开发期调用拨测 API
-- **WHEN** 浏览器从开发服务器请求 `/api/summary`、`/api/targets` 等拨测 API
-- **THEN** Bun.serve SHALL 直接由 routes 中注册的 API handler 处理请求，无需 proxy 转发
+- **WHEN** 浏览器从 Vite dev server 请求 `/api/*` 路径
+- **THEN** Vite SHALL 通过 proxy 将请求转发到 Bun API server（默认 :3000）
+
+#### Scenario: 前端开发期访问健康检查
+- **WHEN** 浏览器从 Vite dev server 请求 `/health`
+- **THEN** Vite SHALL 通过 proxy 将请求转发到 Bun API server
 
 #### Scenario: 开发期访问非 API 前端路由
-- **WHEN** 浏览器从开发服务器请求非 API 前端路由
-- **THEN** Bun.serve SHALL 将该请求作为前端应用流量处理（SPA fallback 返回 HTML）
+- **WHEN** 浏览器从 Vite dev server 请求非 API 前端路由
+- **THEN** Vite SHALL 将该请求作为前端应用流量处理（SPA fallback 返回 HTML）
 
-### Requirement: 开发期单端口运行
-项目 SHALL 保证开发命令中前端页面、HMR 和后端 API 由同一个 Bun.serve 进程在同一端口提供服务。
+### Requirement: 开发期双进程运行
+项目 SHALL 在开发命令中同时启动 Vite dev server 和 Bun API server 两个进程。
 
 #### Scenario: 使用默认开发端口
-- **WHEN** 开发者未提供端口覆盖并运行开发命令
-- **THEN** Bun.serve SHALL 在默认端口同时提供前端页面、HMR 和后端 API
+- **WHEN** 开发者运行开发命令
+- **THEN** Vite dev server SHALL 监听 :5173，Bun API server SHALL 监听配置文件指定的端口（默认 :3000）
 
-#### Scenario: 使用配置覆盖开发端口
-- **WHEN** 开发者通过配置文件覆盖端口并运行开发命令
-- **THEN** Bun.serve SHALL 在配置端口同时提供前端页面、HMR 和后端 API
+#### Scenario: 开发者访问前端
+- **WHEN** 开发者打开浏览器
+- **THEN** 开发者 SHALL 访问 Vite dev server 地址（:5173）获取前端页面
 
 ### Requirement: 前端使用相对 API 路径
 除非有文档化的部署配置覆盖该行为，前端代码 MUST 通过相对 `/api/*` URL 调用后端 API。
@@ -46,21 +50,14 @@
 
 #### Scenario: 运行环境变化
 - **WHEN** host 或 port 在开发环境和生产环境之间变化
-- **THEN** 前端 API 调用 SHALL 无需修改源码即可继续工作
+- **THEN** 前端 API 调用 SHALL 无需修改源码即可继续工作（开发期通过 Vite proxy，生产期通过同源请求）
 
 ### Requirement: 集成开发命令
-项目 SHALL 提供一个文档化命令，用于在开发期间同时运行前端和后端。
+项目 SHALL 提供一个文档化命令，用于在开发期间同时运行 Vite dev server 和 Bun API server。
 
 #### Scenario: 启动全栈开发
 - **WHEN** 开发者运行文档化的全栈开发命令
-- **THEN** 系统 SHALL 启动单个 Bun.serve 进程，同时提供前端 HMR 和后端 API 服务
-
-### Requirement: 开发质量命令文档化
-项目 SHALL 在前端开发工作流文档中说明日常检查和完整验证命令。
-
-#### Scenario: 查阅开发命令
-- **WHEN** 开发者阅读 README 的开发或测试章节
-- **THEN** 文档 SHALL 说明 `check` 用于日常开发检查，`verify` 用于提交前或发布前完整验证
+- **THEN** 系统 SHALL 同时启动 Vite dev server 和 Bun API server，任一进程异常退出时终止另一个
 
 ### Requirement: 共享 TypeScript 契约
 项目 SHALL 为前端和后端共同使用的请求与响应类型提供共享 TypeScript 边界。

openspec/specs/fullstack-app-runtime/spec.md

@@ -1,6 +1,6 @@
 ## Purpose
 
-定义 Bun 全栈应用运行时的 HTTP server、API 命名空间、健康检查、生产静态资源服务和 SPA fallback 行为。
+定义基于 Vite + Bun 的全栈应用运行时，包括 HTTP server、API 命名空间、健康检查、生产静态资源服务和 SPA fallback 行为。
 
 ## Requirements
 
@@ -64,26 +64,26 @@
 - **THEN** Bun server SHALL 返回成功的、机器可读的健康检查响应
 
 ### Requirement: 生产静态资源服务
-系统 SHALL 在生产模式下通过 Bun 内置的 HTML import manifest 机制服务前端资源。
+系统 SHALL 在生产模式下通过自定义 `serveStaticAsset` 函数服务嵌入的 Vite 前端产出。
 
 #### Scenario: 请求构建后的资源
-- **WHEN** 客户端请求构建后的前端资源
-- **THEN** Bun server SHALL 通过 manifest 自动返回该资源并带有适当的 content type 和 content-addressable hash URL
+- **WHEN** 客户端请求 `/assets/*` 路径下的前端资源
+- **THEN** 系统 SHALL 从 StaticAssets 的 files map 中查找并返回对应资源，Content-Type 根据扩展名推断
 
 #### Scenario: 请求前端根路径
 - **WHEN** 客户端请求 `/`
-- **THEN** Bun server SHALL 通过 routes 中注册的 HTML import 返回前端入口 HTML 文档
+- **THEN** 系统 SHALL 返回 StaticAssets 中的 indexHtml，Content-Type 为 `text/html; charset=utf-8`
 
 ### Requirement: 生产缓存策略
-系统 SHALL 利用 Bun 内置的缓存机制为生产静态资源提供缓存策略。
+系统 SHALL 为生产静态资源提供基于文件名 content hash 的缓存策略。
 
 #### Scenario: 请求前端入口 HTML
-- **WHEN** 生产 Bun server 返回前端入口 HTML 文档
-- **THEN** 响应 SHALL 包含 Bun 自动生成的 ETag header
+- **WHEN** 生产 server 返回前端入口 HTML 文档
+- **THEN** 响应 SHALL 包含 `Cache-Control: no-cache` header
 
 #### Scenario: 请求构建后的静态资源
-- **WHEN** 生产 Bun server 返回构建后的静态资源
-- **THEN** 响应 SHALL 包含 Bun 自动生成的 ETag header 和 content-addressable hash URL
+- **WHEN** 生产 server 返回 `/assets/*` 路径下的静态资源
+- **THEN** 响应 SHALL 包含 `Cache-Control: public, max-age=31536000, immutable` header
 
 ### Requirement: 低风险安全响应头
 系统 SHALL 在生产运行时的 JSON API 响应中附加低风险安全响应头；HTML 和静态资源响应由 Bun HTML import manifest 返回其内置 headers。
@@ -92,20 +92,20 @@
 - **WHEN** 生产 Bun server 返回 `/health` 或 `/api/*` JSON 响应
 - **THEN** 响应 SHALL 包含 `X-Content-Type-Options: nosniff` 和 `Referrer-Policy` headers
 
-#### Scenario: 生产 HTML 和静态资源响应使用 Bun 内置 headers
-- **WHEN** 生产 Bun server 返回前端 HTML 文档或构建后的静态资源
-- **THEN** 响应 SHALL 使用 Bun HTML import manifest 提供的内置 headers，不要求附加自定义安全 headers
+#### Scenario: 生产静态资源响应
+- **WHEN** 生产 server 返回前端 HTML 文档或构建后的静态资源
+- **THEN** 响应 SHALL 不要求附加自定义安全 headers（仅需 Content-Type 和 Cache-Control）
 
 ### Requirement: SPA fallback 行为
-系统 SHALL 通过 routes 中注册的 `"/*"` HTML import 通配符为非 API 路径返回前端入口 HTML 文档。
+系统 SHALL 通过 fetch fallback 为非 API、非静态资源路径返回前端入口 HTML 文档。
 
 #### Scenario: 刷新前端路由
-- **WHEN** 客户端请求前端路由，例如 `/dashboard`
-- **THEN** routes 中的 `"/*"` 通配符 SHALL 返回前端入口 HTML 文档
+- **WHEN** 客户端请求不包含文件扩展名的非 API 路径（如 `/dashboard`）
+- **THEN** fetch fallback SHALL 返回前端入口 HTML 文档
 
 #### Scenario: 保留 API 错误语义
 - **WHEN** 客户端请求未知的 `/api/*` 路由
-- **THEN** `/api/*` 通配符 MUST 返回 JSON 404 响应，而不是前端入口 HTML 文档
+- **THEN** routes 中的 `/api/*` 通配符 MUST 返回 JSON 404 响应，而不是前端入口 HTML 文档
 
 ### Requirement: 优雅关机
 系统 SHALL 在收到终止信号时正确清理资源。

openspec/specs/server-bootstrap/spec.md

@@ -5,15 +5,15 @@ TBD - 统一服务启动引导函数，封装开发和生产模式的完整启
 ## Requirements
 
 ### Requirement: 统一启动引导函数
-系统 SHALL 提供 `src/server/bootstrap.ts` 导出 `bootstrap(options: BootstrapOptions)` 函数，封装完整的服务启动序列：加载配置、创建 store、同步 targets、创建并启动 engine、启动 HTTP server、注册 shutdown handler。`bootstrap` SHALL 不接收或传递静态资源对象，前端资源由 Bun HTML import manifest 自动接管。
+系统 SHALL 提供 `src/server/bootstrap.ts` 导出 `bootstrap(options: BootstrapOptions)` 函数，封装完整的服务启动序列：加载配置、创建 store、同步 targets、创建并启动 engine、启动 HTTP server、注册 shutdown handler。
 
 #### Scenario: 开发模式启动
 - **WHEN** `dev.ts` 调用 `bootstrap({ configPath, mode: "development" })`
 - **THEN** 系统 SHALL 完成完整启动序列，不传入 staticAssets
 
-#### Scenario: 生产模式启动
-- **WHEN** `main.ts` 调用 `bootstrap({ configPath, mode: "production" })`
-- **THEN** 系统 SHALL 完成完整启动序列，并由 `server.ts` 中的 HTML import 路由接管前端资源
+#### Scenario: 生产模式启动（带静态资源）
+- **WHEN** code-generated entry 调用 `bootstrap({ configPath, mode: "production", staticAssets })`
+- **THEN** 系统 SHALL 完成完整启动序列，并将 staticAssets 传递给 startServer
 
 #### Scenario: 启动失败处理
 - **WHEN** 启动过程中任何步骤抛出异常
@@ -24,11 +24,15 @@ TBD - 统一服务启动引导函数，封装开发和生产模式的完整启
 - **THEN** bootstrap 注册的 shutdown handler SHALL 调用 engine.stop() 和 store.close() 后退出
 
 ### Requirement: BootstrapOptions 接口
-`bootstrap` 函数 SHALL 接受 `BootstrapOptions` 参数，仅包含 `configPath: string` 和 `mode: RuntimeMode`。
+`bootstrap` 函数 SHALL 接受 `BootstrapOptions` 参数，包含 `configPath: string`、`mode: RuntimeMode` 和可选的 `staticAssets?: StaticAssets`。
 
-#### Scenario: 最小配置
+#### Scenario: 最小配置（开发模式）
 - **WHEN** 仅传入 configPath 和 mode
-- **THEN** 系统 SHALL 正常启动
+- **THEN** 系统 SHALL 正常启动，startServer 不接收 staticAssets 参数
+
+#### Scenario: 生产模式配置
+- **WHEN** 传入 configPath、mode 和 staticAssets
+- **THEN** 系统 SHALL 将 staticAssets 传递给 startServer
 
 ### Requirement: dev.ts 和生产入口使用 bootstrap
 `dev.ts` 和 `src/server/main.ts` SHALL 调用 `bootstrap()` 而非各自维护启动序列。

openspec/specs/single-executable-packaging/spec.md

@@ -1,22 +1,26 @@
 ## Purpose
 
-定义将 Bun HTML import 前端资源与 Bun 后端打包为单个 standalone executable 的生产构建、运行配置和验证要求。
+定义将 Vite 构建的前端资源通过 code generation 嵌入 Bun 后端，打包为单个 standalone executable 的生产构建、运行配置和验证要求。
 
 ## Requirements
 
 ### Requirement: 生产构建顺序
-生产构建 MUST 通过 Bun.build 的 HTML import 识别机制一步完成前端资源打包和后端编译。
+生产构建 MUST 通过三步流水线完成：Vite 前端构建 → code generation → Bun compile。
 
 #### Scenario: 运行生产构建
 - **WHEN** 开发者运行生产构建命令
-- **THEN** 系统 MUST 调用 Bun.build，自动识别 server 入口中的 HTML import 并完成前端 bundling 和后端编译
+- **THEN** 系统 MUST 依次执行 Vite build、资源导入 code generation、Bun.build compile，最终输出单可执行文件
 
-#### Scenario: 前端 bundling 失败
-- **WHEN** Bun.build 在处理 HTML import 中的前端资源时失败
-- **THEN** 系统 MUST 停止生产构建，且不能输出 stale executable
+#### Scenario: Vite 构建失败
+- **WHEN** Vite build 步骤失败
+- **THEN** 系统 MUST 停止后续步骤，不生成 code generation 文件或 executable
+
+#### Scenario: Bun compile 失败
+- **WHEN** Bun.build compile 步骤失败
+- **THEN** 系统 MUST 清理 `.build/` 临时目录，不保留 stale executable
 
 ### Requirement: 单 executable 输出
-生产构建 SHALL 输出一个 standalone executable，其中包含 Bun 后端和通过 HTML import manifest 嵌入的前端资源。构建流程 SHALL 不再生成项目自定义中间产物目录，构建失败时 SHALL 不保留 stale executable。
+生产构建 SHALL 输出一个 standalone executable，其中包含 Bun 后端和通过 `import with { type: "file" }` 嵌入的 Vite 前端产出。
 
 #### Scenario: 在目标机器运行 executable
 - **WHEN** 生成的 executable 在兼容目标平台上运行
@@ -24,19 +28,22 @@
 
 #### Scenario: 服务嵌入的前端
 - **WHEN** executable 收到前端根路径请求
-- **THEN** 它 SHALL 通过 Bun 内置的 HTML import manifest 机制服务前端资源，且不需要外部 `dist/` 目录
+- **THEN** 它 SHALL 通过内嵌的 Vite 构建产出服务前端资源，且不需要外部 `dist/` 目录
 
 #### Scenario: 服务嵌入 API 和页面
 - **WHEN** 生成的 executable 启动，且浏览器打开前端根路径
 - **THEN** 页面 SHALL 展示同一个 executable 进程中 `/api/summary` 和 `/api/targets` 返回的数据
 
-#### Scenario: 构建成功不生成自定义中间产物
-- **WHEN** 生产构建成功完成并输出 executable
-- **THEN** 系统 SHALL 不生成 `.build/` 静态资源清单或 server entry 中间产物
+### Requirement: 构建中间产物管理
+构建流程 SHALL 使用 `.build/` 临时目录存放 code generation 产物，构建完成后清理。
 
-#### Scenario: 构建失败时不保留 stale executable
-- **WHEN** 生产构建在任意步骤失败
-- **THEN** 系统 SHALL 不输出上一次构建遗留的 stale executable
+#### Scenario: 构建成功后清理中间产物
+- **WHEN** 生产构建成功完成并输出 executable
+- **THEN** 系统 SHALL 删除 `.build/` 临时目录
+
+#### Scenario: 构建失败时清理中间产物
+- **WHEN** 生产构建在 Bun compile 步骤失败
+- **THEN** 系统 SHALL 删除 `.build/` 临时目录和 stale executable
 
 ### Requirement: 外部运行时配置
 executable MUST 将环境相关运行时配置保留在嵌入的前端和 server bundle 之外。

openspec/specs/static-asset-embedding/spec.md

@@ -0,0 +1,58 @@
+# Static Asset Embedding
+
+定义构建时将 Vite 产出的前端静态资源嵌入 Bun 可执行文件的 code generation 流程和运行时静态资源服务逻辑。
+
+## Purpose
+
+支持将 Vite 构建的前端资源通过 `import with { type: "file" }` 嵌入 Bun 可执行文件，实现单文件交付的同时保持正确的缓存策略和 Content-Type 处理。
+
+## Requirements
+
+### Requirement: 构建时资源扫描与 Code Generation
+构建脚本 SHALL 在 Vite build 完成后扫描 `dist/web/` 目录，自动生成 TypeScript 文件，为每个静态资源创建 `import ... with { type: "file" }` 声明。
+
+#### Scenario: 生成资源导入文件
+- **WHEN** 构建脚本扫描 `dist/web/` 目录
+- **THEN** 系统 SHALL 在 `.build/static-assets.ts` 中为每个文件生成 `import fN from "<path>" with { type: "file" }` 语句，并导出 `StaticAssets` 对象
+
+#### Scenario: StaticAssets 对象结构
+- **WHEN** `static-assets.ts` 被生成
+- **THEN** 导出的对象 SHALL 包含 `indexHtml: Blob` 和 `files: Record<string, Blob>` 两个字段，其中 files 的 key 为 URL 路径（如 `/assets/index-a1b2c3.js`）
+
+#### Scenario: 生成 production server entry
+- **WHEN** 构建脚本生成资源导入文件后
+- **THEN** 系统 SHALL 在 `.build/server-entry.ts` 中生成 production 入口，import bootstrap、config 和 staticAssets 并调用 bootstrap
+
+### Requirement: 运行时静态资源服务
+系统 SHALL 提供 `serveStaticAsset` 函数，根据请求路径从 StaticAssets 中查找并返回对应资源。
+
+#### Scenario: 请求根路径
+- **WHEN** 请求路径为 `/`
+- **THEN** 系统 SHALL 返回 `indexHtml`，Content-Type 为 `text/html; charset=utf-8`，Cache-Control 为 `no-cache`
+
+#### Scenario: 请求已知静态资源
+- **WHEN** 请求路径匹配 `files` 中的某个 key
+- **THEN** 系统 SHALL 返回对应 Blob，Content-Type 根据文件扩展名推断，Cache-Control 为 `public, max-age=31536000, immutable`
+
+#### Scenario: 请求未知带扩展名路径
+- **WHEN** 请求路径包含文件扩展名但未匹配任何已知资源
+- **THEN** 系统 SHALL 返回 404 响应
+
+#### Scenario: SPA Fallback
+- **WHEN** 请求路径不包含文件扩展名且不以 `/api/` 开头
+- **THEN** 系统 SHALL 返回 `indexHtml`（SPA fallback）
+
+### Requirement: Content-Type 推断
+系统 SHALL 根据文件扩展名推断正确的 Content-Type header。
+
+#### Scenario: JavaScript 文件
+- **WHEN** 请求路径以 `.js` 或 `.mjs` 结尾
+- **THEN** Content-Type SHALL 为 `text/javascript; charset=utf-8`
+
+#### Scenario: CSS 文件
+- **WHEN** 请求路径以 `.css` 结尾
+- **THEN** Content-Type SHALL 为 `text/css; charset=utf-8`
+
+#### Scenario: SVG 文件
+- **WHEN** 请求路径以 `.svg` 结尾
+- **THEN** Content-Type SHALL 为 `image/svg+xml`

openspec/specs/vite-frontend-bundling/spec.md

@@ -0,0 +1,46 @@
+# Vite Frontend Bundling
+
+定义 Vite 作为前端构建工具的配置、产出结构和优化策略。
+
+## Purpose
+
+使用 Vite 的 Rolldown 引擎完成前端打包，实现 code splitting、vendor chunk 分离和 CSS 优化，解决 Bun bundler 前端性能问题。
+
+## Requirements
+
+### Requirement: Vite 前端构建配置
+系统 SHALL 使用 Vite 作为前端构建工具，配置文件位于项目根目录 `vite.config.ts`，以 `src/web` 为 root，产出到 `dist/web/`。
+
+#### Scenario: 运行 Vite 生产构建
+- **WHEN** 构建脚本执行 `bunx --bun vite build`
+- **THEN** Vite SHALL 将 `src/web/index.html` 及其引用的所有模块构建到 `dist/web/` 目录，包含 `index.html` 和 `assets/` 子目录
+
+#### Scenario: 产出文件名包含 content hash
+- **WHEN** Vite 构建完成
+- **THEN** `assets/` 目录下的 JS 和 CSS 文件名 SHALL 包含 content hash（如 `index-a1b2c3.js`）
+
+### Requirement: Code Splitting 策略
+系统 SHALL 配置 Vite 的 Rolldown code splitting，将 vendor 库分离为独立 chunks。
+
+#### Scenario: React 相关库分离
+- **WHEN** Vite 构建完成
+- **THEN** `react`、`react-dom`、`scheduler` SHALL 被打包到名为 `vendor-react` 的独立 chunk
+
+#### Scenario: TDesign 相关库分离
+- **WHEN** Vite 构建完成
+- **THEN** `tdesign-react`、`tdesign-icons-react` 相关模块 SHALL 被打包到名为 `vendor-tdesign` 的独立 chunk
+
+#### Scenario: 图表库分离
+- **WHEN** Vite 构建完成
+- **THEN** `recharts` 和 `d3-*` 相关模块 SHALL 被打包到名为 `vendor-chart` 的独立 chunk
+
+### Requirement: CSS 处理
+系统 SHALL 通过 Vite 处理 CSS 导入，产出独立的 CSS 文件。
+
+#### Scenario: CSS 文件产出
+- **WHEN** Vite 构建完成
+- **THEN** 所有 CSS 导入 SHALL 被提取为独立的 `.css` 文件到 `assets/` 目录
+
+#### Scenario: CSS 压缩
+- **WHEN** Vite 执行生产构建
+- **THEN** 产出的 CSS 文件 SHALL 经过压缩处理