zijunchiang
bba5bcf59e
需求 1：管理端端口与软件 API 端口分离 - 软件 API 端口 PORT（默认 3000）只提供 /api、/health、/static、/contracts， 不提供管理页面（未命中路径 404）；管理端端口 ADMIN_PORT（默认 3001） 提供管理页面与全部接口；ADMIN_HOST 可单独限制管理端来源 - main.ts 同进程监听两个端口，用 req.socket.localPort 区分端口行为； ADMIN_PORT=PORT 为单端口兼容模式（只创建一个 server，无 EADDRINUSE） - 端口非法在生产环境中止启动；ADMIN_PORT=PORT 只 warn - 启动日志分别打印两个端口的访问地址 需求 2：动作数据支持 VMD（MikuMikuDance） - vmd-parser.ts：二进制解析（30 字节头 + Shift-JIS 模型名 + 111 字节/条骨骼 关键帧 + morph 段）、MMD 贝塞尔插值、GBK 模型名回退、固定 30fps - mmd-skeleton.ts：标准 MMD 骨架；静止比例从参考 PMX 骨骼段实测得到 （足首 1.43 / 膝 6.57 / 髋 11.50 / 首 16.21 / 頭 17.16，腿长 10.09） - mmd-pose.ts：FK + 两骨骼解析腿部 IK（膝盖朝正面，不可达收敛为伸直） + 左手系→右手系 Z 镜像（由真实数据对照实验确定：94.1% vs 5.9%） - retarget.ts：抽出 worldFramesToKeypointFrames()，BVH 与 VMD 共用重定向 - MotionFormat 增 vmd、扩展名映射增 .vmd；管理端上传支持 .vmd - scripts/inspect-vmd.mjs：上传前自查工具 契约：rest-api / data-models / model-formats → 0.2.0（另两库已同步逐字节一致） 验证：85 项单测通过（VMD 31 项）；契约与 29 条路由一致；typecheck/build 通过； 真实样本经 HTTP 端到端：霜雪千年 2901 帧（IK 腿）、恋爱循环 4604 帧（FK 腿） 均 preprocessState=done、0 NaN、0 越界（测试数据已从数据库清理）。
50 lines
2.1 KiB
Bash
50 lines
2.1 KiB
Bash
# ============================================================
|
||
# OpenDance Studio Web 服务端 —— Linux 原生部署环境变量
|
||
#
|
||
# 复制为 deploy/.env 后填写；.env 已被 .gitignore 忽略，禁止提交。
|
||
# 该文件由 systemd 通过 EnvironmentFile 注入 Node 进程。
|
||
# ============================================================
|
||
|
||
# ---- 服务 ----
|
||
NODE_ENV=production
|
||
# 软件 API 端口：Windows/Godot 客户端与 Android App 调用它
|
||
# （提供 /api、/health、/static、/contracts，**不提供管理页面**）
|
||
PORT=3000
|
||
# 管理端端口：浏览器访问管理界面（页面 + 上面全部接口）
|
||
# 不设置时默认 = PORT + 1（即 3001）；设为与 PORT 相同即为单端口兼容模式
|
||
ADMIN_PORT=3001
|
||
# 监听地址：
|
||
# 反代与后端同机 → 127.0.0.1（后端不直接对外暴露，推荐）
|
||
# 反代在别的机器 → 0.0.0.0，并用防火墙把该端口限制为仅反代来源可访问
|
||
HOST=0.0.0.0
|
||
# 管理端单独绑定地址（可选）。只想让管理端暴露在内网时，例如 127.0.0.1 或内网网卡地址
|
||
# ADMIN_HOST=127.0.0.1
|
||
|
||
# 管理端静态站点目录（本服务自带管理端页面，反代只需整体转发到管理端端口）
|
||
ADMIN_DIR=/opt/opendance/admin
|
||
|
||
# ---- 现有 MySQL / MariaDB 实例（本项目不安装、不管理数据库）----
|
||
DB_HOST=<existing-mysql-host>
|
||
DB_PORT=3306
|
||
DB_USER=opendance_app
|
||
DB_PASS=<部署方提供>
|
||
DB_NAME=opendance
|
||
# 生产环境必须为 false，表结构一律走 TypeORM migration
|
||
DB_SYNCHRONIZE=false
|
||
DB_LOGGING=false
|
||
|
||
# ---- 文件存储 ----
|
||
# 需与 install.sh 的 STORAGE_DIR 一致，且服务用户可写
|
||
STORAGE_DIR=/var/lib/opendance/storage
|
||
# 单文件上传上限（字节），默认 512 MiB。
|
||
# ★ 反向代理层的同名限制必须不小于此值（nginx client_max_body_size /
|
||
# IIS requestLimits），否则大模型上传会在代理层被拒（413）。
|
||
UPLOAD_MAX_BYTES=536870912
|
||
|
||
# ---- 可选的 Assimp（FBX/glTF 动作预处理）----
|
||
ASSIMP_BIN=assimp
|
||
|
||
# ---- 契约目录 ----
|
||
# 指向安装目录下的 contracts/，使 /health 与 /api/catalog/version 反映实时契约版本
|
||
CONTRACTS_DIR=/opt/opendance/contracts
|