主题
附录 H:门户页面清单
vite-cosmos-web/src/views下全部 17 个页面。说明取自文件头注释。
文件(src/views/) | 行数 | 说明(文件头注释) |
|---|---|---|
AlbumView | 321 | 相册页:相册卡片列表 → 点击进入照片墙(灯箱预览)。 VS 扩展:封面/照片渐进加载(VS-U2)、alt 语义(VS-A3)、灯箱焦点陷阱 + 键盘关闭(VS-A2/A5)。 |
ArchiveView | 120 | 归档页:按年份分组的时间线。VS 扩展:骨架屏加载态(VS-U1)。 M19:补错误态与重试(此前接口失败会被 finally 吞掉,页面误报"暂无已发布的文章")。 |
ArticleDetailView | 1942 | 文章详情页。 正文为后端渲染好的 HTML(commonmark,已过滤原始 HTML 标签), 这里只做增强:代码高亮/行号/折叠(VS-U5)、目录生成、面包屑(VS-N1)、 |
CategoriesView | 135 | 分类总览(VS-N1/S7):点击进入首页并按分类筛选;支持时间范围二次筛选。 |
CustomPageView | 219 | 自定义页面(关于页等),正文为后端渲染好的 HTML。 |
FavoritesView | 232 | 我的收藏(N15):读浏览器本地存储,展示标题/收藏时间,可单条移除或清空。 不请求接口(收藏不上传服务器),因此断网也能查看——与 PWA 离线缓存天然契合。 |
HistoryView | 231 | 最近浏览(VS-N3):/history,纯本地记录。 |
HomeView | 564 | 首页:站点 Hero + 文章流。 列表筛选通过 URL query 驱动(categoryId / tagId / keyword / sort / range),便于分享与前进 |
LinksView | 340 | 友链页:友链展示 + 访客自助申请(验证码 + 限流)。 VS 扩展:骨架屏、Toast 替代 alert、字段级校验。 |
MessageView | 399 | 留言板:留言列表(含博主回复)+ 发表留言。 VS 扩展:骨架屏加载态、Toast 替代 alert、字段级即时校验。 |
NotFoundView | 55 | 404 页(路由兜底)。 M31:对爬虫输出 noindex —— 避免"页面存在但没有内容"的 404 被收录 (与文章详情"文章不存在"分支同策略,见 docs/01-项目归档 |
SearchView | 425 | 搜索结果页(VS-S4/S5/S6/S7):/search?keyword=&scope=&sort=&range= - scope 支持全部 / 文章 / 页面 / 说说 - s |
SeriesDetailView | 245 | 系列详情(VS-N2):/series/:slug 展示系列目录(当前篇高亮 + 上下篇切换)。 |
SeriesListView | 136 | 系列专栏列表(VS-N2):/series |
SitemapView | 242 | HTML 站点地图(VS-N4):/sitemap 聚合文章(按年)、分类、标签、系列、自定义页面链接,方便爬虫与访客检索全站。 |
TagsView | 131 | 标签云(VS-N1/S7):点击进入首页并按标签筛选;支持时间范围/排序二次筛选。 二次筛选通过带 range 的 URL query 进入首页(首页已支持 sort/range) |
TalkView | 243 | 说说时间线:短动态 + 图片 + 点赞(本地记录已点赞,防重复点击)。 VS 扩展:骨架屏加载态(VS-U1)、图片渐进加载(VS-U2)。 |