做主题的起因很简单：想要一个打开快、读着舒服，日常功能又齐全的 Typecho 博客主题。功能堆得太多的往往沉重，极简的又缺东少西，于是有了暮秋 Dusk。

本站现在运行的就是它。

一眼看过去

暮秋 Dusk 桌面端首页

桌面端：沉浸式大图、三栏布局与最新文章列表。

暮秋 Dusk 手机端首页

手机端：单栏排版，页头收进抽屉，图文随屏幕宽度缩放。

主题以白色面板、蓝绿交互色和摄影横幅为主视觉。深浅色共用一套语义变量，默认跟随系统，也可以手动固定。

阅读需要的细节

文章工具栏：分享收进一个按钮，与点赞并排居中。复制链接、微博、X、邮件都在下拉菜单里，手机上一行放得下。

阅读辅助：面包屑、目录、阅读时间、阅读量、相关文章卡片；正文图片支持灯箱、srcset 与懒加载，代码块带复制按钮。

写作与互动：KaTeX 公式、图片表情、AJAX 评论与嵌套回复、QQ 头像联动、闪念时间线、友情链接模板。

性能与 SEO：页面缓存支持文件、Redis 与 Memcached；thumb.php 输出 16:9 WebP 缩略图，带 ETag 与 30 天强缓存；输出 Open Graph、Twitter Card、JSON-LD、分片站点地图与 robots.txt。前台使用原生 JavaScript，没有 jQuery，也没有前端构建步骤。

文章页工具栏

文章页：分享与点赞同一行居中，分享菜单收纳四个入口。

短代码

写视频、音频和友链时不必打开 HTML 编辑器：

[video src="https://example.com/demo.mp4" poster="https://example.com/cover.jpg" loop="loop" width="100%" height="auto"]
[audio src="https://example.com/music.mp3" name="曲名" loop="loop"]
[friends]
[link href="https://example.com" img="https://example.com/avatar.png" title="一句简介"]站点名[/link]

[video] 输出响应式播放器，loop 可选，width 与 height 接受 px、%、vw 等单位。[audio] 是主题自带播放器，name 省略时取文件名。[friends] 读取友情链接页面数据；[link] 适合在正文里单独插入一张友链卡片。

数学公式直接写 LaTeX。行内示例 $E = mc^2$，独立成行：

$$ \int_{-\infty}^{\infty} e^{-x^2}\,dx = \sqrt{\pi} $$

长公式在窄屏上可以横向滚动。

安装

  1. 从 发布页 下载最新包，或在 usr/themes 下执行 git clone https://gitea.com/xkd/Dusk.git Dusk。
  2. 后台「控制台 → 外观」启用「暮秋 Dusk」。
  3. 进入「设置外观」，按分组调整后点击页面底部「保存设置」。

主题兼容 Typecho 1.2 / 1.3、PHP 8.1–8.4，支持 MySQL 与 SQLite，不修改 Typecho 核心文件。设置以数据库为主存储，并自动镜像到 usr/custom/dusk/settings.json.php，方便备份与恢复。

开源地址

如果它正好合你的口味，欢迎拿去用。遇到问题、想要新功能，可以在仓库提 issue，或在这篇文章下面留言。