已完成2
已完成
(已解决)目前hugo-teek换到默认侧边栏后,是有一定的Bug的,点击某个文档后,这个文档名称会往下缩进一下的,这个的修复下
(已解决)悬浮文章右侧目录后,怎么不显示 多余的内容了?(把之前功能修复丢了🤣)
2026年1月7日记录。
(已解决)文章右侧 的 左侧分界虚线怎么没了? 不然别人都不知道咋们的目录能左右拖动宽度。
2026年1月7日记录。

(已解决)(紧急重大bug、性能问题)当前的hugo-teek侧边栏体验很卡–>丢弃转teek语法这个步骤 & 使用hugo默认的短代码配置侧边栏
2026年1月7日记录。
https://imfing.github.io/hextra/



Hextra侧边栏用的hugo原生union .context.RegularPages .context.Sections 37行, teekhugo侧边栏弄了995行

已切换到hugo默认短代码了。
不可以再在目录/文档前加svg图标了。。。


gpt答复






结论
(已解决)(非常影响体验)总感觉当前hugo-teek的侧边栏体验,切换文件这个效果还是有点卡顿,是我站点文章里图片多导致的嘛? w3c这个就很轻。 应该是代码层的问题。。
2026年1月7日记录。
(已解决)侧边栏切换文件时整个侧边栏会刷新(@one)
2025年12月26日记录。
存在问题:
当前白木修复后的侧边栏切换文件时整个侧边栏会刷新,影响用户体验。
(已解决)告警容器里的图片语法没被正确渲染


(已解决)容器里反引号和链接语法hugo-teek没识别
2025年12月17日提出。

ty里md内容:

hugo-teek渲染效果:

(已解决)文档的最后更新时间应该从 文档修改时间取值,当时是从commit时间取值的
2026年1月4日记录。

(已解决)(紧急重大bug):当前最新版本,侧边栏问题解决了50%,目前第一次点击进去后,侧边栏还是有问题,重新点击一个文件后,整个侧边栏才会正常,可以看下我这个录屏
2026年1月3日记录。
且,点击后,怎么其它目录也展开了,理想状况,是到当前页面,其它默认保持收缩状态。

(已解决)(bug)文章底部版权模块 文章链接 出现的是中文乱码
2026年1月3日记录。

(已解决)(优化)40.专题 下目录的数字序号没必要给显示出来哇,这个是排序用的
2026年1月3日记录。

(已解决)(优化)图片加阴影,hover后再出现蓝色边框(@白木)
2025年12月26日记录。
当前白木修改后的特性是:图片正常是蓝色边框,hover后蓝色边框消失了,不合理。
具体原因:


(已解决)(优化)个人头像hover效果需改进
2025年12月20日记录。
当前悬浮后,是顺时针旋转一次;
理想效果:hover后,先逆时针旋转一次,鼠标离开后,又转一圈恢复回来,这样效果会更友好点。

(已解决)(优化)当前的h2级别目录最好也能往前移动下,会好看点

hugo-teek的:

teek的:

(已解决)代码块需要优化下,加长最后一行距离底部边缘距离(@白木)
(已解决)(bug)首页文章 hover后卡片边框会出现一个白色,这个白色圈能否去掉,每次出现有点难受(之前teek博客是没这个问题的)
群主回复:(2025年11月23日)
之前都解决了,不过后来开发过程中又复现了。。。。🤣🤣🤣



(已解决)(紧急重大bug)最新版 代码块折叠功能失效了(很影响用户阅读博客体验)
2025年12月27日记录。

(已解决)(严重影响体验)没法自动定位文件位置
2025年12月24日测试。
pc段,首页文章点进去之后,依然无法自动定位到文件位置,但是文件有被重点标注:
移动端,点击文章进去后,侧边栏对应起文件没重点标注,也没自动定位位置:
(严重影响用户文档库的体验)bug:点击首页文章后,进到对应文章层级目录后,没法自动定位到文件位置
bug:点击首页文章后,进到对应文章层级目录后,没法自动定位到文件位置。
之前vp就存在这个bug,官网也没修复。不知道Hugo-teek修复不?
合理情况应该是,点击首页文章后,会直接跳转到对应文章,且侧边栏也应该直接滑动到对应位置才对,而不是一直往下滑动自己找那个文件位置
作者答复:(2025年11月17日记录)


