• v0.2.1 e9de740d66

    zijunchiang released this 2026-09-15 22:27:16 +08:00 | 27 commits to main since this release

    OpenDance 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 被当成命令执行。

    本次改动

    1. 模板改为 MODEL_CONVERT_PMX="Hatsune Miku.pmx"(占位符值同样加引号);
    2. 新增 deploy/env-lib.sh 语法预检: install.sh 与 ctl.sh 在 source 之前检查,
      报错直接指出哪一行、原文、改法; $( ) 与反引号会建议改用单引号
      (双引号里的它们仍会被执行);
    3. install.sh 的失败提示补上出错文件名(.env 被 source 时行号属于 .env,
      只报行号无法定位);
    4. 新增 12 项回归测试 web-server/test/env-file.spec.ts, 锁住「模板可被 shell 原样载入」;
    5. 文档补充 .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   # 期望 OK
    

    opendance-web-v0.2.1.tar.gz sha256: f574c82f4c9f7ac705ebd1099510bd863010b7f2d5d43fac43800b705ee9eaf0

    Downloads