一句话认识它
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。愿你的博客,安静、清晰、有一点点好看。
支持
因为主题侧栏没有标签云模块
标签云(所有标签)- 紧凑微圆角版(完美适配深/浅主题)我增加了一个,,大佬看怎么样
<?php
/**
*@author 您的名字@link https://example.com@update 2025-02-24
*/
if (!defined('__TYPECHO_ROOT_DIR__')) {
exit;}
list-style: none; padding: 0; margin: 0; display: flex; flex-wrap: wrap; gap: 0.3rem;?>
/ 标签云专属样式 - 使用主题变量,自动适配深色模式 /
.tagcloud-list {
}
margin: 0;.tagcloud-item {
}
display: inline-block; padding: 0.1rem 0.3rem; background: var(--bg-color-primary); /* 使用主题次级背景色(浅灰/深灰) */ border-radius: 0.5rem; font-size: 0.85rem; color: var(--font-color-main); /* 使用主题主文字颜色(黑/白) */ text-decoration: none; transition: all 0.2s ease;.tagcloud-link {
}
background: var(--color-primary); /* 使用主题主色(蓝色) */ color: #fff !important; /* 悬停时文字强制变白,确保清晰可读 */.tagcloud-link:hover {
}
font-size: 0.75rem; margin-left: 0.2rem; opacity: 0.7; color: var(--font-color-main-light); /* 使用主题浅色文字(深色下自动变浅) */.tagcloud-count {
}
text-align: center; color: var(--font-color-muted); /* 使用主题柔和文字 */.text-center {
}
标签云 <div class="widget-content tagcloud-widget scroll-cover"> <?php $limit = 20; $db = Typecho_Db::get(); $tags = $db->fetchAll($db->select('mid', 'name', 'slug', 'count') ->from('table.metas') ->where('type = ?', 'tag') ->order('count', Typecho_Db::SORT_DESC) ->limit($limit)); if (!empty($tags)): ?> <ul class="tagcloud-list"> <?php foreach ($tags as $index => $tag): $tagUrl = Typecho_Common::url('/tag/' . $tag['slug'] . '/', $this->options->siteUrl); ?> <li class="tagcloud-item"> <a class="tagcloud-link" href="<?php echo $tagUrl; ?>" title="<?php echo htmlspecialchars($tag['name']); ?> 共 <?php echo $tag['count']; ?> 篇文章"> <span class="tagcloud-name"><?php echo htmlspecialchars($tag['name']); ?></span> <span class="tagcloud-count">(<?php echo $tag['count']; ?>)</span> </a> </li> <?php endforeach; ?> </ul> <?php else: ?> <div class="text-center">暂无标签</div> <?php endif; ?> </div>移动端,导航的自定义菜单和自动生成菜单不能对齐。和前面图标的距离不一样
已优化,后面发布
最近一直在找相册插件,不过没找到好用的,发现一个只支持1.21版的相册 模板,挺不错的,不过模板不支持1.3版,而且,是一个纯粹的相册模板 ,,我就想着把它移植到这个主题,用独立页面形式,,,但因为技术 有限,出现很多问题没成功,,,不知道大佬有没时间 把它加进你的主题里,这样会让这个主题更加优秀。
相册模板地址:https://typechx.com/themes/light.html
一个根据Light 修改的博客主题相册https://liuqingwushui.top/photo.html
后面会添加相册这个功能
你好,这里再反馈2个问题:
1、你看看我之前发的评论和你回复的,有些没有显示出来;
2、因为有白天与黑夜模式,所以我logo准备了两个,对应不同的背景,现在就只能调用一种模式下的logo,是否考虑加上黑夜模式的logo
感谢建议已添加LOGO图标日间URL和夜间模式URL
已优化,可以github下载最新代码
LOGO图自适应有点问题,我logo放上去会显示不全;
目前展示发现这些bug,期待更新更多功能,感谢提供了这么好的主题
另外反馈一个问题,后台文章设置单栏,但是没有效果
感谢反馈,已修复