(已解决)cnb私有库 往 公开库 推送dist数据还是有点耗时哇,需要9.2s | 钉钉推送也有点耗时了,需要4.6s (待后续研究,目前速度基本够用)


2025年12月20日记录:

还可以优化钉钉


(已解决)可以支持全文搜索了哦,真不错(@xgq)
- Flexsearch文章字数越多索引就越长



(已解决)站点信息的行距可以更紧凑些
hugo-teek博客:

teek博客:

(已解决)让文章卡片和左侧卡片栏高度保持一致(让首页文章数量多一些)

(已解决)让首页加载更丝滑
案例:
https://lisir.me/ 基于vitepress
https://www.vvhan.com/ 基于Astro
(已解决)文章顶部的tag悬浮后没弹出其余tag

(已解决)footer底部元素的间距太大
hugo-teek存在的问题:

teek效果:

(已解决)(优化)移动版首页 文章卡片 两边留白可以再小点 (@尘影|chiplayout.top)
2025年12月24日记录。

🔴(紧急重大bug):之前说的侧边栏还是有一定问题的,从首页文章点进去的侧边栏是可以正常点击切换的。但是把侧边栏收缩后,再次想点开目录就会失败了,无法点开。[捂脸]
2025年12月26日记录。
(已解决)小火箭和评论的图标稍微再大点,目前有点小
hugo-teek效果:

teek效果:

(已解决)首页 最新评论样式又出bug了
2025年12月22日记录。

(已解决).gitignore里docs目录注释问题
官网仓库 .gitignore里的docs目录需被注释
(已解决)移动端 文章 左右2侧的小目录按钮 位置



讨论:



(已解决)全文模糊搜索
理想需求
如vscode、word、有道云笔记等可以实现全文精确查找。
必要性
不管是个人笔记,还是博客网站,如果能做到全文模糊搜索就尤其重要;
algolia方案(不能实现全文模糊搜索🤣)
pagefind方案(不能实现全文模糊搜索🤣)
pagefind extend版本 虽然 支持中文,但是对 断词做的不好,官网有说明(@时光)



为什么 md 目录大纲在 Pagefind 里效果差?(@官方解释)(待xgq大佬研究)
2025年12月18日记录。


案例:wp支持全文模糊搜索



Fuse.js方案(待xgq测试)
2025年12月18日记录。

(已解决)(优化)文章右侧目录行间距有点大,显得很奇怪,需改进
2025年12月15日提出

(已解决)移动端 侧边栏和文章目录 按钮点击后内容的弹出方式
当前hugo-teek效果:

还是之前的teek效果nice:
2025年12月23日讨论:




之前群主讨论:


(已解决)移动端 个人头像 右下角 小表情 白色圈太大;pc端也有小白圈;


teek博客风格:

(已解决)线上和本地侧边栏没问题,但是移动端侧边栏又出问题了
2025年12月22日产生:

(已解决)(优化)移动端正文字体有点小,🉐往大调一下
2025年12月23日记录:

(已解决)图片查看器新增点击图片区域外,可关闭图片,增强交互体验
白木图片样式优化:

(已解决)移动端适配图片查看器
(已解决)(比较影响体验)目录层级影响打包体积(侧边栏问题)
问题背景
目录层级不要太深(尽量限制在5级内)
2025年12月23日记录。






再次记录:2025年12月24日

w3c大佬提供的建议(使用hugo自身的语法重写侧边栏)



(已解决)导航栏 样式问题
🔴🔴待后续继续优化(2025年11月23日)
额,刚体验了下,hugo-teek的导航栏字体随着背景色深浅会切换成白色/黑色字体,这个效果体验不是很好,常规来说,作为导航栏字体,不能来回变化字体颜色,不然很奇怪,严重影响体验。
推荐按白木方式 让豆包重写下样式为好。
另外: teek博客的导航栏只有在鼠标往上滑动时,导航栏背景才会出现毛玻璃,默认情况,只有字体出现在导航栏区域的。 这个效果也是不错的,可以很好配合白木实现的导航栏风格。
xgq群主这个解决方案没问题了(对白色壁纸场景);但存在问题(在呼吸时候偶尔看不大清)

