# C2 — 前端代码精简空间 > 审计范围(实际 Read 过的文件): > - `frontend/package.json`、`frontend/tsconfig.json`、`frontend/env.d.ts` > - `frontend/plugin-page/vite.config.ts`、`frontend/plugin-page/src/App.vue`、`frontend/plugin-page/src/main.ts` > - `frontend/standalone-web/vite.config.ts`、`frontend/standalone-web/src/main.ts` > - `frontend/standalone-web/src/App.vue`(22563 行,逐段抽样通读 + 全量脚本分析) > - `frontend/standalone-web/src/styles/workbench.css`、`styles/tokens.css` > - `frontend/standalone-web/src/components/{ConfirmDialog,ImagePreviewDialog,MaterialCategoryCreateDialog,MaterialDetailDialog,EmptyState,StateCard,MetricCardGrid}.vue` > - `frontend/standalone-web/src/features/workflow/{WorkflowCompareDialog,WorkflowGenerationReviewDialog,WorkflowBranchPanel,WorkflowRoundPanel}.vue` > - `frontend/standalone-web/src/features/profiles/{ProfileDetailPane,ProfileMasterPane,ProfileWardrobePane,ProfilesPage}.vue` > - `frontend/standalone-web/src/features/gallery/GalleryPage.vue` > - `frontend/standalone-web/src/features/materials/AdvancedMaterialImportPage.vue` > - `frontend/standalone-web/src/features/settings/{SettingsPage,BackupPage}.vue` > - `frontend/shared/utils/{presentation,collections,storage-uri}.ts`、`frontend/shared/types/{workflow,workflow-material,integration}.ts` > > 全量静态分析脚本(自写,跑在真实源码树上):CSS 类引用可达性、CSS 声明块重复度、导出符号可达性、组件样式归属泄漏。 ## 摘要 前端源码 40182 行,其中 **CSS 占 14698 行(36.6%)**,`standalone-web/src/App.vue` 一个文件就占 22563 行(56%),其样式块 8396 行、模板块 2785 行、脚本块 11357 行,是典型的 god component。 **可确证的"净删除"空间约 1900–2000 行(≈ 全部前端源码的 5%,CSS 的 13%)**,主要来自:App.vue 内 413 行永远不会命中的死 CSS 规则、`SettingsPage.vue` 里一整段重构后遗留的 `.backup-*` 死样式、素材选择器弹层模板被逐字复制两份(109 行)、4 份几乎一字不差的焦点陷阱实现(130 行)、图片查看器缩放/拖拽逻辑与 `ImagePreviewDialog.vue` 完全重复(脚本 60 行 + 样式 104 行)、以及 2251 行上限的重复 CSS 声明块。 **"迁移拆分"空间约 6000 行**(不减总量但把 App.vue 压到 6000–7000 行):`quick-profile` 前缀样式 1268 行、`workflow-*` 约 1400 行、`materials-*` 约 600 行可直接切成 feature CSS 文件;`workflowActionCards`(441 行)/`generateFeatureCards`(171)/`queueActionCards`(143)/`materialActionCards`(113)/`quickProfileActionCards`(88) 五个卡片工厂 + 4 张标签映射表共约 1080 行是纯数据,应搬到独立模块。 **pinia 与 vue-router 声明了但整个代码库零引用**(`grep -rn "pinia\|vue-router"` 在 src 下 0 命中),App.vue 用 206 个 `ref` + 135 个 `computed` 的巨型局部状态树代替 store。**`devDependencies` 为空**,`typescript`/`vite`/`vue-tsc`/`@vitejs/plugin-vue` 全部错放在 `dependencies`。 **好消息**:`plugin-page` 与 `standalone-web` 两套构建之间**没有代码重复**——`plugin-page/src/App.vue` 只有 7 行、直接 re-export `standalone-web/src/App.vue`,两份 `vite.config.ts` 各 16 行仅 `base`/`outDir` 不同。这一项无精简空间。 --- ## 发现 ### [P2-中等] App.vue 样式块内 413 行 CSS 规则永远不会命中(死代码) - **位置**:`frontend/standalone-web/src/App.vue:17323`、`:17764-17845`、`:19007-19059`、`:20075-20101`、`:21129-21286`、`:21484-21499`、`:21662-21703`(共 41 条规则);另 `:17213-17316`、`:21491-21499` 等 - **问题**:全量扫描 903 个 CSS 类,其中 63 个在任何 `.vue` 模板/脚本(含 Vue `` 派生类、动态 `:class` 绑定)中都无法被引用到。逐条核实后,App.vue 内**由纯死类构成的完整规则块合计 277 行**;另有 136 行是子组件已有 `scoped` 副本的重复定义。 - **代码**(真实片段,App.vue:21129-21145): ```css .generate-status-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 12px; } .generate-status-grid article, .generate-feature-card { position: relative; overflow: hidden; display: grid; gap: 6px; border: 1px solid var(--border); border-radius: 12px; padding: 14px; background: var(--panel); box-shadow: var(--shadow); } ``` `generate-status-grid` / `generate-feature-card` / `generate-section` / `generate-card-grid` / `generate-card-top` / `feature-state` 这一整组类在整个前端模板中零出现(`generateFeatureCards` computed 仍在,但渲染它的模板早已改用 `quick-profile-command-card`)。 同样死掉的还有 App.vue:17764-17787: ```css .workflow-node-card { position: relative; display: grid; grid-template-columns: 26px minmax(0, 1fr); align-items: start; gap: 10px; border: 1px solid var(--border); border-radius: 10px; padding: 11px; background: var(--panel-muted); } .workflow-node-card::after { position: absolute; left: 24px; top: 100%; width: 1px; height: 8px; background: var(--border); content: ""; } ``` 模板里节点卡实际用的是 `workflow-node-item`,`workflow-node-card` 从未出现。 - **影响**:约 413 行 CSS 每次构建都被打进 `web/assets/index-*.css` 与 `pages/imagestudio/assets/index-*.css` 两份产物;改样式时会误导人以为在改生效的规则(`.workflow-node-card` 这种名字极具迷惑性)。 - **修复建议**: 1. 把我这次的可达性扫描固化成一个 `frontend/tests/dead-css.test.mjs`(项目已有 `node --test tests/*.test.mjs` 的契约测试习惯),断言"App.vue 样式块内的类必须能在某个模板中被引用",白名单里放 `Transition` 派生类与动态拼接类。 2. 直接删除上述行区间。删除时注意保留 `.image-viewer-backdrop`(App.vue 模板里 4 个内联弹层仍在用),只删 `.image-viewer-card/-actions/-stage`。 --- ### [P2-中等] `.image-viewer-*` 的 104 行样式与 60 行缩放/拖拽逻辑在 App.vue 和 ImagePreviewDialog.vue 中各存在一份 - **位置**:`frontend/standalone-web/src/App.vue:17213-17316`(CSS)与 `frontend/standalone-web/src/components/ImagePreviewDialog.vue:221-324`(CSS,`scoped`);`App.vue:7952-8011`(脚本)与 `ImagePreviewDialog.vue:58-114`(脚本) - **问题**:两处 CSS **逐字节相同**(`diff` 除去尾部一条无关规则后无差异)。App.vue 侧那 104 行的使用者只有 `ImagePreviewDialog.vue` 的模板,而该组件自带 `scoped` 副本,所以 App.vue 的这份是纯冗余。脚本侧同理:同一套 MIN/MAX 缩放、指针捕获拖拽逻辑写了两遍,只是变量名从 `scale/offset/dragging` 改成 `imageViewerScale/imageViewerOffset/imageViewerDragging`。 - **代码**(App.vue:7982-8011): ```ts function startImageViewerDrag(event: PointerEvent) { if (imageViewerScale.value <= 1) return imageViewerDragging.value = true imageViewerDragStart.value = { pointerId: event.pointerId, x: event.clientX, y: event.clientY, offsetX: imageViewerOffset.value.x, offsetY: imageViewerOffset.value.y, } if (event.currentTarget instanceof HTMLElement) { event.currentTarget.setPointerCapture(event.pointerId) } } ``` 对照 `ImagePreviewDialog.vue:85-98`: ```ts function startDrag(event: PointerEvent) { if (scale.value <= 1) return dragging.value = true dragStart.value = { pointerId: event.pointerId, x: event.clientX, y: event.clientY, offsetX: offset.value.x, offsetY: offset.value.y, } if (event.currentTarget instanceof HTMLElement) { event.currentTarget.setPointerCapture(event.pointerId) } } ``` 两处的魔数也各写一遍:`0.5/4/0.12/2.2` vs `MIN_SCALE/MAX_SCALE/WHEEL_STEP/DOUBLE_CLICK_SCALE`。 - **影响**:约 164 行冗余;更糟的是缩放行为会漂移——改 `ImagePreviewDialog` 的手感不会同步到 quick-profile 查看器。 - **修复建议**:抽 `standalone-web/src/composables/useImageZoomPan.ts`: ```ts export function useImageZoomPan(opts?: { min?: number; max?: number }) { const scale = ref(1), offset = ref({ x: 0, y: 0 }), dragging = ref(false) // reset / zoom / zoomFromWheel / toggleZoom / startDrag / drag / endDrag return { scale, offset, dragging, transform, ...handlers } } ``` `ImagePreviewDialog.vue` 与 App.vue 的 quick-profile 查看器都用它;删掉 App.vue:17213-17316 的 CSS,让 quick-profile 查看器直接复用 ``(模板 `App.vue:12218-12266` 的 49 行也一并消失)。 --- ### [P2-中等] 素材选择器弹层模板被逐字复制两份(109 行) - **位置**:`frontend/standalone-web/src/App.vue:12009-12117`(quickProfile 模式)与 `App.vue:12658-12769`(workflow 模式) - **问题**:把两段去掉缩进后 `diff`,97 行中只有 5 行不同:`material.category` → `binding.category`(3 处)、一句文案 `取消这个素材参考` → `默认不注入这个参考`、多一条 ``。其余包括分组 tab、`TransitionGroup`、"不使用"选项、缩略图渲染全部一致。 - **代码**(App.vue:12021-12042 与 12672-12693 完全同构): ```html
{{ material.category }}参考 选择素材
{{ activeQuickProfileMaterialPickerCountLabel }}
``` - **影响**:约 109 行模板重复;两侧已经开始漂移(`reference.advanced` 的"进阶素材 · 高优先级"标记只有 workflow 侧有,quickProfile 侧看不到),这是双份维护必然的结果。 - **修复建议**:抽 `standalone-web/src/features/materials/MaterialPickerPopover.vue`,props 为 `{ category: string; placement?: 'up'|'down'; extraClass?: string }`,事件 `select` / `clear`。两处调用点各缩到 8 行左右,净省约 100 行,同时消除功能漂移。 --- ### [P2-中等] 4 份几乎一字不差的焦点陷阱(focus trap)实现 - **位置**:`frontend/standalone-web/src/components/ConfirmDialog.vue:30,42-83`、`components/ImagePreviewDialog.vue:27,116-151`、`features/workflow/WorkflowCompareDialog.vue:20,34-78`、`features/workflow/WorkflowGenerationReviewDialog.vue:53,149-205` - **问题**:每个弹窗组件都自己写了 `previousFocus` / `focusableElements()` / `trapFocus()`(或 `handleKeydown`) / `restoreFocus()` / `watch(() => props.open, ...)` 这一套约 45 行的样板。四份实现还不一致: - `ConfirmDialog` 与 `ImagePreviewDialog` 的选择器包含 `input/select/textarea`,`WorkflowCompareDialog` 只有 `'button:not([disabled]), [href], [tabindex]:not([tabindex="-1"])'` —— 对比弹窗里如果出现输入框,Tab 会跳出弹窗。 - `ConfirmDialog` 额外做了 `!dialogRef.value?.contains(active)` 的兜底,另外三份没有。 - **代码**(`WorkflowCompareDialog.vue:34-40` vs `ConfirmDialog.vue:42-47`): ```ts // WorkflowCompareDialog.vue function focusableElements() { return Array.from( dialogRef.value?.querySelectorAll( 'button:not([disabled]), [href], [tabindex]:not([tabindex="-1"])', ) ?? [], ) } ``` ```ts // ConfirmDialog.vue function focusableElements() { return Array.from( dialogRef.value?.querySelectorAll( 'button:not([disabled]), [href], input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])', ) ?? [], ).filter((element) => !element.hasAttribute("hidden")) } ``` - **影响**:约 180 行样板,抽成 composable 后剩约 50 行,净省 130 行;顺带统一无障碍行为,消除 `WorkflowCompareDialog` 的 Tab 逃逸。 - **修复建议**:新增 `standalone-web/src/composables/useDialogFocusTrap.ts`: ```ts export function useDialogFocusTrap(open: Ref, opts: { dialogRef: Ref initialFocus?: () => HTMLElement | null | undefined onEscape?: () => void }) { /* previousFocus / focusables / onKeydown / restore */ return { onKeydown } } ``` 项目已有 `safe-backdrop-close.ts` 这种单一职责工具模块的先例,放在同级即可。 --- ### [P2-中等] `SettingsPage.vue` 里遗留一整段 1796 字符的 `.backup-*` 死样式 - **位置**:`frontend/standalone-web/src/features/settings/SettingsPage.vue:165`(单物理行,1796 字符,格式化后约 45 行) - **问题**:备份面板早已拆成独立的 `features/settings/BackupPage.vue`,且该组件用的是自己的 `scoped` 类名(`.page` / `.hero` / `.cards` / `.full` / `.snapshots` / `.file` / `.list`)。`SettingsPage.vue` 的 `scoped` 样式里却仍保留着旧类名的全套定义,而 `SettingsPage.vue` 模板里这些类零出现——因为是 `scoped`,它们绝无可能作用到 `BackupPage.vue` 上。 - **代码**(`SettingsPage.vue:165` 开头片段): ```css .backup-page{display:grid;gap:15px}.backup-hero{display:flex;align-items:center;gap:13px;border:1px solid var(--border);border-radius:10px;padding:15px;background:linear-gradient(105deg,var(--primary-soft),var(--panel-muted))}.backup-hero>div:last-child{display:grid;gap:4px}.backup-hero p,.backup-grid p{color:var(--text-soft);font-size:12px;line-height:1.5}.backup-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:13px}... ``` 对照 `BackupPage.vue` 模板实际使用的类: ```html
↕...
...
``` - **影响**:约 1.8 KB / 45 逻辑行死样式;`SettingsPage.vue:167` 的媒体查询里还引用了 `.backup-grid` / `.backup-scope>div`,同样死。 - **修复建议**:删除 `SettingsPage.vue:165` 整行,以及 `:167` 媒体查询中的 `.backup-grid,.backup-scope>div` 选择器项。 --- ### [P2-中等] App.vue 全局样式里躺着 5 个已抽离组件的样式,其中 691 行属于"隐式全局依赖" - **位置**:`frontend/standalone-web/src/App.vue`(样式块);受影响组件 `components/AppNavigationRail.vue`(**整个文件没有 `