Appearance
文件清理与保留
清理前先停止对应开发/预览服务。不要清空整个 public 或 artifacts。本地模型、数据、许可证和正式交付记录必须保留。本次补全不执行大范围文件删除。
| 路径 | 是否可清理 / 恢复办法 |
|---|---|
| 根 node_modules | 可重装:根目录 npm ci |
| demos/tgz-demo/node_modules | 可重装:保留 vendor TGZ 和锁文件,再 npm ci |
| packages/sdk/dist | 可重建:npm run build:sdk |
| apps/example/dist | 可重建:先 npm run prepare:assets 再构建 example;线上版使用静态交付流程 |
| apps/docs/.vitepress/dist、cache | 可重建:构建 docs;正式下载文件来自静态交付流程 |
| demos/tgz-demo/dist | 可重建:该目录 npm run build |
| 两个 Demo 的 public/cesium | 复制产物:运行各自 prepare:assets;与 Cesium 版本一致 |
| test-results、playwright-report | 定位完成并保存必要证据后可清理 |
| artifacts | 只清旧调试结果;保留最终 TGZ、ZIP、manifest、SHA-256、验证记录与发布目录 |
| apps/docs/public/downloads | 自动生成,可从正式 release/site/downloads 备份恢复;不能丢失唯一交付文件 |
| apps/example/public/models | 保留,这是模型数据,不是缓存,Git 默认不跟踪,需单独备份 |
| .env.local | 本地保留,不上传站点、不提交 Git |
| 源码、测试、文档、锁文件、LICENSE、第三方署名、.github、.git、deploy | 保留;deploy 中私有 registry 为可选方案 |
FONT-LICENSE.txt、tile.svg 等小文件只有确认引用并同步说明后才可删除,收益很小。安全做法是把选定的旧产物移到独立备份文件夹,确认可重建且新发布验收通过后,再删除备份。