ForeverYang's 博客

停止 AI 焦虑！四象限规则帮你做减法

mythstraw@msn.com (ForeverYang) — Wed, 30 Sep 2026 21:59:00 +0800

你有没有下面这些焦虑

AI 发展日新月异，急速迭代，概念、技术、产品层出不穷。
很多比较流行的 AI 相关的东西，我们不可能都花时间去了解、理解、深度使用研究。
一方面希望自己跟上 AI 的浪潮，另一方面自己的时间和精力又不允许。
而且，AI 迭代速度太快，刚出的产品或者概念，没过多久就过时了。
所以如何解决这些问题呢？四象限法则就可以帮助我们做出合理的判断。

什么是四象限法则

四象限法则由史蒂芬·柯维提出，用"重要性 × 紧急性"将任务分为四类：重要且紧急、重要但不紧急、紧急但不重要、不重要且不紧急，用于确定优先级并提升时间管理效率

很多人应该听说过这个概念，可能用过在时间管理上面，比如一些待办 todo 的应用，番茄时钟应用，把计划和待办做重要且紧急、重要但不紧急、紧急但不重要、不重要且不紧急四大分类，就可以帮助我们确定一件事的优先级，哪些先做，哪些按计划去做，哪些可以忽略不用急着去做。

四象限法则在时间管理上的应用

那么这个规则又如何帮助我们解决 AI 焦虑呢？

这是通过宝玉老师的文章学到的 AI 发展太快跟不上？一张四象限图帮你做减法

解决 AI 焦虑：用"生产力"和"保鲜期"做减法

解决 AI 焦虑，就问这两个问题：

它离我当前的生产力有多近？（能不能让我现在的活干得更快或更好？）
这个知识的保鲜期有多长？（三年后还能用，还是三个月后就改名了？）

把这两个问题作为横纵轴，就能把 AI 资讯分成四类，对应四种完全不同的处理方式：

直接跳过（离得远 + 保鲜期短）：比如每个月变的模型跑分排名、某家 AI 公司的融资八卦、各种不知名的小套壳。这些是噪音最密集的地方，过早关注只会增加沉没成本。如果它真重要，半年后你自然会听到。
维持地图感（离得远 + 保鲜期长）：比如 RAG（检索增强生成）、思维链（CoT）、Scaling Laws。你不需要自己去写代码实现它们，但你得知道它们是什么、能解决什么问题。花 15 分钟读篇好文章，确保和同事聊天时能听懂就行，不动手，不装环境。
浅尝辄止（离得近 + 保鲜期短）：比如某个刚火的 AI 画图工具的具体提示词套路。它确实能帮你省时间，值得花几个小时上手试试。但千万别花一周去精通它的每个参数，因为产品形态可能下个月就大变，你积累的特定技巧会一夜贬值。
深度死磕（离得近 + 保鲜期长）：这是真正值得投入精力的地方。比如软件工程的核心思维、上下文工程（Context Engineering），或者像 Claude Code 这样有大厂持续投入的核心编程智能体。深度使用一个核心工具带来的复利，远大于浅尝十个新玩具。

AI 学习优先级四象限

四象限法则，让你的 AI 变得更强大

最近有一个基于"乔哈里视窗"改造的 AI 提示词框架非常火。它把人和 AI 的认知分成了四个象限。如果你能把这四句话写进你的系统提示词（System Prompt）里，AI 的产出质量会有质的飞跃。

1. 共同已知（我和 AI 的已知）：给足背景，让它闭嘴干活
先确认任务目标、已有背景、交付标准和明确边界。信息给充分了，就直接告诉它：“信息已充分，请直接执行，不要重复询问或说废话。“这能极大消除 AI 那种令人烦躁的"过度礼貌"和无效反问。

2. 我的已知（但 AI 的未知）：喂给它你的"潜规则”
AI 不知道你老板的审美偏好、你们公司的历史遗留代码规范，或者某个业务的真实限制。如果这些信息缺失会搞砸结果，你必须说出来。如果信息太多，可以定个规矩：“如果缺失关键信息，最多向我提 3 个问题；否则，请基于你的合理假设，先给我一个探索版本。”

3. 我的未知（但 AI 的已知）：让它来挑你的刺
这是把 AI 当"思考伙伴"的关键。明确告诉它：“不要局限于我的原始方案。请主动补充我没考虑到的知识、方法、潜在风险和替代方案。如果我的前提可能错误，请直接指出，并给出更优建议及取舍依据。”

4. 双方未知：别瞎猜，设计个最小实验
遇到前沿问题或复杂业务，谁也给不出完美答案。这时候提示词应该引导 AI：“我们把这个问题转化为可验证的假设。请帮我设计一个最小实验（MVP），说明要改变的单一变量是什么、成功或失败的信号是什么，以及后续需要回收什么数据。“用科学实验的思路，代替拍脑袋决策。

1. 双方已知：先确认任务目标、已有背景、交付标准和明确边界。信息充分时直接执行，不要重复询问。

2. 我的已知、你的未知：识别可能只存在于我脑中的真实语境、审美偏好、现实限制。若缺失信息会显著改变结果，最多提出 3 个关键问题；若不明确你的合理假设，先完成探索版本。

3. 我的未知、你的已知：主动补充我没考虑到的知识、方法、风险和替代方案。不要局限于我的原始方案，如果我的前提可能错误，请直接指出，并给出更优建议及取舍依据。

4. 双方未知：识别无法仅靠现有信息确定的问题，把它们转化为可验证的假设，设计最小实验，说明要改变的单一变量、成功/失败信号，以及后续需要回收的数据。

乔哈里视窗改造的提示词四象限

四象限法则的跨界启发：色彩搭配也是画十字

最近在翻一篇讲设计配色的文章（研习设的《十字形配色法》），发现了一个有趣的共鸣。

很多人面对成千上万种颜色会觉得无从下手。作者的办法极其粗暴：在设计软件的色板里，横向（明度）和纵向（纯度/饱和度）各画一条线，形成一个十字，把颜色分成四个区域。

区域 1（高明度 + 高纯度）：健康、积极、视觉冲击力强。（适合年轻化、促销）
区域 2（高明度 + 中低纯度）：简洁、干净、清爽、温柔。（适合生活方式、母婴）
区域 3（低明度 + 高纯度）：强力、商务、有格调、深邃。（适合运动、高端商务）
区域 4（低明度 + 低纯度）：偏黑灰色调，成熟、神秘、高雅、内敛。（适合奢侈品、艺术展）

十字形配色法

它的核心操作原则只有一条：选定一个区域后，其他颜色也尽量保持在这个区域内。 只要在这个框里选，画面的色调就绝对不会乱。

总结一下

把 AI 学习、AI 提示词和色彩搭配放在一起看，你会发现一个共通的规律：

人脑其实很不擅长处理"多维度、无边界"的混沌信息。而四象限的本质，就是强迫你找出当前问题里最关键的两个变量，画下一个十字。

一旦十字画下，你就有了"拒绝"的底气：

在学 AI 时，你有底气跳过左下角的噪音。
在写提示词时，你有底气要求 AI 别废话，直接基于假设出方案。
在选颜色时，你有底气放弃那些虽然好看、但不在当前象限里的干扰项。

工具和方法永远只是辅助。真正有价值的，是这种"先定边界，再做选择"的克制思维。少即是多，慢即是快。

《时光倒流的女孩》读后感

mythstraw@msn.com (ForeverYang) — Mon, 28 Sep 2026 17:00:00 +0800

这世上有那么多种生活。我们多么希望自己能够同时体验多种生活，而不是一个一个地去经历。我们多么希望自己能够挑选每一种生活最好的部分，把他们像珍珠一样串起来。可生活不是这样安排的。人的生命因凌乱而美丽。

时光倒流的女孩 (豆瓣)

真的很久没有认真读过一本书了，前段时间因为赵雷《我记得》，听完歌后看到有个公众号的采访说这首歌赵雷的灵感来源是一本叫《时光倒流的女孩》的书。
后来在云音乐的评论下看到赵雷好友浩子的评论，就随口在下面问了一句：这首歌赵雷真的是写一本书的故事吗？没想到浩子回复说：“你猜谁送的”。
所以我更好奇这本书的故事了，然后第一时间买了实体书，一口气读完了这本书，想说说我的了解，全当读后感吧。

《时光倒流的女孩》的主人公小莉齐15岁时因为一场车祸，离开了人间。当她再次醒来时发现自己正坐在一艘叫“尼罗河号”的船上航行在空旷的尼罗河中，而这艘船的目的地是一个叫“另界”的地方。

在另界所有的人，从来到这的那一刻开始慢慢的往回长，越变越小，直到回到最初的婴孩的样子，再重新从尼罗河中回到人间

这本书写了小莉齐在另界经历的从15-0岁的过程。
在她来到另界的第一天她见到了未曾见过面的外婆，因为外婆离世的早，所以现在的外婆已经非常年轻，很像妈妈，所以小莉齐虽然没见过外婆但依然很亲切。

