feat(web): 端口分离 + VMD 动作支持;契约升至 0.2.0
需求 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 越界(测试数据已从数据库清理)。
This commit is contained in:
@@ -16,7 +16,18 @@
|
||||
|
||||
放置位置:IIS 站点根目录下的 web.config
|
||||
|
||||
后端(NestJS)自带管理端页面与 SPA 回退,所以这里只需一条全匹配重写规则,
|
||||
后端(NestJS)同时监听两个端口,职责不同:
|
||||
|
||||
软件 API 端口(PORT,默认 3000)—— 给 Windows/Godot 客户端与 Android App
|
||||
只有 /api、/health、/static、/contracts
|
||||
管理端端口(ADMIN_PORT,默认 3001)—— 给浏览器
|
||||
管理页面 + 上面全部接口
|
||||
|
||||
**在 IIS 里建两个站点**,把下面这份 web.config 各放一份,只改 <action> 里的端口:
|
||||
站点 A(如 dance-api.example.com) → http://127.0.0.1:3000/{R:1}
|
||||
站点 B(如 dance-admin.example.com)→ http://127.0.0.1:3001/{R:1}
|
||||
|
||||
后端自带管理端页面与 SPA 回退,所以每个站点只需一条全匹配重写规则,
|
||||
不需要在 IIS 上再配置默认文档或 URL Rewrite 的 SPA 回退。
|
||||
============================================================
|
||||
-->
|
||||
@@ -25,7 +36,12 @@
|
||||
|
||||
<rewrite>
|
||||
<rules>
|
||||
<!-- 全部请求转发给后端:管理端页面 / 前端深链接 / api / health / static / contracts -->
|
||||
<!--
|
||||
全部请求转发给后端。
|
||||
管理端站点把端口改成 3001;软件 API 站点保持 3000。
|
||||
注意:软件 API 端口**不提供管理页面**,用浏览器访问它会得到 404,
|
||||
这是有意设计(职责分离),不是配置错误。
|
||||
-->
|
||||
<rule name="OpenDanceReverseProxy" stopProcessing="true">
|
||||
<match url="(.*)" />
|
||||
<action type="Rewrite" url="http://127.0.0.1:3000/{R:1}" />
|
||||
@@ -70,8 +86,12 @@
|
||||
</configuration>
|
||||
<!--
|
||||
┌──────────────────────────────────────────────────────────────┐
|
||||
│ 两个最常踩的坑 │
|
||||
│ 三个最常踩的坑 │
|
||||
├──────────────────────────────────────────────────────────────┤
|
||||
│ 0. 两个端口搞混。浏览器要访问的是**管理端端口 3001**; │
|
||||
│ 客户端调用的是**软件 API 端口 3000**。指错会出现 │
|
||||
│ "管理页面 404" 或 "接口全 404"。 │
|
||||
│ │
|
||||
│ 1. 代理超时是**服务器级**配置,不在 web.config 里。 │
|
||||
│ ARR 默认 120 秒,上传大模型会中途断开。改 │
|
||||
│ C:\Windows\System32\inetsrv\config\applicationHost.config │
|
||||
|
||||
Reference in New Issue
Block a user