97 lines
3.4 KiB
Markdown
97 lines
3.4 KiB
Markdown
# blog-5l：后台预览一致性 + 排版提醒 + 瞬间置顶/隐藏 - 完成总结
|
||
|
||
## 交付结论
|
||
- 结果：完成
|
||
- 完成时间：2026-11-05 10:03
|
||
|
||
## 假设回顾
|
||
### 已验证假设
|
||
- 预览窗格是 CMS 内部管理的文档，官方 registerPreviewStyle 是唯一稳定注入口（MutationObserver 手注会被重渲染冲掉且升级易碎）
|
||
- 预览目标是「类效果可见」（颜色对、字体对、基础排版近似），不追求像素级还原
|
||
|
||
### 仍未完全验证的假设
|
||
- 无
|
||
|
||
## 交付范围
|
||
### 已交付
|
||
- task_0001 预览样式注入
|
||
- task_0002 编辑提醒
|
||
- task_0003 瞬间置顶/隐藏
|
||
|
||
### 未交付
|
||
- 无
|
||
|
||
### 偏差说明
|
||
- 无
|
||
|
||
## 简化决策
|
||
### 保持简单的关键选择
|
||
- 最简可行：一个新脚本 preview-style.js + 三处既有文件小改（typography-classes 加 css 字段、typography-editor pattern 放宽、config.yml hint/开关）+ moments 三点改（schema/MomentsPage/config.yml）+ 一条置顶示例数据 + E2E 断言更新
|
||
- 暂不引入：常驻样式速查面板、预览明暗主题切换
|
||
- 不做的抽象：通用「字段级 hint 生成器」（hint 手写三处即可，量小不值得抽）
|
||
- 范围级别：package
|
||
- 变更对象：后台静态资源（public/admin）与瞬间列表渲染（MomentsPage）
|
||
- 快速检查：`pnpm astro build` + `python3 scripts/build-perf/config-check.py .`
|
||
- 集成检查：E2E 59 项 + content-lint 0/0/0 + 产物 grep（moments 首卡 pin 徽标、admin 三脚本接线序）
|
||
- 全项目检查：生产部署后人工核验后台预览显色显字体；**升级条件**——仅当改动触及 BaseLayout 字体注入或 build 链时才升级全站回归，本包不涉及
|
||
- 升级触发：后台预览为独立资源面，升级为「后台人工核验」即可
|
||
|
||
### 本轮明确不做的内容
|
||
- Sveltia bundle 升级与魔改；预览像素级还原；moments 单条页面 / RSS / sitemap 变化
|
||
|
||
## 变更边界
|
||
### 本轮主要改动模块
|
||
- 见 tasks.md 的 boundary 记录
|
||
|
||
### 明确未触碰的区域
|
||
- Sveltia bundle 升级与魔改；预览像素级还原；moments 单条页面 / RSS / sitemap 变化
|
||
|
||
## 验证证据
|
||
### 备注
|
||
- 机器证据：runs.jsonl（见验证范围的机器验证率）
|
||
|
||
## 验证范围
|
||
- 级别：package
|
||
- 机器验证率：3/3
|
||
- 规则：check 与 done 复用该范围；只有记录升级触发时才执行全项目检查
|
||
|
||
## 哲学生效证据
|
||
### 行为成效回填
|
||
- Development Record 行为门禁通过
|
||
|
||
### 一致性门禁回顾
|
||
- 验收面（checklist 或成功标准）已通过
|
||
|
||
## Git 记录
|
||
- 日期时间：2026-11-05 10:03
|
||
- 范围：blog-5l：后台预览一致性 + 排版提醒 + 瞬间置顶/隐藏
|
||
- 功能：task_0001 预览样式注入；task_0002 编辑提醒；task_0003 瞬间置顶/隐藏
|
||
- 操作：提交 / 推送
|
||
- 成效：Development Record 行为门禁通过
|
||
- 提交：pending local commit
|
||
- 提交区间：c5889f960b94a70c61b7c31d13e3e4be4cacaaf8..c5889f960b94a70c61b7c31d13e3e4be4cacaaf8
|
||
- 推送：not-run (push stage follows commit)
|
||
|
||
## AGENTS.md 增量提议
|
||
```diff
|
||
后台编辑体验三件套：预览窗格显色显字体（registerPreviewStyle 官方口子 + 切片字体按需取片）、编辑字段排版速查提醒、瞬间置顶/隐藏真字段（对齐 posts 契约）。
|
||
```
|
||
|
||
## 被拒绝的扩展提议
|
||
- 无
|
||
|
||
## 门禁证据
|
||
- check_spec_package.py exit 0
|
||
|
||
## 遗留事项
|
||
- 无；问题处置见下方结构化区块
|
||
|
||
## 问题处置
|
||
|
||
```json
|
||
{
|
||
"issues": [],
|
||
"version": 1
|
||
}
|
||
```
|