更新优化

2025-12-12 00:10:13 +08:00
parent 026d564c92
commit 50ff0d347a
34 changed files with 8669 additions and 7884 deletions
@@ -0,0 +1,160 @@
+# SoonDesign 设计工具
+
+简单易用的桌面设计软件，支持光盘和卡片模板设计。
+
+---
+
+## 🚀 快速开始
+
+### 第一次使用
+
+```bash
+# 1. 安装依赖（只需一次）
+npm install
+
+# 2. 启动程序
+npm start
+```
+
+> **前置要求**：需要安装 [Node.js](https://nodejs.org/)（推荐 16 或更高版本）
+
+---
+
+## 📦 发布流程（傻瓜式操作）
+
+### 方式一：一键发布 ⭐ 推荐
+
+```bash
+# Windows 系统
+npm run release:win
+
+# Mac 系统
+npm run release:mac
+
+# Linux 系统
+npm run release:linux
+```
+
+✅ **自动完成**：加密 → 测试 → 清理 → 打包  
+✅ **安装包位置**：`build` 文件夹
+
+---
+
+### 方式二：分步操作（手动控制）
+
+#### 步骤 1：加密代码
+
+```bash
+npm run encrypt:win    # Windows
+npm run encrypt:linux  # Mac/Linux
+```
+
+✅ 生成 `.jsc` 加密文件（自动覆盖旧文件）
+
+#### 步骤 2：测试
+
+```bash
+npm start
+```
+
+✅ 确认程序正常运行，无报错
+
+#### 步骤 3：清理源文件
+
+```bash
+npm run cleanup
+```
+
+✅ 删除 `.js` 源文件，自动备份到 `.backup` 文件夹
+
+#### 步骤 4：打包
+
+```bash
+npm run build:win    # Windows
+npm run build:mac    # Mac
+npm run build:linux  # Linux
+```
+
+✅ 生成安装包到 `build` 文件夹
+
+---
+
+## 🔧 其他常用命令
+
+### 恢复源文件
+
+```bash
+npm run restore
+```
+
+> 从 `.backup` 文件夹恢复所有源文件（误删除时使用）
+
+### 清理加密文件
+
+```bash
+npm run cleanup:jsc
+```
+
+> 删除所有 `.jsc` 文件（重新加密前使用）
+
+### 修改文件名映射
+
+编辑 `lib/module-map.json`：
+
+```json
+{
+  "mappings": {
+    "design1": {
+      "core": "core1",      // 修改这里
+      "output": "output1",
+      "ui": "ui1"
+    }
+  }
+}
+```
+
+然后重新运行 `npm run encrypt:win`
+
+---
+
+## ⚠️ 注意事项
+
+- **开发时**：保留 `.js` 源文件，不要运行 `cleanup`
+- **发布时**：必须先加密、再清理、最后打包
+- **备份在**：`.backup` 文件夹（不会被打包进应用）
+
+---
+
+## 📁 项目结构
+
+```
+lib/
+├── module-map.json   - 文件名映射配置
+├── index.js          - 首页入口
+├── design1.js        - 光盘模板入口
+├── design2.js        - 卡片模板入口
+├── design1/          - 光盘模板功能模块
+│   ├── core.js       - 核心功能
+│   ├── output.js     - 导出/保存
+│   └── ui.js         - 界面交互
+└── design2/          - 卡片模板功能模块
+    ├── core.js
+    ├── output.js
+    └── ui.js
+
+scripts/encrypt/      - 加密脚本（不会被打包）
+.backup/              - 源文件备份（不会被打包）
+```
+
+---
+
+## 🔧 调试模式
+
+按 `F12` 或 `Ctrl+Shift+I` 打开开发者工具查看错误信息。
+
+---
+
+## 📚 更多文档
+
+- [加密详细说明](scripts/encrypt/README.md)
+- 当前版本：v2.3.017