Forráskód Böngészése

docs: 记录驾驶舱仓库跟踪文件瘦身边界

2026-11-18 逐类核查415项跟踪文件后确认当前无可安全删除项:
- jessibuca为FLV回退运行时依赖,tests被视频验收文档引用
- openspec/skills/docs为项目规则显式依赖,docs视频材料对应未关闭票据
- 记录后续可另立票的代码解耦方向
ChenJZ 2 órája
szülő
commit
feba60b42e
2 módosított fájl, 53 hozzáadás és 0 törlés
  1. 1 0
      README.md
  2. 52 0
      docs/cockpit-repo-slimming-boundary.md

+ 1 - 0
README.md

@@ -41,5 +41,6 @@ yarn build
 - 运行时 mock 是驾驶舱原有离线模式的一部分,并非孤立测试文件,保留其真实引用链;生产默认 real。
 - 本地归档、工具、模型加工文件、设计源、验证脚本按 [忽略规则](<.gitignore>) 隔离。旧工具依赖原始依赖清单,不能用精简后的安装环境重跑加工流程。
 - [锁文件](<yarn.lock>) 已按当前直接依赖及传递/可选依赖闭包离线裁剪;保留条目的版本、下载地址和完整性字段不变,未安装或升级依赖。
+- [跟踪文件瘦身边界](<docs/cockpit-repo-slimming-boundary.md>):2026-11-18 逐类核查结论,当前跟踪文件均为运行必需、构建约定、规则依据或在制验收材料,没有可安全删除项;后续可解耦项已单列。
 
 本次仅做静态核查;尚未进行 build/debug 验证、提交或推送。历史 Git 对象没有被改写,历史仓库体积不会因工作树删文件自动缩小。

+ 52 - 0
docs/cockpit-repo-slimming-boundary.md

@@ -0,0 +1,52 @@
+---
+status: accepted
+---
+
+# 驾驶舱仓库跟踪文件瘦身边界
+
+## 结论
+
+2026-11-18 对跟踪文件(415 项)逐类核查后,**当前 Git 端没有可安全删除的文件**。11 月 6 日那轮瘦身已移除上游示例插件、预览资产与离线加工工具;剩余跟踪文件全部属于运行必需、构建约定、规则依据或仍在推进的验收材料。
+
+这不是"没检查",而是下面每类都有**正向引用证据**;继续删会破坏构建、运行时、部署或项目规则。
+
+## 各类判定与依据
+
+| 类别 | 数量 | 判定 | 依据 |
+| --- | ---: | --- | --- |
+| `src/modules/cockpit/**` | 212 | 保留 | 驾驶舱全部业务代码,页面与服务层入口 |
+| `src/common/**` | 4 | 保留 | 四个构建插件全部注册在 [.fes.js](<../.fes.js>) 的 `viteOption.plugins`:Cesium 静态包拷贝、本机 GIS 挂载、公共资源白名单、生产配置生成 |
+| `src/app.jsx`、`src/global.less` | 2 | 保留 | FES 运行时约定入口:`app.jsx` 提供 `defineRuntimeConfig` 并注册 Pinia;`global.less` 为全局样式 |
+| `src/pages/**` | 2 | 保留 | `.fes.js` 路由表直接引用 |
+| `public/cockpit/**` | 121 | 保留 | [公共资源白名单](<../src/common/cockpitStaticPlugin.js>) 按 `cockpit/assets`、`cockpit/models`、`cockpit/aerial.webp` 复制进产物;含 UI 图标字体、管件 glTF/bin、Cesium 静态包 |
+| `public/jessibuca/**` | 4 | 保留 | [VideoPlayer.vue](<../src/modules/cockpit/components/VideoPlayer.vue#L22-L35>) 在缺少全局 `Jessibuca` 时动态注入该脚本作为 FLV 回退播放 |
+| `public/logo.png`、`public/.nojekyll` | 2 | 保留 | `index.html` 的 favicon 指向 `./logo.png`;`.nojekyll` 属静态托管约定 |
+| `tests/cockpit-video/**` | 8 | 保留 | 被[视频生命周期验收](<cockpit-video-lifecycle-acceptance.md>)与[视频监控验收](<cockpit-video-monitoring-acceptance.md>)直接引用为回归入口 |
+| `openspec/**` | 8 | 保留 | [领域约定](<agents/domain.md>)将 `openspec/specs` 与 `skills` 定为本地规格与工作流基线 |
+| `skills/tvt-js-plugin-builder/**` | 6 | 保留 | [项目规则](<../AGENTS.md>)声明 `skills/` 为本项目 Project Skills 根目录 |
+| `docs/agents/**`、`docs/adr/**` | 13 | 保留 | 票据格式、分流标签、领域术语与九项架构决策的规范来源,被 AGENTS.md 与技能引用 |
+| `docs/superpowers/specs/**` | 1 | 保留 | 驾驶舱原始需求规格,是 ADR 0001–0009 的上游依据 |
+| `docs/cockpit-*.md`(部署、环境、瘦身) | 3 | 保留 | [README](<../README.md>)与部署手册互相引用,是三份交付说明 |
+| `docs/cockpit-video-*.md`、`cockpit-device-detail-acceptance.md` | 5 | 保留 | 记录**尚未关闭**的 02/03 视频票据与播放器许可来源问题,属在制材料而非废弃草稿 |
+| `deploy/**` | 2 | 保留 | 生产地图模板与模型独立交付清单,构建与部署直接读取 |
+| `patches/**` | 1 | 保留 | [package.json](<../package.json>) 的 `postinstall` 执行 `patch-package`,该补丁修复 FES 路由 |
+| 根配置文件(`.env*`、`index.html`、`yarn.lock`、`package.json`、`.fes.js`、`tsconfig.json` 等) | 15 | 保留 | 构建、路由、环境与依赖闭包 |
+
+## 明确不做的删除
+
+- 不删 `public/jessibuca/`:它是 FLV 回退播放的运行时依赖,不是遗留样例。
+- 不删 `tests/`:视频验收文档以其为回归入口。
+- 不删 `openspec/` 与 `skills/`:项目规则显式依赖,删除会直接破坏技能可用性。
+- 不删 `docs/`:过程类文档已被 11 月 6 日那轮清理过一轮;现存文档均有引用或对应未关闭票据。
+
+## 后续可另立票的优化
+
+以下属于代码结构改进,不在 Git 端瘦身范围,应另开实施票并保留回退:
+
+- `src/modules/cockpit/services` 中体积较大的编排类可评估拆分纯函数与副作用边界。
+- `VideoPlayer.vue` 可评估将播放器适配与 UI 呈现解耦,避免组件内同时承担会话与渲染。
+- 生产无耦合的加工/验证脚本已由 [.gitignore](<../.gitignore>) 隔离在工作树外,若需进一步减少检出体积,可评估单独的工具仓或发布包。
+
+## 边界声明
+
+本轮为只读核查加一次推送准备,未删除任何跟踪文件,未改业务代码,未执行 build、依赖安装、测试、服务器或浏览器验证。历史 Git 对象体积不受影响;需要小体积检出应使用浅克隆或部分克隆,历史清理需另行决定,不得擅自重写。