作者：Kuqilin（kuqilin@outlook.com）

Tips

本文中，看到字体颜色为蓝色且带有类似“🔗”图标的为跳转链接，可以点开
看到一段话右上角（就像幂次一样）带有一个蓝色数字且有类似“🔗”图标的是注解，点它可以跳转到文末看注解。注解最后面类似“↩️🔗”图标的是返回原文
这是第二版了，第一版在「归档」里面

其实挺早就有写年记的想法了，忘记是从谁的 Blog 看到的了，想着既然我不写日记、不写周记，也没有月记，那还是写个年记吧。没想到由于各种各样 不可抗力 的原因，比如「不知道是每年元旦发、还是除夕发，抑或是生日发」这些问题 （其实是超级无敌拖延症犯了） 导致一直没写成。至于为什么突然写了，我也不知道。所以，这是我第一篇「年记」 谁知道会不会是最后一篇呢
既然是每年生日发出来（如你所见） 并非如此，当时还在想要不要发出来 ，那么整个年记肯定就要从 2025 年 09 月开始呗。
诶，话说这样还挺好，正好是一学年，所以这个「2026 年记」其实是「2025 学年记」来的。

这么一想，这年还是做了挺多东西的呢。

去年生日当天，又去了一次二中，参加广州市的数学与科学联赛（信息学），被人完虐。不过也是吃上二中的饭菜了（喜）。没过几天，又去了趟铁一，打 CSP¹ 的去了。第一轮还好，还算简单，结果第二轮，去到六中参加， 相比于市联赛，还是复赛对我好点 那时年少轻狂，结果 T3 忘记取消文件输出的注释，导致这题没输出答案，我的二等奖啊😭
那天，下着雨…… 编不下去了
然后，台风桦加沙🌀来了，把我们的学农挤走了，比较可惜的就是没有 挑粪 野炊。

这一年里，也是在 Google Play² 里把 Minecraft 以极低的价格拿下了，至此，PC 端的 Bedrock+Java 和移动端的 Bedrock 已经全部拿下³。

这年，还参加了北师大的数学建模比赛，在拖延症的统治下，成功地把实验 & 写作时间挤压到一个月内。 我失去的一个寒假机会谁给我补啊 在这里，要特别感谢为我论文实验提供大力支持的呆萌der杜小杜，为我们提供实验场地和实验器材。以及我们小组的同学，Kimi Agent⁴真香，$\mathrm{\TeX}$⁵轻而易举啊。最后也是成功拿下省一等奖。 怎么我们学校一个进决赛都没有啊😭 关于这篇论文的小故事，也许会再写一篇，但也大概率被我拖到猴年马月。一开始，小组选题其实是绿化对城市热岛效应的影响，毕竟都是地理班的学生，结果发现，这玩意光收集数据就太麻烦了，这还只是从各种网站下载遥测数据的情况去，更别提自己做实验了。后来不知哪根筋抽了，看到人大附中那篇怎么开碳酸饮料能不溢出的论文，就想着做一个碳酸饮料清洁厕所🚽，当时还是太天真了，以至于被豆包骗，斥巨资买了一斤的磷酸三钠($\ce{Na3PO4}$)，结果制造污渍需要的是小苏打和氯化钙混合得到碳酸钠（骗你的，其实还要加热）。后来为了数据，连续三周去了杜小杜的实验室，每周日都去，一去一上午。后来还要 vibe code⁶ 一个提取陶瓷片灰度值的程序，总算是把数据什么的搞定。不容易啊！

论文下载
可乐能清洁厕所吗？ ——碳酸饮料清洁厕所效果的影响因素分析与数学建模

这年，玩了好几个解密类游戏，「机械迷城」、「纪念碑谷」、「纪念碑谷 II」、「纪念碑谷 III」全都玩了，只能说挺不错的。

这年，去了「琶洲实验室」，体验了一些全运会所使用的高科技，比如人工智能手语翻译、非侵入式脑机接口操控轮椅等，挺不错的。

这年，参加了学校艺术节，虽然在幕后基本没干什么，但是编不下去了我们班的节目也是拿下一等奖了呢🤣

这年，顺手给电脑分了个 128GB 出来装 Cachy OS⁷，没想到给数学论文写作提供了极大的便利 指还得从 Win 里面把字体拷过来、自己写 TeX 配置文件、编译一次 PDF 花我一分钟 不得不说$\mathrm{\LaTeX}$是真香啊，极致优美的排版、 极其臃肿的编译 ，以及一眼过去全是反斜杠\的「宏地狱」⁸。

这年，成功地埋下了 5 年后的时空胶囊，必须吐槽的是学校机房的光驱真是一坨，吞了我两块档案级光盘（我的钱…）和好几块普通光盘，不过也是成功刻录好了。等到 2031 年再搞台光驱读取，但愿我不要忘了密码…

Important

别问为什么不用 U 盘、移动硬盘，这些太久不通电得话电荷会逸散，导致数据丢失，而光盘是用物理方式记录数据的，能保存挺久

今年，收到了来自中国东极的第一缕阳光的祝福，黑龙江省佳木斯市抚远。

今年，有幸在班上晚修看了「元宵+月食」的直播 那天广州的天气太差了😭 一生只有这一次！

其实，9 月份的时候，貌似还有过一场月食，我们宿舍恰好能从阳台看到，那周便带了一个望远镜，半夜时分起来看月食。不过，天公依旧不作美，☁☁☁，时不时地挡一下。这年，一次完整月食都没看过啊。

这年，又拉了好几个人入坑 PGP⁹。这年又有许许多多的期望与失望，本以为无希望的事却又突然成功、本以为成功的事却无望，就这样起起落落、浮浮沉沉。不久前，想到了一个题目「雅园的最后一个冬天」，想写点什么，却又什么也写不出来。没有什么题材，全部都藏在每一天的学习与生活中。读到这篇年记的同学有能力的可以写一写，顺便发给我看看(嘻嘻)。

这年，退出了信竞，正因如此，开始读书了。这 5 年来，看似学了很多，真正有用的又有多少呢？真正带来的，是不断的学习的习惯吧。多少是有点不甘的，不过这又有什么用呢，也只是日后一个谈资罢了。不过阅读确实可以开拓视野、增长见识。先是 $\textit{Just}$ $\textit{for}$ $\textit{Fun:}$ $\textit{The}$ $\textit{Story}$ $\textit{of}$ $\textit{an}$ $\textit{Accidental}$ $\textit{Revolutionary}$ 再到《化学之书》、《世界神话二十五讲》、《太空漫游：2010》、《太空漫游：2061》、《美丽新世界》等等的书籍，不能说大大拓展我的视野和知识面 broaden my horizons乱入 ，但是除了消遣之外，还是让我了解不少内容。接下来应该还会把《夜色温柔》、《瓦尔登湖》这些书看一看（确信）。

这年，终于想起来自己还有个 Blog 闲置很久，于是暑假简单用 Hugo¹⁰ 搭了一个，不过这个主题嘛，本身是博丽灵梦¹¹的，装主题简单啊，改主题要累死。这张照片、那张照片，这个配置、那个配置，不过还好，deepseek-v4-pro 确实好用，挂上 Kimi Code¹² 之后直接完全自主 覆盖掉我 5 个视频文件不嘻嘻 修了好几个主题的问题，顺手加了一个 Shortcode¹³ 功能spoiler来实现文本的遮罩效果，就像这样子，显然你前面已经见过了。搭好 Blog 之后把一些古早的.md¹⁴文件也传了上来，所以……。今年 Deepseek 的 token¹⁵ 消耗大概有 1B(illion) 了，虽然听起来很多，实则并不少。

