40 KiB
C2 — 前端代码精简空间
审计范围(实际 Read 过的文件):
frontend/package.json、frontend/tsconfig.json、frontend/env.d.tsfrontend/plugin-page/vite.config.ts、frontend/plugin-page/src/App.vue、frontend/plugin-page/src/main.tsfrontend/standalone-web/vite.config.ts、frontend/standalone-web/src/main.tsfrontend/standalone-web/src/App.vue(22563 行,逐段抽样通读 + 全量脚本分析)frontend/standalone-web/src/styles/workbench.css、styles/tokens.cssfrontend/standalone-web/src/components/{ConfirmDialog,ImagePreviewDialog,MaterialCategoryCreateDialog,MaterialDetailDialog,EmptyState,StateCard,MetricCardGrid}.vuefrontend/standalone-web/src/features/workflow/{WorkflowCompareDialog,WorkflowGenerationReviewDialog,WorkflowBranchPanel,WorkflowRoundPanel}.vuefrontend/standalone-web/src/features/profiles/{ProfileDetailPane,ProfileMasterPane,ProfileWardrobePane,ProfilesPage}.vuefrontend/standalone-web/src/features/gallery/GalleryPage.vuefrontend/standalone-web/src/features/materials/AdvancedMaterialImportPage.vuefrontend/standalone-web/src/features/settings/{SettingsPage,BackupPage}.vuefrontend/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<Transition name>派生类、动态:class绑定)中都无法被引用到。逐条核实后,App.vue 内由纯死类构成的完整规则块合计 277 行;另有 136 行是子组件已有scoped副本的重复定义。 -
代码(真实片段,App.vue:21129-21145):
.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这一整组类在整个前端模板中零出现(generateFeatureCardscomputed 仍在,但渲染它的模板早已改用quick-profile-command-card)。同样死掉的还有 App.vue:17764-17787:
.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这种名字极具迷惑性)。 -
修复建议:
- 把我这次的可达性扫描固化成一个
frontend/tests/dead-css.test.mjs(项目已有node --test tests/*.test.mjs的契约测试习惯),断言"App.vue 样式块内的类必须能在某个模板中被引用",白名单里放Transition派生类与动态拼接类。 - 直接删除上述行区间。删除时注意保留
.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):
对照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:
两处的魔数也各写一遍: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.2vsMIN_SCALE/MAX_SCALE/WHEEL_STEP/DOUBLE_CLICK_SCALE。 - 影响:约 164 行冗余;更糟的是缩放行为会漂移——改
ImagePreviewDialog的手感不会同步到 quick-profile 查看器。 - 修复建议:抽
standalone-web/src/composables/useImageZoomPan.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 查看器直接复用<ImagePreviewDialog>(模板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 处)、一句文案取消这个素材参考→默认不注入这个参考、多一条<small v-if="reference.advanced">。其余包括分组 tab、TransitionGroup、"不使用"选项、缩略图渲染全部一致。 - 代码(App.vue:12021-12042 与 12672-12693 完全同构):
<header class="quick-profile-material-picker-header"> <div> <span>{{ material.category }}参考</span> <strong>选择素材</strong> </div> <small>{{ activeQuickProfileMaterialPickerCountLabel }}</small> </header> <div v-if="material.category === QUICK_PROFILE_ACCESSORY_CATEGORY" class="quick-profile-material-picker-groups" aria-label="配饰分类" > <button v-for="group in quickProfileAccessoryGroups" :key="group" type="button" :class="{ active: activeQuickProfileMaterialAccessoryGroup === group }" @click="setQuickProfileAccessoryGroup(group)" > {{ group }} </button> </div> - 影响:约 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-40vsConfirmDialog.vue:42-47):// WorkflowCompareDialog.vue function focusableElements() { return Array.from( dialogRef.value?.querySelectorAll<HTMLElement>( 'button:not([disabled]), [href], [tabindex]:not([tabindex="-1"])', ) ?? [], ) }// ConfirmDialog.vue function focusableElements() { return Array.from( dialogRef.value?.querySelectorAll<HTMLElement>( '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:
项目已有export function useDialogFocusTrap(open: Ref<boolean>, opts: { dialogRef: Ref<HTMLElement | null> 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开头片段):
对照.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模板实际使用的类:<div class="page"> <section class="hero"><b>↕</b>...</section> <div class="cards"><article>...</article></div> - 影响:约 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(整个文件没有<style>)、components/MaterialCategoryCreateDialog.vue(没有<style>)、components/MaterialDetailDialog.vue(只有 4 行<style scoped>) - 问题:静态分析发现 31 个类在 App.vue 的全局
<style>中定义、但只被子组件模板使用。分成两类:- 隐式依赖(691 行):
AppNavigationRail的rail / brand / brand-mark / brand-copy / icon-nav / nav-scroll / nav-group / nav-group-label / nav-group-items / nav-glyph / nav-copy / nav-label / rail-pin / rail-pin-label共 347 行;MaterialCategoryCreateDialog的 4 个类共 173 行;MaterialDetailDialog的materials-detail-card*共 171 行。这些组件离开 App.vue 就没有样式。 - 纯重复(136 行):
image-viewer-card/-actions/-stage(104 行,见上一条)、state-card/empty-state-actions/workflow-chat-panel/workflow-composer-panel(32 行),子组件已有等价scoped副本。
- 隐式依赖(691 行):
- 代码(
components/AppNavigationRail.vue全文 97 行,无<style>块;其模板):
样式却在<aside :class="['rail', { pinned, visible }]" ...> <div class="brand"><span class="brand-mark">IS</span><div class="brand-copy">...</div></div> <nav class="icon-nav">...App.vue全局块里。 - 影响:组件不自洽,无法单独测试/复用;App.vue 样式块虚胖 691 行;136 行是纯冗余可直接删。
- 修复建议:把 347/173/171 三组规则分别剪切进
AppNavigationRail.vue、MaterialCategoryCreateDialog.vue、MaterialDetailDialog.vue的<style scoped>(.rail这类需要父级配合的定位规则用:deep()或保留在workbench.css);136 行重复的直接删。App.vue 样式块净减 827 行。
[P2-中等] 全局重复 CSS 声明块:上限 2251 行,保守可回收 800–1200 行
- 位置:
frontend/standalone-web/src/App.vue(8396 行样式)、features/gallery/GalleryPage.vue(916)、features/profiles/*.vue(1741)、features/workflow/*.vue(1516)等,全前端 CSS 共 14698 行 - 问题:扫描所有
.vue/.css的声明块(≥2 条声明),完全相同的声明体重复出现 —— 按(出现次数-1) × (声明数+2)计,冗余上限 2251 行。高频样本:overflow:hidden; text-overflow:ellipsis; white-space:nowrap—— 21 次color: var(--text-soft); font-size: 12px; font-weight: 800—— 21 次(其中 14 次在 App.vue 内且声明完全一致)display: grid; gap: 4px; min-width: 0—— 18 次height:100%; object-fit:cover; width:100%—— 14 次background: var(--primary); border-color: var(--primary); color: #ffffff—— 10 次
- 代码(App.vue 内 14 处完全相同的"眼眉标签"规则,各 5 行):
每处都是:App.vue:15423 .queue-hero span, .queue-board-panel header span, ... App.vue:15659 .queue-detail-panel dt App.vue:15810 .materials-hero span, .materials-library-panel header span, ... App.vue:16233 .materials-detail-card-preview span, ... App.vue:16358 .materials-category-create-card header span, ... App.vue:16612 .generate-hero span, .generate-section header span App.vue:16712 .image-preview-panel header span, .image-info-card header span, ... App.vue:16899 .image-info-card dt App.vue:17238 .image-viewer-card header span App.vue:19236 .quick-profile-detail-card-portrait span, ... App.vue:19427 .quick-profile-viewer-info header span, .quick-profile-viewer-info dt App.vue:19925 .quick-profile-profile-field span App.vue:20725 .external-profile-import-card > header span, ... App.vue:20959 .persona-questionnaire-card header span, ...
以及 6 个组件各自重复定义主按钮({ color: var(--text-soft); font-size: 12px; font-weight: 800; }GalleryPage.vue:473、AdvancedMaterialImportPage.vue:1791、ProfileDetailPane.vue:614、ProfilesPage.vue:236、ProfileWardrobePane.vue:501、WorkflowMaterialDrawer.vue:528):button.primary-button { border-color: var(--primary); color: #fff; background: var(--primary); } - 影响:约 10% 的 CSS 是复读;主色/字号改一次要改 20 处,
workbench.css的存在恰恰证明改不动——它是一层 458 行的"事后覆盖层",专门用超长选择器列表去覆盖 App.vue 的既有规则。 - 修复建议:
styles/tokens.css(当前仅 24 行)扩成真正的 token/utility 层:.u-truncate、.u-eyebrow、.u-stack-4、.u-cover-img、.u-btn-primary。- App.vue 内那 14 处合并成一条选择器列表规则(70 行 → 20 行)。
- 把
workbench.css的覆盖规则回填进各自的基础规则,删掉这一层(458 行可减到 150 行以内)。 workbench.css:431-451是同一个媒体查询写了两遍(第二遍只是加了.navigation-shell前缀提高优先级),可直接删掉 10 行:@media (max-width: 1360px) and (min-width: 901px) { .overview-strip { grid-template-columns: minmax(220px, 1.2fr) repeat(3, minmax(120px, 0.8fr)) minmax(200px, 0.9fr); gap: 10px; } .overview-strip > * { min-width: 0; } } @media (max-width: 1360px) and (min-width: 901px) { .navigation-shell .overview-strip { grid-template-columns: minmax(220px, 1.2fr) repeat(3, minmax(120px, 0.8fr)) minmax(200px, 0.9fr); gap: 10px; } .navigation-shell .overview-strip > * { min-width: 0; } }
[P2-中等] 25 个 loader 函数复读同一套 loading/error/try/catch/finally 样板
- 位置:
frontend/standalone-web/src/App.vue:4488(loadDashboard)、:4511(loadGalleryImages)、:4611(loadDailyCostUsage)、:4624(loadJobs)、:4638(loadLogs)、:4673(loadModelOptions)、:4700(loadSettingsPage)、:4787(loadMaterials)、:4864(loadBackendQuickProfiles)、:5010(loadProfileWardrobe)、:6872(loadWorkflowBranches)、:6894(loadWorkflowDependencyContext)、:7028(loadWorkflowRounds)、:7115(loadSelectedWorkflowNodeMaterials) 等 - 问题:App.vue 声明了 10 个
loadingXxxref + 25 个xxxErrorref + 5 个xxxBusyref(:869-892集中区 +:666-814分散区),每个 loader 手写同一套开关。全文件 82 处try {、76 处catch (err)。 - 代码(App.vue:4611-4622,与 4488/4624/4700/4787 结构完全一致):
async function loadDailyCostUsage() { loadingDailyCostUsage.value = true dailyCostUsageError.value = "" try { dailyCostUsage.value = await getJson<CostUsageSummary>(endpoints.costUsage, { days: 1 }) } catch (err) { dailyCostUsage.value = null dailyCostUsageError.value = `今日用量读取失败:${errorMessage(err)}` } finally { loadingDailyCostUsage.value = false } } - 影响:约 125 行纯样板 + 40 个平行 ref。样板本身还不一致:
loadModelOptions(:4673) 忘了try/finally,直接在末尾赋loadingModelOptions.value = false,请求抛错时 loading 会永久卡死;loadJobs(:4624) 的 error 清理带条件分支。 - 修复建议:抽
standalone-web/src/composables/useAsyncResource.ts:
25 个 loader 各缩到 1–3 行,40 个 ref 缩到 25 个解构,净省约 90–120 行,并顺手修掉export function useAsyncResource<T>(loader: () => Promise<T>, opts?: { initial?: T; errorPrefix?: string; onError?: (e: unknown) => void }) { const data = ref(opts?.initial), loading = ref(false), error = ref("") async function reload() { loading.value = true; error.value = "" try { data.value = await loader() } catch (e) { error.value = `${opts?.errorPrefix ?? ""}${errorMessage(e)}`; opts?.onError?.(e) } finally { loading.value = false } } return { data, loading, error, reload } }loadModelOptions的 loading 泄漏。
[P2-中等] pinia 与 vue-router 声明为依赖但整个代码库零引用;构建工具全部错放在 dependencies
- 位置:
frontend/package.json:15-23 - 问题:
实测"dependencies": { "@vitejs/plugin-vue": "^5.2.0", "pinia": "^2.3.0", "typescript": "^5.7.0", "vite": "^6.0.0", "vue": "^3.5.0", "vue-router": "^4.5.0", "vue-tsc": "^2.2.0" }, "devDependencies": {}grep -rn "pinia" --include=*.ts --include=*.vue frontend/{shared,standalone-web,plugin-page,tests}→ 0 命中;vue-router同样 0 命中。两者在node_modules里占 1.1 MB(pinia 407 K + vue-router 691 K)。 同时devDependencies为空,typescript(23 MB) /vite(2.7 MB) /vue-tsc/@vitejs/plugin-vue这些纯构建期工具全在dependencies。插件发布时只带预构建产物(web/、pages/imagestudio/),运行期完全不需要node_modules,所以严格说 7 个依赖全部应该是 devDependencies。 - 影响:
npm ci --omit=dev得不到任何东西(无法只装运行期依赖);任何基于dependencies的 SCA/许可证扫描会把 23 MB 的 TypeScript 编译器算作运行期依赖;pinia/vue-router 的存在会误导人以为项目有路由和 store,实际上导航是 App.vue 里的activeNavref(:5102 setActiveNav)+navigation-config.ts。 - 修复建议:
删除"dependencies": {}, "devDependencies": { "@vitejs/plugin-vue": "^5.2.0", "typescript": "^5.7.0", "vite": "^6.0.0", "vue": "^3.5.0", "vue-tsc": "^2.2.0" }pinia、vue-router,同步更新package-lock.json。
[P2-中等] App.vue 用 206 个 ref + 135 个 computed 的巨型局部状态树代替 store
- 位置:
frontend/standalone-web/src/App.vue:644-893(集中 ref 区)、:894-4296(computed 区)、:9834-9935(overlay 状态机) - 问题:统计 App.vue 顶层符号:206 个
ref、135 个computed、264 个function、101 个async function。整个文件只有 1 条区块注释(:903)。跨模块状态(bootstrap/permissions、素材库、角色档案、工作流轮次、队列)全部平铺在同一个 setup 作用域里,子组件靠 props 逐层透传 + emit 回传。 最典型的症状是 overlay 状态机被写成两条 12 分支的if链:// App.vue:9846-9894 function setOverlayOpen(key: ControlledOverlay, open: boolean) { if (key === "search") { searchFocused.value = open; searchPanelOpen.value = open } if (key === "palette") { showPalette.value = open } if (key === "notifications") { showNotificationPanel.value = open } if (key === "logs") { showLogPanel.value = open } if (key === "imageViewer") { showImageViewer.value = open; if (!open) { imageViewerDragging.value = false } } ... // 共 12 个分支 } // App.vue:9896-9931 function isOverlayOpen(key: ControlledOverlay) { if (key === "search") { return searchPanelOpen.value } ... // 共 11 个分支 return showLogPanel.value // ← 兜底返回 logs,新增 overlay 忘了加分支就会静默错判 } - 影响:85 行可被 25 行的注册表替代;更重要的是
isOverlayOpen的 fallback 是showLogPanel.value,新增一个ControlledOverlay而忘记加分支时不报错、行为诡异。整体上 App.vue 的状态树使得任何一个功能改动都要打开 22563 行的文件。 - 修复建议:
- 低成本、立刻可做:overlay 改注册表驱动 ——
省 40 行并消除 fallback 陷阱。const overlayRegistry: Record<ControlledOverlay, { isOpen(): boolean; setOpen(v: boolean): void }> = { search: { isOpen: () => searchPanelOpen.value, setOpen: (v) => { searchFocused.value = v; searchPanelOpen.value = v } }, ... } const isOverlayOpen = (k: ControlledOverlay) => overlayRegistry[k].isOpen() - 中成本:不必上 pinia。按 feature 抽 composable(
useWorkflowWorkspace()/useMaterialLibrary()/useQuickProfile()/useQueue()),每个返回自己的 state + actions,App.vue 只负责组装。这条路子和现有features/*/xxx-state.ts(如advanced-material-state.ts)的组织方式一致,迁移成本低于引入 store。 - 若坚持要 store,pinia 已在
package.json里但main.ts(4 行)从未createPinia(),需要先接入;考虑到本项目是嵌入式插件页、无 SSR、无跨路由状态共享需求,建议走 composable 路线并删掉 pinia。
- 低成本、立刻可做:overlay 改注册表驱动 ——
[P3-轻微] shared/types/workflow.ts 里 35 行类型是 workflow-material.ts 的过期副本
- 位置:
frontend/shared/types/workflow.ts:88-130与frontend/shared/types/workflow-material.ts:1-62 - 问题:
WorkflowMaterialNavigationContext在两个文件里逐字段完全相同地定义了两遍;workflow.ts的WorkflowNodeMaterialBindingDetail(:108-123) 与WorkflowNodeMaterialBindingSaveRequest(:125-130) 是workflow-material.ts的WorkflowNodeMaterialBindingsResult/WorkflowNodeMaterialBindingsSaveRequest的旧版本。全代码库检索显示WorkflowNodeMaterialBindingDetail、WorkflowNodeMaterialBindingSaveRequest、WorkflowTemporaryReference只在workflow.ts内部互相引用,无任何外部使用者(App.vue:129 导入的是workflow-material.ts那一版)。 - 代码:
// shared/types/workflow.ts:88-94 export interface WorkflowMaterialNavigationContext { workflow_id: string branch_name: string node_id: string round_id?: string | null return_view: string }// shared/types/workflow-material.ts:1-7 ← 一模一样 export interface WorkflowMaterialNavigationContext { workflow_id: string branch_name: string node_id: string round_id?: string | null return_view: string } - 影响:35 行死类型;两份定义如果后端字段变更时只改一份,类型检查会给出互相矛盾的结论。
- 修复建议:删除
workflow.ts:96-130(WorkflowTemporaryReference+ 两个绑定接口);workflow.ts:88-94改成export type { WorkflowMaterialNavigationContext } from "./workflow-material"(:82仍需引用它)。
[P3-轻微] 19 个导出符号无任何使用者
- 位置:
frontend/shared/types/integration.ts:1(整个文件 7 行只有DailyOutfitResult,零引用)、shared/api/client.ts(patchJson)、shared/types/advanced-material.ts(AdvancedMaterialImportListResult/AdvancedMaterialValidationAttemptListResult/AdvancedMaterialListResult/MaterialCatalogResult/AdvancedMaterialValidationAttemptRequest/AdvancedStyleConsensusRequest)、shared/types/logs.ts(EventStreamResult/LogBundle)、shared/types/storage.ts(StorageStatus/StorageMigrationPlan)、shared/types/ui.ts(UiAction)、shared/types/wardrobe.ts(WardrobeMatchResult)、shared/types/workflow-round.ts(WorkflowRoundNextRequest/WorkflowRoundConfirmRequest)、features/workflow/types.ts(WorkflowRoundKnownStatus) - 问题:全量扫描 93 个
.ts/.vue/.mjs源文件,这 19 个导出的标识符在整个代码库中只出现 1 次(即声明自身)。 - 代码(
shared/types/integration.ts全文):export interface DailyOutfitResult { matched: boolean selected_materials: Array<Record<string, unknown>> final_prompt: string job_id?: string | null fallback_used: boolean }App.vue:4566-4568手写了内联的事件流类型而不用EventStreamResult:const stream = await getJson<{ events: Array<{ event_id?: string; event_type?: string; data?: Record<string, unknown> }> }>(endpoints.eventStream, { limit: 20 }) - 影响:约 45 行死类型;
EventStreamResult这种"定义了但调用方手写内联类型"的情况还会导致后端字段变更时类型失去保护作用。 - 修复建议:删掉
integration.ts(整文件)与其余 18 个;App.vue:4566改用getJson<EventStreamResult>(...)而不是删EventStreamResult。删除前建议先跑npm run typecheck确认(该脚本已存在于package.json:12)。
[P3-轻微] errorMessage 在两处独立实现且行为不一致
- 位置:
frontend/standalone-web/src/App.vue:11354-11356与frontend/standalone-web/src/features/materials/AdvancedMaterialImportPage.vue:1354-1356 - 问题:
// App.vue:11354 function errorMessage(err: unknown) { return readableApiError(err) // 会识别 ApiClientError、区分预览模式、给中文可读文案 }
同一个// AdvancedMaterialImportPage.vue:1354 function errorMessage(err: unknown) { return err instanceof Error ? err.message || "请求失败" : String(err || "请求失败") }ApiClientError在主界面显示"后端未连接,当前为预览模式"之类的可读提示,在进阶素材页只会显示原始 message。AdvancedMaterialImportPage.vue:1350还独立重实现了normalizeStatus(shared/utils/presentation.ts:7已有同名导出)。 - 影响:行数很小(约 8 行),但错误提示体验不一致,属于"共享工具没被共享"的信号。
- 修复建议:把
readableApiError/backendWriteBlockMessage(App.vue:4356-4387)下沉到shared/utils/api-error.ts,两处都导入;AdvancedMaterialImportPage.vue:1350的normalizeStatus改为从shared/utils/presentation导入。
[P3-轻微] tsconfig.json 的 @shared/* 路径别名无人使用,且 Vite 侧没有对应 alias
- 位置:
frontend/tsconfig.json:15-17、frontend/plugin-page/vite.config.ts、frontend/standalone-web/vite.config.ts - 问题:
全代码库检索"baseUrl": ".", "paths": { "@shared/*": ["shared/*"] }@shared/→ 0 命中。所有引用走的是相对路径,App.vue 里是"../../shared/api/endpoints",features/settings/BackupPage.vue:3甚至写到"../../../../shared/api/client"。而且两个vite.config.ts都没有配resolve.alias,即便有人开始用@shared/,vue-tsc能过、vite build会失败。 - 代码(
BackupPage.vue:3-5):import { getJson, postJson } from "../../../../shared/api/client" import { endpoints } from "../../../../shared/api/endpoints" import type { DiffSettingsResult, ... } from "../../../../shared/types/settings" - 影响:配置死代码 + 潜在的"类型检查通过但构建失败"陷阱;
../../../../这种路径也让文件移动变得昂贵。 - 修复建议:二选一 —— 要么删掉
tsconfig.json的paths/baseUrl;要么在两个vite.config.ts补上
并把全部resolve: { alias: { "@shared": resolve(rootDir, "../../shared") } }../../shared/../../../../shared批量替换为@shared(约 60 处 import)。推荐后者。
[P3-轻微] App.vue 内出现压缩风格代码,与文件其余部分格式冲突
- 位置:
frontend/standalone-web/src/App.vue:4549-4559;同样风格见components/MaterialDetailDialog.vue:34-58、features/settings/BackupPage.vue:14-25、features/settings/ReviewPolicyPanel.vue:14 - 问题:同一文件里既有 Prettier 风格的展开代码,又有手工压行的代码:
async function expandImageGenerationPrompt() { const prompt=imageGenerationPrompt.value.trim() if(!prompt||promptExpansionBusy.value)return promptExpansionBusy.value=true try{ const result=await postJson<{selected_prompt?:string;translation?:{translated_text?:string;status?:string;error?:string}}>(endpoints.promptGovernancePreview,{prompt,entrypoint:"web",translation_consent:true,selection:"translated",model_route:selectedImageModelRoute()}) const expanded=String(result.selected_prompt||result.translation?.translated_text||"").trim() if(!expanded||result.translation?.status==="unavailable_fallback"||result.translation?.status==="failed_fallback")throw new Error(result.translation?.error||"未找到可用的提示词扩写模型") imageGenerationPrompt.value=expanded }catch(err){imageGenerationError.value=`提示词扩写失败:${errorMessage(err)}`}finally{promptExpansionBusy.value=false} }ReviewPolicyPanel.vue:14更极端:整个<style scoped>是一行 1000+ 字符。 - 影响:行数统计失真(压行让"精简"的账面收益被掩盖)、
git diff一行全红/全绿无法审查、无法用 lint 自动格式化。 - 修复建议:引入 Prettier(配
printWidth: 110,与现有多数代码一致)并加一个npm run format:check到 CI。展开后 CSS/TS 总行数会上升约 800 行,但这是把隐藏的复杂度显性化,后续所有重复检测/删除都会更可靠。
量化汇总
A. 净删除空间(可直接减少的行数)
| # | 项目 | 位置 | 预计削减 |
|---|---|---|---|
| 1 | App.vue 死 CSS 规则(41 条,纯死类构成) | App.vue:17323 / 17764-17845 / 19007-19059 / 20075-20101 / 21129-21286 / 21484-21499 / 21662-21703 | 277 |
| 2 | .image-viewer-card/-actions/-stage 与子组件 scoped 重复 |
App.vue:17213-17316 | 104 |
| 3 | state-card/empty-state-actions/workflow-chat-panel/workflow-composer-panel 与子组件 scoped 重复 |
App.vue 样式块 | 32 |
| 4 | SettingsPage.vue 遗留 .backup-* 死样式 |
SettingsPage.vue:165,167 | 45(1 物理行) |
| 5 | workbench.css 重复媒体查询 |
workbench.css:442-451 | 10 |
| 6 | 素材选择器弹层模板重复 | App.vue:12009-12117 / 12658-12769 | 100 |
| 7 | 4 份焦点陷阱 → composable | ConfirmDialog / ImagePreviewDialog / WorkflowCompareDialog / WorkflowGenerationReviewDialog | 130 |
| 8 | 图片缩放/拖拽逻辑重复 → composable | App.vue:7952-8011 + 12218-12266 | 95 |
| 9 | App.vue 内 14 处相同"眼眉"规则等,选择器列表合并 | App.vue(14 处,各 5 行) | 50 |
| 10 | 跨组件重复声明块(truncate / cover-img / primary-button / grid-gap 等)→ utility class | 全前端 CSS 14698 行 | 700–1100(上限 2251) |
| 11 | 25 个 loader 样板 → useAsyncResource |
App.vue:4488-7185 各 loader | 90 |
| 12 | setOverlayOpen/isOverlayOpen 表驱动 |
App.vue:9846-9931 | 40 |
| 13 | shared/types/workflow.ts 过期类型副本 |
workflow.ts:96-130 | 35 |
| 14 | 19 个零引用导出(含 integration.ts 整文件) |
shared/types/*、shared/api/client.ts | 45 |
| 15 | errorMessage/normalizeStatus 重复实现 |
App.vue:11354 / AdvancedMaterialImportPage.vue:1350-1356 | 8 |
| 16 | tsconfig.json 死别名配置 |
tsconfig.json:15-17 | 4 |
| 17 | pinia + vue-router 依赖(源码 0 行,node_modules 1.1 MB) |
package.json:17,21 | 2 行 / 1.1 MB |
| 合计 | 约 1770–2170 行(取中值 ≈ 1970 行) |
占前端源码 40182 行的 4.9%,占 CSS 14698 行的 约 13%。
B. 迁移拆分空间(不减总量,但把 App.vue 从 22563 压到 6000–7000)
| 目标 | 当前位置 | 迁出行数 |
|---|---|---|
styles/quick-profile.css |
App.vue 样式块 quick-profile-* |
1268 |
styles/workflow.css |
workflow-*(node/profile/persona/prompt/draft/material/subnode/preview/action/group/section/generation) |
~1400 |
styles/materials.css |
materials-* |
~600 |
styles/image-workspace.css |
image-* (composer/preview/info/stage) |
~400 |
剪进 AppNavigationRail.vue |
App.vue 的 rail/brand/nav-* 规则 |
347 |
剪进 MaterialCategoryCreateDialog.vue / MaterialDetailDialog.vue |
App.vue 的对应规则 | 344 |
features/workflow/WorkflowStages.vue(×6 stage 子组件) |
App.vue:12440-12772、12842-12988 | ~530 |
features/quick-profile/QuickProfileWorkspace.vue |
App.vue:11809-12268 | ~460 |
features/image/ImageGenerateWorkspace.vue |
App.vue:11648-11807 | ~160 |
features/quick-profile/ExternalProfileImportDialog.vue |
App.vue:12988-13075 | ~88 |
features/quick-profile/PersonaQuestionnaireDialog.vue |
App.vue:13077-13329 | ~252 |
features/workflow/workflow-action-cards.ts |
App.vue:2782-3222(441 行)+ 标签表 3223-3282 | ~500 |
features/*/action-cards.ts(generate/queue/material/quickProfile) |
App.vue:3751-3921、3370-3512、1346-1458、1931-2041 | ~580 |
features/quick-profile/quick-character-generation.ts |
App.vue:5786-6077 | 292 |
| 合计迁出 | ≈ 7200 行 |
拆分后 App.vue 预计:脚本 ~3500 行 + 模板 ~350 行 + 样式 <300 行 ≈ 4200 行。
C. 无精简空间的项(已核实)
plugin-pagevsstandalone-web重复:0 行。plugin-page/src/App.vue仅 7 行(import WorkbenchApp from "../../standalone-web/src/App.vue"),plugin-page/src/main.ts6 行,两个vite.config.ts各 16 行且只有base/outDir不同。这套双构建方案已经是最优解,不要动。- 未被引用的组件:无。
standalone-web/src/components/与features/下 25 个.vue全部有引用者(WorkflowCompareDialog等 7 个走defineAsyncComponent,App.vue:39-45)。 - 仓库卫生:
frontend/node_modules、frontend/.pytest_cache均未被 git 跟踪(git ls-files0 命中),无需清理。
D. 建议执行顺序(按 收益/风险 比)
- 零风险,立刻做(约 550 行):#4
SettingsPage.vue:165、#5workbench.css:442-451、#13workflow.ts:96-130、#14 19 个死导出、#16 tsconfig 别名、#17 删 pinia/vue-router + 依赖分类。跑npm run typecheck+npm run test:contracts验证。 - 低风险,需视觉回归(约 460 行):#1/#2/#3 死 CSS 删除。建议先加
tests/dead-css.test.mjs把规则固化,再删。 - 中风险,需功能验证(约 465 行):#6 素材选择器组件化、#7 focus trap composable、#8 图片查看器复用。这三项都触及交互,建议逐项 PR。
- 大工程(#10 CSS utility 层 + B 表全部迁移):建议先做 #10 的 token/utility 层(它是所有后续 CSS 迁移的前置),再按 feature 逐个迁样式和模板。