docs: 三库文档规范化(去混淆字符 + 占位符)+ Web README 初次部署清单

- 三库所有 .md/.txt 与配置样例中的 — – … § → 一律换成 ASCII(Gitea 的
  「模棱两可的 Unicode 字符」告警即由这几个字符触发;中文全角标点不受影响,
  实测 README.txt 修正后告警消失)
- contracts/* 在三库保持逐字节一致(已校验 md5)
- 残留真实值清理:README.txt 建库 SQL 的 dpendance -> opendance/opendance_app,
  Android HostDiscovery.kt 注释示例 192.168.1.23 -> 192.0.2.23
- Web README.txt 新增「初次部署(从零跑起来)」8 步清单与「常见问题(初次部署)」
  7 条;去掉纯文本 README 里的 markdown 粗体标记;统一 '以 root 直接执行' 写法
- 重新打包 v0.2.0

验证:168 项单测通过;契约 6 项与 30 条路由一致。
This commit is contained in:
2026-09-15 21:28:12 +08:00
parent ebd871018f
commit 8c2f2afaea
6 changed files with 29 additions and 29 deletions
+7 -7
View File
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
============================================================
OpenDance Studio Web 服务端 —— IIS 反向代理样例
OpenDance Studio Web 服务端 -- IIS 反向代理样例
说明:本 Web 端不自带反向代理。本文件是**给你的反代服务参考**的配置样例。
@@ -11,21 +11,21 @@
2. Application Request Routing (ARR)
https://www.iis.net/downloads/microsoft/application-request-routing
3. 启用 ARR 代理(否则会 404.4):
IIS 管理器 → 服务器节点 → Application Request Routing Cache
→ Server Proxy Settings → 勾选 Enable proxy
IIS 管理器 -> 服务器节点 -> Application Request Routing Cache
-> Server Proxy Settings -> 勾选 Enable proxy
放置位置:IIS 站点根目录下的 web.config
后端(NestJS)同时监听两个端口,职责不同:
软件 API 端口(PORT,默认 3000)—— 给 Windows/Godot 客户端与 Android App
软件 API 端口(PORT,默认 3000)-- 给 Windows/Godot 客户端与 Android App
只有 /api、/health、/static、/contracts
管理端端口(ADMIN_PORT,默认 3001)—— 给浏览器
管理端端口(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}
站点 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 回退。