今年，高三了，嗯，高三了。也就高三了。没什么宏大的叙事，没什么激情的话语，也没有什么特别的感悟。很普通，和初三没什差别，初三那时也只是在 $24$ 年 $3$ 月份从楼梯间的窗户看到异木棉又开了，才发觉自己初三，在广雅又有什么标志物呢？昭明楼的玉兰花已经开过两次了……那个香气甚至在三楼都能闻到，不知四楼如何。

今年健康状况有些许下降，最直观的感受是请了两天病假。

四月底学校组织去“研学”，也是好好地玩了一趟，也还算可以吧。

今年，大抵还做了几个小玩意，一个是用 Python 重写了网易云音乐的.ncm格式转.mp3/.flac工具ncmdump的ncmdumpPy，能够保留歌曲元数据，即图片、作者信息等；一个是烂尾的切换广雅一体机壁纸的程序花都校区定制壁纸切换，结果出了一个可用版本之后就烂尾了，现在高二（9）班的畅言依旧装着［当然，高三（9）班也有］。还有一个要在这里跟大家坦白的，就是classNightLapse，即晚修延时摄影程序，有时候晚修会提前打开来拍摄第一节晚修的延时摄影🥺，放心，所有视频文件均没有外传，并且已经删除。当初做这个的目的其实是想要看看自己上晚修是一个什么状态，所以还请各位轻喷。毕竟开着这个程序拍延时摄影，会占用摄像头，导致希沃云班无法看到我们的晚修🥰。不过现在，“金盆洗手”了，以后不再录这个延时摄影了，不过高考前的晚修倒是可以考虑一下（嘻嘻¹⁶
欸，看来写的这个遮罩效果还有待加强啊，Emoji 都遮不住😭，有色字体也没遮住😭😭

这年，听得多的还是$\textit{Secret}\ \textit{Garden}$的$\textit{Anticipation}$这首歌，不多说，你们自己听。

今年跟初中部分同学们小聚了两次，吃了一顿饭和一顿烧烤，也还不错。不过今年没回初中看看，挂了那个私人牌子我还哪敢回去啊😭😭😭是谁干的!!!

这年初时，貌似还挺常冲固体饮料喝的，想什么阿华田、立顿的奶茶、牛乳茶等，不知为什么高二下又没怎么喝，不过，这学期倒是又补充了挺多的，大抵是因为夏天太热了，冬天的时候，北风经过十班旁边的那一段“狭管”，这时候在那里冲上一杯确实是个享受。

这年，买了个 16V 1A 的 DC 5.5×2.5 电源适配器，又买了个 USB-B 的线，往虚拟机里装了个 Windows XP 又下了个古老驱动，总算是把那台 09 年的扫描仪给复活了。尽管扫描版上有些发霉，但丝毫不影响，最高 1200 DPI 和 48 位彩色¹⁷吓死个人，扫一张不下 5 分钟，并且文件大小大概到了 600 MB 的样子。这我可无福消受，只好开 600 DPI 来扫 9 班同学的签名，就算这样，也是到了 1 分钟左右，每张 100 MB 左右了（也许就发过给你呢？）。所有的扫描出来，也才 4 GiB 左右，刻进一个普通 DVD 刚好:)

噢，本来想着上 XP 截个图放过来的，结果发现没激活的 30 天使用早过了，网络机会也莫名其妙不可用，于是想着试试电话激活，输入了激活码后，打电话¹⁸。想起了每年都有人做的“打电话给微软激活 Windows”，结果发现电话激活门户已经迁移到网络上，本来还想试试在手机上输那 14 组 6 位数字是什么感觉，可惜了。
激活完才发现虚拟机里面的文件早删了，所以这里没截图😁

这年的课堂，文科没什么好说的。数学可谓是不断付出，结果却一直不尽人意的科目了。上课认真做到了，课后作业认真做了，不过化用一下泰戈尔的诗句：“数学以痛吻我，我报之以歌。”物理算是给我倒一盆冷水，这年的成绩曲线可谓是一个$\forall x_1, x_2 \in \text{今年的考试}\ (x_1 < x_2),$ $\dfrac{f(x_1) - f(x_2)}{x_1 - x_2} < 0$。化学一如既往，无需赘述，不过赋分是真吃大亏了。

这年，把哔哩哔哩的个性化推荐关了（详情可见20260517），本想着离开短视频，结果变成了一直在刷 TG¹⁹ 频道里的各种 meme²⁰，感觉也没比刷短视频好多少。不过至少离开了那些引战、“愤怒诱饵”等的东西，终究是向好的。今年也开始看点电影了，看了个《王牌特工：特工学院》，又看了 007 系列的前 3 部。

今年，也是当上半个“植物人”了，参加读后续写得到的一罐“驱蚊草”被种下。然后又掰了一截高一研学时得到的“碰碰香”回去种。 至于驱蚊草到底能否驱蚊，有待考证。

要问为什么土这么满，被某人填的。

八月底的时候，DeepSeek Harness发布，装来玩了一下，这种搭乐高一样的插件模式可操作性非常强，也是给我帮了不少忙（比如那个 315 成语用法辨析小测）。

这里删掉了两段话，放出来不太合适。放心，查 Git 提交记录也找不到的^_^

游戏方面，这年一如既往，还是打 9 和荒野乱斗。Minecraft 因为时间原因要先放一段时间了。9 应该还会一直玩下去，不过荒野乱斗可能不定时退坑。

还有什么可写的呢？扔给了 LobeHub 上的一个 agent，让我写对未来的展望或者目标，这里贴一个 meme：

对了，今年参加了“十佳学生”竞选。本来以为那个体测成绩会绊我一脚，结果却给我过了第一轮的“广雅好少年”。广雅真草台，本来说好要假期就给我们制作海报的，结果拖到八月底，29 号才发了方案……怎么说呢？只好斥巨资开了个Canvas可画的会员，耗时两天做出了这个玩意：

这篇年记，虽说是生日发出来，其实基本都是从写于 7 月下旬开始写的。所以多少会缺少一点时效性。并且，这篇年记只是一个记录，大家对事不对人，也别过多讨论🤝🏻🙏🏻。
大致完成这篇年记的草稿时，内心其实是没什么感想的，就是感觉完成了一件事，仅此而已。就这样吧。

在不知不觉中，上了一个半月的学了，八月适应考开了个头，以后如何？不得而知。想起那句话了，“生存是进步的最大动力，我们为此赞美牺牲者，但畏惧和厌恶死亡并不可耻，真正该警惕的是停止前进。”，前进吧，向前看！

接下来一年，十校联考、调研考、一模、听说……不同的事情；下一次年记动工，得是高考后了，那时会有什么感悟呢？恭喜我又活过一年🧡

其实目前还是挺满意自己的：成绩还可以、课外耍耍 AI、写点小东西玩玩，比起只学习没人情味的人还是好很多的（请勿对号入座）。

贴两张照片结尾

时代的潮水不断起落，正如日夜更迭流转，一晦一明，永无止境。尽情向后展望吧，我们有取之不尽的未来。
Tides of time rise and fall. Days and nights switch and whirl. The infinite loop will never come to an end. Go ahead, look as much as you want. We have an endless supply of the future.

声明：本文不遵从 CC BY-NC-SA 许可协议，不允许转载。

本文2026-09-13首發於Kuqilin's Blog，最後修改於2026-09-13

本部落格所有文章除特別聲明外，均採用 BY-NC-SA 授權協議。轉載請註明出處！

作者：Kuqilin（kuqilin@outlook.com）

Tips

