hexo-theme-autuswing — Hexo Blog Template

SHA-256: e72394d21f5d78562bbbf69651bc87b9f373e402c7b8556fe6ed08e2e3597a24

2026-10-06T15:49:43.047Z

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/autuswing-logo-dark.svg">
    <img src="docs/assets/autuswing-logo-light.svg" width="560" alt="AutuSwing · 秋漾，秋叶与秋千组成的 Logo">
  </picture>
</p>

<p align="center">
  <strong>秋日轻轻摇荡的秋千，为文字留一片安静的空间。</strong><br>
  云母卡片 · 移动阅读 · 本地公式 · 边缘交付
</p>

<p align="center">
  <a href="package.json"><img src="https://img.shields.io/badge/version-0.1.1-426351?style=flat-square" alt="版本 0.1.1"></a>
  <a href="https://hexo.io/"><img src="https://img.shields.io/badge/Hexo-8.1.2-527566?style=flat-square" alt="Hexo 8.1.2"></a>
  <a href="package.json"><img src="https://img.shields.io/badge/Node.js-%E2%89%A520.19.0-6D826B?style=flat-square" alt="Node.js 至少 20.19.0"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-C79245?style=flat-square" alt="MIT 许可"></a>
  <a href="https://github.com/AkiSenn/hexo-theme-autuswing/actions/workflows/ci.yml"><img src="https://github.com/AkiSenn/hexo-theme-autuswing/actions/workflows/ci.yml/badge.svg" alt="主题构建检查"></a>
</p>

<p align="center">
  <strong>简体中文</strong> · <a href="README.en.md">English</a>
</p>

<p align="center">
  <a href="#quick-start">快速开始</a> ·
  <a href="docs/index.md">使用文档</a> ·
  <a href="#preview">主题预览</a> ·
  <a href="https://github.com/AkiSenn/hexo-theme-autuswing/releases/latest">下载发行版</a>
</p>

---

**Autuswing · 秋漾** 是一款适用于 Hexo 8 的独立博客主题，以温润的云母材质和清晰的阅读布局，承载技术、生活与日常记录。名称来自 **Autu**mn 与 **Swing**：秋天的暖意，以及秋千轻轻摇荡的节奏。

本仓库提供主题源码、默认素材、公式资源与文档，安装在博客的 `themes/autuswing/`。自己的文章、域名和站点配置由博客维护。

<a id="features"></a>

## 功能概览

| 方向 | 功能 |
| --- | --- |
| 外观 | 云母文章卡片、全站/单篇壁纸、日间/夜间/自动外观、头像与入场动效 |
| 阅读 | 手机抽屉、唯一左侧目录、阅读进度、代码复制、图片预览与分享 |
| 内容 | 中文站内搜索、分类与标签共同入口、稳定短链接、RSS / Atom |
| SEO | 国内外站长验证、标准/百度/文本网站地图、canonical 与结构化数据 |
| 服务 | 六种可选评论、不蒜子、运行时间、ICP 与公安备案 |
| 公式 | 随主题提供 MathJax / KaTeX 脚本和字体，可选公共 CDN 或自有资源域名 |
| 交付 | Cloudflare Workers、腾讯 EdgeOne、阿里云 ESA 原生部署产物，资源指纹与可选预压缩 |

简体中文与英文界面，可选 PWA。移动布局、键盘操作、减少动态效果与打印样式均有相应支持。

<a id="preview"></a>

## 主题预览

<p align="center">
  <img src="docs/assets/responsive-showcase.png" width="1000" alt="akisenn.com 使用 AutuSwing 的桌面、平板与手机实景，包含浅色和深色模式">
</p>

[akisenn.com](https://akisenn.com/) 实景截图，展示桌面、平板与手机布局，以及浅色和深色模式。

<a id="quick-start"></a>

## 快速开始

需要 **Node.js ≥ 20.19.0** 和 **Hexo 8.1.2**。以下命令从已有博客根目录开始；渲染器和列表生成器的准备步骤见[完整安装说明](docs/usage.md#install)。

也可以在 [发行版](https://github.com/AkiSenn/hexo-theme-autuswing/releases/latest) 下载主题 ZIP，解压到博客的 `themes/`，再进入 `themes/autuswing/` 安装依赖。

```powershell
git clone https://github.com/AkiSenn/hexo-theme-autuswing.git themes/autuswing
cd themes/autuswing
npm ci --omit=dev
cd ../..
```

在博客根 `_config.yml` 中启用主题，并填写自己的正式域名：

```yaml
theme: autuswing
language: zh-CN
url: https://blog.example.com
root: /
```

在博客根新建 `_config.autuswing.yml`，只填写需要覆盖的主题设置：

```yaml
profile:
  author: 你的名字
  subtitle: 记录技术与生活，留下值得记住的瞬间。
color_mode: auto
```

然后仍在博客根执行：

```powershell
npx hexo clean
npx hexo generate
npx hexo server
```

打开 `http://localhost:4000/`。更多设置从[使用手册](docs/usage.md)或[起步配置](docs/starter-config.yml)开始。

> [!TIP]
> 个人配置写在博客根 `_config.autuswing.yml`；主题目录 `_config.yml` 的中文注释用于查询默认值。这样更新主题时可以保留自己的设置。

<a id="documentation"></a>

## 文档导航

| 你想做什么 | 阅读 |
| --- | --- |
| 安装、预览、写文章、升级 | [使用手册](docs/usage.md) |
| 更换头像、作者名与标语 | [个人信息](docs/profile.md) |
| 设置壁纸与卡片外观 | [外观指南](docs/appearance.md) |
| 配置评论、备案、访问统计 | [评论与页脚](docs/comments-and-footer.md) |
| 设置短链接、搜索引擎与订阅 | [SEO 与链接](docs/seo-and-urls.md) |
| 选择 CF、EdgeOne 或 ESA | [边缘部署](docs/deployment.md) |
| 了解组件、参与修改 | [源码说明](docs/source-guide.md) |

[浏览全部文档 →](docs/index.md)

## 许可与致谢

主题代码采用 [MIT](LICENSE)。模板、CSS、JavaScript 部分参考 **Yelee / MOxFIVE**、**Yilia / Litten**。