用 Hexo + Stellar 搭一个 GEO 友好的技术博客

直接回答：本站用 Hexo 8 + Stellar 主题搭建，GEO 相关的关键改动只有三处——用英文固定链接保证 URL 可引用、用生成脚本自动产出 llms.txt 与结构化数据、用清晰的分类和专栏构建主题聚类。主题本身不需要改源码。

为什么是 Hexo + Stellar

选型理由其实很简单：

我不需要 CMS，也不需要在线编辑。写作流程应该只有一件事：新建一个 Markdown 文件，写完推送。

目录结构

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

blog/
├── _config.yml              站点配置（网址、链接格式、插件）
├── _config.stellar.yml      主题配置（布局、颜色、评论、注入）
├── scripts/
│   └── geo.js               GEO 生成器：robots.txt / llms.txt / 结构化数据
├── source/
│   ├── _posts/              文章
│   ├── _data/
│   │   ├── authors.yml      作者档案
│   │   ├── widgets.yml      自定义侧栏组件
│   │   └── topic/           专栏定义
│   ├── about/index.md       关于页
│   ├── message/index.md     留言板
│   └── images/              图片资源
└── tools/                   部署与辅助脚本

把内容、配置、脚本分开放，是长期维护的前提。 主题升级时只需要替换 node_modules 里的包，自己的内容一点不受影响。

三处对 GEO 真正有影响的设置

一、固定链接改成英文路径

1
2
3
4
5

# _config.yml
permalink: posts/:title/
pretty_urls:
  trailing_index: false
  trailing_html: false

文章文件名用英文，标题仍写中文：

1

source/_posts/what-is-geo.md   → https://devnotes.cuiyuehui.cn/posts/what-is-geo/

这样做的好处：

• URL 里没有中文编码，复制、分享、被引用时不会出错。
• 去掉 index.html 和 .html 后缀，链接更短。
• 路径稳定，已发布的 URL 不再改动，避免丢失已有的引用积累。

二、用脚本自动生成 llms.txt

手工维护 llms.txt 一定会忘记更新。本站的做法是在 scripts/geo.js 里注册一个生成器：

1
2
3
4
5

hexo.extend.generator.register("geo_llms_txt", function (locals) {
  const posts = locals.posts.sort("-date").toArray();
  // ... 组装标题、简介、分组链接
  return { path: "llms.txt", data: lines.join("\n") };
});

每次构建都会重新生成，同时输出完整正文版的 llms-full.txt。效果可以直接查看 llms.txt。

三、结构化数据自动注入

主题已经输出了 BlogPosting。我在 scripts/geo.js 里补了两类：

• BreadcrumbList：让机器知道这篇文章属于哪个分类。
• FAQPage：文章的问答对直接写在前面的 front matter 里。

1
2
3

faq:
  - q: 为什么用静态博客而不是 WordPress？
    a: 静态博客输出纯 HTML，不依赖后端渲染，抓取时不会出现空壳页面。

站点结构：为 GEO 设计的信息架构

内容组织方式对 GEO 的影响经常被忽略。本站的结构是：

1
2
3
4
5
6
7
8
9
10

/                       首页（文章列表）
/categories/            分类
/tags/                  标签
/topic/                 专栏索引
/topic/geo/             GEO 方法论专栏
/topic/geo-platform/    GEO 平台搭建专栏
/about/                 关于作者
/message/               留言板
/llms.txt               给模型的站点导览
/sitemap.xml            站点地图

三个设计考量：

1. 专栏承担主题聚类。 同类文章聚在一个专栏下，比散落在时间线里更容易被识别为完整主题。
2. 作者页负责说清楚"这是谁写的"。 读者看完一篇有用的文章，通常会想确认作者靠不靠谱，作者页要能正面回答这件事。
3. 留言板是唯一的交流入口。 不加复杂的表单，减少放弃率。

内容写作规范（本站自用）

写每篇文章时遵守这几条，已经固化成模板：

常见问题（FAQ）

为什么用静态博客而不是 WordPress？

静态博客的输出就是纯 HTML，不依赖后端渲染和数据库，抓取时不会出现空壳页面，正好满足 GEO 的第一层要求。同时部署简单、成本低、几乎没有被打穿的风险，对个人技术博客足够。

Stellar 主题需要改很多代码吗？

基本不需要。它提供了完整的配置项，布局、颜色、侧栏组件都可以用 YAML 配置完成。本站只额外写了一个构建脚本用来生成 llms.txt 和注入结构化数据，没有修改主题源码，这样主题升级时不会有冲突。

文章链接该用什么形式？

用英文文件名的固定链接，例如 /posts/what-is-geo/。中文标题不变但路径保持 ASCII，既避免编码问题，也让链接更短、更容易被引用。已发布文章的路径不要改动。

下一篇

站点生成好之后，就该放到服务器上了：《把 Hexo 博客部署到阿里云 ECS：Nginx + HTTPS 完整流程》。