项目地址：github.com/kuqilin/classNightLapse

背景

想用班上一体机的摄像头来拍班级晚修的延时摄影，因此写了这个简单的 Python 程序。非常好用哈，在晚修前运行这个程序，没有痕迹，下晚修后就能看到成片了 ^_^

全程只需要 opencv-python 和 requests 两个依赖，核心就是一个 main.py，简单粗暴。

Note

附带效果：程序运行期间摄像头会被一直占用，所以老师也没法通过希沃云班远程看我们晚修了（嘘，这算是写这个程序的一大动力）🤫

功能特性

• 定时自动拍摄：设置开始 / 结束时间（默认 18:55–20:35，正好覆盖一节晚修），到点自动开拍，结束自动保存
• 拍摄间隔可调：默认 1 秒拍一帧，一节晚修 100 分钟 ≈ 6000 帧，最终以 30fps 合成，成片约 3 分多钟
• 自动时间戳：每帧右上角叠加当前时间，背景色根据画面亮度自适应（亮背景黑底白字，暗背景白底黑字）
• 双输出日志：控制台和日志文件同步记录，方便排查"为什么没拍上"
• 可选 WebDAV 上传：拍完自动把成片传到网盘（默认关闭，需要自己改配置）

项目结构

classNightLapse/
├── main.py            # 全部代码，单文件
├── requirements.txt   # opencv-python、requests
├── LICENSE            # MIT
└── .gitignore         # 忽略 outputs/ logs/ 等

核心实现解析

配置区

所有参数都集中在文件头部，改起来非常直观：

WEBDAV = False                 # 是否启用 WebDAV 上传
START_HOUR, START_MINUTE = 18, 55
END_HOUR, END_MINUTE = 20, 35
CAMERA_INDEX = 0               # 摄像头编号
OUTPUT_FILE = f"outputs/{datetime.now().strftime('%Y-%m-%d_%H-%M-%S')}.avi"
FPS = 30                       # 最终视频帧率
FRAME_WIDTH = 1920             # 试了几个，只有这个能拍全班级
FRAME_HEIGHT = 1080            # 3224 那个不够宽，拍不全
INTERVAL_SECONDS = 1           # 拍摄间隔，单位秒
SHOW_TIMESTAMP = True          # 是否显示时间
LOG_FILE = f"logs/{datetime.now().strftime('%Y-%m-%d_%H-%M-%S')}.log"

这里有个小细节：分辨率是试出来的，只有 1920x1080 能把整个班级拍全。输出文件和日志文件名都带时间戳，每次运行不会互相覆盖。

主流程 main()

整体思路很清晰：

# 1. 如果已经过了结束时间，直接退出
# 2. 如果还没到开始时间，睡到开始前 2 秒
# 3. 打开摄像头、设分辨率、读一帧确定尺寸
# 4. 创建 VideoWriter，精确对齐开始时间拍第一帧
# 5. while 循环按绝对时刻拍摄，直到结束时间
# 6. finally 里释放资源，统计帧数，可选上传 WebDAV

值得一说的有两个点：

提前 2 秒打开摄像头。摄像头初始化需要时间，如果到点才开始初始化，第一帧会晚于预定时刻。所以程序在开始时间前 2 秒就打开摄像头，等真正到点了直接抓帧，保证第一帧精确落在 18:55:00。

绝对时刻调度防漂移。拍摄循环里没有用"睡 1 秒"这种相对间隔，而是维护一个 next_capture 绝对时刻，每拍完一帧就 next_capture += timedelta(seconds=INTERVAL_SECONDS)，再睡到那个时刻：

# 下一个预定拍摄时刻（绝对时间，避免累积偏差）
next_capture += timedelta(seconds=INTERVAL_SECONDS)

这样即使某次 sleep 或抓帧慢了，也不会把误差累积到后面，长跑一节课也不会越拍越飘。这个细节很关键，延时摄影最怕的就是节奏漂移。

时间戳 draw_timestamp()

每帧右上角叠加时间，背景色是根据画面亮度自适应的——先取背景框区域的平均亮度，亮背景用黑底白字，暗背景用白底黑字：

mean_brightness = cv2.mean(gray)[0]
if mean_brightness > 128:
    bg_color = (0, 0, 0)          # 黑色背景
    text_color = (255, 255, 255)  # 白色文字
else:
    bg_color = (255, 255, 255)    # 白色背景
    text_color = (0, 0, 0)        # 黑色文字

再用 cv2.addWeighted 做 0.6 透明度的半透明底，效果比直接白字好看不少，晚修教室灯光忽明忽暗也不会看不清。

日志 logprint()

同时写控制台和日志文件，每行都带时间戳。晚上在教室一体机上跑的时候，你不可能一直盯着屏幕看，出问题了翻日志就行：

def logprint(message, end='\n'):
    print(f"[{datetime.now().strftime('%Y-%m-%d %H:%M:%S')}] {message}", end=end)
    with open(LOG_FILE, 'a', encoding='utf-8') as f:
        f.write(f"[{datetime.now().strftime('%Y-%m-%d %H:%M:%S')}] {message} {end}")

WebDAV 上传 upload_webdav()

默认关闭。开启后拍完会把成片用标准 PUT 请求传到 WebDAV 网盘（用的是 HTTPBasicAuth 认证），这样不用回教室就能在手机上看到成片：

resp = requests.put(
    url,
    data=data,
    auth=HTTPBasicAuth(USERNAME, PASSWORD),
    timeout=120,
    verify=False,  # 忽略 SSL 证书问题
)

如果要用 WebDAV，记得自己改配置并重新编译。

异常兜底

while 循环外面包了 try / except KeyboardInterrupt，即使中途被人 Ctrl+C 打断，也会在 finally 里正常释放摄像头、保存已经拍到的部分，不会丢帧丢文件。

使用方法

pip install -r requirements.txt
python main.py

到点自动开拍，结束自动保存成片到 outputs/ 下。日志在 logs/ 下。

想部署到班上一体机的话，可以根据 .gitignore 里预留的 build/、dist/、*.spec 用 PyInstaller 打成 exe，直接双击运行，非常省事。

总结

一个单文件就能搞定的延时摄影小工具：定时开拍、自动时间戳、防漂移调度、日志兜底，功能不多但都很实用。代码量不大，感兴趣的可以直接去看源码：classNightLapse。

下次晚修，记得提前 2 分钟运行它，下课后就能收获一份属于全班的三分钟延时大片了 🎬

本文2026-08-23首發於Kuqilin's Blog，最後修改於2026-08-23

本部落格所有文章除特別聲明外，均採用 BY-NC-SA 授權協議。轉載請註明出處！

作者：Kuqilin（kuqilin@outlook.com）

Tips

建议先通读本文了解基本流程和坑以后在一步一步跟着操作。
因为作者表达能力欠佳，本文由作者写完之后交由 AI 进行润色。

虽然花时间翻译自己的文章并不常见，但既然做了，就记录一下完整流程，方便后来者。

为什么需要手动配置？

Hugo 本身支持多语言（i18n），但主题通常需要你按约定组织文件和配置。Reimu 主题默认只提供单语言结构，要启用多语言，你需要做三件事：

1. 重构内容文件夹，按语言分目录
2. 为每篇文章关联翻译（通过 translationKey）
3. 在配置文件中声明语言，并（如果使用非内置语言）补充主题的本地化文案和翻译文件

下面按步骤展开。

第一步：调整内容文件夹结构

Reimu 主题默认将文章放在 content/ 下（如 content/post/、content/about.md 等）。
多语言时，需在 content/ 下为每种语言单独建一个子文件夹，子文件夹名即为语言代码（如 zh-CN、en、yue）。