虽然有亲人，可是初到另界的小莉齐还是对人间很不舍，每天从特殊的望远镜观察着在人间的爸爸妈妈的情况，还有弟弟以及她最好的朋友的生活，甚至还想着通过海井（可以连接另界和人间）和人间的家人保持联系，后来在另界生活了一段时间后，她有了新的工作，认识了新的朋友和恋人，也渐渐习惯了这里的一切。

在她倒着长到13岁时她微笑着对外婆说：幸福就是一种选择，如果她不是在15岁来到另界，她可能永远见不到她的外婆，她也不会遇到现在这些朋友。

虽然这本书的主题是生死与轮回，但是我觉得作者想告诉我们的道理很简单：人生中得到与失去是常态，生活中你做的每一个选择都是有得有失，你会得到一些东西同样也会失去一些东西，所以不用因为每一次得失而烦恼，得到与失去都是一种经历一种生活，人生最精彩的就是未知，如果所有的选择都是好的，生活也挺无趣的不是吗？

就像书中所说的：这世上有那么多种生活。我们多么希望自己能够同时体验多种生活，而不是一个一个地去经历。我们多么希望自己能够挑选每一种生活最好的部分，把他们像珍珠一样串起来。可生活不是这样安排的。人的生命因凌乱而美丽。

了解了这本书的故事，再说说赵雷的《我记得》这首歌，读完《时光倒流的女孩》我又仔细听了《我记得》，我的感受是这首歌是赵雷为这个故事写了一个后续。

这只是我的认知，毕竟同一首歌不同人的感受都会不一样

这本书的最后是以小莉齐回到0岁，被放进到尼罗河中重回人间结束的，后面的故事作者没有再写。

所以读完这本书会很好奇，重回人间又是一个怎样的过程，会发生什么故事？
而这首《我记得》给这个故事作了一个结尾。这首歌是以第一人称写的，所以歌中的我可以是书中的主角小莉齐，也可以是赵雷自己，我更倾向于赵雷把书中的主角想像成了自己，写了一段和母亲的故事。

整首歌可以分成三个段落，第一段接着书中故事的结束，写的是从另界回到人间新生的过程

我带着比身体重的行李，游入尼罗河底，经过几道闪电，最后以新生的状态回到了人间，当听到母亲的声音，就知道是她，可母亲已不记得我，或许刚新生的小孩还留有一丝丝另界的记忆，这些记忆伴随在人间的成长，也开始淡忘，所以人们最终总是失忆着相遇。

第二段开始写了这一世以及前几世在人间的故事，这一世我们做母子，前几世我们做过朋友，做过叔侄，做过恋人，一次又一次相互送别，然后一次又一次失忆着重聚。

最后一段，是描写书中小莉齐在另界的故事，可能赵雷联想到自己，想到了已故的母亲，所以在另界我遇到了故去多年的外婆，见到她时她在另界生活了很久已变的很年轻（另界的人都是越来越小），她扎着和母亲一样的马尾，露出和母亲一样的笑。外婆讲了很多关于母亲成长的故事，在这里外婆的思念从未停止。

最后歌曲的结尾雷子说：不要哭我最亲爱的人，我最好的玩伴，时空是一个圆圈，直行或是转弯，我们最终都会相见，在万家灯火的某一处，人们失忆着相聚。
这或许是在另界的人想对人间亲人想说的话，也许是母亲想对雷子说的话。

时空是一个圆圈，另界与人间是分开的两个直线，一条从死到重生，一条从生到死，在生与死的转折点上，两个时空交汇成一个圆圈，那些走完直线或半途转弯的人，大家终会失忆着再见的。

所以这首歌可能也是雷子对自己的和解，他相信在另界的人有自己的生活，一定会生活的很好，不管是在另界的故人还是人间的人，都活好自己就好，直行或是转弯，都是幸福的。

写的很主观，大家看看就好。
最后借雷子在《家乡》里写给苏菲.珊曼妮的话送给赵雷：愿赵雷知道，我永远爱他和他的音乐。

《世界尽头的咖啡馆》分析阅读

mythstraw@msn.com (ForeverYang) — Mon, 28 Sep 2026 16:40:00 +0800

作者：约翰·史崔勒基（John Strelecky）
类别：哲学寓言 / 心灵成长小说
阅读方法：分析阅读（基于《如何阅读一本书》）

一、书籍分类

书名：《世界尽头的咖啡馆》（The Why Café）
作者：约翰·史崔勒基（John Strelecky），美国作家
类别：哲学寓言 / 心灵成长小说（虚构叙事 + 存在主义哲学探讨）
体裁特征：以小说故事为载体，传递人生哲学思考，属于"说理型"作品，但通过叙事而非论证呈现

二、一句话概括

一个在人生中迷失方向、疲惫不堪的上班族，因堵车迷路误入一家神秘的"你为什么来这里咖啡馆"，在与女招待凯茜、店主迈克和客人安妮的一夜长谈中，直面三个关于人生本质的问题，最终找到自己"存在的意义"（PFE）并重获生活方向。

三、整体架构

全书以第一人称叙事展开，结构清晰：

序（作者自述：迷路与咖啡馆的相遇）
├── 01-03 现实困境：堵车、迷路、绝望（人生迷失的隐喻）
├── 04-07 进入咖啡馆：三个问题浮现（你为什么来这里？）
├── 08-10 核心探讨：PFE（存在意义）+ 绿海龟的故事
├── 11-12 渔夫的故事 + 广告与消费陷阱（安妮的循环）
├── 13-14 死亡与满足感 + 金钱观
├── 15-16 运气与指数理论 + 高尔夫球的故事（掌控命运）
├── 17-18 如何寻找答案 + 迈克的哥斯达黎加顿悟
├── 19 离开咖啡馆，带着问题重新出发
尾声（改变后的生活）

叙事手法：以"菜单背面的三个问题"为线索，通过人物对话层层递进，每个故事（绿海龟、渔夫、高尔夫球）都是哲学观点的具象化。

四、核心问题

全书围绕三个递进的核心问题展开：

你为什么来这里？（存在的意义是什么？）
你害怕死亡吗？（是否因虚度人生而恐惧？）
你满足吗？（当下的生活是否让你满意？）

这三个问题相互关联，共同指向一个终极追问：人应该如何度过自己的一生？

五、关键概念

概念	含义
PFE（Purpose For Existing）	存在的意义，一个人活着的根本目标
反向浪 / 正向浪	消耗你精力但与目标无关的事物（反向浪）vs 助你实现目标的事物（正向浪）
绿海龟法则	只在顺流时划水，逆流时保存体力——把精力花在正确的事情上
消费陷阱循环	广告制造欲望→购物→缺钱→做不喜欢的工作→更不满足→买更多东西
高尔夫球法则	你可以把球捡起来放到别处打——主动掌控自己的命运
指数理论	分享你的目标，会通过人际网络指数级放大机会

六、主要论点

大多数人从未认真问过自己"为什么存在"，只是机械地遵循社会期待（考学、工作、升职）生活。
找到 PFE 后，做任何你想做的事去实现它——选择权完全在自己手中，不需要他人允许。
把时间花在与 PFE 无关的事情上，就是浪费生命（绿海龟法则：反向浪消耗精力）。
消费主义是陷阱：广告让人把幸福寄托在物质上，陷入"工作→购物→更不满足"的恶性循环。
害怕死亡的本质，是害怕"再也没有机会做想做的事"——而如果你每天都在做想做的事，就不会恐惧。
运气并非偶然：为实现 PFE 全力以赴的人，往往"运气好"，因为他们的热情会吸引他人帮助（指数理论）。
答案只能自己寻找：没有统一方法，但独处、接触新事物、倾听内心的"共鸣"是常见途径。
不要等待"退休"：每一天都是机会，现在就能做想做的事，不必等到未来。

七、论证分析

本书的论证方式不是逻辑推演，而是通过故事和对话层层引导：

绿海龟故事 → 论证"精力管理"：只在顺流时划水，避免在反向浪上浪费精力
渔夫故事 → 论证"不必等待退休"：渔夫现在就过着商人梦想中的生活
安妮的循环 → 论证"消费陷阱"：广告如何让人陷入恶性循环
高尔夫球故事 → 论证"掌控命运"：你可以主动选择，而非被动接受
迈克的哥斯达黎加经历 → 论证"存在意义的觉醒"：面对自然的宏大，反思自我渺小

论证特点：每个抽象观点都配一个具体故事，让读者在叙事中"悟"出道理，而非被说服。这种"苏格拉底式对话"（凯茜总是用问题回答问题）强化了读者的主动思考。

八、问题解决状况

提出的问题：人为什么存在？如何找到并实现存在的意义？
给出的答案：通过独处、接触新事物、倾听内心共鸣来寻找 PFE；找到后做任何想做的事去实现它；把精力花在正向浪上。
解决程度：部分解决。作者给出了方法论框架（如何找、如何做），但承认"答案只能自己决定"，没有提供普适的、具体的答案——这既是本书的局限，也是其诚实之处。

九、批判性评价

优点

