文档索引

文档核对后的维护待办

状态:未完成 / 待决策。校对日期: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。

实现前确定入口、站长档位、排序与分页;复用既有只读查询,展示操作者、前后档位与 变更时间。创建不记变更账、软删语义与改档位同事务记账的约束维持原口径,不另建账源。

本页内容来自仓库 docs/plan/maintenance-plan.md·在 GitHub 上查看

文档核对后的维护待办 · 聪明山