Sfoglia il codice sorgente

docs(cockpit): 产物不含 tools 与部署精简清单

按维护者 2026-11-03 要求,明确生产打包与部署边界:
· build 产物 = src 构建 + public 拷贝,tools/docs/.scratch/DesignAssets 等
  均不在 public 下,不会被拷进 dist;.fes.js 另已把 **/tools/** 排除出 watch;
· 部署只需三块:dist(约120MB) + GIS 影像地形(约1.2GB) + 生产 3D 模型(292MB);
· 生产模型已随仓库版本化(4891d86a),旧版本只保留 city-regions-v10 作回退;
· 可选精简:public/plugins 108MB 会进产物但驾驶舱不依赖(票06),不用插件页可移除。
ChenJZ 1 giorno fa
parent
commit
b6f702eca9
1 ha cambiato i file con 26 aggiunte e 0 eliminazioni
  1. 26 0
      docs/cockpit-deployment.md

+ 26 - 0
docs/cockpit-deployment.md

@@ -519,6 +519,32 @@ location /gis/cad-bim/ {
 
 **目录搬走/换机器**:只改 `config.json` 里对应的 `url`,**不用改前端、不用重建**。
 
+### 3.2 产物内容与部署精简(2026-11-03)
+
+**打包不含工具**:`yarn build` 的产物 = `src/` 构建结果 + `public/` 整体拷贝。
+仓库根的 `tools/`、`docs/`、`DesignAssets/`、`.scratch/`、`openspec/`、`skills/`
+都不在 `public/` 下,**不会被拷进 `dist/`**;`.fes.js` 另把 `**/tools/**` 排除出
+dev server 的 watch(`tools/` 实测 3.6 万文件,曾是常驻内存的主要来源)。
+
+**部署只需三块**,其余一概不上传:
+
+| 上传什么 | 体积 | 去向 |
+| --- | --- | --- |
+| `dist/`(前端产物,含 `public/` 拷贝) | 约 120 MB | 站点根 |
+| `dem/` + `pic-ring0..3/`(见 §3.1) | 约 1.2 GB | `/data/gis/` |
+| `city-regions-v10-cs1/` + `lod-near-estate-pilot-v6/` | 约 292 MB | `/data/gis/cad-bim/`(二者必须同父目录) |
+
+**不要上传**:`tools/`(3.3 GB 生成物与脚本)、`docs/`、`.scratch/`、`DesignAssets/`、
+`openspec/`、`skills/`、`node_modules/`、`after-deploy/`。
+
+**资产已入库**:生产 3D 模型(`city-regions-v10-cs1` 与 `lod-near-estate-pilot-v6`)
+自 2026-11-03 起随仓库版本化(提交 `4891d86a`),部署时从仓库对应路径取,不再依赖
+某台机器上的未跟踪副本。旧模型版本只保留 `city-regions-v10` 作回退。
+
+**可选精简**:`public/plugins/` 108 MB 会随 `public/` 进入产物。驾驶舱不依赖它
+(票 06 验收第 1 条:`public/plugins/**` 属 TvT 插件体系,驾驶舱不得依赖);
+若该部署不使用 TvT 插件页面,可在打包前移除以减小产物。
+
 ---
 
 ## 4. 完整的最小可用配置(内网离线)