docs: 消除 Gitea 模棱两可 Unicode 告警(全角标点紧邻 ASCII 时改为半角)

依据 Gitea v1.27.3 modules/charset/escape_stream.go 的判定规则
(analyzeDetectResults:仅当左右相邻字符都不是非 ASCII 时才标记,
且 _common 表恒定生效),把说明文档中会被标记的全角标点
(,:;?!() 等)改为半角,并保证成对括号宽度一致。
中文语境中的全角标点(左右均为中文)保持原样,不动代码与契约语义。

同时删除临时探针目录 _probe/(仅用于确认 Gitea 判定规则)。
This commit is contained in:
opendance
2026-09-15 21:45:51 +08:00
parent a34cca007c
commit 60c182f1b2
28 changed files with 276 additions and 615 deletions
+14 -14
View File
@@ -1,7 +1,7 @@
# OpenDance Studio 管理端(opendance-admin)
# OpenDance Studio 管理端(opendance-admin)
基于 **React 18 + TypeScript + Vite** 的管理后台,对接 `web-server` 的 NestJS API。
接口契约以 [`../contracts/rest-api.yaml`](../contracts/rest-api.yaml)(rest-api 0.1.0)为准,
接口契约以 [`../contracts/rest-api.yaml`](../contracts/rest-api.yaml)(rest-api 0.1.0)为准,
字段语义见 [`../contracts/data-models.md`](../contracts/data-models.md)。
界面语言为简体中文;无任何 UI 组件框架,全部样式集中在 `src/styles.css`。
@@ -11,16 +11,16 @@
```bash
npm install # 或 pnpm install
npm run dev # 开发服务器 http://localhost:5173
npm run build # 生产构建(tsc -b && vite build)-> dist/
npm run build # 生产构建(tsc -b && vite build)-> dist/
npm run preview # 本地预览 dist/
npm run typecheck # 只做类型检查(tsc --noEmit)
npm run typecheck # 只做类型检查(tsc --noEmit)
```
> 管理端请求的是**同源**的 `/api/**` 与 `/health`,不含任何硬编码域名。
## 开发代理(dev proxy)
## 开发代理(dev proxy)
`vite.config.ts` 已把 `/api` 与 `/health` 代理到 `http://localhost:3000`:
`vite.config.ts` 已把 `/api` 与 `/health` 代理到 `http://localhost:3000`:
```ts
server: {
@@ -73,24 +73,24 @@ bash deploy/install.sh
```
- 后端通过 `ADMIN_DIR` 定位管理端产物,默认 `../admin`
- 反代配置样例:`deploy/proxy/nginx.conf.example`(nginx)、
`deploy/proxy/web.config.example`(IIS)
- 反代配置样例:`deploy/proxy/nginx.conf.example`(nginx)、
`deploy/proxy/web.config.example`(IIS)
- 完整说明:`deploy/proxy/README.md`
## 目录结构
```
src/
main.tsx 入口(BrowserRouter)
main.tsx 入口(BrowserRouter)
App.tsx 路由表
styles.css 全部样式
api/
client.ts fetch 封装(ApiError / 分页 / multipart)
client.ts fetch 封装(ApiError / 分页 / multipart)
types.ts 契约类型(与 rest-api.yaml 一一对应)
endpoints.ts 契约端点封装
components/
Layout.tsx 左侧导航骨架
ui.tsx 通用组件(表格/弹窗/分页/来源五元组展示与表单...)
ui.tsx 通用组件(表格/弹窗/分页/来源五元组展示与表单...)
VrmPreview.tsx three + @pixiv/three-vrm 的 3D 预览(懒加载分包)
lib/
labels.ts 枚举中文文案
@@ -119,12 +119,12 @@ src/
## 3D 预览说明
`src/components/VrmPreview.tsx`:`GLTFLoader` + `VRMLoaderPlugin`(来自 `@pixiv/three-vrm`),
`src/components/VrmPreview.tsx`: `GLTFLoader` + `VRMLoaderPlugin`(来自 `@pixiv/three-vrm`),
- 依据 `vrm.meta.metaVersion` 区分 VRM 0.x / 1.0,0.x 自动执行 `VRMUtils.rotateVRM0`;
- 依据 `vrm.meta.metaVersion` 区分 VRM 0.x / 1.0, 0.x 自动执行 `VRMUtils.rotateVRM0`;
- 自实现鼠标拖拽旋转与滚轮缩放(未引入 OrbitControls);
- `requestAnimationFrame` 循环内调用 `vrm.update(delta)`,并按包围盒自动取景;
- 卸载时取消 RAF、断开 ResizeObserver、释放 renderer / geometry / material / texture;
- 卸载时取消 RAF、断开 ResizeObserver、释放 renderer / geometry / material / texture;
- 无 WebGL 上下文时降级为错误提示,不会让页面崩溃。
`three` + `@pixiv/three-vrm`(约 750 kB)通过 `React.lazy` 单独分包,仅进入模型页时加载。