diff --git a/README_CN.md b/README_CN.md new file mode 100644 index 0000000..68e1e70 --- /dev/null +++ b/README_CN.md @@ -0,0 +1,332 @@ +# NexusLauncher + +[English](README.md) | [简体中文](README_CN.md) + +一个强大且直观的桌面应用程序,专为简化艺术家工作流程而设计,通过管理项目、组织任务文件夹和高效启动创意应用程序来提升工作效率。 + +--- + +## ✨ 功能特性 + +### 🎨 项目管理 +- **多项目支持**:无缝切换多个项目 +- **项目个性化**:使用自定义图标和颜色个性化每个项目 +- **自动保存配置**:所有设置自动保存 + +### 📁 任务管理 +- **7种预设模板**:角色、武器、道具、环境、动画、绑定和其他 +- **可视化节点编辑器**:可视化创建和自定义文件夹结构 +- **一键创建**:即时生成标准化文件夹层次结构 + +### 🚀 应用启动器 +- **快速启动**:快速访问您喜欢的创意应用程序 +- **图标缩放**:使用 `Ctrl + 鼠标滚轮` 调整图标大小 +- **拖放排序**:轻松重新排序应用程序 + +### 🔧 插件系统 +- **Maya 集成**:支持 Maya 2023+ 的自定义插件 +- **Substance Painter**:内置启动器集成 +- **可扩展**:易于添加自定义插件 + +--- + +## 📋 目录 + +- [功能特性](#-功能特性) +- [安装](#-安装) +- [快速开始](#-快速开始) +- [使用指南](#-使用指南) + - [项目管理](#项目管理) + - [任务管理](#任务管理) + - [应用管理](#应用管理) +- [项目结构](#-项目结构) +- [配置](#-配置) +- [文档](#-文档) +- [系统要求](#-系统要求) +- [快捷键](#-快捷键) +- [从源码构建](#-从源码构建) +- [致谢](#-致谢) + +--- + +## 🚀 安装 + +### 方式 1:独立可执行文件 +1. 从发布页面下载 `NexusLauncher.exe` +2. 解压到您喜欢的目录 +3. 运行 `NexusLauncher.exe` + +### 方式 2:从源码运行 +1. 克隆仓库: + ```bash + git clone https://github.com/Jeffreytsai1004/NexusLauncher + cd NexusLauncher + ``` + +2. 安装依赖: + ```bash + pip install -r requirements.txt + ``` + +3. 运行应用程序: + ```bash + python main.py + ``` + +--- + +## ⚡ 快速开始 + +### 1️⃣ 添加您的应用程序 +``` +主窗口 → ⚙ 设置 → + 添加应用 +``` + +填写详细信息: +- **名称**:Maya 2025 +- **路径**:`C:\Program Files\Autodesk\Maya2025\bin\maya.exe` +- **版本**:2025.1 + +### 2️⃣ 创建项目 +``` +设置窗口 → 新建项目 → 输入项目名称 +``` + +建议命名: +- `Character_角色名称` +- `Environment_场景名称` +- `Weapon_武器名称` + +### 3️⃣ 创建任务文件夹 +``` +Task 标签页 → 选择任务类型 → 设置工作空间 → Create Task Folder +``` + +### 4️⃣ 启动应用程序 +``` +Project 标签页 → 点击应用图标 +``` + +💡 **提示**:使用 `Ctrl + 鼠标滚轮` 调整图标大小 + +--- + +## 📖 使用指南 + +### 项目管理 + +#### 创建项目 +- 导航到设置(`⚙` 图标) +- 点击"新建项目" +- 输入描述性项目名称 +- 使用图标和颜色进行自定义 + +#### 切换项目 +- 使用顶部下拉菜单 +- 键盘快捷键:`Ctrl + Tab` +- 所有设置自动保存 + +#### 项目操作 +| 操作 | 描述 | +|------|------| +| **新建** | 创建新项目 | +| **复制** | 复制现有项目 | +| **重命名** | 修改项目名称 | +| **删除** | 删除项目 | +| **图标** | 设置自定义图标 | +| **颜色** | 选择主题颜色 | + +### 任务管理 + +#### 可用模板 + +| 模板 | 使用场景 | +|------|----------| +| **Character** | 角色制作 | +| **Weapon** | 武器建模 | +| **Prop** | 道具资产 | +| **Environment** | 环境艺术 | +| **Animation** | 动画制作 | +| **Rigging** | 角色绑定 | +| **Other** | 自定义任务 | + +#### 角色模板结构 +``` +TaskFolder_Character_001/ +├── Reference/ # 参考资料 +├── MP/ # 中精度建模 +├── HP/ # 高精度雕刻 +├── LP/ # 低精度建模 +├── Baking/ # 烘焙流程 +├── Texture/ # 贴图制作 +├── FBX/ # 最终导出 +└── Screenshot/ # 展示图片 +``` + +#### SubFolder Editor(节点编辑器) + +| 操作 | 快捷键 | 功能 | +|------|--------|------| +| **移动节点** | 拖拽 | 重新定位 | +| **重命名** | `F2` | 重命名节点 | +| **删除** | `Delete` | 删除节点 | +| **复制** | `Ctrl + D` | 复制节点 | +| **添加子节点** | 右键菜单 | 添加子文件夹 | +| **缩放** | `Ctrl + 鼠标滚轮` | 缩放视图 | +| **平移** | 中键拖拽 | 移动视图 | +| **居中** | `Home` | 居中显示 | +| **保存** | `Ctrl + S` | 保存结构 | + +### 应用管理 + +#### 添加应用程序 +``` +⚙ 设置 → + 添加应用 → 填写详细信息 → 保存 +``` + +**必填信息**: +- **名称**:应用程序显示名称 +- **路径**:可执行文件完整路径 +- **版本**:版本号(可选) + +#### 常用应用程序路径 + +| 软件 | 默认路径 | +|------|---------| +| **Maya 2025** | `C:\Program Files\Autodesk\Maya2025\bin\maya.exe` | +| **Blender** | `C:\Program Files\Blender Foundation\Blender 4.2\blender.exe` | +| **ZBrush** | `C:\Program Files\Maxon\ZBrush 2025\ZBrush.exe` | +| **Substance Painter** | `C:\Program Files\Adobe\Adobe Substance 3D Painter\...` | +| **Photoshop** | `C:\Program Files\Adobe\Adobe Photoshop 2025\Photoshop.exe` | +| **Unreal Engine** | `C:\Program Files\Epic Games\UE_5.4\Engine\Binaries\Win64\UnrealEditor.exe` | + +--- + +## 📂 项目结构 + +``` +NexusLauncher/ +├── main.py # 主应用程序入口 +├── requirements.txt # Python 依赖 +├── build.bat # 构建脚本 +├── Run.bat # 运行脚本 +├── config/ # 配置模块 +│ ├── config_manager.py # 配置管理 +│ ├── constants.py # 应用常量 +│ └── icon_config.py # 图标配置 +├── ui/ # 用户界面 +│ ├── project/ # 项目面板 +│ ├── task/ # 任务面板 +│ └── utilities/ # UI 工具 +├── plugins/ # 插件系统 +│ ├── maya.py # Maya 集成 +│ └── substancepainter/ # Substance Painter 插件 +├── icons/ # 应用程序图标 +└── docs/ # 文档 + ├── ARTIST_GUIDE.md # 用户指南(中文) + └── CUSTOM_PLUGIN_GUIDE.md # 插件开发指南 +``` + +--- + +## ⚙️ 配置 + +应用程序将所有设置存储在应用程序目录中的 `config.json` 文件中。 + +### 配置结构 +```json +{ + "projects": [ + { + "name": "Project_01", + "icon": "path/to/icon.png", + "color": "#FF5733" + } + ], + "applications": [ + { + "name": "Maya 2025", + "path": "C:/Program Files/Autodesk/Maya2025/bin/maya.exe", + "version": "2025.1" + } + ] +} +``` + +### 备份配置 +只需备份 `config.json` 文件即可保留所有设置。 + +--- + +## 📚 文档 + +- **[艺术家指南](docs/ARTIST_GUIDE.md)** - 综合用户指南(中文) +- **[自定义插件指南](docs/CUSTOM_PLUGIN_GUIDE.md)** - Maya 插件开发指南(中文) + +--- + +## 💻 系统要求 + +### 最低要求 +- **操作系统**:Windows 10 或更高版本 +- **内存**:4GB +- **存储空间**:100MB 可用空间 +- **Python**:3.8+(如果从源码运行) + +### 推荐配置 +- **操作系统**:Windows 11 +- **内存**:8GB 或更多 +- **显示器**:1920x1080 分辨率 +- **Python**:3.10+ + +--- + +## ⌨️ 快捷键 + +| 快捷键 | 功能 | +|--------|------| +| `Ctrl + Tab` | 切换项目 | +| `Ctrl + 鼠标滚轮` | 缩放图标/视图 | +| `Ctrl + 点击` | 多选 | +| `Delete` | 删除选中项 | +| `Escape` | 取消选择 | +| `F2` | 重命名 | +| `Ctrl + D` | 复制 | +| `Ctrl + S` | 保存 | +| `Home` | 居中视图 | +| `中键拖拽` | 平移视图 | + +--- + +## 🛠️ 从源码构建 + +### 要求 +- Python 3.8+ +- `requirements.txt` 中的所有依赖 + +### 构建步骤 +1. 安装依赖: + ```bash + pip install -r requirements.txt + ``` + +2. 运行构建脚本: + ```bash + build.bat + ``` + +3. 在 `dist/` 目录中找到可执行文件 + +--- + +## 🙏 致谢 + +- 使用 [CustomTkinter](https://github.com/TomSchimansky/CustomTkinter) 构建 +- 图标来自各种开源项目 +- 特别感谢所有贡献者 + +--- + +**NexusLauncher** - 让艺术家的项目管理更简单 🚀 + +*版本 1.2.0 | 更新时间:2025年11月*