用途:在把生成或自然演进的前端 UI 重构为共享组件之前使用,目标不是“全部去重”,而是选择能保留产品语义、设计还原、可访问性契约与可测试性的复用边界。
证据分级:T1 安全抽取候选,需两处以上具体源码位置、相同用户可见语义、相同可访问性角色/名称/状态契约、相同设计变体轴与定向回归测试路径;T2 可能候选,仅剩一个契约维度待确认;T3 仅疑似坏味道,源码位置或契约未确认,暂不改动;T4 阻塞,缺少源码、设计权威、仅有打包产物、无安全测试路径或需产品/API 决策。只有 T1 才执行重构,T2/T3 转为带缺失证据的清理计划或 TODO。
工作流:先冻结契约,列出组件名/文件、调用上下文、用户可见用途、设计与 token 权威、可访问性角色/名称/状态、文案/i18n 归属、数据形状、加载/错误/空状态与响应式断点;再查找候选簇,基于重复 JSX/模板/SFC 结构、props/事件名、插槽、class token、复制的处理器与映射逻辑等证据;若框架扫描器已安装或被允许(如 React:react-unify scan <src>、duplicalis scan),仅作线索,保持只读或 --propose,不自动应用,不为检查新增依赖;按 prop-parameterizable、slot-composition、thin-wrapper、logic-reuse、style-token、false-friend 分类;按决策矩阵选择抽取共享组件、共享原语加包装、行为助手、token/class 抽取或保持独立;锁定行为,添加最小回归测试。
限制:复用逻辑的助手不得引入展示细节;视觉相似但可访问性契约、语义、状态或生命周期不同者不可合并;布尔陷阱、同时接受领域数据与展示逃生舱、首个补丁即全仓库改名等均属红旗。仅凭名称、截图或扫描分数不足以实施,需至少两处具体源码且契约一致;缺失事实暂未提供。