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
+3 -3
View File
@@ -1,13 +1,13 @@
# ============================================================
# OpenDance Studio Web 服务端 —— nginx 反向代理样例(双端口)
# OpenDance Studio Web 服务端 -- nginx 反向代理样例(双端口)
#
# 说明:本 Web 端不自带反向代理。本文件是**给你的反代服务参考**的配置样例,
# 由部署 `deploy/install.sh` 之外的反代负责人使用。
#
# 后端同时监听两个端口,职责不同:
# 软件 API 端口(PORT,默认 3000)—— Windows/Godot 客户端、Android App
# 软件 API 端口(PORT,默认 3000)-- Windows/Godot 客户端、Android App
# 只提供 /api、/health、/static、/contracts
# 管理端端口(ADMIN_PORT,默认 3001)—— 浏览器,提供管理页面 + 上面全部接口
# 管理端端口(ADMIN_PORT,默认 3001)-- 浏览器,提供管理页面 + 上面全部接口
#
# 两个端口都不需要在代理层托管静态文件、也不需要 SPA 回退(服务端已处理),
# 因此每个站点只要一条 `location /` 全匹配转发即可。