-
released this
2026-09-15 22:27:16 +08:00 | 27 commits to main since this releaseOpenDance Studio -- Web 管理服务端 v0.2.1
v0.2.0 的补丁版: 修复首次部署必然失败的问题。功能与契约与 v0.2.0 相同
(rest-api / data-models / model-formats 0.4.0、database 0.3.0)。修复的问题
现象(在干净服务器上按 README 部署 v0.2.0 时):
./deploy/.env: line 53: Miku.pmx: command not found [install] 第 53 行执行失败(退出码 127)根因:
deploy/.env.example里MODEL_CONVERT_PMX=Hatsune Miku.pmx的值含空格却没加引号。
install.sh用set -a; . deploy/.env载入配置时会真的执行这个文件, 这一行被切成
「赋值 + 命令」,Miku.pmx被当成命令执行。本次改动
- 模板改为
MODEL_CONVERT_PMX="Hatsune Miku.pmx"(占位符值同样加引号); - 新增
deploy/env-lib.sh语法预检:install.sh与ctl.sh在 source 之前检查,
报错直接指出哪一行、原文、改法;$( )与反引号会建议改用单引号
(双引号里的它们仍会被执行); install.sh的失败提示补上出错文件名(.env被 source 时行号属于.env,
只报行号无法定位);- 新增 12 项回归测试
web-server/test/env-file.spec.ts, 锁住「模板可被 shell 原样载入」; - 文档补充
.env写法约定与 FAQ; 测试规模 11 文件 / 180 项。
已经部署到一半(v0.2.0)怎么继续
不必重新下载, 在解压目录里给这一行加上引号再重跑安装:
sed -i 's|^MODEL_CONVERT_PMX=Hatsune Miku.pmx$|MODEL_CONVERT_PMX="Hatsune Miku.pmx"|' deploy/.env bash deploy/install.sh校验
curl -LO https://gitea.kasugano.cn/zijunchiang/opendance-web/releases/download/v0.2.1/SHA256SUMS sha256sum -c SHA256SUMS # 期望 OKopendance-web-v0.2.1.tar.gzsha256:f574c82f4c9f7ac705ebd1099510bd863010b7f2d5d43fac43800b705ee9eaf0Downloads
- 模板改为