叙事生动：用故事承载哲学，可读性强，易于引发共鸣
观点清晰：PFE、绿海龟、反向浪等概念简洁有力，易于记忆
真诚不教条：反复强调"答案只能自己找"，不强行灌输

局限

哲学深度有限：探讨的是存在主义的基本命题，但未触及尼采、萨特等哲学家的深层思辨，属于"入门级"人生哲学
理想化倾向：书中"做想做的事就能成功且运气好"的设定过于乐观，忽略了现实中的结构性限制（经济压力、家庭责任、社会约束）
叙事巧合过多：咖啡馆人物仿佛"全知全能"，总能猜中主角心思，削弱了真实感
对"金钱"的讨论略显单薄：虽然触及"对金钱的定义会改变"，但未深入探讨现实生存与理想追求的平衡

价值判断

作为一本心灵成长读物，它成功唤起了读者对人生意义的思考，具有启发价值；但作为哲学著作，其深度和严谨性有限。适合作为人生思考的"起点"，而非"终点"。

十、实践应用

这本书的启示可以这样落地：

明确你的 PFE：花时间独处思考，你真正热爱的是什么？基金分析是手段还是目的？
识别反向浪：审视每天的时间花在哪里——哪些是消耗精力但与目标无关的"反向浪"（如无意义的刷手机、无效社交）？
把精力放在正向浪上：把时间投入到与目标一致的事情上（如深入学习投资分析、研究市场）
不要等待"退休"：现在就开始做想做的事，不必等到"条件成熟"
主动掌控命运：像"移走高尔夫球"一样，主动选择人生道路，而非被动接受安排

一句话总结

这本书用一个温暖的寓言提醒我们——人生最大的浪费，不是没赚到钱，而是把时间花在了与"你是谁、你为什么存在"无关的事情上。

GitHub 部署自己的个人博客网站

mythstraw@msn.com (ForeverYang) — Sun, 27 Sep 2026 17:50:00 +0800

在这个 AI 时代，知识库成了最火的项目。AI 需要知识库来提升专业度，人类需要知识库辅助学习和记忆。但有一个问题是：互联网上有什么是可以永久留存的呢？所有的服务都会随着运营商的倒闭而面临关闭，你用来保存知识库的载体也会随着消失。而目前来看，唯一能够长久存在可能也就只有这个全球最大的仓库 GitHub 了，所以把知识放在 GitHub 上成了很多人的首选方案。

想要了解整个详细流程，可以查看使用 Hugo + GitHub 部署博客这个详细的文档。

使用的技术

Hugo：静态 blog 网站工具
Git 工具
GitHub 仓库
AI 工具：nanobot
Cloudflare 部署
GitHub 自定义域名

简化的流程说明（AI 自动操作）

本地环境搭建：安装 Hugo 和 Git。
创建与配置站点：初始化 Hugo 站点，选择并配置主题样式。
编写与预览内容：用 Markdown 写文章，本地启动服务预览。
连接 GitHub 并自动化部署：将代码推送到 GitHub，配置 Actions 自动构建和发布。

修改美化 Hugo Blog

先了解一下 Hugo 的整体框架，了解了框架才能知道 AI 改了哪些东西。使用不同的主题，架构可能有一些不同，我们只要了解基础架构，细节就交给 AI 自己去学习。

Hugo 站点的目录结构

📁 核心内容与模板（你需要经常编辑的）

content/：存放你的博客文章。所有的 Markdown 文件（如 posts/my-first-post.md）都在这里。
layouts/：存放自定义的 HTML 模板。当你需要覆盖主题的页面结构（如修改页脚、首页样式）时，把主题里的文件复制到这里修改。
static/：存放不需要 Hugo 处理的静态文件。比如自定义的 CSS、JS、图片、favicon 等，Hugo 会原样复制到最终的 public/ 目录。
assets/：存放需要 Hugo 处理（如压缩、编译 SCSS）的文件。通常由主题使用，你也可以在这里放需要打包的 CSS/JS。
archetypes/：存放内容模板（原型）。当你执行 hugo new posts/xxx.md 时，Hugo 会以此处的模板生成文章的初始 Front Matter。
data/：存放数据文件（JSON/YAML/TOML），供模板调用，常用于生成列表或配置信息。
i18n/：存放多语言翻译文件。如果你的博客是中文，这里可能主要用于覆盖主题的默认语言字符串。

⚙️ Hugo 配置与构建（自动生成或较少改动）

themes/：存放你安装的 Hugo 主题（如 PaperMod 或 BearNeo）。建议永远不要直接修改这个文件夹内的文件，以免更新主题时被覆盖。
hugo.yaml：Hugo 站点的主配置文件。你的站点标题、baseURL、菜单、主题参数都在这里设置。
public/：Hugo 构建后生成的静态网站最终输出目录。部署时，GitHub Actions 或 Cloudflare 实际上就是把这里的文件发布出去。
resources/：Hugo 的缓存目录。存放图片处理、SCSS 编译等生成的中间文件。
.hugo_build.lock：Hugo 构建时的锁文件，防止多个构建任务同时修改文件。通常不需要管它，会自动生成。

🔀 版本控制与自动化（Git 相关）

.git/：Git 的本地仓库数据。不要手动修改里面的文件。
.github/：存放 GitHub Actions 工作流。里面有 workflows/hugo.yaml，是你推送到 GitHub 后自动部署到 GitHub Pages 的配置文件。
.gitignore：告诉 Git 哪些文件和文件夹不需要上传（例如 public/、resources/、.hugo_build.lock 通常会被忽略）。
.gitmodules：如果你用 git submodule 安装了主题，这个文件记录了主题的仓库地址。由于你用了主题，这个文件很重要，需要在部署时用 submodules: recursive 拉取。

☁️ 部署与托管（Cloudflare 与 GitHub Pages）

.wrangler/：Cloudflare Wrangler CLI 的本地缓存目录。通常不需要手动修改。
wrangler.jsonc：Cloudflare Workers 的配置文件。告诉 Cloudflare 项目名称、构建命令（hugo build --gc --minify）以及静态资源目录（./public）。
CNAME：用于 GitHub Pages 绑定自定义域名的文件（通常包含你的域名）。如果你同时部署到了 Cloudflare 和 GitHub，这个文件会指定 GitHub Pages 的访问域名。

你只要知道这些文件是干什么的、修改的东西要到哪里去查看就可以了，至于操作的事情交给 AI。

BearNeo 主题里，每一个导航就是一个 Markdown 文档

我使用的主题是 BearNeo，它是一个极简的主题，每一个导航其实就是一个 MD 文档，你也可以自己去打开文档去编辑内容。

Hugo 的 HTML 模板文件

如果想要做很大的样式上的修改，那就需要去改 HTML 模板了，当然你也可以让 AI 去修改。

Cloudflare 部署（了解一下，国内访问有限制）

Cloudflare 有两种部署方式 pages 和 workers，现在 Cloudflare 开始转向 workers，pages 现在是停止维护但是仍然可以使用的状态。

这里主要说明 workers 的部署过程。

选 Workers：具体设置

① 仓库里新增 wrangler.jsonc（这是唯一的仓库改动，AI 会帮你自动完成）

{
 "$schema": "./node_modules/wrangler/config-schema.json",
 "name": "foreveryang-blog",
 "compatibility_date": "2026-09-27",
 "assets": {
 "directory": "./public",
 "not_found_handling": "404-page"
 }
}

name 必须和控制台里的 Worker 名完全一致，否则构建直接失败（官方明确警告）。
compatibility_date 填你创建那天的日期。
not_found_handling 默认是 "none"（不存在路径只给一句 404）→ 必须写成 "404-page"，才会用你 404.html 生成的那个自定义 404 页。Pages 会自动探测 404.html，Workers 不会，这是从 Pages 思路切过来最容易漏的一项。
不用写 html_handling，默认 auto-trailing-slash 正好适配 Hugo 的 /p/slug/ 这种漂亮 URL。
纯静态、没有 Worker 脚本 → 不要写 "binding": "ASSETS"（那是配合 main 用的）。

② 控制台（Workers & Pages → Create application → Continue with GitHub）

接下来的流程：

Continue with GitHub → 弹 GitHub 授权页 → 授权 Cloudflare 的 GitHub App（仓库权限建议选 Only select repositories，只勾 xxxxxx.github.io）
回到 Cloudflare 选仓库 → xxxxxx.github.io
Build command 填：

git submodule update --init --recursive && hugo --minify --gc ${HUGO_BASEURL:+--baseURL "$HUGO_BASEURL/"}

Advanced settings 填：

项	值
Root directory	留空
Build variables and secrets	`HUGO_VERSION` = `0.154.5`（必填）；`HUGO_BASEURL` = `https://foreveryang.xxxxx.workers.dev/`（不知道就先不建）
API token	保持默认（Create new token）

两个开关

Enable Preview builds → 保持默认开启。它只对“非 main 分支”生效，你平时只推 main，不额外耗构建分钟；以后开分支试版式就能拿预览 URL。
Protect with Cloudflare Access → 必须关。这是给内部/私密站点套 Zero Trust 登录的，开了访客要先登录才能看博客。

