---

title: "17 款主题 + 主题协议：博客的门面自由" date: 2026-09-17 tags: [主题, 主题协议, 自定义, 第三方开发] category: 主题与插件 description: "17 款内置主题 + 完整的主题协议。zip 免编译安装，公开页一键切换，第三方可独立开发交付。"

17 款主题 + 主题协议：博客的门面自由

同一个博客内容，换一套主题，气质完全不同。

技术博客用极简黑白，摄影博客用大图全屏，个人博客用温暖配色。内容是你的，门面你说了算。

17 款内置主题

爱库录内置了 17 款主题，覆盖常见风格：

• 极简系 — 纯文字排版，适合技术博客
• 杂志系 — 卡片布局，适合多分类内容
• 图片系 — 大图展示，适合摄影/设计
• 暗色系 — 深色背景，适合程序员
• 阅读系 — 类似 Medium 的沉浸式阅读

公开页右上角一键切换。 不需要改配置、不需要重启。

主题协议

主题不是「换个 CSS」那么简单。爱库录的主题协议定义了完整的接口：

registerTheme

主题注册入口。声明主题的名称、版本、配置项。

themeContext

主题上下文。包含当前文章、分类列表、标签、站点配置等数据。

entries

主题入口文件。定义页面结构和组件渲染。

--th-* 令牌

CSS 自定义属性（CSS Variables）。主题的颜色、间距、字体通过令牌系统统一管理：

:root {
    --th-color-primary: #2563eb;
    --th-color-bg: #ffffff;
    --th-color-text: #1a1a2e;
    --th-font-body: 'Inter', sans-serif;
    --th-radius-card: 12px;
    --th-space-section: 2rem;
}

换主题就是换一套令牌值。 不需要改 HTML 结构。

第三方主题开发

爱库录的主题协议面向第三方开发者设计：

1. zip 免编译安装 — 打包成 zip，上传即安装。不需要构建工具。
2. 协议即文档 — 遵循协议接口，不需要阅读系统源码。
3. 独立交付 — 第三方可以独立开发、测试、发布主题，不依赖爱库录主仓库。

主题目录结构

my-theme/
├── theme.json          # 主题元信息（名称、版本、作者）
├── entries/
│   ├── blog.html       # 博客列表页
│   ├── article.html    # 文章详情页
│   └── category.html   # 分类页
├── assets/
│   ├── style.css       # 主样式（--th-* 令牌）
│   └── script.js       # 交互逻辑
└── README.md           # 主题说明

验收标准

主题需要通过基本的验收检查：

• 公开页正常渲染（列表、详情、分类）
• 搜索功能可用
• 响应式适配（桌面 / 平板 / 手机）
• --th-* 令牌生效
• 无 JS 报错

主题生态在早期，但协议已经就绪。 第三方现在就可以开始开发。

实际操作

安装主题

控制台 → 主题管理 → 上传 zip → 安装完成。

切换主题

公开页右上角下拉菜单 → 选择主题 → 即时切换。

自定义令牌

控制台 → 主题设置 → 修改颜色 / 字体 / 间距 → 实时预览。

---

相关：[[4 挂载点 12 插件：博客功能即插即用]] — 了解插件系统。