opendance-web

76 Commits 2 Branches 17 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
opendance	da03777995	fix(models): Assimp 缺失时给出可操作报错，部署脚本自动安装现象：服务器未安装 Assimp，上传 PMX 压缩包只得到 GLB 直出：导出失败（ENOENT）：spawn assimp ENOENT glTF 直出：导出失败（ENOENT）：spawn assimp ENOENT 用户看不出缺什么、怎么装，也不知道只传 glb/vrm 其实不需要它。修复： 1. 新增 src/common/assimp.ts：按 ASSIMP_BIN -> PATH -> /usr/bin、/usr/local/bin 等常见目录定位可执行文件（只认文件，不认同名目录），转换前先预检；找不到就一次性给出各发行版安装命令、查过的路径与替代办法，不再打两条 ENOENT。动作预处理（FBX/glTF -> BVH）复用同一文案。 2. 新增 deploy/assimp-lib.sh：install.sh 按发行版自动安装（apt-get / dnf / yum / zypper / apk / pacman），装在非常规目录时把绝对路径写入 deploy/.env 的 ASSIMP_BIN；装不上只告警不中止，可用 SKIP_ASSIMP_INSTALL=1 跳过。check-access.sh 自检增加 Assimp 一行。 3. /health 增加 assimp.path；管理端「概览 -> 服务健康」显示 Assimp 状态，不可用时给出安装提示。 4. 新增 test/assimp-locate.spec.ts 13 项；强化「assimp 不存在」用例断言安装命令。测试规模 12 文件 / 193 项。 5. 版本 0.2.2，README(.md/.txt)/DSH.md 同步（前置要求、FAQ、环境变量说明）。	2026-09-16 02:55:32 +08:00
zijunchiang	34c5040e6b	feat(deploy): 新增外部访问诊断脚本 check-access.sh "服务已启动但外部访问不了"时一次性定位原因，只读诊断、不改配置： - 读出 .env 的 HOST/PORT，并对 127.0.0.1 这种只监听回环的配置直接报错 - 检查实际监听地址（ss/netstat），区分通配与仅回环 - 回环 + 对外 IP 两次 /health 自测（用 ip route get 取真实出口 IP） - 检查 80/443 上有没有反向代理，并说明本项目不部署反代 - 检查 firewalld / ufw / iptables 对端口的放行情况，给出修复命令 - 结尾按"直连后端"与"经反代"两条路径给出结论同时更新 README.txt、deploy/proxy/README.md（新增第八节：还没有反代时如何直连后端）与打包校验清单。	2026-09-15 01:43:35 +08:00

Author

SHA1

Message

Date

opendance

da03777995

fix(models): Assimp 缺失时给出可操作报错，部署脚本自动安装

现象：服务器未安装 Assimp，上传 PMX 压缩包只得到
  GLB 直出：导出失败（ENOENT）：spawn assimp ENOENT
  glTF 直出：导出失败（ENOENT）：spawn assimp ENOENT
用户看不出缺什么、怎么装，也不知道只传 glb/vrm 其实不需要它。

修复：
1. 新增 src/common/assimp.ts：按 ASSIMP_BIN -> PATH -> /usr/bin、/usr/local/bin
   等常见目录定位可执行文件（只认文件，不认同名目录），转换前先预检；
   找不到就一次性给出各发行版安装命令、查过的路径与替代办法，
   不再打两条 ENOENT。动作预处理（FBX/glTF -> BVH）复用同一文案。
2. 新增 deploy/assimp-lib.sh：install.sh 按发行版自动安装
   （apt-get / dnf / yum / zypper / apk / pacman），装在非常规目录时把绝对
   路径写入 deploy/.env 的 ASSIMP_BIN；装不上只告警不中止，可用
   SKIP_ASSIMP_INSTALL=1 跳过。check-access.sh 自检增加 Assimp 一行。
3. /health 增加 assimp.path；管理端「概览 -> 服务健康」显示 Assimp 状态，
   不可用时给出安装提示。
4. 新增 test/assimp-locate.spec.ts 13 项；强化「assimp 不存在」用例断言安装命令。
   测试规模 12 文件 / 193 项。
5. 版本 0.2.2，README(.md/.txt)/DSH.md 同步（前置要求、FAQ、环境变量说明）。

2026-09-16 02:55:32 +08:00

zijunchiang

34c5040e6b

feat(deploy): 新增外部访问诊断脚本 check-access.sh

"服务已启动但外部访问不了"时一次性定位原因，只读诊断、不改配置：
- 读出 .env 的 HOST/PORT，并对 127.0.0.1 这种只监听回环的配置直接报错
- 检查实际监听地址（ss/netstat），区分通配与仅回环
- 回环 + 对外 IP 两次 /health 自测（用 ip route get 取真实出口 IP）
- 检查 80/443 上有没有反向代理，并说明本项目不部署反代
- 检查 firewalld / ufw / iptables 对端口的放行情况，给出修复命令
- 结尾按"直连后端"与"经反代"两条路径给出结论

同时更新 README.txt、deploy/proxy/README.md（新增第八节：还没有反代时
如何直连后端）与打包校验清单。

2026-09-15 01:43:35 +08:00