③ 点部署后，日志里核对三行

Hugo 版本 = 0.154.5（证明 HUGO_VERSION 生效，没退到镜像默认的 0.147.7）；
没有 Unable to find theme "hugo-bearneo"（submodule 拉下来了）；
末尾 wrangler deploy 成功，并给出 https://xxxxxxxx.<子域>.workers.dev。

之后就是把域名发给 AI，让它确认就可以了。Cloudflare 的 workers 域名国内网络访问不了，可以自行使用自定义域名。

GitHub 怎么自定义域名

关键顺序（别做反）

GitHub 官方明确要求：先在仓库里填好域名，再去 DNS 加记录，反了有子域名被人抢注的风险。

① GitHub（先做）

https://github.com/mythstraw/mythstraw.github.io/settings/pages → Custom domain 填：

blog.foreveryang.top

→ Save

② 腾讯云 DNSPod（后做） 添加记录：

主机记录	记录类型	记录值	线路	TTL
`blog`	`CNAME`	`xxxxxx.github.io`	默认	600

记录值不带仓库名、也不要填 Settings 里那个 *.pages.github.io 的临时地址。

③ 生效后（几分钟 ~ 24h）回 Pages 页勾 Enforce HTTPS（证书签发还要几分钟）。

④ 让 AI 自行检查去触发一次构建：仓库 Actions → Deploy Hugo site to Pages → Run workflow（或随便 push 一篇文章）。构建时 configure-pages 会把 baseURL 自动换成新域名，canonical / index.xml / favicon 就都是 blog.foreveryang.top 了。

使用 Hugo + GitHub 部署博客

mythstraw@msn.com (ForeverYang) — Sun, 27 Sep 2026 10:11:00 +0800

一、Hugo 是什么？

Hugo 是一个用 Go 语言编写的静态网站生成器（SSG），自 2013 年发布以来，以其极快的构建速度和简单的部署方式在开发者社区中广受欢迎。

⚡ Hugo 的核心优势

极致的构建速度：这是 Hugo 最突出的标签。由于采用 Go 语言编译，它的构建速度在同类工具中处于领先地位。根据基准测试，构建一个包含 5,000 页的网站，Hugo 仅需约 2.1 秒，而 Jekyll 则需要约 4 分钟。对于内容量大的站点，这个优势会非常明显。
简单的部署与零依赖：Hugo 以单个二进制文件的形式分发，你下载后即可使用，无需安装 Ruby、Node.js 等运行时环境或处理复杂的依赖关系。这使得它在任何操作系统上的安装和部署都极其简单。
内置丰富功能：Hugo 自带了许多开箱即用的功能，例如多语言支持、强大的分类系统（Tags/Categories）、图片处理管道以及对 SASS/SCSS 的原生支持，无需依赖外部插件。

⚠️ Hugo 的局限性

模板系统学习曲线较陡：Hugo 使用 Go 语言的 html/template 语法，对于不熟悉 Go 的开发者来说，其语法和逻辑可能不太直观，相比 Jekyll 的 Liquid 或 Hexo 的 EJS 等模板语言，需要更多的学习时间。
缺乏官方插件系统：Hugo 没有像 Jekyll 或 Hexo 那样成熟的插件生态系统。虽然可以通过 Shortcodes、主题和 Hugo Modules 进行扩展，但实现高度自定义的功能时，可能不如有插件系统的工具灵活。
主题生态相对有限：虽然 Hugo 拥有超过 900 个主题，但与 Hexo 等拥有庞大社区和丰富主题数量的工具相比，其主题库在数量和一些特定需求的覆盖上可能稍显不足。

🔍 与其他主流工具的横向对比

为了更直观地展示差异，下表汇总了 Hugo 与几款主流 SSG 的核心特性：

工具	编程语言	构建速度	学习曲线	核心优势	最适合场景
Hugo	Go	极快 (毫秒/秒级)	中等	速度最快、单二进制、零依赖	大型站点、内容密集型网站、追求极致性能
Jekyll	Ruby	较慢 (分钟级)	简单	GitHub Pages 原生支持、成熟的插件生态	简单的博客、GitHub Pages 托管
Hexo	Node.js	快	简单	丰富的插件和主题生态、对 JS 开发者友好	个人博客、Node.js 技术栈用户
Gatsby	JavaScript (React)	较慢	陡峭	强大的 React 组件和 GraphQL 数据层	复杂的 React 应用、需要大量动态交互的站点
Astro	JavaScript (多框架)	快	简单	默认零 JS、支持多框架组件、内容驱动	现代内容网站、电商落地页、追求最小化 JS
Eleventy	JavaScript	快	简单	配置灵活、不依赖特定前端框架、对 JS 生态友好	偏好 JS 工具链的开发者、注重灵活性的项目

综合来看，Hugo 的核心竞争力在于 “速度” 和 “简洁”。它非常适合以下场景：

内容量大、更新频繁的博客或文档站点：构建速度的优势会极大提升开发体验和部署效率。
不想深入折腾前端工具链的开发者：单二进制文件、零依赖的特性让部署和维护变得非常简单。
对网站性能有极致要求的场景：Hugo 生成的静态站点本身就非常轻量，配合 CDN 可以轻松获得极快的加载速度。

二、整体部署流程概述（简单了解）

使用 Hugo 和 GitHub 部署博客，整个流程可以概括为：

在本地用 Hugo 生成静态网站 → 通过 Git 推送到 GitHub 仓库 → 再由 GitHub Actions 自动构建并发布到 GitHub Pages。

🧭 整体流程概览

整个部署管线大致分为四个阶段：

本地环境搭建：安装 Hugo 和 Git。
创建与配置站点：初始化 Hugo 站点，选择并配置主题。
编写与预览内容：用 Markdown 写文章，本地启动服务预览。
连接 GitHub 并自动化部署：将代码推送到 GitHub，配置 Actions 自动构建和发布。

🛠️ 步骤一：准备工作与本地搭建

安装必要工具
你需要在本地安装 Hugo（建议安装 extended 扩展版，因为许多主题依赖 SCSS 支持）和 Git。
- macOS: brew install hugo
- Windows: scoop install hugo-extended
- Linux: sudo snap install hugo 或 sudo apt install hugo
创建 Hugo 站点并初始化 Git
在终端中运行以下命令，创建一个名为 my-blog 的站点，并初始化 Git 仓库：
```
hugo new site my-blog
cd my-blog
git init
```
选择并安装主题
Hugo 有丰富的主题生态，官方主题库 themes.gohugo.io 收录了 900+ 个主题，可以按标签、功能、语言筛选，先逛一逛再决定用哪个。中文友好的热门主题包括 PaperMod、LoveIt、hugo-theme-stack 等。以 PaperMod 为例，通过 Git 子模块安装：
```
git submodule add https://github.com/adityatelange/hugo-PaperMod themes/PaperMod
```
然后，在站点配置文件 hugo.toml（或 config.toml）中启用主题：
```
theme = "PaperMod"
```

基础站点配置
编辑 hugo.toml，至少设置以下关键项：

baseURL = "https://你的用户名.github.io/"
languageCode = "zh-cn"
title = "我的博客"

✍️ 步骤二：编写内容与本地预览

创建新文章
使用 hugo new 命令创建文章，它会根据模板自动生成 Front Matter（元数据）：
```
hugo new posts/my-first-post.md
```
打开生成的文件，将 draft: true 改为 false，文章才会被正式发布。
本地预览
启动 Hugo 内置的开发服务器，实时预览效果：
```
hugo server -D
```
访问 http://localhost:1313/ 即可查看。-D 参数表示包含草稿文章。

🚀 步骤三：推送到 GitHub 并启用 Pages

创建 GitHub 仓库
在 GitHub 上新建一个仓库。关键点：如果你希望博客地址是 https://你的用户名.github.io，仓库名应设置为 你的用户名.github.io；如果是项目站点，仓库名可以任意，但地址会多一级子路径。

推送本地代码
在本地仓库中添加远程地址并推送：

git remote add origin https://github.com/你的用户名/仓库名.git
git add .
git commit -m "Initial commit"
git push -u origin main

启用 GitHub Pages
进入仓库的 Settings > Pages，将 Source 从 “Deploy from a branch” 改为 “GitHub Actions”。这个改动是立即生效的，无需保存按钮。

⚙️ 步骤四：配置 GitHub Actions 自动部署

这是实现“推送即部署”的核心。你需要创建一个 GitHub Actions 工作流文件。

创建工作流文件
在站点根目录下创建 .github/workflows/hugo.yaml 文件。

配置工作流内容
将以下官方示例内容粘贴进去（注意根据你的 Hugo 版本和分支名微调）。这个工作流会在你向 main 分支推送代码时，自动安装 Hugo、构建站点并部署到 GitHub Pages：

name: Deploy Hugo site to Pages
on:
 push:
 branches:
 - main
 workflow_dispatch:
permissions:
 contents: read
 pages: write
 id-token: write
concurrency:
 group: "pages"
 cancel-in-progress: false
defaults:
 run:
 shell: bash
