增量质检报告：dzs-admin v1.0.101 → v1.0.102

一、结论摘要

• 本次变更聚焦「表格行操作按钮组紧凑化」：新增 RowActions 组件 + 全站 CSS 规则、改造文章列表与未发布稿工作台两页的行操作与列宽，并配套规则文档与只读 e2e 断言；附带修复 spec 30 的既有测试假红。
• 版本对比（codescan.issues_diff 真实数据）：修复 1 条 / 新增 3 条，全部为 Low/Medium 的可维护性与耦合类，无 Critical / High / Security 新增。
• 未发现功能性回归：两页操作列宽度重算自洽（已独立复核，见 §六）；核对了「单行最多按钮数」与列宽上限，scroll.x ≥ 各列宽度之和 成立。
• 主要遗留：全站约 39 条含固定操作列的路由尚未改造（本批仅两页），文档口径存在一处轻微不一致（见 §七）。

---

二、版本与变更范围

变更文件清单（10 个）

---

三、修复的问题（codescan.issues_diff 真实数据）

该修复即本批的 spec 30 假红治理：把重复的路径处理逻辑抽为 liveE2ePath()，将 e2ePath 中写死的 [id]（如 /admin/articles/1/edit，而库内最小 id 为 577，物理不存在 → 编辑页取数失败 router.push 回列表 → 顶条标题退化为菜单名）替换为「当前真实存在的一篇」，消除时序性偶发假红。

---

四、新增的问题（codescan.issues_diff 真实数据）

三条新增项均为测试代码的可维护性/耦合类问题，不影响产品运行时；无 Critical / High / Security 新增。

---

五、变更详解

5.1 前端

• RowActions.tsx：封装 Space.Compact size="small" className="row-actions"，作为表格行操作的统一入口；文件头写明宽度实测口径（带图标按钮 60px = 1 边框 + 7 内边距 + 14 图标 + 2px 图标↔文字 + 文字 28px + 7 内边距 + 1 边框；相邻按钮边框重叠 −1px）。
• globals.css：.row-actions .ant-btn { gap: 2px }，专门把行操作按钮的图标↔文字间距从 antd 默认 8px 收到 2px；选择器限定在 .row-actions 下，不影响全站其他按钮。两个类的选择器（0,2,0）优先级高于 antd 的 :where(.css-hash).ant-btn（0,1,0），可稳定覆盖。
• 两页列宽重算：按钮 type="link"→"default"（link 边框透明，连起来看不到分隔线）、外层 Space→RowActions；操作列与 scroll.x 同步收缩。

5.2 测试

• e2e/fixtures/row-actions.ts（只读）：量取「按钮最多」行的操作列几何，断言四类回归：①命中 .row-actions 紧凑容器；②相邻按钮间隙 ≤ 0.5；③按钮 column-gap === '2px'；④内容不溢出（scrollWidth ≤ clientWidth + 1）且末按钮在表格右边界内。定位上兼容 antd 6（.ant-drawer-section 等类名变化）。
• 52-* / 53-*：各新增一条 1820 宽下的布局断言，覆盖文章列表与工作台。

5.3 既有假红修复（见 §三）

• 仅测试侧改动，未改产品行为（「文章不存在时静默跳回列表」这一行为本身保留待产品决策）。

5.4 文档

• rules/frontend.md：更新「表格列宽纪律」（按钮宽度按实测口径算），「文章列表操作列宽度」补重算，新增「行操作紧凑相连按钮组」章节（强制口径 + 按钮宽度实测表 + 禁止事项 + 适用范围）。

---

六、独立复核（列宽自洽性，直接读 head 源码复核）

复核以 git diff 与 head 源码为准。注意：子任务的 file_research 读取返回了旧版本内容（操作列仍为 320/260），与 head diff（290/280）不符，故下表以直接源码核对为准。

「单行最多按钮数」核对（结合 canDeleteArticle：删除仅 draft/qa_failed（未发布）或 offline 可显）：

• 结论：最大 4 个按钮，不存在「5 个按钮」场景（下架需 published、删除需 offline，互斥）。head 已把旧注释「最多 5 个」更正为「最多 4 个」，正确。
• 由此排除了「列宽收窄（320→290 / 260→280 中的工作台是放宽）导致按钮顶出」的风险：两页均有 ≥ 9px 余量，且 e2e 已加防回归断言。

---

七、风险与待办

1. 改造面有限：全站约 39 条含固定操作列的路由仍是 type="link" 平铺，规则要求「由各自批次推进」，届时需同步该页按钮宽度、操作列宽度与 scroll.x。
2. 图标间距只作用于行操作组：全站其他按钮仍为 8px，属刻意范围控制，非缺陷。
3. 文档口径轻微不一致（建议顺手修正）：
   • RowActions.tsx JSDoc 写「无图标按钮…2 个汉字 44px」，而 rules/frontend.md 与实施报告已按实测订正为 ≈48px（47.8px）；组件注释未同步。
   • articles/page.tsx 旧注释把「撤回」列为「带图标」按钮，实际「撤回」无图标（2 汉字 ≈48px）。
   • 以上均为注释级瑕疵，不影响运行与断言（断言按实测 DOM，不依赖注释数值）。
4. 发布态：据实施报告，本批改动当时「未提交、未发版」；请以实际发布的 tag/CI 结果为准。
5. 测试侧遗留：45-* 布局断言属自建/清理夹具的写库用例，日常只读回归可不跑；新增 3 条低级别可维护性问题可在后续测试重构时一并收敛。

---

总体评价：本次为一次低风险的表层 UI 紧凑化 + 文档/e2e 配套变更，产品逻辑无改动，列宽与按钮数经独立复核自洽，防回归断言到位；质检对比仅引入 1 条 Medium、2 条 Low 的测试代码可维护性项，无阻断性风险，可随版本发布。