Studio v0.1.1
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 使用已有构建

扩展包见插件 SDK,打包程序的使用见安装与启动。