cockpit-repo-slimming-boundary.md 4.4 KB


status: accepted

驾驶舱仓库跟踪文件瘦身边界

结论

2026-11-18 对跟踪文件(415 项)逐类核查后,当前 Git 端没有可安全删除的文件。11 月 6 日那轮瘦身已移除上游示例插件、预览资产与离线加工工具;剩余跟踪文件全部属于运行必需、构建约定、规则依据或仍在推进的验收材料。

这不是"没检查",而是下面每类都有正向引用证据;继续删会破坏构建、运行时、部署或项目规则。

各类判定与依据

类别 数量 判定 依据
src/modules/cockpit/** 212 保留 驾驶舱全部业务代码,页面与服务层入口
src/common/** 4 保留 四个构建插件全部注册在 .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 保留 公共资源白名单 按 cockpit/assets、cockpit/models、cockpit/aerial.webp 复制进产物;含 UI 图标字体、管件 glTF/bin、Cesium 静态包
public/jessibuca/** 4 保留 VideoPlayer.vue 在缺少全局 Jessibuca 时动态注入该脚本作为 FLV 回退播放
public/logo.png、public/.nojekyll 2 保留 index.html 的 favicon 指向 ./logo.png;.nojekyll 属静态托管约定
tests/cockpit-video/** 8 保留 被视频生命周期验收与视频监控验收直接引用为回归入口
openspec/** 8 保留 领域约定将 openspec/specs 与 skills 定为本地规格与工作流基线
skills/tvt-js-plugin-builder/** 6 保留 项目规则声明 skills/ 为本项目 Project Skills 根目录
docs/agents/**、docs/adr/** 13 保留 票据格式、分流标签、领域术语与九项架构决策的规范来源,被 AGENTS.md 与技能引用
docs/superpowers/specs/** 1 保留 驾驶舱原始需求规格,是 ADR 0001–0009 的上游依据
docs/cockpit-*.md(部署、环境、瘦身) 3 保留 README与部署手册互相引用,是三份交付说明
docs/cockpit-video-*.md、cockpit-device-detail-acceptance.md 5 保留 记录尚未关闭的 02/03 视频票据与播放器许可来源问题,属在制材料而非废弃草稿
deploy/** 2 保留 生产地图模板与模型独立交付清单,构建与部署直接读取
patches/** 1 保留 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 隔离在工作树外,若需进一步减少检出体积,可评估单独的工具仓或发布包。

边界声明

本轮为只读核查加一次推送准备,未删除任何跟踪文件,未改业务代码,未执行 build、依赖安装、测试、服务器或浏览器验证。历史 Git 对象体积不受影响;需要小体积检出应使用浅克隆或部分克隆,历史清理需另行决定,不得擅自重写。