2025年11月23日记录。


但存在一个问题:


(闭环)hugo-teek的导航栏样式依然存在问题(字体一会儿为白色,一会儿为黑色;且当壁纸背景为白色时,字体也为白色,就会出现看不清字体问题,这个需要加上白木优化过的代码。)已提供css代码;
字体一会儿为黑色:

字体一会儿为白色:

白木优化过的代码:


最新代码:
1/* 仅首页全屏 Banner 时的导航栏样式美化 */
2.tk-layout .VPNavBar.home.full-img-nav-bar:not(.screen-open) {
3 /* 控制文字的阴影颜色 */
4 .VPNavBarTitle .title,
5 .VPNavBarMenuLink,
6 .VPNavBarMenuGroup .text,
7 .VPSocialLink {
8 color: var(--vp-c-white) !important;
9 text-shadow:
10 2px 2px 4px rgba(0, 0, 0, 0.5),
11 -2px 2px 4px rgba(0, 0, 0, 0.5),
12 2px -2px 4px rgba(0, 0, 0, 0.5),
13 -2px -2px 4px rgba(0, 0, 0, 0.5);
14
15 /* 添加平滑过渡动画 */
16 transition:
17 color 0.3s ease,
18 text-shadow 0.3s ease;
19
20 /* 控制鼠标悬停文字后的文字颜色 */
21 &.active,
22 &:hover {
23 color: rgba(0, 110, 255, 1) !important; // 修改文字颜色
24 text-shadow: none !important;
25 }
26 }
27
28 /* 控制搜索栏的阴影颜色 */
29 .DocSearch-Button,
30 .DocSearch-Input {
31 background-color: rgba(0, 0, 0, 0.5);
32 border-radius: 8px;
33 padding: 0.5rem 1rem;
34 color: var(--vp-c-white);
35 text-shadow:
36 2px 2px 4px rgba(0, 0, 0, 0.5),
37 -2px 2px 4px rgba(0, 0, 0, 0.5),
38 2px -2px 4px rgba(0, 0, 0, 0.5),
39 -2px -2px 4px rgba(0, 0, 0, 0.5);
40 }
41
42 .DocSearch-Button-Placeholder {
43 text-shadow:
44 2px 2px 4px rgba(0, 0, 0, 0.5),
45 -2px 2px 4px rgba(0, 0, 0, 0.5),
46 2px -2px 4px rgba(0, 0, 0, 0.5),
47 -2px -2px 4px rgba(0, 0, 0, 0.5);
48 }
49
50 /* 控制配置切换图标的描边颜色 */
51 .tk-icon {
52 cursor: pointer;
53 filter: drop-shadow(0 0 1px rgba(255, 0, 212, 0.5)) // 可修改描边颜色🔽颜色要与下面保持一致
54 drop-shadow(0 0 0.5px rgba(255, 0, 212, 0.5)); // 可修改描边颜色🔼颜色要与上面保持一致
55 }
56
57 /* 控制时钟容器背景色 */
58 #clock {
59 display: inline-flex;
60 align-items: center;
61 gap: 0.2rem;
62 position: relative;
63 border-radius: 0.5rem;
64 padding: 0.2rem 0.5rem;
65 background-color: rgba(0, 0, 0, 0.2); //可修改背景色
66 }
67
68 /* 控制时钟文字颜色 */
69 #clock .hour,
70 #clock .minute,
71 #clock .second,
72 #clock .separator {
73 color: rgba(255, 255, 255, 1); // 可修改文字颜色
74 }
75}
(闭环)(严重影响体验)希望把白木给teek博客贡献的导航栏样式给加上,不然,目前黑色壁纸背景导致菜单栏字体更笨看不清……
- 目前hugo-teek壁纸背景存在问题 截图:

- 修复办法代码链接:
https://onedayxyy.cn/teek/b2i4t

- 解决问题的背景:

- 解决思路

- 最终效果:

