docs(readme): 新增初次部署清单与常见问题；统一 root 执行写法；清除 markdown 粗体标记与残留真实库名

web-server/admin/README.md

@@ -11,7 +11,7 @@
 ```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）
 ```
@@ -39,14 +39,14 @@ server: {
 `src/api/client.ts` 的基址取自：
 
 ```ts
-const BASE_URL = import.meta.env.VITE_API_BASE ?? '';
+const BASE_URL = import.meta.env.VITE_API_BASE?? '';
 ```
 
-- **不设置（默认，空串）**：同源请求 —— 开发期走上面的 vite 代理，生产期走 nginx 反代。**推荐**。
+- **不设置（默认，空串）**：同源请求 -- 开发期走上面的 vite 代理，生产期走 nginx 反代。**推荐**。
 - **设置**：例如服务端在另一台机器上：
 
   ```bash
-  # .env.local（不要提交）
+  #.env.local（不要提交）
   VITE_API_BASE=http://192.0.2.10:3000
   ```
 
@@ -90,7 +90,7 @@ src/
     endpoints.ts           契约端点封装
   components/
     Layout.tsx             左侧导航骨架
-    ui.tsx                 通用组件（表格/弹窗/分页/来源五元组展示与表单…）
+    ui.tsx                 通用组件（表格/弹窗/分页/来源五元组展示与表单...）
     VrmPreview.tsx         three + @pixiv/three-vrm 的 3D 预览（懒加载分包）
   lib/
     labels.ts              枚举中文文案
@@ -108,8 +108,8 @@ src/
 ## 页面与任务对照
 
 | 路由 | 说明 | 任务 |
-|---|---|---|
-| `/` | 概览：三类资产按状态计数、契约版本与目录指纹、健康检查、API 不可达告警 | — |
+|--|--|--|
+| `/` | 概览：三类资产按状态计数、契约版本与目录指纹、健康检查、API 不可达告警 | - |
 | `/songs` | 歌曲管理：分页/搜索/筛选、来源五元组必填、音频上传、软删除 | T-WEB-008 |
 | `/models` | 模型管理：VRM 优先、来源五元组完整展示、设为默认、3D 预览 | T-WEB-009 |
 | `/motions` | 动作管理：上传、预处理、关键点 NDJSON 下载 | T-WEB-004/006 |