Skip to content
LeeLaa Blog 公开站点审计报告
审计时间:2026-08-23
审计对象:VitePress 公开站点,包括首页、文章、电台、记忆、圈子、关于和移动端关键路径。
设计上下文:个人博客读者在桌面和移动设备上阅读文章、收听电台和浏览照片记忆;产品定位是安静、个人、带实验性的内容型个人杂志,而不是后台或营销落地页。
结果概览
| 项目 | 结果 |
|---|---|
| 公开站点构建 | 通过:pnpm build |
| 公开站点 E2E | 通过:pnpm test:blog:e2e,兼容别名 pnpm test:e2e 也通过 |
| 后台 E2E | 通过:pnpm test:admin:e2e(后台另有独立报告) |
| 移动端横向溢出 | 通过:390x844 视口检查 |
| 已确认公开站点 bug | 5 项,已全部修复并加入回归断言 |
| P0/P1 未修复阻断项 | 0 |
Audit Health Score
| 维度 | 得分 | 依据 |
|---|---|---|
| Accessibility | 3/4 | 主导航、播放控制、随机电台卡片和记忆交互具备语义标签与键盘路径;仍可继续扩大动态错误状态和媒体控制的辅助技术覆盖。 |
| Performance | 3/4 | VitePress 构建、图片懒加载、媒体和动态模块均可工作;首页内容较丰富,仍需持续观察资源加载和第三方请求。 |
| Theming | 3/4 | 明暗主题使用品牌变量,主题切换 E2E 通过;部分页面仍存在少量硬编码颜色。 |
| Responsive Design | 3/4 | 390x844 关键路径无横向溢出,核心内容在移动端可访问;密集卡片和媒体控制仍值得扩展平板/窄屏覆盖。 |
| Anti-Patterns | 3/4 | 整体保持内容导向的个人杂志布局;部分专题区仍使用重复卡片结构,但未发现阻断使用的视觉反模式。 |
| 合计 | 15/20 | Good:核心体验可用,剩余工作以质量提升和覆盖面扩展为主。 |
本轮已修复问题
[P1] 电台播放结束同时触发上一曲和下一曲导航
- 位置:
.vitepress/theme/pages/RadioDetail.vue - 根因:同一个
Audio同时绑定了nextTrack、prevTrack和包装后的第二个nextTrack。 - 处理:保留单一
ended -> nextTrack监听,并在卸载时移除同一引用。 - 验证:E2E 在浏览器注入监听计数,确认
ended只注册一次。
[P2] 首页“流浪星球”快捷功能不显示
- 位置:
.vitepress/theme/pages/Home/components/FunSection.vue - 根因:快捷区只渲染
funList.slice(0, 4),跳过了索引 4。 - 处理:快捷区改为渲染前 5 项,并增加
leelaa.wander()命令展示。 - 验证:E2E 滚动到趣味区并断言“流浪星球”可见。
[P2] 电台列表“随机播放”不执行播放行为
- 位置:
.vitepress/theme/pages/Radio/components/RadioList.vue、RadioContent.vue - 根因:随机卡片只做闪烁动画,父组件处理函数只有日志输出。
- 处理:动画完成后传出选中的真实节目,父组件跳转到对应节目详情页;同步修正卡片无障碍文案为“打开节目”。
- 验证:E2E 点击随机卡片并确认 URL 进入节目详情路由。
[P2] 记忆页标题数量与可浏览卡片数量不一致
- 位置:
.vitepress/theme/pages/Memory/components/MemoryContent.vue - 根因:列表使用
slice(1),计数却使用完整数组长度,首条记忆没有列表入口。 - 处理:列表展示完整数组,预览、回列表滚动逻辑统一使用同一索引基准。
- 验证:E2E 断言标题数字等于
.memory-card数量,并打开首张卡片。
[P2] 记忆预览离线时仍显示在线
- 位置:
.vitepress/theme/pages/Memory/components/MemoryPreview.vue - 根因:
useNow()的返回值被错误赋给online,useOnline()没有接收变量。 - 处理:分别绑定
fps、now和online三个 composable 返回值。 - 验证:E2E 切换浏览器离线模式,确认状态灯变为红色。
当前风险判断
本轮没有发现会阻断公开站点启动、主导航、文章阅读、电台详情或记忆浏览的 P0/P1 未修复问题。公开站点没有登录和后台权限能力,也不应按后台本地工具的威胁模型评估。
后续可继续关注:
- 扩大键盘导航、屏幕阅读器和
prefers-reduced-motion的覆盖。 - 对首页媒体/图片和外部请求做真实网络环境下的性能采样。
- 将剩余硬编码颜色逐步收敛到主题变量。
复验命令
bash
pnpm build
pnpm test:blog:e2e
pnpm test:admin:e2e
pnpm test:admin:unit后台安全边界和本地运行模型见 project-admin/DESIGN.md;浏览器测试说明见 test/README.md。
2026-10-29:主题升级兼容性复查与圈子页
- 已复现 VitePress alpha.21 新增
ul.list > li后与 DaisyUI.list竖排样式冲突,以及新版主题定位/最小高度对胶囊导航的覆盖。已恢复横排、对齐和间距,并统一 48rem 移动菜单断点。 - 已移除新版
VPNavBar::before对圆角描边的遮盖,隔离 DaisyUI 对当前导航链接的黑色背景/阴影,保留下划线选中态。 - 已修复目录标题配置、移动端“更多内容”图标竖排、点击目录文字后面板不关闭、路由完成后过渡标记未清理,以及错误提示容器拦截搜索结果点击。
- 圈子顶部参考现有页面的居中标题和圆形图标,用细线涟漪替代漂浮重复头像。顶部最多 6 位作者;更多作者通过支持搜索、滚动和每批 48 位的面板访问,失效头像显示姓名首字。人数统计覆盖接口实际返回的全部文章,不推断未返回的订阅作者。
- 本地开发环境与构建预览均通过公开站点 E2E;主题回归通过首页/文章页 12 个宽度的布局检查及 56 项主要页面/主题/交互检查。圈子页在桌面和手机以隔离响应通过 0、4、120 位作者、搜索、加载、主页入口和 Escape 焦点恢复检查。
pnpm build通过。 - 纯静态构建预览不提供
/api/chp和/api/getFriendsRss,相关错误仍会记录在浏览器日志;这不代表线上接口验收。外部音频实际播放、评论服务、真实设备和线上部署不在本轮本地结果中。
转载请注明来源:leelaa : 《》
正在连接 GitHub评论区马上就来...
