拓展 Coco AI 功能 - 智能检索 Hexo 博客

在之前的文章中，我们成功让 Coco AI 检索 Hugo 博客，这对于博客作者来说是一大福音。然而，从 Hexo 迁移到 Hugo 的成本不容小觑，毕竟大多数开发者对 Node.js 更熟悉，而 Golang 相对陌生。那么，既然 Coco AI 官方尚未支持 Hexo，是否有办法让它兼容 Hexo 呢？

当然可以！💡 既然 Coco AI 依赖的是 Hugo 生成的 index.json 进行检索，那我们干脆在 Hexo 中实现 相同结构的 index.json，这样就可以直接复用 Hugo 的数据结构，避免字段不兼容导致的潜在 Bug。

接下来，我们将从 0 到 1 实现 Hexo 的智能检索功能！ 🚀

---

📌 1. 安装 Hexo 并切换到 Next 主题

首先，我们需要安装 Hexo 并设置 Next 主题。

安装 Hexo

pnpm install -g hexo-cli
hexo init my-blog
cd my-blog
pnpm install

启动本地服务器：

pnpm hexo s

访问 http://localhost:4000/，确保 Hexo 站点运行正常。

---

安装 Next 主题

pnpm add hexo-theme-next

修改 _config.yml：

theme: next

然后运行：

pnpm hexo clean && pnpm hexo s

访问 http://localhost:4000/，确认 Next 主题已生效。

---

📌 2. 安装 hexo-generator-json-content

我们需要安装 JSON 生成插件，用于输出博客文章数据：

pnpm add hexo-generator-json-content

这些添加到 _config.yml，确保 Hexo 生成完整的 JSON 数据：

jsonContent:meta: falsepages: falseposts:title: truedate: truepath: falsepermalink: trueexcerpt: truecontent: truecategories: truetags: true

运行：

pnpm hexo clean && pnpm hexo generate

然后检查 public/index.json：

cat public/index.json

此时 JSON 已经生成，但 url 不是 Hugo 风格的，我们需要进一步优化。

---

**📌 3. 自定义 index.json **

默认情况下，Hexo 不会生成 /YYYY/MM/DD/slug/ 格式的 URL，因此我们需要手动调整。

📌 创建 scripts/generate_index_json.js

在 Hexo 站点目录 下，创建 scripts/generate_index_json.js：

hexo.extend.generator.register("index_json", function (locals) {let posts = locals.posts.sort("-date").map(post => {let category = post.categories && post.categories.length > 0 ? post.categories.data[0].name : null;let subcategory = post.categories && post.categories.length > 1 ? post.categories.data[1].name : null;let tags = post.tags ? post.tags.map(tag => tag.name) : null;// 解析发布日期let date = post.date;let formattedDate = `${date.year()}/${String(date.month() + 1).padStart(2, "0")}/${String(date.date()).padStart(2, "0")}`;// 生成 Hugo 风格 URL: `/YYYY/MM/DD/slug/`let postUrl = `/${formattedDate}/${post.slug || post.title.replace(/\s+/g, "-").toLowerCase()}/`;return {category: category,subcategory: subcategory,content: post.content.replace(/(<([^>]+)>)/gi, ""), // 去除 HTML 标签created: post.date.toISOString(),updated: post.updated ? post.updated.toISOString() : post.date.toISOString(),lang: "en", // 你可以修改为动态语言检测summary: post.excerpt || post.content.substring(0, 150) + "...",tags: tags,title: post.title,url: postUrl // 确保符合 Hugo 格式};});return {path: "index.json",data: JSON.stringify(posts, null, 2)};
});

---

📌 4. 重新生成 index.json

运行：

pnpm hexo clean && pnpm hexo generate

然后检查 public/index.json：

cat public/index.json

你应该会看到 JSON 变成：

[{"category": "Technology","subcategory": "Web Development","content": "This is a test post.","created": "2025-03-20T12:00:00+08:00","updated": "2025-03-20T12:00:00+08:00","lang": "en","summary": "This is a test post.","tags": ["Hexo", "Static Site"],"title": "Hello World","url": "/2025/03/20/hello-world/"}
]

✅ 成功让 URL 变成 /YYYY/MM/DD/slug/ 格式！

---

📌 5. 让 Coco AI 识别 Hexo 博客

既然 index.json 已经生成，我们可以像 Hugo 那样，在 Coco AI 里添加 Hexo 博客的检索。

在 Coco AI 里，点击 添加 Hugo Site，然后输入：

http://host.docker.internal:4000/index.json

如果想测试数据同步，我们可以修改同步时间为 1 秒，以便实时观察更新情况。

---

📌 6. 观察数据同步情况

过了一会，我们可以在 Coco AI 界面看到博客数据已经同步，但前提是需要先添加模型！ ✅

Coco AI 的 KNN（近邻搜索） 会按照相关性对内容进行智能排序，使检索更高效！

---

🎯 总结

步骤	命令
安装 Hexo 并切换到 Next 主题	pnpm install -g hexo-cli && hexo init my-blog
安装 hexo-generator-json-content	pnpm add hexo-generator-json-content
修改 _config.yml	让 Hexo 生成 index.json
创建 scripts/generate_index_json.js	确保 URL 变成 Hugo 风格
生成 JSON	pnpm hexo clean && pnpm hexo generate
在 Coco AI 里添加 Hexo 站点	输入 http://host.docker.internal:4000/index.json

---

🚀 结论

🎉 通过本教程，你已经成功：

✅ 让 Coco AI 兼容 Hexo 博客，实现智能检索
✅ 复用 Hugo 的 index.json 结构，避免迁移成本
✅ 让 URL 变成 /YYYY/MM/DD/slug/ 以适配 Hugo Connector
✅ 在 Coco AI 里成功同步 Hexo 博客数据，并进行智能查询

💡 现在，你可以愉快地使用 Hexo + Coco AI 进行智能检索了！如果有 更多定制需求（如 author、word count），可以继续优化 generate_index_json.js！🔥🚀