文档核对后的维护待办
状态:未完成 / 待决策。校对日期:2026-10-12。 本文从现行规范与遗留清单中集中登记维护事项;只核对代码和历史,不在本轮实施修复。 编辑器功能与验收见
docs/plan/editor-plan.md§7.2;格式转换器见docs/plan/format-converter-roadmap.md§16。
1. 前端样式整理
规则与风险说明保留在 docs/frontend-styles.md §5/§12。下表按当前代码区分已有重复、
潜在复用风险与可选清理,避免把「现在没有冲突」说成已复现故障。
| 事项 | 当前状态 | 处理范围与验收 |
|---|---|---|
| 剪贴板表单的页面外壳 | 待修:组件与页面都带 clipboard-page;新建页重复主标题 |
UploadForm.tsx 的外壳责任交还新建 / 编辑页面;验收两页仅一层容器、各有一个主标题,宽度与内距不重复 |
| OAuth 应用行的卡片外壳 | 待整理:ApplicationRow.tsx 与父 section 都带 management-card |
区分页面卡壳与行组件样式,连同嵌套卡片底色兜底核对;验收内距与底色,保留启停与复制操作 |
| 后台文章管理容器 | 结构性待办:当前由 AdminArticlesManager.tsx 提供 admin-container,尚未双重嵌套 |
将整页容器责任上提至 admin/blogs/page.tsx;当前几何不变,组件复用时不再带页面外壳 |
| 收款错误组件的外壳责任 | 可选整理:PayError.tsx 带整页 content-wrapper,当前 early-return 分支不冲突 |
有复用需求再分离外壳与内容;先核对 /fish/pay 与 /fish/collect 错误分支,遵守收银台 DOM 契约 |
.current-category 同名不同义与死规则 |
待整理:后台分类徽章与博客分类标签共享根级类,博客侧仍有 .badge 死规则 |
分开两个语义与选择器,清理死规则;核对徽章间距、未分类态及两套主题 |
正文 .copy-btn 的样式归属 |
待整理:博客根级规则与故事局部规则靠特异性覆盖 | 结合共享 DOM 后处理核对注入点,明确公共基础与场景差异;验收博客、剪贴板、故事及编辑预览的复制按钮 |
通知样式中的 .filter-btn |
待清理:通知页无消费者,流水页使用鱼干样式 | 保留流水页的权威样式,清理通知侧无效规则;验收流水筛选布局 |
.notification-card 的同名冲突目前靠通知中心规则抵消,margin-top: 0 是现行必要约束;
btnPulse 的品牌色差异也有刻意保留的理由。这两项先留作风险说明,不因本次归档而改样式。
2. 翻译跳转入口的取舍
待站长决定保留、增加入口还是退役:src/app/tool/translate/page.tsx 仍直接跳转到
http://116.62.179.232:9198,没有工具箱入口。它是可直接访问的路由;缺少站内引用
不能证明没有人在用。
写死 IP + 端口是刻意支持无法解析 DNS 的用户,不是待清理的旧站地址。决定前保持现状; 如需退役,应先确认直接访问的使用情况与替代路径,不把删除路由当成注释清理。
3. 面向站长的可见性完整轨迹
未实施:blog_visibility_logs 与 listBlogVisibilityLogs() 已存在,目前管理文章的
可见性设置只显示最近一条。完整历史视图仍缺 CLI 或管理端入口,现状见
docs/architecture.md §6.11。
实现前确定入口、站长档位、排序与分页;复用既有只读查询,展示操作者、前后档位与 变更时间。创建不记变更账、软删语义与改档位同事务记账的约束维持原口径,不另建账源。