Studio v0.1.1 · 产品手册
源码开发
源码开发:GalCraft Studio 操作与参考。
源码开发与 CI 固定使用 Node.js 24.21.0 与 pnpm 12.3.4。发行 npm 应用包和独立插件 CLI 的最低版本为 Node.js 22.12.0;开发仓库继续使用上述固定环境。在 GalCraft 仓库根目录(同时包含 package.json 和 pnpm-lock.yaml)打开 PowerShell,检查版本,再安装依赖并启动完整桌面宿主:
git clone https://github.com/TianyuEric/GalCraft.git
cd GalCraft
node --version
pnpm --version
pnpm install --frozen-lockfile
pnpm --filter @galcraft/studio desktop最后一条命令会构建 Studio、Player 及默认引擎,再打开窗口。首次准备缺失字体和媒体工具需要网络;终端仍在构建或下载时,等待它完成。以后只想启动已有构建,可运行:
pnpm --filter @galcraft/studio desktop:start源码修改后,先运行 node apps/studio/service/cli.mjs stop 明确停止旧服务,再运行 desktop 取得更新后的构建。根目录的 pnpm dev 只启动 renderer 的 Vite 服务;实际创作使用桌面或下面的本机 Web 入口。
| 启动时遇到的情况 | 下一步 |
|---|---|
找不到 node 或 pnpm | 准备上述开发环境,重新打开终端并检查版本;已打包的桌面程序可直接运行 |
| 首次准备字体或媒体工具失败 | 按终端显示的下载或文件错误修正网络、路径或权限,再运行 desktop |
| 改了源码,窗口仍显示旧界面 | 明确停止旧服务,再重新构建并启动;desktop:start 使用已有构建 |