jobs:
 build:
 runs-on: ubuntu-latest
 env:
 HUGO_VERSION: 0.147.9
 steps:
 - name: Install Hugo CLI
 run: |
 wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
 && sudo dpkg -i ${{ runner.temp }}/hugo.deb
 - name: Checkout
 uses: actions/checkout@v4
 with:
 submodules: recursive
 fetch-depth: 0
 - name: Setup Pages
 id: pages
 uses: actions/configure-pages@v5
 - name: Build with Hugo
 env:
 HUGO_CACHEDIR: ${{ runner.temp }}/hugo_cache
 HUGO_ENVIRONMENT: production
 run: |
 hugo \
 --minify \
 --baseURL "${{ steps.pages.outputs.base_url }}/"
 - name: Upload artifact
 uses: actions/upload-pages-artifact@v3
 with:
 path: ./public
 deploy:
 environment:
 name: github-pages
 url: ${{ steps.deployment.outputs.page_url }}
 runs-on: ubuntu-latest
 needs: build
 steps:
 - name: Deploy to GitHub Pages
 id: deployment
 uses: actions/deploy-pages@v4

推送并触发部署
提交这个工作流文件并推送到 GitHub。推送后，GitHub Actions 会自动开始运行。你可以在仓库的 Actions 标签页下查看构建和部署的实时日志。

🔄 后续写作与发布流程

完成上述配置后，你日常的写作和发布流程会非常简洁：

本地写作：用 hugo new posts/文章名.md 创建文章，用 Markdown 编辑。
本地预览：hugo server -D 确认效果。
一键发布：git add . && git commit -m "更新文章" && git push。

推送后，GitHub Actions 会在云端自动完成构建和部署，几分钟后你的博客就会更新。

💡 关键提醒

baseURL 配置：务必在 hugo.toml 中正确设置 baseURL，否则部署后可能出现样式或链接错误。
主题更新：如果通过 Git 子模块安装主题，在克隆仓库或 Actions 中构建时，需要使用 --recursive 参数来拉取主题代码，上述工作流示例中已包含 submodules: recursive。
自定义域名：如果你绑定了自定义域名，需要在仓库的 Pages 设置中配置，并相应调整 baseURL。

三、Hugo 其他安装方式

Hugo 还支持免本地安装的构建和部署方式。得益于其“单二进制文件”的设计，你可以将构建过程完全放在云端完成，本地只需要一个浏览器和 Git 即可。

☁️ 方式一：利用 GitHub Actions 自动构建

只需要在项目仓库中配置好 GitHub Actions 工作流（如之前封装好的 hugo.yaml），每次将 Markdown 源文件推送到 GitHub 后，Actions 的虚拟环境会自动安装 Hugo、构建站点并部署到 GitHub Pages。

核心配置：
在 hugo.yaml 中，你只需要通过 peaceiris/actions-hugo@v3 这个 Action 来按需安装指定版本的 Hugo（支持 extended 版本和 Hugo Modules），它会在几秒内完成安装。

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

这样，你的本地环境就完全不需要 Hugo，只需负责编写 Markdown 和推送代码。

🐳 方式二：使用 Docker 容器

如果你需要在本地进行实时预览，但不想直接安装 Hugo 到系统里，Docker 是最佳选择。

你可以直接运行官方的 Hugo Docker 镜像，将本地项目目录挂载到容器中，即可在容器内执行 hugo server 命令。

# 示例：使用官方镜像启动本地预览服务
docker run --rm -it \
 -v $(pwd):/src \
 -p 1313:1313 \
 ghcr.io/gohugoio/hugo:latest server --bind 0.0.0.0

这种方式将 Hugo 的运行环境隔离在容器内，不会污染你的主机系统，同时还能获得完整的本地开发体验。

🚀 方式三：使用云构建服务平台

一些静态网站托管平台（如 Netlify、Vercel、EdgeOne Pages 等）内置了对 Hugo 的支持。

你只需要将 GitHub 仓库连接到这些平台，它们会自动检测到这是一个 Hugo 项目，并在云端完成构建和部署，实现真正的“零配置”持续集成。

对于“Hugo + GitHub”的博客方案，使用 GitHub Actions 进行云端构建是最简洁、最一致的路径。你的本地角色可以简化为“内容创作者”，只需专注于用 Markdown 写作和 git push 即可。

四、使用 AI 工具自动部署

下面是一个完整的 Skill 技能，整合了 Hugo 博客部署 和 自定义编辑 两大流程。你只需将整个 hugo-blog-manager 文件夹放入任何 agent 的 skills/ 目录，即可通过自然语言触发。

我用的是 nanobot，其他 AI 工具一样，保险起见可以让 AI 对 skill 做一次校验。

📁 目录结构

skills/
└── hugo-blog-manager/
 ├── SKILL.md
 └── scripts/
 ├── _common.ps1 # 公共函数：DryRun 预演、hugo 定位、UTF-8 写文件
 ├── check_env.ps1 # 只读环境体检
 ├── install_hugo.ps1 # 安装 hugo（本地 winget / Docker）
 ├── init_site.ps1 # 新建站点 + git init
 ├── install_theme.ps1 # 装主题并写入 theme:
 ├── preview.ps1 # hugo server 本地预览
 ├── push_github.ps1 # 提交并推送
 └── setup_actions.ps1 # 生成 GitHub Actions 部署 workflow

脚本全部是 PowerShell（Windows 原生，不依赖 WSL / Git Bash），并且每个脚本都带 -DryRun：只打印将要执行的命令，不做任何改动。这就是整个 Skill「确认式执行」的地基——先预演给用户看，用户点头了才实跑。

📄 SKILL.md

---
name: hugo-blog-manager
description: 管理 Hugo 博客：从零创建站点、选装主题、推送 GitHub 并配置 GitHub Actions 自动部署到 GitHub Pages；以及安全地修改现有站点的内容、Front Matter、布局、样式和配置（先给 diff 再逐步确认，hugo server 本地预览，构建或发布失败排错）。当用户说“部署 Hugo 博客”“新建 Hugo 站点”“修改 Hugo 页面”“改页脚”“加关于页”“博客发不出去/Pages 404”或提到 Hugo、GitHub Pages、hugo.yaml 时使用。安装 Hugo 本体必须先让用户在“本地安装 / Docker 安装”之间选择；主题必须在安装那一刻现场询问用户。
metadata:
 nanobot:
 emoji: 📝
 requires:
 bins: ["git"]
---

# Hugo 博客管理器

两个工作流：**流程 A 部署新博客**、**流程 B 安全修改现有站点**。

脚本目录（下文记作 `$S`，调用时替换成这个技能的真实路径）：

```
$S = <skills>\hugo-blog-manager\scripts
```

运行时的当前目录不是技能目录，**调用脚本必须用绝对路径**。

## 两条硬性规则

1. **Hugo 本体安装必须先问用户**。只能在用户明确选择「本地安装」（winget `Hugo.Hugo.Extended`）或「Docker 安装」（拉 hugo 镜像，用 `docker run` 跑）之后，才通过 `install_hugo.ps1` 执行。不要自动安装，不要替用户选。
2. **主题必须现场问用户**。本技能不预设任何主题。走到装主题那一步时，先给 3~4 个候选（各自特点 + 仓库地址）让用户挑，选定后才跑 `install_theme.ps1`。

## 确认式执行

每个关键节点三步走：先跑 `-DryRun` → 把命令和影响讲给用户 → 用户明确同意后去掉 `-DryRun` 实跑。

## 全局前置检查

```powershell
powershell -NoProfile -File "$S\check_env.ps1"
```

只读体检（hugo / git / docker / winget），退出码 `0`=就绪、`1`=hugo 缺失、`2`=git 缺失、`3`=两者都缺。hugo 缺失时**不要自己装**，转去问用户选哪种方式：

```powershell
powershell -NoProfile -File "$S\install_hugo.ps1" -Method Local -DryRun # 本地安装
powershell -NoProfile -File "$S\install_hugo.ps1" -Method Docker -DryRun # Docker 安装
```

装完重跑 `check_env.ps1` 确认；本地安装后若 `hugo` 仍不可见，提醒用户新开终端刷新 PATH。

## 流程 A：部署新博客

按顺序走，每步先 DryRun 再等确认。

1. **环境检查** —— 见上。
2. **确定站点位置与标题** —— 问用户博客放哪个目录、叫什么名字（`baseURL` 后续可改）。
3. **创建站点**：`init_site.ps1 -SitePath "<目录>" -Title "<标题>"` → `hugo new site --format yaml` + `git init -b main` + 写 `hugo.yaml` 与 `.gitignore`。目标目录必须为空，脚本拒绝覆盖已有内容。
4. **选主题（必须先问用户）**：`install_theme.ps1 -SitePath "<目录>" -ThemeName <名> -ThemeRepo <仓库地址>`。默认走 `git submodule`（主题可后续升级）；GitHub 不可达时脚本会报错并提示改用 `-Mode Zip -ZipUrl <镜像 zip 地址>`。
5. **本地预览，交给用户确认**：`preview.ps1 -SitePath "<目录>"`（`hugo server`，默认 http://127.0.0.1:1313/）。这是前台长进程，用后台会话跑；**界面效果必须由用户在浏览器确认**，不要用 HTTP 探测 localhost 代替。
6. **建 GitHub 仓库**（让用户在网页端建，**不要勾 README / .gitignore**），然后推送：
 `push_github.ps1 -SitePath "<目录>" -RepoUrl https://github.com/<user>/<repo>.git -Message "Initial commit: Hugo blog"`
