zuowei/DP
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
8ea58fe48054fd5446580e3098671974d99fa7b2
DP/tempdocs/常用命令.md

8.3 KiB
Raw Blame History

DesignerCEP 常用命令

🏗️ 三层架构说明

┌────────────────────────────────────────┐
│  第 1 层：Shell（登录层）               │
│  - 本地：file:// 协议（CEP 扩展）       │
│  - 服务器：http://127.0.0.1:8000/shell/ │
│  - 作用：登录、下载、启动               │
└────────────────────────────────────────┘
         ↓
┌────────────────────────────────────────┐
│  第 2 层：Core（业务层）                │
│  - http://127.0.0.1:8000/core/vX.X.X/  │
│  - 作用：所有业务功能                   │
└────────────────────────────────────────┘
         ↓
┌────────────────────────────────────────┐
│  第 3 层：Server（后端服务器）          │
│  - http://127.0.0.1:8000/api/v1/       │
│  - 作用：API、核心算法、数据库          │
└────────────────────────────────────────┘

📦 构建命令

开发模式

cd D:\main\DesignerCEP\Designer
npm run dev          # 启动开发服务器（Core）

构建 Core（业务层）

cd D:\main\DesignerCEP\Designer
npm run build:core   # 构建 Core 应用

构建 Shell（登录层）

cd D:\main\DesignerCEP\Designer
npm run build:shell  # 构建 Shell（登录、更新、加载 Core）

# 构建后部署到服务器
cd ..
Copy-Item -Path "Designer\dist" -Destination "Server\Designer\dist" -Recurse -Force

🚀 发布命令

自动发布 Core（推荐）

cd D:\main\DesignerCEP
python auto_deploy_core.py --version v1.1.2                    # 只构建打包
python auto_deploy_core.py --version v1.1.2 --update-db        # 构建打包 + 更新数据库
python auto_deploy_core.py --version v1.1.2 --update-db --skip-clean  # 不清除缓存

手动发布步骤

# 1. 构建
cd D:\main\DesignerCEP\Designer
npm run build:core

# 2. 重命名入口文件
cd dist_core
ren index-core.html index.html

# 3. 打包 ZIP
# 把 dist_core 目录打包成 core-v1.1.2.zip

# 4. 上传到 Server/archives/

🗄️ 服务器命令

启动后端服务

cd D:\main\DesignerCEP\Server
python main.py                              # 启动 FastAPI 服务器
python -m uvicorn app.main:app --reload    # 或使用 uvicorn（推荐）

更新数据库版本

cd D:\main\DesignerCEP\Server
python update_version.py

部署 Shell 到服务器

# 1. 构建 Shell
cd D:\main\DesignerCEP\Designer
npm run build:shell

# 2. 复制到服务器
cd ..
Copy-Item -Path "Designer\dist" -Destination "Server\Designer\dist" -Recurse -Force

# 3. 重启服务器
cd Server
python -m uvicorn app.main:app --reload

验证： 访问 http://127.0.0.1:8000/ 应该自动跳转到 Shell 登录页

🧹 清理命令

清除客户端缓存

Remove-Item -Recurse -Force "$env:APPDATA\DesignerCache"

清除 CEP 扩展缓存

Remove-Item -Recurse -Force "$env:APPDATA\Adobe\CEP\extensions\Designer"
Remove-Item -Recurse -Force "$env:APPDATA\Adobe\CEP\extensions\Designer-dev"

📁 重要目录

目录 说明
Designer/src/view/ Core Vue 页面组件
Designer/src/launcher/ Shell 源代码（登录、更新器）
Designer/src/api/jsxApi/inline/ 内联 JSX 函数
Designer/dist_core/ Core 构建输出
Designer/dist/ Shell 构建输出
Server/Designer/dist/ Shell 服务器部署目录 ⭐
Server/archives/ Core 版本 ZIP 包存放
%APPDATA%\DesignerCache\ 客户端 Core 缓存目录

🌐 URL 访问路径

