拓展 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！🔥🚀