操作示例
假设你原有简体中文内容（zh-CN），现在要增加英文（en）和粤语（yue）：

1. 在 content/ 下新建 zh-CN/、en/、yue/ 文件夹。
2. 将原来 content/ 下的所有内容（about.md、post/ 等）整个移动或复制到 zh-CN/ 内（作为默认语言）。
3. 再将 zh-CN/ 下的内容复制到 en/ 和 yue/ 中，之后分别翻译各文件夹内的 .md 文件。

最终结构类似：

content/
├── en/
│   ├── about.md
│   ├── archives/
│   ├── friend.md
│   └── post/
├── yue/
│   ├── about.md
│   ├── archives/
│   ├── friend.md
│   └── post/
├── zh-CN/
│   ├── about.md
│   ├── archives/
│   ├── friend.md
│   └── post/
└── zh-TW/          # 可选，以此类推
    ├── about.md
    ├── archives/
    ├── friend.md
    └── post/

注意：原 content/ 根目录下不要再放置任何内容，否则 Hugo 会将其视为无语言归属的内容，可能引发混乱。

第二步：关联不同语言版本（translationKey）

Hugo 需要通过 translationKey 来识别哪些文件互为翻译。
在每个语言的对应文件中，frontmatter 里写上相同的 translationKey 值。

例如，在 content/zh-CN/about.md、content/en/about.md 和 content/yue/about.md 中都加入：

translationKey: about

同样，每篇博文（如 post/hello.md）也要在所有语言版本中设置相同的 translationKey（可以设置为文章标题的 slug 或自定义标识）。

为什么重要：没有这个字段，语言切换按钮将无法在文章页显示可切换的语言列表。

第三步：在 hugo.toml 中声明语言

完成文件夹结构后，构建时 Hugo 会找不到语言定义而喜提报错。你需要在 hugo.toml（或 config.toml）中为每一种语言添加配置。

基础配置示例（以粤语 yue 为例）：

[languages.yue]
  locale = "yue"                # 语言代码，需与文件夹名一致
  label = "粵語"                # 界面显示的语言名称（可自定义）
  hasCJKLanguage = true         # 若语言包含中日韩文字，设为 true
  contentDir = "content/yue"    # 指向该语言的内容文件夹
  weight = 2                    # 在语言切换列表中的排序，数值越小越靠前

其他语言（如英文）同理：

[languages.en]
  locale = "en"
  label = "English"
  hasCJKLanguage = false
  contentDir = "content/en"
  weight = 3

设置默认语言（避免浏览器语言偏好干扰）：

defaultContentLanguage = "zh-CN"   # 设为你的主语言

提示：weight 影响切换菜单中的顺序，建议为常用语言设较小值。

第四步：处理「主题未内置」的自定义语言

Reimu 主题自带了一些 UI 文案（如“复制成功”），但只在部分语言（如 en、zh-CN、ja 等）中预置了翻译。
如果你添加的语言不在主题支持列表中（例如泰文 th、粤语 yue 虽然主题可能未包含），则必须额外补充两处配置，否则构建时主题会因找不到对应语言的文案而报错。

4.1 补充 params.yml 中的文案翻译

主题的 UI 文案定义在 themes/reimu/config/_default/params.yml 中。
你需要将这份文件复制到项目根目录的 config/_default/params.yml（若没有则新建对应文件夹），然后在该文件中为你的语言添加所有字段。

例如，原文件中有 clipboard.success 字段：

clipboard:
  success: 
    en: Copy successfully (*^▽^*)
    zh-CN: 复制成功 (*^▽^*)
    yue: 複製成功 (*^▽^*)          # 新增 yue 的翻译
    zh-TW: 複製成功 (*^▽^*)
    ja: コピー成功 (*^▽^*)
    pt-BR: Copiado com sucesso (*^▽^*)

你需要检查所有带 i18n 的字段（如 comment.title、preloader.text 等），逐一为你的语言添加对应值。
注意：语言键（如 yue）必须与你在 hugo.toml 中 [languages.yue] 的 locale 值完全一致。

4.2 创建独立的 i18n 翻译文件

Hugo 本身需要一些基础翻译字符串（如月份名称、日期格式等），这些在主题的 i18n/ 文件夹中提供。
同样，将 themes/reimu/i18n/ 下的某个现有文件（如 zh-CN.yml）复制到项目根目录的 i18n/ 文件夹中，重命名为你的语言代码（如 yue.yml），然后将里面的字符串逐一翻译成你的语言。

如果不做这一步，Hugo 构建时会因为缺少翻译数据而报错（类似 missing translations）。

常见问题

• 切换语言后页面 404？
  检查 contentDir 路径是否正确，且每个语言文件夹内确有对应文件。

• 语言切换按钮不出现？
  确认所有互为翻译的文件都设置了相同的 translationKey，且至少有两个语言版本存在。

• 修改后仍报错？
  运行 hugo --cleanDestinationDir 清除缓存后重新构建，有时旧配置会残留。

• 只改 params.yml 还不够？
  确保同时完成了 4.1 和 4.2 两步，缺一不可。

总结

Reimu 主题的 i18n 配置虽不复杂，但步骤环环相扣。简记要点：

