现在前台能用什么：一份访客功能说明

趁着这一轮更新刚收好，把 qqqzj@Crane 的前台也整理成一份说明。这里说的前台，就是普通访客打开 qqqzj.cn 后能直接看到、能直接使用的部分。

现在这个站点不只是文章列表，它更像一个小型个人档案馆：可以按时间看动态，按主题读笔记，也可以从归档、搜索、RSS 或文章内目录慢慢翻。

首页入口#

首页第一屏保留了 qqqzj@Crane 的主视觉，下面是最近更新。访客一进来不用先判断栏目，直接看 Latest Posts 就能进入最新文章。

页面继续分成几个主要区域：

• About me：一段个人简介和联系入口。
• News 动态：记录网站更新、阶段变化和公告。
• Notes 笔记：放学习笔记、复习资料和整理好的长文。
• Life 生活：放生活记录、照片、视频或日常片段。
• Archive 归档：按月份集中列出所有公开文章。

顶部导航可以直接跳到这些区域。手机端导航会横向滚动，尽量保留完整入口，不把页面压成一团。

搜索和筛选#

顶部搜索现在是前台的主要找文章方式。它不只搜标题，也会匹配标签、栏目、摘要、作者和正文文本。

输入关键词后，会出现即时搜索结果；按 Enter 可以直接打开最靠前的匹配文章。搜索框旁边有清空按钮，可以一键回到全部文章。

标签筛选也会跟着文章自动生成。Notes 区还额外有笔记分类按钮，比如数学、物理、随笔等，适合以后内容变多之后按主题回找。

文章阅读#

每篇公开文章都有详情页。详情页会显示标题、发布日期、标签、作者和大致阅读时间。长文章会自动生成目录，目录默认收在侧边，打开后可以跳到对应章节。

阅读时页面顶部会有进度条，能大概知道自己读到哪里。标题旁边的 # 可以复制这一小节的链接，适合把某一段笔记单独发给别人。

文章底部有回到顶部按钮，也会显示上一篇和下一篇。直接打开文章独立链接时，也能看到同样的正文、目录、主题切换和相邻文章入口。

正文支持#

前台正文是从 Markdown 生成的，当前已经支持本站最常用的阅读元素：

• 标题、段落、引用、分割线。
• 无序列表、有序列表和表格。
• 粗体、斜体、行内代码和代码块。
• 数学公式和物理公式渲染。
• 定理、证明、例题、定义、注意、提示等提示块。
• 图片、视频和图注。
• 附件下载。

PDF 附件可以直接在页面里预览；Markdown、文本、代码、CSV、JSON 这类文本附件也可以展开看预览。大文件仍然以下载为主，不会强行塞进正文。

图片、视频和生活记录#

文章里的图片会按正文宽度自适应，详情页里会尽量完整显示，不会故意裁掉关键信息。视频文件会显示播放器；如果文章提供了可嵌入的视频链接，前台也会以播放器形式展示。

Life 生活栏目会优先显示文章里的第一张图作为卡片预览。没有图片时，就使用统一的 Life 标记，保持列表整齐。

主题和互动#

前台有白天、黑夜、自动三种主题。自动模式会跟随系统深浅色；手动切换后会记住访客自己的选择。

左上角头像和右下角小人会跟随主题切换素材。右下角小人可以点击，会根据当前页面说不同的话；双击时可以回到顶部。它只是一个轻量互动入口，不影响正常阅读。

About me 里的邮箱按钮可以点击复制，省去手动改 [at] 和 [dot] 的麻烦。

安装和订阅#

前台已经支持 PWA。手机或桌面浏览器如果支持添加到主屏幕，就可以把 qqqzj@Crane 当成一个小 App 打开。

站点会缓存基础外壳和轻量文章数据，让再次打开更快；图片、PDF 和视频这类大文件不做长期强缓存，避免更新后还看到旧内容。

RSS 订阅也可以直接使用。打开 RSS 页面时，浏览器里会显示成一份可读列表；放到 RSS 阅读器里，则仍然是标准订阅源。

公开访问和搜索引擎#

网站提供首页、独立文章页、RSS、网站地图和 404 页面。也就是说，访客可以从首页进入文章，也可以直接打开某篇文章的独立链接。

搜索引擎和社交平台能读到文章标题、摘要、正式链接和分享图。找不到的旧链接会进入站点风格一致的 404 页面，再引导回首页或归档。

现在的前台定位#

这一版前台的目标很明确：它不是复杂社区，也不要求访客学习额外操作；它是一个对阅读友好的个人站。

读者能做的事情包括：看最新更新，按栏目浏览，用搜索找文章，用目录读长文，预览附件，复制联系方式，订阅 RSS，把网站加到桌面，以及在手机上像小 App 一样打开。

后面再继续加内容时，这些入口会作为基础能力留在前台。内容越多，搜索、归档、目录和订阅就越有用。