一句话认识它
HarmonyHues 是一个为 Typecho 打造的轻新拟态主题:柔和的同色系表面、克制的双向阴影、明确的留白与层级,让博客读起来安静,看起来有质感。
设计理念
「Harmony」是和谐,「Hues」是色调。
主题的取色灵感来自日出日落与四季更替:底色始终比卡片深一点点,卡片再比文字浅一点点,所有颜色都收敛在一个偏冷的灰蓝色谱里,暗色模式则整体下潜,保留同样的层次关系,而不是简单反色。
于是有了现在的观感:卡片像从页面里轻轻浮起,而不是贴着一张白纸;悬停、滚动、切页的动效都保持同一套节奏,尽量不打断阅读。
主题亮点
- 轻新拟态:页面底、卡片面、描边、投影四层关系统一,不靠强对比堆砌立体感。
- 双色主题:亮色 / 暗色 / 跟随系统三态,所有组件都有对应的暗色令牌,切换不闪白。
- 多模式导航:全宽与居中两种导航形态;下滚自动隐藏、上滚立即出现,底部还有一条阅读进度线。
- 内容友好:图片懒加载与灯箱、文章目录锚点、提示框与折叠框短代码、代码高亮。
- 免插件能力:评论表情包(放图即用)、评论邮件提醒、友情链接、Sitemap、IP 归属地展示等能力内置。
- 独立页面:我的装备、明信片留言、友情链接、文章归档、关于主题。
- 归档热力图:按日聚合的发布热力图 + 连续写作统计,一年写了多少天一目了然。
- 持续更新:版本号与缓存自动失效机制配合,升级后不会读到旧样式。
技术栈
- HTML5 + CSS3(SCSS 组织,CSS 变量驱动主题)
- jQuery + Bootstrap 4 栅格
- 本地 iconfont 图标,无外部 CDN 依赖
- 原生 IntersectionObserver 实现滚动入场,尊重
prefers-reduced-motion
快速开始
- 下载主题压缩包,解压后上传到
usr/themes/目录; - 重要:把解压出来的文件夹重命名为
HarmonyHues; - 登录 Typecho 后台 → 控制台 → 外观,启用主题;
- 进入「设置外观」,按需开启侧栏模块、填写备案号与自定义代码。
提示:主题设置里的「侧边栏显示」包含博主信息、一言、热门文章、最新评论、标签等模块,默认只勾选了前三个,其余按需开启。
界面预览


常见问题
Q:升级主题后样式没变?
A:主题会在检测到版本变化时提示刷新缓存;也可以手动 Ctrl + F5 强制刷新一次。
Q:想换主色调?
A:打开 assets/css/style.scss,修改 --color-primary 及其 dark-* / light-* 变量后重新编译;页面里所有强调色会一起变化。
Q:评论表情包怎么加?
A:在 assets/emoji/ 下新建一个文件夹放图片即可自动出现在表情面板;想自定义中文名与插入方式,加一个 info.json 就行。
Q:导航栏有两种样式?
A:主题设置里可以选「默认(全宽)」或「MINI(居中)」,两种形态的动效与进度线都已适配。
结语
HarmonyHues 还在持续打磨:新的动效、新的页面、新的细节会随版本一起长出来。
如果你在使用中遇到问题,或者有更好的想法,欢迎在评论区留言,也欢迎到 GitHub 提 Issue。愿你的博客,安静、清晰、有一点点好看。
代码高亮是在哪个文件里,代码高高的颜色想改一下,
一启用主题就提示“数据库查询错误”啥情况
可能是什么插件导致的,自己搭建全新环境测试看看
重新搭建测试了,还是不行, 对了 博主之前是不是用的wordpresss的子比主题么,怎么改用typecho了
已修复报错问题,目前已解决页面出现Database Query Error报错问题
https://888333.xyz/?random=true
右上角随机文章突然用不了了怎么排查什么情况啊
没有复现出这个异常,看看是不是加了什么插件或者代码呗?或者Nginx防火墙啥的
用上了还可以
下个版本更新可以增加M3U8/FLV视频格式播放吗,或者增加 自定义解析接口
还有评论分页,现在没有分页,实在太长了影响美观
暂时不添加M3U8/FLV视频格式、自定义解析接口功能,可自己开发。目前评论是有分页的,可在后台->评论->评论显示中设置,只是回复的子评论没有分页。
为啥我安装这个主题页面出现Database Query Error 咱解决呀 在线等着急!
之前使用什么主题?