7. **配置自动部署**：`setup_actions.ps1 -SitePath "<目录>"` 写 `.github/workflows/hugo.yaml` 并推送。Hugo 版本自动取自本地 hugo 或 hugo 容器，也可 `-HugoVersion x.y.z` 指定。
8. **收尾**：提醒用户去仓库 `Settings → Pages → Source` 选 **GitHub Actions**（一次性手动步骤），之后每次 push 自动发布。

## 流程 B：安全修改现有站点

1. **先读再动**。定位改动点：`hugo.yaml`（站点配置）、`content/`（文章 / Front Matter）、`layouts/`（模板覆盖）、`assets/` 与 `static/`（样式、静态资源）、`themes/<主题>/`（主题源码）。
2. **主题是外部代码（submodule），默认不改它内部文件**。优先在站点根目录放同名文件覆盖（Hugo 的 lookup order），例如 `layouts/partials/footer.html`。确实必须改主题内部时，先说明代价（升级会被覆盖，或需要 fork）再决定。
3. **每处改动都是三步**：读原文 → 把 diff（改什么、为什么、影响哪些页面）给用户看 → 等确认 → 再改。一次只改一处，别攒一堆一起改。
4. **改完必看**：`preview.ps1` 让用户在浏览器确认效果；改模板时可用 `-Drafts` 连草稿一起看。
5. **用户认可后再提交**：`push_github.ps1 -SitePath "<目录>" -RepoUrl <origin> -Message "<改了什么>"`。
6. **不可逆操作先备份**：删内容、换主题、改 `baseURL`、重写 git 历史之前，先复制目录或开新分支。

### 常见排错

- **Pages 404 / 页面不更新**：仓库 `Settings → Pages → Source` 必须是 `GitHub Actions`；`baseURL` 与实际域名不一致时由 workflow 的 `--baseURL` 兜底。
- **样式没生效**：核对主题的 `assets` / `static` 目录结构，以及 `hugo.yaml` 里的 `theme` 值与 `themes/` 下的目录名是否一致。
- **构建失败**：看 Actions 日志；本地 hugo 版本与主题要求不匹配时，用 `setup_actions.ps1 -HugoVersion` 重新生成 workflow。
- **CI 里主题目录是空的**：workflow 的 checkout 已带 `submodules: recursive`；若仍为空，确认 `.gitmodules` 已提交进仓库。
- **用户站点仓库（`<user>.github.io`）**：`baseURL` 必须是根域名（如 `https://mythstraw.github.io/`）；私有仓库开 Pages 需付费，必须 public。

## Hugo 陷阱速查

- `T` / `i18n` 返回值会被 HTML 转义 → 翻译串含 `<a>` 时必须 `| safeHTML`。
- 模板内链接用 `.RelPermalink`；`relURL` 在带语言前缀时会重复加前缀。
- 首页 `.Title` 为空 → 判断首页必须用 `.IsHome`。
- front matter 不写 `slug` 时 Hugo 用**标题**做 URL（中文标题 → 百分号编码）→ 每篇显式写 `slug`。
- `buildFuture=false`（默认）：`date` 写成未来时间会被整篇跳过。
- 用 Docker 跑 hugo 必须把站点子目录挂成工作目录（挂整盘会报 "Unable to locate config file"）。

## 脚本清单

| 脚本 | 作用 | 关键参数 |
| --- | --- | --- |
| `check_env.ps1` | 只读环境体检 | `-Json` |
| `install_hugo.ps1` | 安装 hugo（**须用户先选方式**） | `-Method Local\|Docker`、`-StartEngine` |
| `init_site.ps1` | 新建站点 + git init + 配置 + .gitignore | `-SitePath`、`-Title`、`-BaseUrl`、`-LanguageCode` |
| `install_theme.ps1` | 装主题并写入 `theme:`（**主题须现场问用户**） | `-ThemeName`、`-ThemeRepo`、`-Mode Submodule\|Zip` |
| `preview.ps1` | `hugo server` 本地预览 | `-Port`、`-Drafts`、`-BindAddress` |
| `push_github.ps1` | 提交并推送到 GitHub | `-RepoUrl`、`-Branch`、`-Message`、`-Rebase` |
| `setup_actions.ps1` | 生成 GitHub Actions 部署 workflow | `-HugoVersion`、`-Branch`、`-NoPush` |

🔧 脚本关键片段

为控制篇幅，下面是各脚本的关键部分（真代码节选，# ... 表示省略；完整脚本见文末下载）。

`scripts/_common.ps1`

这段是整个技能的核心：本机装了 hugo 就直接跑，没装但 Docker 引擎在跑就用容器跑——两种安装方式共用同一套脚本。

# 有原生 hugo 就原生跑；没有原生 hugo 但 Docker 引擎在跑，就用容器跑
function Invoke-Hugo {
 param(
 [Parameter(Mandatory = $true)][string]$SitePath,
 [Parameter(Mandatory = $true)][string[]]$HugoArgs,
 [string]$MountPath = '',
 [string]$Image = 'hugomods/hugo:exts',
 [string[]]$ExtraDockerArgs = @(),
 [switch]$DryRun
 )
 $status = Get-HugoStatus
 if ($status.Mode -eq 'native') {
 $line = ('cd "{0}"; hugo {1}' -f $SitePath, ($HugoArgs -join ' '))
 if ($DryRun) { Write-Output "DRY-RUN: $line"; return }
 # ... 实跑，退出码非 0 就抛错
 }
 if ($status.Mode -eq 'docker') {
 $mount = $MountPath; if (-not $mount) { $mount = $SitePath }
 $src = ConvertTo-PosixPath $mount # E:\myblog -> /e/myblog
 $dkArgs = @('run', '--rm') + $ExtraDockerArgs + @('-v', "${src}:/src", '-w', '/src', $Image, 'hugo') + $HugoArgs
 if ($DryRun) { Write-Output ('DRY-RUN: docker ' + ($dkArgs -join ' ')); return }
 # ... 实跑，退出码非 0 就抛错
 }
 throw "hugo is not available: neither a native 'hugo' executable nor a running Docker engine was found. Run install_hugo.ps1 first (ask the user to choose Local or Docker)."
}

`scripts/check_env.ps1`

只读体检，靠退出码把结论告诉 agent：0=就绪、1=hugo 缺失、2=git 缺失、3=两者都缺。缺 hugo 时打印的是「去问用户选哪种方式」，而不是自己去装。

$hugo = Get-HugoStatus # native / docker / none
$git = Get-GitExe
$docker = Test-DockerEngine # client / engine / version

$missing = @()
if ($hugo.Mode -eq 'none') { $missing += 'hugo' }
if (-not $git) { $missing += 'git' }

# exit code: 0 ready, 1 hugo missing, 2 git missing, 3 both missing
$exitCode = 0
if ($missing -contains 'hugo') { $exitCode += 1 }
if ($missing -contains 'git') { $exitCode += 2 }

if ($missing -contains 'hugo') {
 Write-Output 'NEXT: hugo is missing. Do NOT install silently - ask the user to pick one:'
 Write-Output ' A) local install : powershell -NoProfile -File install_hugo.ps1 -Method Local (winget Hugo.Hugo.Extended)'
 Write-Output ' B) docker install : powershell -NoProfile -File install_hugo.ps1 -Method Docker (needs Docker Desktop running)'
}

`scripts/install_hugo.ps1`

两种安装方式（-Method Local|Docker），都要求用户先表态。装完自己复检一次，而不是假设成功。

if ($Method -eq 'Local') {
 $wgArgs = @('install', '--id', $WingetId, '-e', '--accept-source-agreements', '--accept-package-agreements')
 if ($DryRun) { Write-Output ('DRY-RUN: {0} {1}' -f $winget, ($wgArgs -join ' ')); exit 0 }
 & $winget @wgArgs
 $after = Get-HugoStatus
 if ($after.Mode -eq 'native') { Write-Output ("OK: hugo {0} -> {1}" -f $after.Version, $after.Exe); exit 0 }
 # ... 仍不可见时给出提示（下载被墙、需刷新 PATH、或改用 Docker）
}

# Docker 方式：引擎没起时可加 -StartEngine，最多等 240 秒
& $docker pull $Image
& $docker run --rm $Image hugo version

`scripts/init_site.ps1`

新建站点前的唯一硬校验：目标目录必须是空的，宁可报错也不碰已有内容。

if (Test-Path -LiteralPath $sitePath) {
 $entries = @(Get-ChildItem -LiteralPath $sitePath -Force | Where-Object { $_.Name -ne '.' })
 if ($entries.Count -gt 0) {
 Write-Fail "Target directory is not empty: $sitePath. Pick another path, or clean it up first (refusing to touch existing content)." 4
 }
}

