开发笔记 v0.19.0:视觉重构 - 瀑布流视图与 CMS 兼容
开发笔记完成一轮前台视觉重构:知识库、Debug 库和开发时间线统一为瀑布流视图,详情页恢复完整阅读样式,并补齐移动端目录与本地 CMS 兼容性。
开发笔记 v0.19.0 以统一三个内容板块的阅读观感为目标,把知识库、Debug 库和开发时间线的落地页收束为同一套瀑布流布局,同时保留原有内容集合、筛选、搜索、排序和详情阅读能力。
瀑布流落地页
- 知识库、Debug 库和开发时间线统一使用瀑布流卡片、分类胶囊、搜索与排序交互,移除冗余的旧侧栏和落地页头部结构。
- 统一桌面端多列排列与移动端单列展示,保留真实 Markdown 内容、分类统计、更新时间排序和时间线版本排序。
- 移除已经不再适合当前信息架构的 AI 排行榜及相关旧数据页面,减少前台无效入口。
详情页与目录
- 知识库和 Debug 库详情页恢复完整的 Markdown 阅读样式,包括脚注悬浮窗、表格、代码、图片预览和正文目录。
- 桌面端保留右侧固定目录,移动端改为随页面滚动的浮动目录按钮;详情页不再依赖旧侧边栏。
- 开发时间线详情页保持白底阅读区域,标题、描述、返回入口和目录按桌面端与移动端分别适配。
CMS 兼容与本地开发
- 前台重构继续复用
knowledge、timeline和debug三套 Content Collections,CMS 的分类、路径和字段约束没有迁移到另一套模型。 - 验证本地 CMS 的列表、详情读取、Markdown 预览、创建、更新、按标题改名和删除链路,非法分类与越界路径仍会被拦截。
- 修复 macOS 下 Finder 自动化不可用时删除接口返回 400 的问题:优先进入系统废纸篓,无法使用时回退到可恢复的 CMS 临时回收目录。
UI 设计图留档





版本与验收
- 项目版本号由
0.18.1升至0.19.0,同步更新package.json和package-lock.json。 - 生产构建继续生成知识库、Debug 库和开发时间线的列表与详情路由,本地 CMS 不进入静态生产输出。