关于

关于本站

你好,我是 👋。这里是我的个人博客 + 知识库——用来记录、整理、沉淀技术与生活点滴。这个站点是自用的个人知识库,用于整理技术笔记、读书心得与生活随笔。

站点的特别之处在于:文章渲染效果与 Typora 导出 HTML 保持一致的风格与配色,而这套主题配色来自开源的 Phycat 主题。

NOTE

你可以通过右上角的「主题」按钮随时在 11 套配色 之间切换(8 套亮色 + 3 套暗色),选择会被浏览器记住;也可以点「主题」→「自定义」打开配色工坊,自制专属主题配色并导出为新主题。

本站特性

  • 🎨 与 Typora 导出一致的渲染:标题图标、渐变 H2、毛玻璃卡片、Mac 风格代码块、任务列表动画、提示块、Mermaid 图表
  • 🔍 站内全文搜索:标题 / 正文 / 分类 / 标签都能搜,按 Ctrl + K 随时唤起
  • 🎨 自定义主题:「主题」→「自定义」打开配色工坊,自制主题色一键应用到全站,可导出为新主题文件
  • 🗂️ 知识组织:首页分类卡片 + 标签云 + 按年月的归档页
  • 📊 阅读体验:顶部阅读进度条、字数与预计阅读时长、正文图片灯箱(滚轮缩放 / 拖拽平移)、多级目录、代码一键复制
  • 📦 PWA:可"安装"到桌面 / 手机主屏,Service Worker 缓存支持离线阅读
  • 📱 响应式布局 + 纯静态站点,多端查看、可部署到任意静态托管

快速上手

你想做什么 怎么做
搜索知识 点右上角 🔍,或按 Ctrl + K
换配色 右上角「主题」按钮,或「主题」→「自定义」自制
浏览全部 导航「归档」按时间线,或首页标签云 / 分类卡片
安装到手机 打开 https 地址后,浏览器菜单里选"安装应用"

写作约定

文章的 YAML front matter 用于标记元信息:

---
title: 文章标题
slug: 文章英文名(如 continual-rl)
date: 2026-08-01
updated: 2026-08-01
category: 技术笔记
tags: [标签1, 标签2]
excerpt: 一句话摘要(用于首页卡片)
---
  • date 用于排序;updated 表示最近更新时间(改了文章记得同步更新,文章页会显示"更新于")
  • slug 可选:文章网址的英文短名(如 slug: continual-rl),页面显示仍为中文;中文标题建议填写,避免网址出现中文。
  • 标签 / 分类的英文网址在 content/tags.md 与 content/categories.md 中统一配置,新增标签 / 分类时记得同步登记。
  • 可选开关(文章与独立页面通用,默认全开):
    • toc: false —— 不显示目录侧栏;
    • tocnum: false —— 保留目录侧栏,但侧栏目录项不显示编号;
    • headnum: false —— 正文标题不显示编号;
    • eqnum: false —— 本页不做公式编号,也不解析 \eqref 交叉引用。

    本页就使用了 toc: false + headnum: false(无目录、标题不带编号)。

  • 图片放在 content/posts/images/<文档名>/ 下,正文用相对路径引用,例如 ![](images/<文档名>/xxx.png)
  • 保存文件后运行 npm run build(或 npm run serve 预览)即可看到更新

公式编号与交叉引用

正文里的块级公式(独立占若干行、首尾各一对美元符号包裹的 LaTeX)会按出现顺序自动编号:每篇文章独立从 (1) 开始,编号显示在公式右侧;鼠标悬停时编号会临时让位给「复制」按钮。

写法是给公式加一行 \label{名字},在正文里用 \eqref{名字} 引用。下面这个公式就是本页真实的例子(直接写在正文里,没有放进代码块):

(1)

于是正文里写「由式 (1) 可知」,就会显示成「由式 (1) 可知」,编号可以点击跳到该公式。

  • \eqref{名字} 显示为带括号的编号 (3),\ref{名字} 显示为纯数字 3,两者都可点击跳转
  • 标签名自取(建议 eq: 前缀),只要同一篇内不重复
  • 支持前向引用:可以先写「见式 (1)」再在下面给出公式
  • 一个公式可以被引用多次;标题里也能用,右侧目录会同步显示编号
  • 编号是构建时按顺序生成的:插入或删除公式后编号会自动调整,引用跟着一起变,无需手工维护
  • 引用只在同一篇内有效,不支持跨文章引用
  • 找不到标签时,正文保持原样(字面显示 \eqref{...}),并在构建日志里给出 warning
  • 整篇不想编号:front matter 里加 eqnum: false

技术

  • 基于 Phycat 主题配色(MIT 许可)
  • 渲染引擎:markdown-it(与 Typora 同源)
  • 字体:霞鹜文楷(LXGW WenKai)与 Cascadia Code(OFL 许可)
  • 纯静态站点,零后端依赖

联系

欢迎交流,也欢迎把这里当作你的知识库模板。如果喜欢这套配色,欢迎把知识一点点积累进来,让这里成为你的「第二大脑」🎉。