Invoke-Hugo -SitePath $parent -MountPath $parent -Image $Image -DryRun:$DryRun `
 -HugoArgs @('new', 'site', $leaf, '--format', 'yaml')

# 新站点没有需要保留的内容，直接写一份干净的 hugo.yaml（theme: 留到装主题那步再写）
$config = @"
baseURL: "$BaseUrl"
languageCode: "$LanguageCode"
title: "$Title"
"@
New-Utf8File -Path $configPath -Content $config # UTF-8 无 BOM，避免中文标题乱码

`scripts/install_theme.ps1`

默认 git submodule（主题可后续升级）；github.com 不可达时不硬顶，改走 -Mode Zip 从镜像下载。

# 先探活：不通就明确告诉用户「加速器没开」或「改用 -Mode Zip」
$probe = & $git ls-remote $ThemeRepo HEAD 2>&1
if ($LASTEXITCODE -ne 0) {
 Write-Fail "Cannot reach $ThemeRepo" 3
}

& $git -C $sitePath submodule add $ThemeRepo "themes/$ThemeName"
& $git -C $sitePath submodule update --init --recursive

# -Mode Zip 分支：下载 + 解压到 themes/<名>
Invoke-WebRequest -Uri $ZipUrl -OutFile $tmpZip -UseBasicParsing -TimeoutSec 300
Expand-Archive -LiteralPath $tmpZip -DestinationPath $tmpDir -Force

# 把 theme: 写进配置（已有就替换，没有就追加）
if ($content -match '(?m)^\s*theme\s*[:=]') {
 $newContent = [regex]::Replace($content, '(?m)^\s*theme\s*[:=].*$', $line)
}
New-Utf8File -Path $configPath -Content $newContent

`scripts/preview.ps1`

本地预览。Docker 模式下有个坑：容器内得监听 0.0.0.0，端口只发布到宿主机回环地址，否则外面打不开。

$status = Get-HugoStatus
if ($status.Mode -eq 'none') {
 Write-Fail "hugo is not available. Run check_env.ps1, then ask the user to choose Local or Docker install." 1
}

# 容器模式：容器内监听 0.0.0.0，端口发布在宿主机回环地址上
$innerBind = $BindAddress
$extra = @()
if ($status.Mode -eq 'docker') {
 $innerBind = '0.0.0.0'
 $extra = @('-p', ("{0}:{1}:{1}" -f $BindAddress, $Port))
}

$hugoArgs = @('server', '--port', "$Port", '--bind', $innerBind)
if ($Drafts) { $hugoArgs += '-D' }

`scripts/push_github.ps1`

三道保险：身份没配不提交、工作区干净不算失败、远端已有提交时默认中止（要显式加 -Rebase）。

# 1) git 身份没配就中止，绝不以未知作者提交
if (-not $email -or -not $name) {
 Write-Fail 'git user.name / user.email are not configured. Ask the user for them and re-run with -GitUserName / -GitUserEmail.' 4
}

# 2) 工作区干净就跳过 commit（不是报错）
$status = (& $git -C $sitePath status --porcelain 2>$null)
if ($status) {
 Invoke-Git -GitArgs @('-C', $sitePath, 'add', '-A')
 Invoke-Git -GitArgs @('-C', $sitePath, 'commit', '-m', $Message)
}

# 3) 远端已有提交时中止，除非显式 -Rebase
$remoteHeads = (& $git ls-remote --heads origin $Branch 2>$null)
if ($remoteHeads -and $LASTEXITCODE -eq 0) {
 if (-not $Rebase) {
 Write-Fail "Remote is not empty. Re-run with -Rebase to pull remote commits first, or push to another repo/branch." 4
 }
 Invoke-Git -GitArgs @('-C', $sitePath, 'pull', '--rebase', 'origin', $Branch)
}

Invoke-Git -GitArgs @('-C', $sitePath, 'push', '-u', 'origin', $Branch) -AllowFail

`scripts/setup_actions.ps1`

Hugo 版本不写死：优先用 -HugoVersion，否则从本地 hugo 或 hugo 容器里探测，保证 CI 用和你本地一致的版本。

if (-not $HugoVersion) {
 $status = Get-HugoStatus
 if ($status.Mode -eq 'native') {
 $HugoVersion = Get-HugoVersionFromString -Text $status.Version
 }
 elseif ($status.Mode -eq 'docker') {
 $raw = @(& $status.Exe run --rm $Image hugo version 2>$null) -join ' '
 $HugoVersion = Get-HugoVersionFromString -Text $raw
 }
}

# 模板里占位，再替换成真实版本号与分支，UTF-8 无 BOM 写出
$workflow = $template.Replace('__HUGO_VERSION__', $HugoVersion).Replace('__BRANCH__', $Branch)
New-Utf8File -Path $workflowPath -Content $workflow

# 交给 push_github.ps1 提交推送（复用同一套身份/远端/分支保护）
& (Join-Path $PSScriptRoot 'push_github.ps1') -SitePath $sitePath -RepoUrl $remote -Message $Message

🚀 使用方式

解压后把整个 hugo-blog-manager 文件夹放进 nanobot 工作区的 skills/ 目录（Windows 下不用 chmod，PowerShell 脚本直接就能跑）。
对 nanobot 说：
- 部署新博客：“部署 Hugo 博客”
- 修改现有博客：“修改 Hugo 页脚”、“添加关于页面”等
nanobot 会自动加载 Skill，按对应流程逐步询问并执行——每个节点都是「先 -DryRun 给你看命令 → 你确认 → 才真正执行」。

📦 下载这个 Skill

上面第四节贴的只是节选，完整脚本（7 个脚本 + 公共函数，含全部边界检查、退出码与排错提示）打包在这里：

⬇️ 下载 hugo-blog-manager.zip

下载后解压，把整个 hugo-blog-manager 文件夹放进 nanobot 工作区的 skills/ 目录，重启会话即可自动加载。

📄 延伸阅读：这篇讲的是「为什么这么搭」——Hugo 是什么、和其它静态站点生成器的差别、Actions 自动部署的原理。另一篇《GitHub 部署自己的个人博客网站》是一份更完整的实操记录：从建仓库、配 Actions 到绑定自定义域名，可以对照着看。

第一篇文章：博客开张

mythstraw@msn.com (ForeverYang) — Sun, 27 Sep 2026 00:45:00 +0800

博客搭起来了 🎉

这个站点用什么搭的

Hugo（extended 版）+ hugo-bearneo 主题，构建速度极快，页面很轻
内容用 Markdown 写，放在 content/blog/ 目录
主题固件是 submodule，升级用 git submodule update --remote
推送到 GitHub 后由 GitHub Actions 自动构建并发布到 GitHub Pages

怎么写新文章

在站点根目录执行：

hugo new content blog/文章文件名.md

或者直接复制本文件的表头（front matter），改 title / date / tags 即可。

Front matter 里常用字段：

字段	作用
`title`	文章标题
`date`	发布时间（决定排序；写未来时间会当天不显示）
`slug`	文章 URL 末段，例如 `/p/hello-world/`
`description`	摘要，用于列表页和搜索引擎
`tags`	标签数组
`draft: true`	标记为草稿，默认不发布
`mermaid: true`	允许本文使用 Mermaid 图表

 之前的内容会作为列表页的摘要。

已开启的功能

按年份分组的文章列表、标题搜索、文章目录、图片点击放大、外链新窗口打开。

这篇文章可以删掉，或者留着当模板用。

工具推荐

mythstraw@msn.com (ForeverYang) — Mon, 01 Jan 0001 00:00:00 +0000

工具推荐

这里主要推荐一些好用的 AI 小工具，都是我自己在用或者在折腾的，陆续补充。

网页工具

随心打印 —— 康奈尔笔记纸在线生成，选好版式直接打印，随手就能用。
免费抠图 —— 在线一键抠图，图片本地处理，不用担心素材外传。
iLoveIMG —— 图片在线编辑工具集
TinyWow —— 免费在线小工具的合集：PDF、图片、视频、文字处理。
压缩工具 —— 在线压缩图片、视频、PDF，不用装软件。
Wx-Library电子书 —— 电子书网站
iLovePDF —— PDF爱好者的在线工具集
PDF24 Tools —— 解决所有PDF问题的免费PDF工具
懒人工具箱 —— 超全的工具网站，日常处理、开发调试
全能颜色工具 —— AI配色、图像处理、代码转换、数据可视化
包装纸工具 —— 把照片变成包装纸的工具
煎蛋阅读器 —— 网页版电子书阅读器，覆盖主流电子书格式
设计工具箱 —— 免费在线设计工具合集
DeepL翻译工具 —— 功能最全的翻译工具
Watt Toolkit工具箱 —— 一个开源跨平台的多功能 Steam 工具箱
AI 字体生成器 —— 免费创作独特的纹身、签名和手写文本
Calligrapher —— 免费创作英文手写签名
OKLCH colors —— OKLCH色彩模型的工作原理探索工具
Palettt —— OKLCH 色彩调色板生成器与色彩工具
DevKitLab —— 给开发者使用的工具集

有趣的网站

中华珍宝馆 —— 中国历代书法绘画在线欣赏
奇迹秀 —— 设计师的宝藏网站
麦田艺术 —— 高清油画免费下载
Neal.fun —— 打发时间的解压小游戏

开源工具

FMHY —— 互联网最大的免费资源收藏
SVG图案生成器 —— 在SVG中创建无缝图案，用作网站背景、头部图片等设计
BumpMesh —— 给3D模型添加纹理的工具
DevsideCar —— 通过本地代理加速访问国外网站
MinerU —— 智能文档解析工具
Readest —— 电子书阅读器
Revezone —— 一个轻量级、以本地为先、以图为中心的思维管理工具
Salt Player —— 本地音乐播放器

关于我

mythstraw@msn.com (ForeverYang) — Mon, 01 Jan 0001 00:00:00 +0000

关于我

嗨！👋 这里是 ForeverYang 的个人博客。

我是一名家装设计师，习惯在图纸上构建空间；我也是一名 3D 打印玩家，喜欢把虚拟的想象打印成真实的触感。我对这个世界充满好奇，尤其是科技带来的一切变革。

目前，我正以 AI 新手的身份，一头扎进人工智能的浪潮里。
带着一点 Python 基础，我折腾过 Codex、OpenCode、NanoBot、WorkBuddy、n8n等工具。从写第一个 AI Skill，到搭建网页端 App，再到构建这个个人网站……

我享受这种“一点点尝试，一点点进步”的养成感。
在这里，我会毫无保留地分享我的探索过程，希望能为你带来一点微光。

在代码与设计之外，我的生活还有两个避风港：
🎸 戴上耳机，听赵雷 🦔，在民谣的吉他声里感受人间烟火；
⚓️ 翻开漫画，看海贼王 🏴‍☠️，跟着路飞一起向往那片自由的海。

这个博客，是我记录科技探索与知识沉淀的自留地。
很高兴认识你，希望这里的文字能与你产生共鸣。✨

联系方式

邮箱：mythstraw@msn.com

欢迎来信，或者直接订阅 RSS 。

名句库

mythstraw@msn.com (ForeverYang) — Mon, 01 Jan 0001 00:00:00 +0000

名句库

首页每天显示的那一句，就是从下面这些名句里轮换出来的：轮到哪条由访客本地的日期决定
（算法：距 2000-01-01 的天数 mod 名句条数），所以同一天打开看到的是同一条，隔天自动换。

名句内容单独存放在站点根目录的 data/quotes.yaml，想加、想删、想改直接编辑那个文件就行——
列表顺序就是轮换顺序，条数变了也不用改别的地方。下面这份清单会自动跟着更新，
带「今天」标记的那条就是此刻首页显示的那句。

我们终此一生，就是要摆脱他人的期待，找到真正的自己伍绮诗《无声告白》
不是所有人都有勇气在明知前路艰难的情况下继续往前奋跑的《冲·撞》
在人生的路途中，如果我们愿意而且有能力做到两点:放眼前途，容忍异己，我们会受益良多。前者让我们不受损失和伤害，后者可以使我们免于争论和口角叔本华
我现在渴望的并非快乐，但求自己不要无知。人们总以为自己和这个世界是隔离的，但只需一株伫立在金色尘埃中的橄榄树，或晨曦下几片亮晶晶的沙滩，也许就能让我们察觉到内心的抗拒正在消解阿尔贝·加缪
世界就是你自己，这个真理适用于生活中的所有人。当你懂得这个道理后，你就会意识到，你不认识什么太阳、地球，而永远只承认自己的双眼和双手，因为太阳为眼睛所见，地球为双手所感知叔本华
无人问津也好，技不如人也罢，你都要试着安静下来，去做自己该做的事，而不是让内心的烦躁、焦虑，毁掉你本就不多的热情和定力《人民日报》
好的和坏的我们都收下吧，然后一声不响继续生活，如此我们才能活得干净、自在，几乎接近幸福，如此我们才敢面对那些美好的事物说：我爱着海桑《这世界如此喧闹》
重要的不是过去，而是你现在变成的样子《狮子王》
要完全与另一个人发生关联，必须先跟自己发生关联。如果我们不能拥抱我们自身的孤独，就只是利用他人作为对抗孤立的挡箭牌而已。只有当人可以活得像只老鹰，不需要任何观众，才能爱慕地转向另一个人。只有在那个时候，一个人才能够去关心另一个存在的生长。欧文·亚隆《当尼采哭泣》
内心过分单纯和敏锐、看问题的目光过于明察秋毫，实际并无好处。处理人间事务时粗线条即可，不必过分深究。世间万事万物，总存在太多彼此矛盾的方面和各不相同的形式，考虑多了，反而迷茫蒙田《蒙田随笔》
跟志趣相投的人共事，跟思维同频的人生活，跟互相喜欢的朋友呆在一起，是理想的生活李雪琴
有一些人，在出生的地方，他们好像是过客，孩提时代就非常熟悉的浓荫郁郁的小巷，同伙伴们游戏其中的人烟稠密的街衢，对他们来说都不过是旅途中的一个宿站毛姆《月亮与六便士》
认识自己的无知，是认识世界最可靠的方法蒙田
真正的发现之旅，不在于寻找新的风景，而在于拥有新的眼光普鲁斯特
我们读书，是为了知道自己并不孤单。C.S.路易斯
每一个不曾起舞的日子，都是对生命的辜负尼采
世界上只有一种真正的英雄主义，就是在认清生活真相之后依然热爱生活罗曼·罗兰
耐心是一切聪明才智的基础柏拉图
人感知的不是英寸、米、磅和加仑，他只感到热，感到冷，感到轻重。他还懂得恨和爰、骄傲和绝望。感受是无法以公式计算的，情绪也没有换算因数罗杰·泽拉兹尼
你的时间有限，不要浪费时间过别人的生活史蒂夫·乔布斯
去读书，去学习，去受教育，记住掌握知识不是目的而是手段，最重要的是我们可以拥有选择的机会《我的天才女友》
一个人之所以有意思，是因为他大量阅读，习惯思考，放缓脚步，投入深度对话，并为自己创建了一个丰满的内心世界威廉 · 德雷谢维奇
没有一劳永逸，永远要重新开始，重新进入动荡，重新寻找，重新赢得欢喜是枝裕和《步履不停》
我也不想要这么念旧，念旧的人很寂寞，风吹心动，就期待是你回来过。没有人愿意沉湎于回忆，只不过美好的都属于过去。星星发亮是为了让每一个人有一天都能找到属于自己的星星《小王子》
在人生或者职业的各种事务中，性格的作用比智力大得多，头脑的作用不如心情，天资不如由判断力所节制着的自制，耐心和规律海明威《真实的高贵》
其实所有纠结做选择的人心里早就有了答案，咨询只是想得到内心所倾向的选择。最终的所谓命运，还是自己一步步走出来的东野奎吾《解忧杂货店》
一个人的兴趣越广泛，他拥有的快乐机会就越多，而受命运拨弄的可能性也就越小，因为即使失去了某一种兴趣，他仍然可以转向另一种《幸福之路》罗素
你能在浪费时间中获得乐趣，就不是浪费时间伯特兰.罗素
我期许自己要活得更真实也更诚实，要更接受甚至喜欢自己身上起伏的每部分，才能更喜欢这世界蔡崇达《皮囊》
吹毛求疵的人即便在天堂也能挑出瑕疵。一个安心的人在哪都可以过自得其乐的生活《瓦尔登湖》梭罗
现在不是去想缺少什么的时候，该想一想凭现有的东西你能做什么海明威《老人与海》
过去不是有形的东西，也不必依靠有形的物体来缅怀提醒。过去是造成今日我们本身的必须过程，它存在我们生命中，是遗失不了的三毛《谈心》
当暴风雨过去，你不会记得自己是如何度过，你甚至不确定暴风雨是否真正结束，但你不再是当初走进暴风雨里的那个人。这就是暴风雨的意义。村上春树
也许每个人心中都有一个风筝，无论它意味着什么，让我们勇敢地去追寻《追风筝的人》卡勒德·胡赛尼
年轻时并不知道自己想要过什么样的生活，但一直清楚地知道我不要过什么样的生活。那些能预知的，经过权衡算计的世俗生活对我毫无吸引力，我要的不是成功，而是看到生命的奇迹《像我这样笨拙地生活》廖一梅
我心中已经听到来自远方的呼唤，再不需要回过头去关心身后的种种是非与议论米兰·昆德拉
人们总是用一生来等待开始新的生活，这是很常见的现象。等待是思维的一个状态，意味着你需要未来，而你不要现在。你不要此时此刻，你把希望寄托于未来。丧失对当下时刻的意识，会大大地降低你的生命质量《当下的力量》埃克哈特·托利
在一个崇高的目标支持下，不停地工作，即使慢，也一定会获得成功爱因斯坦