newrun

开发准则.md

@@ -562,3 +562,55 @@ def calculate_bonus(consecutive_days):
 - **开发模式**: `npm run dev` (在浏览器预览 UI)
 - **构建**: `npm run build`
 - **CEP 调试**: 在 Photoshop 中加载扩展，访问 `http://localhost:XXXX` 进行 Chrome DevTools 调试 UI。
+
+---
+
+## 6. 项目架构与工作流 (2025重构版)
+
+经过 2025 年底的深度重构，项目采用了高效的 **"壳(Shell) + 核(Core)"** 架构：
+
+### 6.1 核心模块分工
+
+| 模块 | 目录 | 类型 | 职责 |
+| :--- | :--- | :--- | :--- |
+| **Designer** | `d:\main\DesignerCEP\Designer` | **核心业务 (Core)** | 包含所有设计工具、UI 界面和业务逻辑。开发时的主要工作区。 |
+| **AdminPanel** | `d:\main\DesignerCEP\AdminPanel` | **加载壳 (Shell)** | 一个轻量级的 CEP 容器，负责在 PS 中运行。它不包含业务代码，只负责通过 `iframe` 加载 Designer。 |
+| **Server** | `d:\main\DesignerCEP\Server` | **后端 (API)** | 基于 FastAPI 的纯数据接口服务。不负责托管静态页面（由 Caddy/Nginx 接管）。 |
+| **AdminTool** | `d:\main\DesignerCEP\AdminTool` | **运维工具** | 负责自动化部署、版本管理和配置修改的 Python GUI 工具。 |
+
+### 6.2 开发流程 (Dev Workflow)
+
+1.  **启动后端** (可选，如需 API):
+    ```bash
+    cd Server
+    uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
+    ```
+
+2.  **启动前端核心**:
+    ```bash
+    cd Designer
+    npm run dev
+    # 运行在 http://localhost:5173
+    ```
+
+3.  **在 PS 中调试**:
+    - 打开 Photoshop。
+    - 启动 **AdminPanel** 扩展。
+    - **智能连接**: AdminPanel 会自动检测环境。开发模式下，它会自动加载 `http://localhost:5173`，实现**热更新**。
+
+### 6.3 生产发布 (Production)
+
+1.  **构建核心**:
+    ```bash
+    cd Designer
+    npm run build
+    # 产物输出到 dist_core
+    ```
+
+2.  **部署**:
+    - 使用 **AdminTool** 将 `dist_core` 上传到服务器。
+    - 生产环境的 AdminPanel 会自动加载服务器地址 (`https://app.aidg168.uk`)。
+
+### 6.4 目录清理说明
+- **冗余移除**: 所有旧的测试脚本、文档草稿、`dist` 目录、`buildLauncher` 脚本等均已移至 `temp_backup`。
+- **配置收敛**: Designer 仅保留 `cep.config.ts`，移除了重复的 dev/prod 配置。