(已解决)刚点文章进去,二级标题是黑色的,稍等一会儿就变成粉色的了
2025年12月25日记录。


(已解决)(优化)让md文章 图片得居中,当前是居左的
(已解决)为啥文章目录底部这里多了个白条,遮挡了视线,效果很不好,之前都没的

(已解决)文章面包屑失效了

(已解决)发布时间又增加到28s了??(因为侧边看渲染级别增加)
2025年12月22日产生:

背景:


(已解决) (bug、紧急)本地的侧边栏没了,线上是有的
2025年12月16日测试:



(已解决)线上部分目录下的文档未正常显示。。。
2025年12月20日记录。
线上渲染:异常

本地文档:

(已解决)白木提供的2个好看的明亮和暗黑切换svg图标
2025年12月20日记录。
效果:


下载位置:
https://img.onedayxyy.cn/images/20251220-shiguang-two-icon.zip
(已解决)cnb流水线代码2个问题得再优化下
1在把私有库dist数据推送到公开库dist分支,init dist branch (public)阶段的代码还得再优化下,目前公开库dist分支体积持续增大,导致cnb流水线耗时加长。
2
3包括上面如果公开库是空仓库时,也需要自动创建下dist分支。
4
5上面2部分的代码还得再优化下,我记录下。晚点我用豆包试试。[破涕为笑]
问题1:
1在把私有库dist数据推送到公开库dist分支,init dist branch (public)阶段的代码还得再优化下,目前公开库dist分支体积持续增大,导致cnb流水线耗时加长。




问题2:
1包括上面如果公开库是空仓库时,也需要自动创建下dist分支。

(已解决)(待改进)之前的一个老问题,新建的md,直接提交后cnb后,流水线会发布失败
2025年12月17日测试。


(已解决)(待测试)(回退后出现的bug)下划线开头的文件或目录依然会出现在网站上
(已解决)(运行/构建太耗时)必须 极致优化hugo-teek的运行时间 & 构建时间


teek运行本地项目,很快的,几乎秒开。
(已解决)(运行 太耗时)每次本地运行项目太耗时了,能不能快速拉起来hugo-teek项目?
(已解决)如今的hugo-teek博客 发布有点耗时,660多文件,需要4min57s多了。。。。需优化
2025年12月17日测试
check也耗时40s 部署也得耗费56s [捂脸] 构建3min


仔细分析:




1私有库(博客主站点):https://cnb.cool/onedayxyy/hugo-teek-private 7.71 MiB
2公开库(dist内容):https://cnb.cool/onedayxyy/hugo-teek-public-dist 965.41 MiB


排查结果:w3c大佬反馈的