• 按语言分目录 → 加 translationKey → 声明语言配置
• 若使用非内置语言，额外补充主题 UI 文案（params.yml）和基础翻译（i18n/*.yml）

按照上述步骤操作，你就能拥有一个完美切换的多语言 Hugo 站点。祝写作愉快！

本文2026-08-01首發於Kuqilin's Blog，最後修改於2026-08-01

本部落格所有文章除特別聲明外，均採用 BY-NC-SA 授權協議。轉載請註明出處！

作者：Kuqilin（kuqilin@outlook.com）

Tips

2026.07.23 21:33:48 UTC+08:00
Vibe 优化了所有 SVG 使得文件大小压缩了⅓，感谢 Deepseek-v4-pro。

忙活许久，终于让 AI 把$37$的签名用 SVG 画出来了。猜猜用的什么？答案出乎意料，是豆包。为什么不用 Deepseek 呢，因为鄙人提示词描述太烂了，Deepseek 为了理解我的要求，会思考特别久，而豆包确实很快，不过……这就是忙活这么久的原因😁
你问为什么不把 Deepseek 的思考关掉？因为豆包写的 svg 可以直接预览！

看看成果吧：

这张是 SVG 格式透明背景

这张是 SVG 格式透明背景白色填充

我也不知道作者为什么作者要放白色填充的进来，配置文件里也没看到用了，但还是放上吧（

下面是源码，可以自行更改颜色

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 300 300" width="300" height="300">
  <!-- 核心缩放与居中变换 -->
  <g transform="translate(150, 150) scale(1.645) translate(-150, -150)">
    
    <!-- 多边形与线段（描边样式统一，无需填充） -->
    <g stroke="#1a768c" stroke-width="3" fill="none">
      <polygon points="150,193.35 137.5,171.64 112.5,171.64 125,150 112.5,128.36 137.5,128.36 150,106.65 162.5,128.36 187.5,128.36 175,150 187.5,171.64 162.5,171.64" />
      <polygon points="150,236.60 125,193.35 75,193.35 100,150 75,106.65 125,106.65 150,63.40 175,106.65 225,106.65 200,150 225,193.35 175,193.35" />
      
      <!-- 合并所有主轴与中点连线 -->
      <path d="M100,150 L200,150 M125,193.35 L175,106.65 M125,106.65 L175,193.35 M100,193.35 L87.5,171.64 M87.5,128.36 L100,106.65 M137.5,85.03 L162.5,85.03 M200,106.65 L212.5,128.36 M212.5,171.64 L200,193.35 M162.5,214.97 L137.5,214.97" />
    </g>
    
    <!-- 合并所有圆心点（利用 path 和圆头端点模拟圆形） -->
    <path d="M150,150 h0 
             M150,193.35 h0 M137.5,171.64 h0 M112.5,171.64 h0 M125,150 h0 M112.5,128.36 h0 M137.5,128.36 h0 M150,106.65 h0 M162.5,128.36 h0 M187.5,128.36 h0 M175,150 h0 M187.5,171.64 h0 M162.5,171.64 h0 
             M150,236.60 h0 M125,193.35 h0 M75,193.35 h0 M100,150 h0 M75,106.65 h0 M125,106.65 h0 M150,63.40 h0 M175,106.65 h0 M225,106.65 h0 M200,150 h0 M225,193.35 h0 M175,193.35 h0 
             M137.5,214.97 h0 M100,193.35 h0 M87.5,171.64 h0 M87.5,128.36 h0 M100,106.65 h0 M137.5,85.03 h0 M162.5,85.03 h0 M200,106.65 h0 M212.5,128.36 h0 M212.5,171.64 h0 M200,193.35 h0 M162.5,214.97 h0" 
          fill="none" stroke="#1a768c" stroke-width="9" stroke-linecap="round" />
          
  </g>
</svg>

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 300 300" width="300" height="300">
  <!-- 核心缩放与居中变换 -->
  <g transform="translate(150, 150) scale(1.6465) translate(-150, -150)">
    
    <!-- 带白色填充的多边形（描边样式统一） -->
    <g fill="#ffffff" stroke="#1a768c" stroke-width="3">
      <polygon points="150,236.60 125,193.35 75,193.35 100,150 75,106.65 125,106.65 150,63.40 175,106.65 225,106.65 200,150 225,193.35 175,193.35" />
      <polygon points="150,193.35 137.5,171.64 112.5,171.64 125,150 112.5,128.36 137.5,128.36 150,106.65 162.5,128.36 187.5,128.36 175,150 187.5,171.64 162.5,171.64" />
    </g>

    <!-- 合并所有主轴与中点连线（无填充） -->
    <path d="M100,150 L200,150 M125,193.35 L175,106.65 M125,106.65 L175,193.35 M100,193.35 L87.5,171.64 M87.5,128.36 L100,106.65 M137.5,85.03 L162.5,85.03 M200,106.65 L212.5,128.36 M212.5,171.64 L200,193.35 M162.5,214.97 L137.5,214.97" 
          fill="none" stroke="#1a768c" stroke-width="3" />

    <!-- 合并所有圆点（利用零长度路径和圆头端点模拟 r=4.5 的圆） -->
    <path d="M150,150 h0 
             M150,193.35 h0 M137.5,171.64 h0 M112.5,171.64 h0 M125,150 h0 M112.5,128.36 h0 M137.5,128.36 h0 M150,106.65 h0 M162.5,128.36 h0 M187.5,128.36 h0 M175,150 h0 M187.5,171.64 h0 M162.5,171.64 h0 
             M150,236.60 h0 M125,193.35 h0 M75,193.35 h0 M100,150 h0 M75,106.65 h0 M125,106.65 h0 M150,63.40 h0 M175,106.65 h0 M225,106.65 h0 M200,150 h0 M225,193.35 h0 M175,193.35 h0 
             M137.5,214.97 h0 M100,193.35 h0 M87.5,171.64 h0 M87.5,128.36 h0 M100,106.65 h0 M137.5,85.03 h0 M162.5,85.03 h0 M200,106.65 h0 M212.5,128.36 h0 M212.5,171.64 h0 M200,193.35 h0 M162.5,214.97 h0" 
          fill="none" stroke="#1a768c" stroke-width="9" stroke-linecap="round" />
          
  </g>
</svg>

这里再附一个没那么大的，因为preloader如果用了上面的，会有遮住文字算算数学中…，所以这是没那么大的

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 300 300" width="300" height="300">
    
    <!-- 多边形与线段（描边样式统一，无需填充） -->
    <g stroke="#1a768c" stroke-width="3" fill="none">
      <polygon points="150,193.35 137.5,171.64 112.5,171.64 125,150 112.5,128.36 137.5,128.36 150,106.65 162.5,128.36 187.5,128.36 175,150 187.5,171.64 162.5,171.64" />
      <polygon points="150,236.60 125,193.35 75,193.35 100,150 75,106.65 125,106.65 150,63.40 175,106.65 225,106.65 200,150 225,193.35 175,193.35" />
      
      <!-- 合并所有主轴与中点连线 -->
      <path d="M100,150 L200,150 M125,193.35 L175,106.65 M125,106.65 L175,193.35 M100,193.35 L87.5,171.64 M87.5,128.36 L100,106.65 M137.5,85.03 L162.5,85.03 M200,106.65 L212.5,128.36 M212.5,171.64 L200,193.35 M162.5,214.97 L137.5,214.97" />
    </g>
    
    <!-- 合并所有圆心点（利用 path 和圆头端点模拟圆形） -->
    <path d="M150,150 h0 
             M150,193.35 h0 M137.5,171.64 h0 M112.5,171.64 h0 M125,150 h0 M112.5,128.36 h0 M137.5,128.36 h0 M150,106.65 h0 M162.5,128.36 h0 M187.5,128.36 h0 M175,150 h0 M187.5,171.64 h0 M162.5,171.64 h0 
             M150,236.60 h0 M125,193.35 h0 M75,193.35 h0 M100,150 h0 M75,106.65 h0 M125,106.65 h0 M150,63.40 h0 M175,106.65 h0 M225,106.65 h0 M200,150 h0 M225,193.35 h0 M175,193.35 h0 
             M137.5,214.97 h0 M100,193.35 h0 M87.5,171.64 h0 M87.5,128.36 h0 M100,106.65 h0 M137.5,85.03 h0 M162.5,85.03 h0 M200,106.65 h0 M212.5,128.36 h0 M212.5,171.64 h0 M200,193.35 h0 M162.5,214.97 h0" 
          fill="none" stroke="#1a768c" stroke-width="9" stroke-linecap="round" />
          
</svg>

好的，就这样了。

本文2026-07-22首發於Kuqilin's Blog，最後修改於2026-08-01

本部落格所有文章除特別聲明外，均採用 BY-NC-SA 授權協議。轉載請註明出處！

作者：Kuqilin（kuqilin@outlook.com）

再次更新

再次更新，用上了 Cloudflare 的 R2 储存桶，绑了kuqilin.eu.org域名，可以 尽情 适度食用了。速度比 jsDelivr 快多了！20 秒之内 99% 的用户都能加载出来了。都去给我欣赏「泉眼深处」😠😠😠

更新

太好了，经历各种斗智斗勇（bushi）终于把网站看板娘搞好了 —— 一个不会说话的 37。
为什么说斗智斗勇呢？你去看后文。不容易啊，最终发现有这些小白块大抵是因为大佬解包过程中出了一些小问题，导致模型图片里面有一个白块，当时看模型图片就感觉奇怪，上 9 看了皮肤，发现本来这里什么都没有，于是用 IsoPix Pro 把白块擦掉了，发现终于没有白块了（应该不会有什么问题的）。
然后也把模型放置位置和大小做了一些调整。可惜的是暂时还不会怎么给她添加例如举牌子、对话框之类的，所以看板娘傻傻的。
欸，国内裸连 GitHub 还是不太好，把 moc3 文件上传到 jsDelivr 上也没多快，你们最坏情况要 2 分钟才能看到美丽的 37！（最好情况是 3 秒）

就此事向仓库管理发了 Issue，结果人家已经知道这个问题了:)

那好吧，没删干净。如果你的网络状况良好（指连接 GitHub 速度飞快），那你可以点这里看看，这里能选择 37 的不同表情和动作。

37 完美的流体

Caution

哈哈哈哈哈，下面的内容没有时效性了，我搞定了泉眼深处
下文原标题为《网站看板娘 —— 37 完美的流体》

耗费许久，最终 vibe code 了网站的看板娘出来，《重返未来：1999》里面角色 37 的皮肤——完美的流体。
或许玩过 1999 的人会问：“难道你不觉得快乐的捕鸟人或者泉眼深处更好看吗？”我会回答：“对！我也想用泉眼深处。”
只不过，这几个有“亿点点”问题： 具体的情况，请看以下图片： 看到那几个白块了吗？37 的洞二皮也有这个问题，vibe 解决不了 我是废物 没办法了，泉眼深处真的很好看啊，部署出来还会有小鸟在飞来飞去，可是这个白块真的没办法解决，不然也不会用这个 洛天依 完美的流体了。

本来我用的 Reimu 主题是直接能用 Live2d 的，但是没办法，你 9 的模型版本太高了，只得自己 vibe 出来 厉不厉害你 Deepseek-V4-Pro 预览版？

不过还好，这个皮肤也不算难看。并且动作和表情也还是有的。调了一个 5 秒钟自动切换动画和一个点击切换动画。需要注意的是，在显示宽度小于 960px 的情况下这个看板娘是不会显示的，就跟侧边栏一样，她俩是同步的。
坏了，为了加快国内的访问速度，把这个“可能侵权”的文件上传到了图床，不知道会有什么风险呢？

还是感觉很可惜，没能让泉眼深处当网站看板娘😭😭😭

这些模型都是从https://github.com/myssal/Reverse-1999-CN-Asset/下载的大佬解包资源，如有侵权，请联系删除。

本文2026-07-28首發於Kuqilin's Blog，最後修改於2026-07-29

本部落格所有文章除特別聲明外，均採用 BY-NC-SA 授權協議。轉載請註明出處！

作者：Kuqilin（kuqilin@outlook.com）

大道雅文融合读写——全部任务一答案

总第44期·任务一：老旧小区改造

近年来，全国多地推进老旧小区改造工程，这一民生实践与中华文明"民为邦本"“富民调均"“天人合一"“和合共生"等传统理念深度契合，彰显了中国式现代化的文化底蕴。

首先，老旧小区改造生动体现了"民为邦本"的执政理念。政府投入专项资金，为老旧小区加装电梯、完善管网、增设养老托育设施，正是将人民需求放在首位、以百姓安居为治国之本的现实写照。正如材料所言，“民惟邦本，本固邦宁”，改造工程让普通居民切实感受到国家发展的温度。

其次，“富民调均"的伦理追求在改造中得到充分展现。居民通过协商共担部分费用，体现的正是"调均"智慧——既非政府全包、也非居民独担，而是各得其分、公平合理。这种制度设计避免了一刀切的平均主义，实现了社会资源的合理分配，让发展的成果惠及更多人。

更有意味的是，不少地方在改造中保留历史建筑风貌、延续社区文脉。这与"天人合一"“和合共生"的理念一脉相承——改造不是推倒重来，而是在现代化进程中尊重历史、顺应人文肌理，实现新旧和谐共存。老旧小区承载着几代人的记忆与情感，保留历史风貌便是让"旧邦"焕发"新命”。

由此可见，老旧小区改造不仅是物理空间的更新，更是中华文明传统理念在当代城市治理中的创造性转化。它用一砖一瓦书写着中国式现代化以人为本、古今交融的独特品格。

总第45期·任务一：社区食堂

近年来，“社区食堂"在全国多地悄然兴起，以"政府贴一点、企业让一点、老人出一点"的运营模式，为周边居民提供平价餐食。这一现象与中华文明"富民厚生、义利兼顾"的经济伦理高度契合，体现了传统经济智慧在当代社会治理中的生动实践。

材料指出，“凡治国之道，必先富民”，将民生富足作为社会秩序的基础。社区食堂以一份两荤一素的套餐定价10元左右，远低于市场均价，正是"富民厚生"理念的当代落实。它解决的不仅是老年人"吃饭难"的现实困境，更传递出社会对弱势群体的关怀。正如管仲所言"仓廪实而知礼节”，只有基本生活得到保障，社会文明才有根基。

社区食堂的运营模式更体现了"义利兼顾"的经济伦理。“政府贴一点"彰显公共责任，“企业让一点"体现以义制利的商业伦理，“老人出一点"避免养懒汉式的福利依赖。三方共担的模式并非简单的慈善施舍，而是义利协调的制度创新——既保障了企业的可持续运营，又守住了民生底线，实现了社会效益与经济效益的统一。

材料回顾历代治乱兴衰时指出，“坚守伦理则盛世兴，背离伦理则王朝衰”。社区食堂的出现，正是政府、企业与居民三方在"富民厚生"伦理指引下共同书写的当代答卷。它提醒我们：经济发展不能只追求GDP增长，更要将民生福祉镌刻在每一碗热饭之中。这种以人民为中心的发展理念，正是中华民族几千年经济伦理在新时代的延续与升华。

总第46期·任务一：对"中庸"的理解

“中庸"一词在日常生活中常被误解为"和稀泥"“墙头草"“没原则”，甚至被视为缺乏进取精神的代名词。然而，材料清晰指出：“执两用中并非简单的折中主义，而是一种辩证的认识论与方法论"“真正的中道并非无原则的调和，而是以’守正’为前提”。这让我对"中庸"有了全新的认识。

首先，中庸不是没有立场，而是在把握事物全貌之后做出的审慎判断。“执其两端，用其中于民"意味着先要了解事物的两个极端，理解各自的合理性与局限，再在此基础上找到恰如其分的平衡点。这恰恰需要更深刻的洞察力和更大的智慧。孔子说"过犹不及”，反对的不仅是"不及”，同样反对"过度”——激进与保守都是偏颇，真正的智慧在于审时度势、因时制宜。

其次，中庸不等于放弃原则。“守中"的前提是"守正”——在坚守根本原则的基础上，根据时代变化灵活调整具体策略。正如材料列举的历代治世，无不是在改革发展与维持稳定之间寻求动态平衡。反之，秦朝严刑峻法走向极端、晚明空谈义理脱离实际，都是背离中道的教训。

在我的学习生活中，我也逐渐体会到中庸的价值。面对繁重的学业压力，既不能过度放松以致荒废，也不能过度紧绷以致崩溃，要在勤学与休整之间找到适合自己的节奏。这是一种需要不断练习的能力，而非机械地取平均值。中庸之道，实际上是教我们做一个有定力、有判断力的清醒之人，而非随波逐流的墙头草。

总第47期·任务一（唯一任务）：科技与人文——人工智能的不利影响及应对

当下，以人工智能为代表的新技术日新月异，在带来巨大便利的同时，也引发了一系列不利影响。正如材料所言，“技术一旦脱离人的本质需求，便会导致’人的异化’"。技术封建主义的兴起、人的主体性削弱、信息茧房加剧等问题，正成为数字时代的严峻挑战。

人工智能带来的不利影响是多方面的。首先是"人的异化”——当算法能够比人更高效地完成写作、绘画、编程等创造性工作时，人可能在不知不觉中丧失独立思考与动手能力。我身边就有同学过度依赖AI写作文，结果一到考场便无从下笔。其次是信息茧房的加深，推荐算法不断投喂我们"想看的内容”，视野反而越来越窄。再者，如《技术封建主义》一文所述，少数科技巨头垄断数据与平台，普通用户沦为"数字农奴”，失去了对自己数据与劳动成果的控制权。

面对这些挑战，我认为应从三个层面加以应对。在个人层面，要保持清醒的主体意识，把AI当作工具而不是拐杖，坚持独立思考与亲手实践，绝不能让机器代劳一切创造性劳动。在社会层面，需要建立健全伦理规则与法律法规，正如材料所强调的，“技术越强大，越需要强化人的主体地位”，通过算法可解释性、数据安全、隐私保护等制度设计，确保技术"服务于人"而非"驾驭于人”。在教育层面，应更加重视人文素养的培养，让哲学、历史、文学为人提供意义世界，以思考力、感受力、创造力对抗技术的单一价值。

归根结底，科技是"发动机”，人文是"方向盘”。只有在人文精神的指引下，人工智能等新技术才能真正造福人类，而不是把我们带入一种新型的数字依附关系。

实事求是篇·任务一：对"实事求是"的理解

“实事求是"一词在日常生活中常被简单理解为"讲真话"“不弄虚作假”。读了材料后方知，这一概念的意涵远比日常理解更为深远——它不仅是治学态度，更是中国共产党"认识世界、改造世界的根本要求”，是一种科学的思维方法与工作方法。

材料指出，班固最早用"实事求是"赞誉河间献王刘德"务得事实，每求真是"的严谨治学态度。毛泽东同志则将其提升为马克思主义的科学方法论："‘实事’就是客观存在着的一切事物，‘是’就是客观事物的内部联系，即规律性，‘求’就是我们去研究。“这一阐释让我意识到：实事求是绝非被动地承认事实，而是要主动深入实际、详细占有材料、深入研究，从而把握事物发展的内在规律。

这种思想方法对我的学习有着深刻启示。以往我做题时，常常满足于记住答案或套用模板，却忽略了"求是"的关键——去追问一道题背后的原理是什么、规律是什么。比如数学公式，如果只背结论而不理解推导过程中的逻辑链条，遇到变式便会束手无策。真正的"实事求是”，应当是深入钻研每一个知识点的来龙去脉，从具体题目中抽象出普遍规律，再用规律指导解题实践。

材料还强调，实事求是要求"讲实情、出实招、办实事、求实效”。在我的生活中，这意味着脚踏实地、不好高骛远。与其空想一个完美的学习计划而不执行，不如从每天认真完成一篇阅读、弄懂一道错题做起。正如古人所言"非知之艰，行之惟艰”，知道道理不难，难的是落实到行动上。实事求是，最终要落脚在"务实"二字上——知行合一，方为真"实”。

数字文化创造篇·任务一（唯一任务）：炫技还是文化底蕴？

标题：让文化成为数字创造的灵魂

数字技术飞速发展的今天，AI复原古迹、三维建模重生老街巷、体素技术复刻祖国山河，每个人都能轻松拿起数字工具成为文化故事的创作者。然而，光明日报评论文章提出了一个发人深省的追问：“当炫技变得容易，沉下心研习文化是否变得更有价值？“对此，我认为答案不言自明——文化底蕴远比炫技更加珍贵。

技术是工具，文化是灵魂。没有文化底蕴支撑的数字创造，再炫目的特效也只是空洞的视觉刺激。我看到有同学用AI生成了一幅"古风"画作，画面华丽精美，但仔细一看，建筑风格混淆了唐宋明清、人物服饰时空错乱——这便是只有炫技而无文化根基的结果。相反，B站上一位UP主用三维建模复原了家乡的一条百年老街，画面或许不如商业大作精致，但每一块砖瓦的位置都有历史依据、每一家店铺的招牌都有故事可循，看后令人动容。因为他呈现的不只是图像，更是文化记忆与乡愁。

文章指出，当代青年的数字文化创造"自带鲜明的家国底色”。这份底色正来自对中华文化的深刻理解。技术门槛越低，文化底蕴就越是决定作品高下的关键。当人人都能一键生成精美画面时，真正稀缺的将不再是技术能力，而是对文化的研习深度和独到见解。

因此，我们年轻人在拥抱数字工具的同时，更应沉下心去读书、去了解传统、去走进博物馆和古街巷。唯有让文化成为数字创造的灵魂，我们的作品才能经得起时间的淘洗，才能真正用鲜活的创造讲好中国故事。

本文2026-07-22首發於Kuqilin's Blog，最後修改於2026-07-22

本部落格所有文章除特別聲明外，均採用 BY-NC-SA 授權協議。轉載請註明出處！

作者：Kuqilin（kuqilin@outlook.com）

Tip

请务必先通读全文再进行操作，避免一些不必要的错误。

安装 Hugo

Windows

前往官网下载 Hugo 的exe文件，随便找个位置放，然后把他添加到环境变量中即可。

Linux

先安装 Hugo 的二进制文件，可以在官网上下载，也可以直接使用软件包管理器，考虑到apt更新极为缓慢，建议 Debian 系去官网下载deb包进行安装。

sudo apt install hugo    # Debian 系
yay -S hugo              # Arch 系

安装完成后，执行hugo version会看到类似如下的提示：

❯ hugo version  
hugo v0.164.0-ce2470e7012b5ab5fc4e10ebe4027e9f8d9e00dc+extended linux/amd64 BuildDate=2026-07-06T16:39:30Z VendorInfo=gohugoio

即安装完成。

创建项目

我们使用hugo new site <项目名称>来创建项目，比如：

❯ hugo new site myBlog  
Congratulations! Your new Hugo site was created in /home/kuqilin/myBlog.  
  
Just a few more steps...  
  
1. Change the current directory to /home/kuqilin/myBlog.  
2. Create or install a theme:  
  - Create a new theme with the command "hugo new theme <THEMENAME>"  
  - Install a theme from https://themes.gohugo.io/  
3. Edit hugo.toml, setting the "theme" property to the theme name.  
4. Create new content with the command "hugo new content <SECTIONNAME>/<FILENAME>.<FORMAT>".  
5. Start the embedded web server with the command "hugo server --buildDrafts".  
  
See documentation at https://gohugo.io/.

可以看到成功的提示，接下来cd到项目文件夹myBlog，按照提示进行配置。

创建或安装主题

显然，我们是可以自己创建主题的，但是为了白嫖方便，直接前往 Hugo Themes 下载一个称心的即可，这里选择了 hugo-theme-reimu 这个主题。

主题安装有几种方式，推荐使用 Git Submodule：

cd myBlog
git init
git submodule add https://github.com/D-Sketon/hugo-theme-reimu.git themes/hugo-theme-reimu

也可以直接下载主题压缩包，解压到themes文件夹下。

然后在 hugo.toml 中指定主题：

theme = "hugo-theme-reimu"

配置 hugo-theme-reimu

主题的配置文件默认在 themes/hugo-theme-reimu/config/_default/ 下。我们不应该直接修改主题文件，因为更新主题时会将其覆盖掉，所以应该在项目根目录的 config/_default/ 下创建同名文件来覆盖。我们把params.yml（主题参数）复制即可。

基础站点配置（hugo.toml）

baseURL = 'https://<你的用户名>.github.io/'
theme = "hugo-theme-reimu"
title = "xxx's Blog"       # 站点标题
locale = "zh-CN"           # 语言
languageName = "简体中文"   # 语言名称
hasCJKLanguage = true      # 是否包含 CJK 字符

[markup.highlight]         # 语法高亮（含代码块必须）
guessSyntax = true
noClasses = false

[markup.goldmark.renderer]
unsafe = true

[markup.goldmark.extensions.passthrough] # 含数学公式必须
enable = true
delimiters.block = [["\\[", "\\]"], ["$$", "$$"]]
delimiters.inline = [["\\(", "\\)"], ["$", "$"]]

unsafe = true 允许在 Markdown 中直接使用 HTML，passthrough 用于支持数学公式的 $...$ 和 $$...$$ 语法。

主题参数配置（params.yml）

在 config/_default/params.yml 中配置主题的各项功能，这里介绍几个关键项：

导航菜单：

menu:
  - name: home
    url: ""
  - name: archives
    url: "archives"
  - name: about
    url: "about"
  - name: friend
    url: "friend"

个人信息和头像：

author: <你的名字>
email: <你的邮箱>
avatar: "avatar.jpg"           # 放在 static/avatar/ 下
banner: "images/banner.webp"   # 放在 static/images/ 下

社交链接：

social:
  email: mailto:<你的邮箱>
  github: https://github.com/<你的用户名>
  twitter: https://twitter.com/<你的用户名>

侧边栏和小组件：

sidebar:
  position: left  # 左右可选
widgets:
  - category
  - tag
  - tagcloud
  - recent_posts

评论区（以 Waline 为例）：

comment:
  default: waline
waline:
  enable: true
  serverURL: "<你的 Waline 服务地址>"

启用功能：

toc: true                # 目录
dark_mode:
  enable: auto           # 自动跟随系统
math:
  mathjax:
    enable: true         # 数学公式
show_update_time: true   # 显示更新时间

更多配置项（鼠标特效、Live2D、字体、加载动画等）请参考主题官方文档。

配置完成后，运行 hugo server -D 即可在本地预览 http://localhost:1313。

其他内容

其他内容，比如更改鼠标指针、修改字体、文章头图、文章封面、网站主题色、短代码、友链等等，请查看官方文档，这里不再赘述。嘻嘻

部署到 GitHub Pages

部署的核心思路是把 Hugo 构建生成的 public/ 目录推送到 <用户名>.github.io 仓库。GitHub Pages 会自动将这个仓库的内容作为静态网站发布。

也就是说，我们需要两个仓库：

• 源码仓库（如 hugo-build）：放 Hugo 项目源文件（Markdown、配置、主题等）
• 页面仓库（<用户名>.github.io）：只放 public/ 里的静态文件

下面分别介绍手动推送和 GitHub Actions 自动推送两种方式。

方式一：手动推送到 github.io

最直接的方式——在本地执行 hugo 构建，然后把 public/ 目录的内容推到页面仓库。

1. 克隆页面仓库

git clone https://github.com/<你的用户名>/<你的用户名>.github.io.git public

如果 public/ 目录已存在（Hugo 构建会生成），先删掉再克隆。

2. 构建并推送

# 回到源码仓库根目录，先构建
hugo

# 进入 public 目录（此时它已经是页面仓库的克隆）
cd public

# 提交并推送
git add .
git commit -m "update"
git push origin main

每次更新博客时，重复上面几步即可。

3. 写个脚本简化操作

可以把以上步骤写成一个脚本 deploy.sh：

#!/bin/bash
echo "Building..."
hugo

echo "Deploying..."
cd public
git add .
git commit -m "update $(date '+%Y-%m-%d %H:%M:%S')"
git push origin main
cd ..
echo "Done!"

以后只需运行 bash deploy.sh 就完成构建和部署了。

这种方式的优点是不依赖任何第三方 CI 服务，简单直接；缺点是需要手动执行，并且要保证本地 Hugo 环境正常。

方式二：GitHub Actions 自动部署

懒人必备——每次把源码推到 GitHub，剩下的构建和部署全交给 Actions 自动完成。

1. 创建 Personal Access Token

为了让 Actions 能够向页面仓库推送代码，需要一个 Token：

1. GitHub → Settings → Developer settings → Personal access tokens → Tokens(classic)
2. 生成新 Token，勾选 repo 和 workflow 权限
3. 复制生成的 Token（注意：此 Token 只显示一次，务必保存好）

然后在源码仓库的 Settings → Secrets and variables → Actions 中新建一个 Secret，名称为 TOKEN，填入刚才复制的 Token。

2. 编写 Workflow 文件

在源码仓库根目录创建 .github/workflows/hugo.yaml：

name: deploy

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
        - name: Checkout
          uses: actions/checkout@v4
          with:
              fetch-depth: 0
              submodules: true       # 如果主题用 git submodule 安装，需要这行

        - name: Setup Hugo
          uses: peaceiris/actions-hugo@v3
          with:
              hugo-version: "latest"
              extended: true

        - name: Build Web
          run: hugo

        - name: Deploy Web
          uses: peaceiris/actions-gh-pages@v4
          with:
              PERSONAL_TOKEN: ${{ secrets.TOKEN }}
              EXTERNAL_REPOSITORY: <你的用户名>/<你的用户名>.github.io
              PUBLISH_BRANCH: main
              PUBLISH_DIR: ./public
              commit_message: auto deploy

各步骤说明：

3. 推送源码触发部署

git add .
git commit -m "new post"
git push origin main

每次 push 到 main 分支后，GitHub Actions 就会自动运行。可以在源码仓库的 Actions 标签页查看构建进度，绿色 ✅ 即为部署成功，随后访问 https://<你的用户名>.github.io/ 就能看到更新后的博客。

两种方式对比

两种方式不冲突，可以同时使用——配好 Actions 后日常自动部署，偶尔需要手动推也完全可以。

至此，Hugo 博客的搭建、配置和部署就全部完成了 🎉

本文2026-07-11首發於Kuqilin's Blog，最後修改於2026-07-17

本部落格所有文章除特別聲明外，均採用 BY-NC-SA 授權協議。轉載請註明出處！

作者：Kuqilin（kuqilin@outlook.com）

我去过的学校

忽然觉得自己去过很多学校，便想着列个表格出来看看都去过哪些、去干嘛的：

（排名不分前后，按记忆顺序）

本文2025-02-22首發於Kuqilin's Blog，最後修改於2026-07-12

本部落格所有文章除特別聲明外，均採用 BY-NC-SA 授權協議。轉載請註明出處！

作者：Kuqilin（kuqilin@outlook.com）

难得一个清闲的周末，慢慢地写作业、慢慢地出去走走、慢慢地吃个饭，一点都不急。作业也少，rage bait 也不推了，温度很舒适。很久没过这样的周末了 （可能是没刷短视频的原因吧） 。
自从把 B 站的个性化推荐关掉之后，推给我的都是高质量视频，刷视频功能也没掉了，比起以前来个

你们报电话号码都是怎么报的？334还是533？

这样的 rage bait 底下一群人吵翻天要好太多了。

短视频…吃饭旁边桌的两三年级小孩，说个“走过去的是 gay”……
玩梗有度吧，先形成三观还是先刷短视频？也许正如王羲之“后之视今，亦犹今之视昔“一般，只有以后才知道如今这些杂七杂八的东西是什么样的吧。
现在的流量至上确实不好，为了流量丢掉了一些东西。

清闲的周末，也会些许不好，缺少一点对生活的激情，但也够了。

尽情向后展望吧，我们有取之不尽的未来。

这人写的什么意识流玩意😥……

本文2026-05-17首發於Kuqilin's Blog，最後修改於2026-05-17

本部落格所有文章除特別聲明外，均採用 BY-NC-SA 授權協議。轉載請註明出處！