URL 说明 文件位置
http://127.0.0.1:8000/ 根路径（自动跳转） 重定向到 Shell
http://127.0.0.1:8000/shell/ Shell 登录页 Server/Designer/dist/
http://127.0.0.1:8000/core/v1.2.4/ Core 业务页 %APPDATA%\DesignerCache\v1.2.4\
http://127.0.0.1:8000/api/v1/ 后端 API Server 代码
http://127.0.0.1:8000/download/ Core 下载 Server/archives/

🔧 开发新功能

📝 添加纯前端 JSX 功能

1. 在 layer.ts 添加函数

// Designer/src/api/jsxApi/inline/layer.ts
export async function 新功能(): Promise<JSXResponse> {
    const jsx = `
        try {
            // JSX 代码
            return JSXUtils.stringify({ success: true });
        } catch (error) {
            return JSXUtils.stringify({ error: error.toString() });
        }
    `;
    return evalInlineJSX(jsx);
}

2. 在 Home.vue 调用

import * as Layer from '@/api/jsxApi/inline/layer';

const handle新功能 = async () => {
    const res = await Layer.新功能();
    if (res.success) {
        Message.success('成功');
    }
};

🔐 添加混合架构功能（前端 + 后端）

适用场景： 需要保护核心算法、AI 计算、复杂数学模型等

1. 后端实现（Server/app/api/v1/jsx_demo.py）

class YourFeatureRequest(BaseModel):
    param1: str
    param2: int

@router.post("/your-feature")
async def your_feature(
    request: YourFeatureRequest,
    x_api_key: Optional[str] = Header(None)
):
    # 验证 API Key
    if not validate_api_key(x_api_key):
        raise HTTPException(403, "无效的 API Key")
    
    # 🔒 核心算法（客户端看不到）
    result = complex_algorithm(request.param1, request.param2)
    
    return {"success": True, "result": result}

2. 前端实现（Designer/src/api/jsxApi/inline/your-feature.ts）

export async function yourFeature(param1: string, param2: number): Promise<JSXResponse> {
    // 1. 发送到服务器计算
    const response = await fetch(`${config.apiBaseUrl}/jsx_demo/your-feature`, {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'X-API-Key': 'demo_key_123'  // 🔐 API Key
        },
        body: JSON.stringify({ param1, param2 })
    });
    
    const serverResult = await response.json();
    
    // 2. 应用服务器结果到 PS
    const jsx = `
        // 使用 serverResult 执行 PS 操作
    `;
    return evalInlineJSX(jsx);
}

参考文档：

  • tempdocs/framework_guide.md - 完整框架说明
  • tempdocs/quick_start_template.md - 快速开发模板

🧪 测试命令

测试混合架构 Demo

# 1. 启动后端
cd D:\main\DesignerCEP\Server
python -m uvicorn app.main:app --reload

# 2. 在 PS 中创建图层，名称为数学表达式
# 如：87-98, 100+200

# 3. 点击"智能配色"按钮
# 前端会获取图层名称 → 发送到服务器计算 → 显示结果

测试 API Key 验证

# 使用 curl 测试
curl -X POST http://127.0.0.1:8000/api/v1/jsx_demo/calculate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: demo_key_123" \
  -d '{"expression": "87-98"}'

🔄 完整发布流程

发布新版本 Core

# 1. 修改代码
# 2. 构建 + 打包 + 更新数据库（一键完成）
cd D:\main\DesignerCEP
python auto_deploy_core.py --version v1.2.5 --update-db

# 3. 清除客户端缓存（测试用）
Remove-Item -Recurse -Force "$env:APPDATA\DesignerCache"

# 4. 重新登录测试

更新 Shell

# 1. 构建 Shell
cd D:\main\DesignerCEP\Designer
npm run build:shell

# 2. 部署到服务器
cd ..
Copy-Item -Path "Designer\dist" -Destination "Server\Designer\dist" -Recurse -Force

# 3. 重启后端（如果使用 --reload 会自动重启）

📚 相关文档

文档 说明
混合架构开发框架指南.md 混合架构框架完整指南
混合架构快速开发模板.md 5 分钟快速开发模板
混合方案Demo说明.md 混合方案 Demo 说明
许可证验证接口文档.md 许可证验证接口文档
后端部署Shell指南.md Shell 服务器部署指南
API密钥使用指南.md API Key 使用指南
Reference in New Issue View Git Blame Copy Permalink