- 01openlist上配置ji168 2026-01-16
- 02后续可以借鉴的博客 2026-01-16
- 03心脏搭桥 2026-01-16
本页导航
- 已完成
- (已解决)目前hugo-teek换到默认侧边栏后,是有一定的Bug的,点击某个文档后,这个文档名称会往下缩进一下的,这个的修复下
- (已解决)悬浮文章右侧目录后,怎么不显示 多余的内容了?(把之前功能修复丢了🤣)
- (已解决)文章右侧 的 左侧分界虚线怎么没了? 不然别人都不知道咋们的目录能左右拖动宽度。
- (已解决)(紧急重大bug、性能问题)当前的hugo-teek侧边栏体验很卡–>丢弃转teek语法这个步骤 & 使用hugo默认的短代码配置侧边栏
- (已解决)(非常影响体验)总感觉当前hugo-teek的侧边栏体验,切换文件这个效果还是有点卡顿,是我站点文章里图片多导致的嘛? w3c这个就很轻。 应该是代码层的问题。。
- (已解决)侧边栏切换文件时整个侧边栏会刷新(@one)
- (已解决)告警容器里的图片语法没被正确渲染
- (已解决)容器里反引号和链接语法hugo-teek没识别
- (已解决)文档的最后更新时间应该从 文档修改时间取值,当时是从commit时间取值的
- (已解决)(紧急重大bug):当前最新版本,侧边栏问题解决了50%,目前第一次点击进去后,侧边栏还是有问题,重新点击一个文件后,整个侧边栏才会正常,可以看下我这个录屏
- (已解决)(bug)文章底部版权模块 文章链接 出现的是中文乱码
- (已解决)(优化)40.专题 下目录的数字序号没必要给显示出来哇,这个是排序用的
- (已解决)(优化)图片加阴影,hover后再出现蓝色边框(@白木)
- (已解决)(优化)个人头像hover效果需改进
- (已解决)(优化)当前的h2级别目录最好也能往前移动下,会好看点
- (已解决)代码块需要优化下,加长最后一行距离底部边缘距离(@白木)
- (已解决)(bug)首页文章 hover后卡片边框会出现一个白色,这个白色圈能否去掉,每次出现有点难受(之前teek博客是没这个问题的)
- (已解决)(紧急重大bug)最新版 代码块折叠功能失效了(很影响用户阅读博客体验)
- (已解决)(严重影响体验)没法自动定位文件位置
- (已解决)cnb私有库 往 公开库 推送dist数据还是有点耗时哇,需要9.2s | 钉钉推送也有点耗时了,需要4.6s (待后续研究,目前速度基本够用)
- (已解决)可以支持全文搜索了哦,真不错(@xgq)
- (已解决)站点信息的行距可以更紧凑些
- (已解决)让文章卡片和左侧卡片栏高度保持一致(让首页文章数量多一些)
- (已解决)让首页加载更丝滑
- (已解决)文章顶部的tag悬浮后没弹出其余tag
- (已解决)footer底部元素的间距太大
- (已解决)(优化)移动版首页 文章卡片 两边留白可以再小点 (@尘影|chiplayout.top)
- 🔴(紧急重大bug):之前说的侧边栏还是有一定问题的,从首页文章点进去的侧边栏是可以正常点击切换的。但是把侧边栏收缩后,再次想点开目录就会失败了,无法点开。[捂脸]
- (已解决)小火箭和评论的图标稍微再大点,目前有点小
- (已解决)首页 最新评论样式又出bug了
- (已解决).gitignore里docs目录注释问题
- (已解决)移动端 文章 左右2侧的小目录按钮 位置
- (已解决)全文模糊搜索
- (已解决)(优化)文章右侧目录行间距有点大,显得很奇怪,需改进
- (已解决)移动端 侧边栏和文章目录 按钮点击后内容的弹出方式
- (已解决)移动端 个人头像 右下角 小表情 白色圈太大;pc端也有小白圈;
- (已解决)线上和本地侧边栏没问题,但是移动端侧边栏又出问题了
- (已解决)(优化)移动端正文字体有点小,🉐往大调一下
- (已解决)图片查看器新增点击图片区域外,可关闭图片,增强交互体验
- (已解决)移动端适配图片查看器
- (已解决)(比较影响体验)目录层级影响打包体积(侧边栏问题)
- (已解决)导航栏 样式问题
- (已解决)刚点文章进去,二级标题是黑色的,稍等一会儿就变成粉色的了
- (已解决)(优化)让md文章 图片得居中,当前是居左的
- (已解决)为啥文章目录底部这里多了个白条,遮挡了视线,效果很不好,之前都没的
- (已解决)文章面包屑失效了
- (已解决)发布时间又增加到28s了??(因为侧边看渲染级别增加)
- (已解决) (bug、紧急)本地的侧边栏没了,线上是有的
- (已解决)线上部分目录下的文档未正常显示。。。
- (已解决)白木提供的2个好看的明亮和暗黑切换svg图标
- (已解决)cnb流水线代码2个问题得再优化下
- (已解决)(待改进)之前的一个老问题,新建的md,直接提交后cnb后,流水线会发布失败
- (已解决)(待测试)(回退后出现的bug)下划线开头的文件或目录依然会出现在网站上
- (已解决)(运行/构建太耗时)必须 极致优化hugo-teek的运行时间 & 构建时间
- (已解决)(运行 太耗时)每次本地运行项目太耗时了,能不能快速拉起来hugo-teek项目?
- (已解决)如今的hugo-teek博客 发布有点耗时,660多文件,需要4min57s多了。。。。需优化