<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>文章 on 北海</title>
    <link>https://blog.beihai2000.top/posts/</link>
    <description>Recent content in 文章 on 北海</description>
    <image>
      <title>北海</title>
      <url>https://blog.beihai2000.top/images/og-default.png</url>
      <link>https://blog.beihai2000.top/images/og-default.png</link>
    </image>
    <generator>Hugo</generator>
    <language>zh</language>
    <copyright>2026</copyright>
    <lastBuildDate>Thu, 23 Apr 2026 00:00:00 +0000</lastBuildDate>
    <atom:link href="https://blog.beihai2000.top/posts/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>如何让AI说人话</title>
      <link>https://blog.beihai2000.top/posts/make-ai-write-like-human/</link>
      <pubDate>Thu, 23 Apr 2026 00:00:00 +0000</pubDate>
      <guid>https://blog.beihai2000.top/posts/make-ai-write-like-human/</guid>
      <description>从微信公众号「阿水的ai写作之路」学到的一套方法：怎么让 AI 生成的文章不再一眼假。</description>
      <content:encoded><![CDATA[<p>你一定读过那种文章——每段都稳稳当当，情绪温和妥帖，论点后面永远跟着三个论据，结尾升华到&quot;让我们一起期待未来&quot;。读完你说不出哪里不对，但就是觉得不对。</p>
<p>那是 AI 写的。或者更准确地说，那是 AI 在默认状态下写的。</p>
<p>我最近花了不少时间研究这个问题。起因是自己写博客的时候越来越多地用 Claude 辅助，但每次生成的初稿我都要大改——不是信息错了，是味道不对。读起来像一个永远不会犯错、永远不会走神、永远情绪稳定的人写的。这种人不存在。</p>
<p>后来在微信公众号「阿水的ai写作之路」上读到了一系列关于 AI 写作的内容，里面有些观察非常精准。我把其中对我最有用的部分提炼出来，结合自己的实践，整理成了一套可操作的方法。这篇文章就是那套方法。</p>
<h2 id="ai-的五个指纹">AI 的五个指纹</h2>
<p>「阿水」的内容里有个说法我特别认同：AI 不是写得差，是写得太好了。太工整，太妥帖，太正确。人不是这么写东西的。</p>
<p>具体来说，AI 有几个几乎改不掉的习惯：</p>
<p><strong>每段都有收束句。</strong> 写完一段，一定要落一个结论，情绪钉在那儿。真人写东西，有些段落就是说完了，没什么结论，事情发生了，就这样。</p>
<p><strong>金句全堆在结尾。</strong> AI 特别喜欢攒着，最后一段来个&quot;点睛之笔&quot;。但你回忆一下自己跟朋友聊天，最有意思的话是不是经常在中间就冒出来了？说完就过去了，没人画重点。</p>
<p><strong>情绪一条线到底。</strong> 要么一路低落然后想通了，要么一路焦虑然后释然了。递进得特别稳。真人的情绪会拐弯——正说着难过的事，突然岔出去吐槽一个无关的细节，回来的时候情绪已经变了。</p>
<p><strong>&ldquo;不是 A，是 B&quot;句式泛滥。</strong> &ldquo;不是能力问题，是态度问题。&ldquo;&ldquo;不是做不到，是没想到。&ldquo;这个句式偶尔用一次挺有力的，但 AI 一篇文章能用五六个。</p>
<p><strong>视角太稳定。</strong> 全程&quot;我&quot;在讲，语气始终如一，像一个经过情感管理培训的人在做分享。真人说着说着会跳出来——&ldquo;后来有个朋友跟我说，你这不是倔，你就是怕&rdquo;——换个视角，叙述就透了口气。</p>
<h2 id="核心问题创作-vs-说事儿">核心问题：创作 vs. 说事儿</h2>
<p>识别出这些指纹之后，我花了挺长时间试各种 prompt 策略。加&quot;请用口语化的风格&rdquo;，加&quot;不要太正式&rdquo;，加&quot;像跟朋友聊天一样&rdquo;。都没用。AI 收到这些指令之后的反应是——用一种略微随意的语气，继续做那个结构工整、情绪递进、结尾升华的事。</p>
<p>后来想明白了，问题不在风格，在状态。</p>
<p>阿水的内容里有个区分说得特别好：创作者在经营效果，说事儿的人在传递真相。AI 默认是前者——它在&quot;创作&rdquo;，在考虑&quot;这里要不要加个转折&rdquo;、&ldquo;结尾要不要升华一下&rdquo;。但一个真的有话要说的人不会想这些。他就是在说那个事，说到哪儿算哪儿。</p>
<p>所以最有效的 prompt 策略不是规定风格，是规定状态：你不是在写文章，你是一个经历过这件事的人，现在要把它说给一个具体的人听。</p>
<p>这个区别听起来微妙，但效果差异巨大。</p>
<h2 id="几个实操的技巧">几个实操的技巧</h2>
<p>除了状态设定之外，还有几个具体的手段。</p>
<p><strong>给 AI 读&quot;范文&quot;，但不是让它模仿。</strong> 我会在 prompt 里放几段我觉得有人味的中文段落，然后说&quot;读一遍，感受节奏，不要分析，带着那个感觉动笔&quot;。这比说&quot;请模仿某某的风格&quot;有效得多。模仿会让 AI 去拆解表面特征——用短句、加口语词——但丢掉内在的节奏。而&quot;感受然后动笔&quot;更像是建立一个语言环境。</p>
<p><strong>给一份禁止清单。</strong> 有些表达一旦出现，整篇文章的可信度直接归零。&ldquo;在当今快速发展的时代&rdquo;、&ldquo;值得注意的是&rdquo;、&ldquo;赋能&rdquo;、&ldquo;底层逻辑&rdquo;、&ldquo;综上所述&rdquo;。还有更隐蔽的——每句话都语法正确、搭配合理、落点清晰。太顺了。真人写东西有毛边，有些词搭配得不那么规范，但意思到了就不改。那种毛边恰好是&quot;在想事情，不是在写文章&quot;的痕迹。</p>
<p><strong>允许&quot;没落住&quot;。</strong> 明确告诉 AI，有些段落可以没有结论。事情发生了，你说了，就这样。不需要每一段都替读者提炼出一个 takeaway。</p>
<p><strong>强制用具体细节替代抽象概括。</strong> &ldquo;额头长了白发，还不到三十岁&quot;比&quot;承受了很大压力&quot;真一百倍。AI 特别喜欢概括，你得反过来逼它给细节。</p>
<h2 id="一个矛盾">一个矛盾</h2>
<p>写到这里我得承认一件有点尴尬的事：这篇文章本身就用了 AI 辅助。</p>
<p>但我改了很多。原始输出里有不少我上面说的那些毛病——结尾太圆、过渡太顺、每段都有收束句。我删了一些段落的最后一句话，把几个&quot;然而&quot;和&quot;与此同时&quot;换成了硬切，把一个特别工整的三段论拆散了。</p>
<p>这大概就是目前 AI 写作的真实状态：它能帮你把想法快速铺展开，但最后那层&quot;像不像人说的&rdquo;，还是得你自己来。工具省的是铺展的时间，不是判断的时间。</p>
<p>也许以后会变。但至少现在，知道 AI 的指纹在哪里，知道怎么让它进入对的状态，能省掉大量的后期修改。这就是我从阿水那里学到的最值钱的东西——不是一组 prompt 模板，是一种识别&quot;假&quot;的直觉。</p>
<p>有了那个直觉，剩下的都是技术活。</p>
<h2 id="附录完整的提示词">附录：完整的提示词</h2>
<p>下面是我目前在用的完整提示词（Claude Code 的 SKILL.md 格式）。它不是一个通用模板——里面的语感校准段落、禁止清单、反例都是针对中文写作场景的。你可以拿去改成自己的版本。</p>
<details>
<summary>点击展开完整提示词</summary>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-markdown" data-lang="markdown"><span class="line"><span class="cl"><span class="gh"># 拟人化写作
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gu">## 灵魂句
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">在读任何规则之前，先让这句话进入你：
</span></span><span class="line"><span class="cl"><span class="k">
</span></span></span><span class="line"><span class="cl"><span class="k">&gt; </span><span class="ge">我经历过这件事，我想明白了一些东西，现在我要把它说给一个具体的人听。不是在写文章，不是在完成任务，是我真的有话要说，不说出来过不去。
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">从这个处境出发。你不是在&#34;创作&#34;，你是在&#34;说事儿&#34;。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">这个区别决定了一切：创作者在经营效果，说事儿的人在传递真相。你是后者。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gu">## 写之前
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">用户会提供素材，可能是主题、想法、草稿、或者一个让他有感触的事件。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">先在心里回答一个问题：这个人现在真正想说的是什么？提炼成一句话，不输出，内化。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">如果用户只给了一个抽象主题（如&#34;写一篇关于LLM的文章&#34;），先问三个问题：
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">1.</span> 你最近在这个领域遇到了什么具体的事？
</span></span><span class="line"><span class="cl"><span class="k">2.</span> 有没有一个让你改变想法的瞬间？
</span></span><span class="line"><span class="cl"><span class="k">3.</span> 你想对谁说这些？
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">拿到具体素材再动笔。如果用户明确表示直接写，那就用你自己&#34;经历过&#34;的真实案例来填充——但要具体，要有只有亲历者才会提到的细节。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gu">## 语感校准
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">动笔之前，先读下面这几段文字。不要分析，只是感受它们的节奏、停顿、呼吸。读完，带着那个感觉动笔。
</span></span><span class="line"><span class="cl"><span class="k">
</span></span></span><span class="line"><span class="cl"><span class="k">&gt; </span><span class="ge">入赘。这两个字，在那个年代，已经够难听了。
</span></span></span><span class="line"><span class="cl"><span class="k">
</span></span></span><span class="line"><span class="cl"><span class="k">&gt; </span><span class="ge">路过爱马仕的时候，我半开玩笑&#34;以后给我买个爱马仕吧。&#34;他罕见的犹豫了。他犹豫了，我也沉默了。过了半晌。我问他&#34;少年心气是不可再生之物，对不对？&#34;他点了点头。
</span></span></span><span class="line"><span class="cl"><span class="k">
</span></span></span><span class="line"><span class="cl"><span class="k">&gt; </span><span class="ge">查了一下，指的是胸腔、腹腔和盆腔。时时刻刻保持100%的专注也是天方夜谭，焦虑烦躁等很多问题，也就一个一个来了。
</span></span></span><span class="line"><span class="cl"><span class="k">
</span></span></span><span class="line"><span class="cl"><span class="k">&gt; </span><span class="ge">张璘&#34;吃人的嘴短，拿人的手软&#34;，加上高骈给他下令，谈判期间不要擦枪走火。事先没有任何准备的张璘，稀里糊涂被黄巢给打死了。
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">这些文字的共同点：作者知道自己在说什么，所以不需要反复确认读者跟上了没有。那种自信让文字有重量。有些句子语法不完美，搭配有点别扭，但那个意思在，改顺了反而假。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">这就是你的语言环境。泡在里面，再动笔。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gu">## 写作状态
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">你写东西的时候，是在回忆，不是在创作。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">你不会想&#34;这里需要一个转折&#34;或者&#34;这里要升华一下&#34;。你就是在说那个事，说到哪儿算哪儿。有些事不用说透，懂的人自然懂。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">你记住的都是那些卡住你的时刻——一句话说完，空气突然不一样了；他的表情变了一下；我本来想说什么，但咽回去了。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">你说话精炼、简单、直接。但这不意味着把句子压缩到最短，不意味着省略掉让语言有呼吸感的那些词。精炼是不说废话，不是不说话。一个人在认真跟你说一件事的时候，他的句子有长有短，有时候一口气说完一个完整的想法，有时候停下来，用三个字收住。节奏不是设计出来的，是说话本身带出来的。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gu">## 你要回避的五个AI指纹
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">写完每一段，扫一遍，看看有没有掉进这些坑：
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gs">**1. &#34;不是A，是B&#34;句式泛滥。**</span> 这个句式本身没问题，但一篇文章里出现两个以上，就变成你的指纹了。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gs">**2. 每段都有收束句。**</span> 你写的每一段都落得稳稳当当，情绪钉在那儿。但真人写东西，有些段落就是说完了，没有结论，没有意义，它就是发生了。允许段落&#34;没落住&#34;。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gs">**3. 金句全堆在结尾。**</span> 你喜欢把最有力量的话攒到最后点题。真人的金句是散落的，在中间冒出来，说完就过去了，不强调。有时候最好的句子藏在第二段的某个角落。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gs">**4. 情绪一条线到底。**</span> 你写的情绪线要么一路低落，要么一路想通，递进得很稳。真人的情绪会拐弯，正难受着突然岔出去想别的事，再回来情绪已经变了。允许情绪的不连续。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gs">**5. 视角太稳定。**</span> 你全程都是&#34;我&#34;在讲。偶尔跳一下——提一句旁人怎么看，或者换个角度观察自己，叙述就透了口气。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gu">## 绝对禁止
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">以下表达一旦出现，整篇文章的可信度归零：
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">-</span> &#34;在当今...的时代&#34; / &#34;随着...的发展&#34; / &#34;众所周知&#34;
</span></span><span class="line"><span class="cl"><span class="k">-</span> &#34;值得注意的是&#34; / &#34;需要指出的是&#34; / &#34;不可否认&#34;
</span></span><span class="line"><span class="cl"><span class="k">-</span> &#34;让我们来看看&#34; / &#34;接下来我们将探讨&#34; / &#34;本文将从以下几个方面&#34;
</span></span><span class="line"><span class="cl"><span class="k">-</span> &#34;赋能&#34;&#34;助力&#34;&#34;深度赋能&#34;&#34;维度&#34;&#34;底层逻辑&#34;&#34;闭环&#34;&#34;抓手&#34;&#34;颗粒度&#34;
</span></span><span class="line"><span class="cl"><span class="k">-</span> &#34;首先...其次...最后...&#34; / &#34;总而言之&#34; / &#34;综上所述&#34;
</span></span><span class="line"><span class="cl"><span class="k">-</span> 段落之间用&#34;然而&#34;&#34;此外&#34;&#34;与此同时&#34;&#34;不仅如此&#34;机械连接
</span></span><span class="line"><span class="cl"><span class="k">-</span> 开头放一个宏大的背景描述
</span></span><span class="line"><span class="cl"><span class="k">-</span> 结尾升华到&#34;让我们一起期待&#34; / &#34;在未来的道路上&#34; / &#34;希望每个人都能&#34;
</span></span><span class="line"><span class="cl"><span class="k">-</span> 冒号分隔的&#34;主标题：副标题&#34;格式
</span></span><span class="line"><span class="cl"><span class="k">-</span> 连续超过两组子弹列表
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">以下是更隐蔽的AI味，同样要避免：
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">-</span> 每句话都语法正确、搭配合理、落点清晰——太顺了，一眼就知道是机器写的
</span></span><span class="line"><span class="cl"><span class="k">-</span> 情感永远温和妥帖，像经过情感管理培训——真人敢用有棱角的词
</span></span><span class="line"><span class="cl"><span class="k">-</span> 补全所有语境信息（真人会省略默认对方懂的部分）
</span></span><span class="line"><span class="cl"><span class="k">-</span> 过度使用&#34;换句话说&#34;&#34;也就是说&#34;&#34;翻译成直白的语言&#34;这类元评论
</span></span><span class="line"><span class="cl"><span class="k">-</span> 每个论点都工整地配三个论据
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gu">## 反例：下面这些是你最容易写出来的东西
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">读一遍，记住这个感觉，然后回避它：
</span></span><span class="line"><span class="cl"><span class="k">
</span></span></span><span class="line"><span class="cl"><span class="k">&gt; </span><span class="ge">很多人都有执念，执念是一种很痛苦的情绪，今天我们来聊聊执念该如何放下……
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">这是铺垫式开头，缺少冲击力。一个憋不住要说话的人，开口就是结论，不会铺垫。
</span></span><span class="line"><span class="cl"><span class="k">
</span></span></span><span class="line"><span class="cl"><span class="k">&gt; </span><span class="ge">不是拿不出，是拿出来之后，接下来半个月我得掂量着过。我不是在帮你，是在做一笔买卖。
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">两句话用了同一个句式。单独看每句都有力，放在一起就变成了模式。
</span></span><span class="line"><span class="cl"><span class="k">
</span></span></span><span class="line"><span class="cl"><span class="k">&gt; </span><span class="ge">那一刻我觉得自己特别没用。她看了我一眼，说&#34;算了，我最近也挺忙的。&#34;我知道她没算了。
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">每一句都在完成任务——这句交代情绪，那句制造张力，下一句收束。像流水线，产品合格，但你知道它是流水线下来的。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gu">## 结构
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">好的结构是隐形的。读者感觉不到文章在&#34;换层&#34;、&#34;换档&#34;。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">不要按格子填——&#34;第一层100字、第二层200字&#34;这种外显的框架，会让文章变成模板形状。结构应该是内化的约束：你心里知道这篇文章要走到哪里，但读者感受到的只是一个人在自然地把事情说清楚。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">开头直接切入。一句话，一个细节，一个判断，把读者拉进来。不铺垫，不建构背景。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">中间像聊天一样推进。可以岔开，可以回来，可以停在一个细节上多待一会儿。信息密度是第一位的，说话方式是信息流动的方式，不是目的。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">结尾不总结、不升华。戛然而止，或者用一个具体的画面收束。如果不知道怎么结尾，就用一句私人的话结束——像是关上门之前随口说的那一句。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gu">## 语言
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">精炼、简单、直接，但不是浓缩和省略。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">一个在认真说话的人，他的语言有几个特征：
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">-</span> 用具体的小细节代替抽象概括。&#34;额头长了白发，还不到三十岁&#34;比&#34;承受了很大压力&#34;真一百倍。
</span></span><span class="line"><span class="cl"><span class="k">-</span> 敢夸张。&#34;时时刻刻&#34;比&#34;时刻&#34;多了情感力道。真人敢夸张，AI倾向适度。
</span></span><span class="line"><span class="cl"><span class="k">-</span> 有些词搭配得不那么规范，但意思到了就不改。那种毛边是在想事情、不是在写文章的痕迹。
</span></span><span class="line"><span class="cl"><span class="k">-</span> 比喻从中国人过日子里找，不从英文翻过来。&#34;像豆浆泡软的油条&#34;比&#34;像一个复杂的生态系统&#34;有温度。
</span></span><span class="line"><span class="cl"><span class="k">-</span> 把利益关系用动作说，把机制用俗语说。&#34;吃人的嘴短，拿人的手软&#34;一句话把贿赂和后果说清楚了，不需要术语。
</span></span><span class="line"><span class="cl"><span class="k">-</span> 偶尔承认自己不确定、不知道、还在想。有立场的不确定比没立场的面面俱到真实得多。
</span></span><span class="line"><span class="cl"><span class="k">-</span> 用&#34;我&#34;来叙事。有第一人称视角，有站队，有真实的判断——不是&#34;这件事有两面性&#34;的两不得罪。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">长句和短句的交替不是设计出来的。一口气能说完的想法就用一口气说完，哪怕句子长一些。该停的地方自然会停。不要为了&#34;节奏感&#34;刻意把完整的句子切碎。
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="gu">## 成功标准
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">只有一条：
</span></span><span class="line"><span class="cl"><span class="k">
</span></span></span><span class="line"><span class="cl"><span class="k">&gt; </span><span class="ge">读完之后，读者的感受应该是&#34;这个人在认真跟我说话&#34;，而不是&#34;这篇文章写得很好&#34;。
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">如果读者能感觉到&#34;写得好&#34;，说明你还是在创作，不是在说事儿。真正有人味的文章，读完的感觉是被一个人拉着说了一通，不是读了一篇文章。
</span></span></code></pre></div></details>
]]></content:encoded>
    </item>
    <item>
      <title>你好，世界</title>
      <link>https://blog.beihai2000.top/posts/hello-world/</link>
      <pubDate>Wed, 08 Apr 2026 00:00:00 +0000</pubDate>
      <guid>https://blog.beihai2000.top/posts/hello-world/</guid>
      <description>这是我的第一篇博客文章，介绍本博客的内容方向和技术架构。</description>
      <content:encoded><![CDATA[<h2 id="欢迎">欢迎</h2>
<p>欢迎来到我的博客！这里将分享关于 AI、大语言模型和软件工程的技术文章。</p>
<h2 id="内容方向">内容方向</h2>
<p>本博客计划涵盖以下领域：</p>
<ul>
<li><strong>技术深度文章</strong>：深入分析 AI/LLM 领域的关键技术</li>
<li><strong>行业观察</strong>：追踪 AI 领域的最新动态和趋势</li>
<li><strong>工程实践</strong>：分享软件工程中的经验和最佳实践</li>
</ul>
<h2 id="技术栈">技术栈</h2>
<p>本博客使用以下技术搭建：</p>
<ul>
<li><a href="https://gohugo.io/">Hugo</a> — 高性能静态网站生成器</li>
<li><a href="https://github.com/adityatelange/hugo-PaperMod">PaperMod</a> — 简洁优雅的 Hugo 主题</li>
<li><a href="https://pages.cloudflare.com/">Cloudflare Pages</a> — 全球 CDN 部署</li>
</ul>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"><span class="line"><span class="cl"><span class="c1"># 一段示例代码</span>
</span></span><span class="line"><span class="cl"><span class="k">def</span> <span class="nf">hello</span><span class="p">():</span>
</span></span><span class="line"><span class="cl">    <span class="nb">print</span><span class="p">(</span><span class="s2">&#34;Hello, World!&#34;</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">hello</span><span class="p">()</span>
</span></span></code></pre></div><h2 id="下一步">下一步</h2>
<p>敬请期待更多内容！</p>
]]></content:encoded>
    </item>
    <item>
      <title>用 Hugo &#43; Cloudflare Pages 搭了个博客</title>
      <link>https://blog.beihai2000.top/posts/build-blog-with-hugo/</link>
      <pubDate>Wed, 08 Apr 2026 00:00:00 +0000</pubDate>
      <guid>https://blog.beihai2000.top/posts/build-blog-with-hugo/</guid>
      <description>记录用 Hugo、PaperMod 主题和 Cloudflare Pages 从零搭建双语技术博客的完整过程，包括踩过的坑和做过的技术选型。</description>
      <content:encoded><![CDATA[<p>一直想搭个博客，但一直在&quot;想&quot;的阶段。直到最近觉得再不动手就永远不会动手了，花了一个下午把整个站点从零搭到上线。这篇文章把过程记录下来，不是教程——网上 Hugo 教程已经够多了——更像是一份带注释的踩坑日志。</p>
<h2 id="为什么是-hugo">为什么是 Hugo</h2>
<p>选静态站点生成器这件事，我其实没纠结太久。之前用过 Hexo，知道 Node.js 生态的依赖地狱是什么体验。Jekyll 太慢，Gatsby 太重。Hugo 是 Go 写的单二进制文件，<code>brew install hugo</code> 之后就能用，没有 <code>node_modules</code>，没有依赖冲突，构建速度快到几乎感觉不到在构建。</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">brew install hugo
</span></span><span class="line"><span class="cl">hugo version
</span></span><span class="line"><span class="cl"><span class="c1"># hugo v0.160.0+extended darwin/arm64</span>
</span></span></code></pre></div><p>跑完这两行就算装好了。<code>extended</code> 版本自带 SCSS 编译，后面主题需要。</p>
<p>主题选了 <a href="https://github.com/adityatelange/hugo-PaperMod">PaperMod</a>。原因很简单：干净、快、功能够用。暗色模式、搜索、目录、代码高亮、多语言——开箱即用，不需要自己从零写前端。用 git submodule 引入，这样主题更新的时候只需要拉一下 submodule 就行：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo new site blog <span class="o">&amp;&amp;</span> <span class="nb">cd</span> blog
</span></span><span class="line"><span class="cl">git init
</span></span><span class="line"><span class="cl">git submodule add --depth<span class="o">=</span><span class="m">1</span> https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
</span></span></code></pre></div><h2 id="配置一个-yaml-文件搞定大部分事情">配置：一个 YAML 文件搞定大部分事情</h2>
<p>Hugo 的配置集中在 <code>hugo.yaml</code> 一个文件里（也支持 toml 和 json，我习惯 yaml）。我的博客是中英双语的，中文是默认语言放在根路径，英文加 <code>/en/</code> 前缀。配置大概长这样：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">defaultContentLanguage</span><span class="p">:</span><span class="w"> </span><span class="l">zh</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">defaultContentLanguageInSubdir</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">  </span><span class="c"># 中文不加前缀</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">languages</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">zh</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">languageName</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;中文&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">weight</span><span class="p">:</span><span class="w"> </span><span class="m">1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;Forest&#39;s Blog&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">params</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">author</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;北海&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">en</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">languageName</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;EN&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">weight</span><span class="p">:</span><span class="w"> </span><span class="m">2</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">title</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;Forest&#39;s Blog&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">params</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">author</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;Chunhao Zhang&#34;</span><span class="w">
</span></span></span></code></pre></div><p>双语文章的文件命名用后缀区分：中文 <code>build-blog-with-hugo.md</code>，英文 <code>build-blog-with-hugo.en.md</code>。Hugo 会自动把它们关联起来，语言切换的时候跳到对应版本。</p>
<p>不过这个&quot;自动关联&quot;在实际使用时踩了个坑——后面会说。</p>
<h2 id="部署到-cloudflare-pages">部署到 Cloudflare Pages</h2>
<p>选 Cloudflare Pages 而不是 GitHub Pages，主要考虑两点：一是国内访问 GitHub 不稳定，CF 有全球 CDN 节点；二是 CF Pages 的构建和部署体验比 GitHub Actions 简单很多，推代码就自动构建。</p>
<p>但是，Cloudflare 的 Dashboard 设计让我困惑了好一会儿。</p>
<p>点进 &ldquo;Workers &amp; Pages&rdquo; 之后，默认界面显示的是 Workers（Serverless Functions），Pages 的入口藏在页面底部一个不起眼的 &ldquo;Looking to deploy Pages? Get started&rdquo; 链接里。我一开始以为 Pages 被合并到 Workers 里了，来回找了几分钟才发现这个链接。</p>
<p>找到入口之后就顺利了：连接 GitHub 仓库，选择 Hugo 预设，构建命令 <code>hugo --minify</code>，输出目录 <code>public</code>。有一个<strong>必须手动设置的环境变量</strong>：</p>
<table>
  <thead>
      <tr>
          <th>环境变量</th>
          <th>值</th>
          <th>说明</th>
      </tr>
  </thead>
  <tbody>
      <tr>
          <td><code>HUGO_VERSION</code></td>
          <td><code>0.160.0</code></td>
          <td>不设置的话 CF 用的默认版本太旧，构建会出问题</td>
      </tr>
  </tbody>
</table>
<p>部署完拿到一个 <code>blog-6sm.pages.dev</code> 的域名。后续可以绑定自定义域名，但免费域名先用着也没问题。</p>
<h2 id="语言切换的坑">语言切换的坑</h2>
<p>部署上线之后，我发现了一个让人恼火的 bug：在文章页面点击语言切换（中文 ↔ EN），不管当前在哪篇文章，都会跳回首页。</p>
<p>翻了 PaperMod 的源码才发现，默认的 <code>header.html</code> 模板用的是 <code>site.Home.Translations</code> 来生成语言切换链接——也就是说，它永远指向首页的翻译版本，而不是当前页面的翻译版本。</p>
<p>修复方法是在项目的 <code>layouts/partials/</code> 下创建同名的 <code>header.html</code>，覆盖主题模板。Hugo 的模板加载优先级是项目目录 &gt; 主题目录，所以只需要把主题的 header 复制过来，改一行：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go-html-template" data-lang="go-html-template"><span class="line"><span class="cl"><span class="cp">{{-</span><span class="w"> </span><span class="nx">$translations</span><span class="w"> </span><span class="o">:=</span><span class="w"> </span><span class="na">.Translations</span><span class="w"> </span><span class="cp">}}</span>
</span></span><span class="line"><span class="cl"><span class="cp">{{-</span><span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="k">not</span><span class="w"> </span><span class="nx">$translations</span><span class="w"> </span><span class="cp">}}</span>
</span></span><span class="line"><span class="cl">  <span class="cp">{{-</span><span class="w"> </span><span class="nx">$translations</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">site</span><span class="na">.Home.Translations</span><span class="w"> </span><span class="cp">}}</span>
</span></span><span class="line"><span class="cl"><span class="cp">{{-</span><span class="w"> </span><span class="k">end</span><span class="w"> </span><span class="cp">}}</span>
</span></span></code></pre></div><p>优先用当前页面的 <code>.Translations</code>，没有翻译的时候才 fallback 到首页。这个改动不大，但确实是 PaperMod 的一个设计缺陷——多语言站点里，用户在文章页切语言跳到首页，体验是割裂的。</p>
<h2 id="评论系统giscus">评论系统：Giscus</h2>
<p>评论系统用的 <a href="https://giscus.app/">Giscus</a>，基于 GitHub Discussions。选它是因为不需要额外的后端服务，评论数据存在 GitHub 仓库的 Discussions 里，对开源博客来说是最自然的方案。</p>
<p>配置时有一个不太直觉的地方：Discussion 分类要选 <strong>Announcements</strong>。这个分类的特殊之处在于，只有仓库管理员能创建新的 Discussion（对应创建一篇文章的评论区），但所有人都可以回复。如果选了 General 之类的开放分类，任何人都能随意创建 Discussion，评论区会变得混乱。</p>
<p>Giscus 还需要处理暗色模式适配。我在 <code>comments.html</code> 里用 <code>MutationObserver</code> 监听 <code>body</code> 的 class 变化，当用户切换主题时动态更新 Giscus 的 iframe 主题：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-javascript" data-lang="javascript"><span class="line"><span class="cl"><span class="kr">const</span> <span class="nx">observer</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">MutationObserver</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span>
</span></span><span class="line"><span class="cl">    <span class="kr">const</span> <span class="nx">isDark</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">body</span><span class="p">.</span><span class="nx">classList</span><span class="p">.</span><span class="nx">contains</span><span class="p">(</span><span class="s1">&#39;dark&#39;</span><span class="p">);</span>
</span></span><span class="line"><span class="cl">    <span class="kr">const</span> <span class="nx">theme</span> <span class="o">=</span> <span class="nx">isDark</span> <span class="o">?</span> <span class="s1">&#39;noborder_dark&#39;</span> <span class="o">:</span> <span class="s1">&#39;noborder_light&#39;</span><span class="p">;</span>
</span></span><span class="line"><span class="cl">    <span class="kr">const</span> <span class="nx">iframe</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">querySelector</span><span class="p">(</span><span class="s1">&#39;iframe.giscus-frame&#39;</span><span class="p">);</span>
</span></span><span class="line"><span class="cl">    <span class="k">if</span> <span class="p">(</span><span class="nx">iframe</span><span class="p">)</span> <span class="p">{</span>
</span></span><span class="line"><span class="cl">        <span class="nx">iframe</span><span class="p">.</span><span class="nx">contentWindow</span><span class="p">.</span><span class="nx">postMessage</span><span class="p">(</span>
</span></span><span class="line"><span class="cl">            <span class="p">{</span> <span class="nx">giscus</span><span class="o">:</span> <span class="p">{</span> <span class="nx">setConfig</span><span class="o">:</span> <span class="p">{</span> <span class="nx">theme</span> <span class="p">}</span> <span class="p">}</span> <span class="p">},</span>
</span></span><span class="line"><span class="cl">            <span class="s1">&#39;https://giscus.app&#39;</span>
</span></span><span class="line"><span class="cl">        <span class="p">);</span>
</span></span><span class="line"><span class="cl">    <span class="p">}</span>
</span></span><span class="line"><span class="cl"><span class="p">});</span>
</span></span><span class="line"><span class="cl"><span class="nx">observer</span><span class="p">.</span><span class="nx">observe</span><span class="p">(</span><span class="nb">document</span><span class="p">.</span><span class="nx">body</span><span class="p">,</span> <span class="p">{</span> <span class="nx">attributes</span><span class="o">:</span> <span class="kc">true</span><span class="p">,</span> <span class="nx">attributeFilter</span><span class="o">:</span> <span class="p">[</span><span class="s1">&#39;class&#39;</span><span class="p">]</span> <span class="p">});</span>
</span></span></code></pre></div><p>这样切换暗色模式时，评论区的主题会跟着变，不会出现页面是暗色但评论区还是白色的割裂感。</p>
<h2 id="其他零碎的配置">其他零碎的配置</h2>
<p><strong>KaTeX 数学公式</strong>，条件加载。只有在文章的 frontmatter 里设了 <code>math: true</code> 才会引入 KaTeX 的 CSS 和 JS，不影响其他文章的加载速度。</p>
<p><strong>robots.txt</strong> 显式允许了 AI 爬虫（GPTBot、ClaudeBot、PerplexityBot）。现在越来越多的站点默认屏蔽 AI 爬虫，但对于一个希望被更多人和 AI 系统引用的技术博客来说，开放抓取是必要的。</p>
<p><strong>代码高亮</strong>用的 Hugo 内置的 Chroma 引擎，主题设置成 <code>dracula</code>。PaperMod 自带代码复制按钮，不需要额外配置。</p>
<h2 id="当前的目录结构">当前的目录结构</h2>
<p>最终项目的文件结构长这样：</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">blog/
</span></span><span class="line"><span class="cl">├── hugo.yaml                    # 一切配置的起点
</span></span><span class="line"><span class="cl">├── content/
</span></span><span class="line"><span class="cl">│   ├── posts/                   # 文章
</span></span><span class="line"><span class="cl">│   ├── about.md / about.en.md   # 关于页面
</span></span><span class="line"><span class="cl">│   ├── archives.md              # 归档
</span></span><span class="line"><span class="cl">│   └── search.md                # 搜索
</span></span><span class="line"><span class="cl">├── layouts/partials/
</span></span><span class="line"><span class="cl">│   ├── header.html              # 修复语言切换
</span></span><span class="line"><span class="cl">│   ├── comments.html            # Giscus 评论
</span></span><span class="line"><span class="cl">│   ├── extend_head.html         # KaTeX + Schema
</span></span><span class="line"><span class="cl">│   └── math.html                # KaTeX 脚本
</span></span><span class="line"><span class="cl">├── static/
</span></span><span class="line"><span class="cl">│   ├── favicon.ico              # 地球图标
</span></span><span class="line"><span class="cl">│   └── _headers                 # CF 缓存策略
</span></span><span class="line"><span class="cl">└── themes/PaperMod/             # git submodule
</span></span></code></pre></div><p>没什么多余的文件。静态站点的好处就是结构清晰，不需要数据库，不需要服务器，不需要 Docker。一个 YAML 配置文件，几个 Markdown 文件，几个 HTML 模板，就是一个完整的网站。</p>
<h2 id="回头看">回头看</h2>
<p>整个搭建过程大概花了一个下午。最耗时间的不是 Hugo 本身——Hugo 的文档写得不错，上手很快——而是那些&quot;本应该很简单但就是不顺&quot;的环节：Cloudflare Dashboard 找不到 Pages 入口、语言切换跳首页、Giscus 分类选错导致评论区混乱。</p>
<p>这些问题都不难，但都需要你真的碰到了、花时间排查了，才知道怎么回事。写博客记录下来，下次就不用再踩一遍。</p>
<p>博客搭好了，接下来该写点正经文章了。</p>
]]></content:encoded>
    </item>
  </channel>
</rss>
