1.紧急待办

紧急待办

目录

[toc]

紧急待办

🔴（紧急重大bug）：之前说的侧边栏还是有一定问题的，从首页文章点进去的侧边栏是可以正常点击切换的。但是把侧边栏收缩后，再次想点开目录就会失败了，无法点开。[捂脸]

2025年12月26日记录。

1、配置中心

核心思想

博客配置 和 md文档 完全分离，对小白用户来说，只需专心维护md就行，博客配置只需要在图形化上傻瓜式的点点点就行，无需接触底层代码，即可拥有一个超级无敌的丝滑博客，彻底解放了双手。

1.需求背景

任何一款全新的博客，对小白用户来说，如何快速部署起来？如何配置成自己的用户信息？如何自行选择开启或者关闭博客里的一些功能？如何快速升级到最新版本？等等。

对于传统的博客（ssg静态博客、动静分离、动态博客等），以上问题都是一个相对很麻烦的事情。

或许你说有群主耐心的解释、群主详细的文档、群里小伙伴热心的答疑、群里热心小伙伴详细的手把手文档，但是，用户在实际部署和配置过程中，99%存在各种各样的问题🤣。同样，后续新进来的小伙伴也会遇到相同的问题。这样无疑浪费了彼此的大量时间😂。

那么，有什么办法可以解决以上问题呢？

so，hugo-teek的配置中心就可完美解决以上问题。

小白博客用户 拉取hugo-teek源码后，双击点击start.bat脚本后，我们在浏览器通过ip:端口就会打开一个图形化界面。此时，小白用户只需在图形化界面配置一些自己的用户信息，自己选择开启或者关闭一些博客功能，根本无需接触代码，有手就好。

这样是不是非常简单，屏蔽了底层的代码，把简单留给用户，代码开发留给开发者,可以让博客用户专心维护自己的md文档数据，更笨无需关心复杂的博客配置。另外，后续升级，也可以在web上点击一键更新，就可升级到最新版本，尽情享用。

2.理想需求

小白博客用户 部署完hugo-teek博客后，需要将原有一些用户自定义信息修改为自己的信息，一般只需要修改如下事项。那么我们只需要在开发模式下运行博客后台，通过图形化界面的 点点点操作 即可完成如下的用户自定义配置信息，非常简单，有手就行。😍

1. 添加/删除 首页壁纸；更改显示方式（顺序显示/随机显示）；
2. 自定义打字机内容；选择打字机风格；
3. 选择向下滚动小箭头风格；
4. 添加/删除 首页文章封面；
5. 修改 博客名称、logo 图片、标签页名称及副标题
6. 修改 个人头像、个人头像背景、个人头像下座右铭、个人联系方式、github地址、首页侧边栏微信公众号
7. 修改 footer 备案号，公安备案号，座右铭
8. 搜索配置、评论配置
9. 选择 网站主题色
10. 选择 网站字体；新增/删除 网站字体；
11. 选择 网站风格：文档风、简约博客风、完整博客风（文章卡片风、文章列表风、半图背景、全图背景）等
12. 添加友联（需要区分为首页友链 和 独立页面友链）；
13. 添加赞赏人员名单；
14. f11屏保模式：是否需要显示博客名称、打字机、大波浪；
15. 丝滑的md编辑界面；
16. 一键批量导出所有md；

…（目前已知的就这些）

3.实现方式

单纯就是基于hugo配置文件搞，省去使用者修改配置文件的时间。

图形化动态修改博客配置, 如果要持久化到数据库 就违背了做 静态站的初衷了。

可视化配置后直接修改配置文件吗，是的。只有开发模式才能看到后台，部署到公网不会有后台的。

hugo-teek的配置中心（图形化后台）（只存在开发模式下）；

2、一键升级

🍊 预期需求

本地运行图形化管理后台后，wed点击一键升级到最新版，即可。

🍊 XGQ群主 和 teek群主 讨论

🍊 如何实现：在一键升级新版的同时能保证自己之前配置的自定义用户信息不变？

🔴（严重影响体验）没法自动定位文件位置

2025年12月24日测试。

pc段，首页文章点进去之后，依然无法自动定位到文件位置，但是文件有被重点标注:

移动端，点击文章进去后，侧边栏对应起文件没重点标注，也没自动定位位置:

（严重影响用户文档库的体验）bug：点击首页文章后，进到对应文章层级目录后，没法自动定位到文件位置

bug：点击首页文章后，进到对应文章层级目录后，没法自动定位到文件位置。

之前vp就存在这个bug，官网也没修复。不知道Hugo-teek修复不？

合理情况应该是，点击首页文章后，会直接跳转到对应文章，且侧边栏也应该直接滑动到对应位置才对，而不是一直往下滑动自己找那个文件位置

作者答复：（2025年11月17日记录）

🔴 （严重影响体验）不能热更新

为啥hugo-teek本地运行后，配置摘要后不能热更新？更新文章内容后也不能热更新？（万万没想到）

🍊 得不偿失🤣🤣🤣（啊啊啊）

2025年12月23日更新。

啊啊啊……

（比较影响体验）启动项目还是太慢（得44s）

目前hugo-teek启动项目还是有点慢（得44s），teek那个一运行基本就立马起来了，hugo-teek这个得好久，不知道为啥？

2025年12月23日测试

2025年12月17日测试。

（比较影响体验）目录层级影响打包体积（侧边栏问题）

问题背景

目录层级不要太深（尽量限制在5级内）

2025年12月23日记录。

再次记录：2025年12月24日

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

提升下 一键web更新 优先级

疑问：提升下 一键web更新 优先级？

另外，鉴于能够让更多的小白用户更早使用hugo-teek，可以考虑把 一键web更新（如何实现：在一键升级新版的同时能保证自己之前配置的自定义用户信息不变？） 提升下优先级，不知道这部分代码好写不，还是说得等到配置中心开发得差不多地步再说？

这样，用户自己可以定义一下hugo-teek博客的信息（例如壁纸、封面、twikoo评论、umami等常用的选项）

否则每次升级后都得单独配置这些内容，很繁琐。

hugo-teek 配置中心的win版也得适配下

🔴（需求）hugo-teek 配置中心的win版也得适配下，让小伙伴提前体验下