信息技术 on OHTLY Blog

Hugo 博客配置 Mermaid 图表支持

Tue, 05 May 2026 16:30:00 +0800

Hugo 博客配置 Mermaid 图表支持链接到标题

本文说明基于 hugo-coder 主题的博客如何集成 Mermaid 图表。

前提条件链接到标题

使用支持 Mermaid shortcode 的 Hugo 主题（如 hugo-coder）
主题的 baseof.html 中包含以下逻辑：

{{ if .HasShortcode "mermaid" }}
<script src="https://cdn.jsdelivr.net/npm/mermaid@9.3.0/dist/mermaid.min.js"></script>
<script>mermaid.initialize({startOnLoad: true});</script>
{{ end }}

正确写法链接到标题

Mermaid 图表必须使用 Hugo Shortcode 语法，而非标准 Markdown 代码块：

类型	写法
✅ Shortcode	`{{< mermaid >}} ... {{< /mermaid >}}`
❌ Markdown 代码块	```mermaid ... ```

图表类型示例链接到标题

流程图链接到标题

flowchart TD A[开始] --> B{判断} B -->|条件A| C[处理A] B -->|条件B| D[处理B] C --> E[结束] D --> E

时序图链接到标题

sequenceDiagram participant 客户端 participant 服务器 participant 数据库客户端->>服务器: 请求服务器->>数据库: 查询数据库-->>服务器: 返回结果服务器-->>客户端: 响应

gantt title 项目计划 dateFormat YYYY-MM-DD section 设计设计方案 :done, d1, 2026-05-01, 3d 设计评审 :done, d2, after d1, 1d section 开发编码实现 :active, dev1, after d2, 5d 单元测试 :dev2, after dev1, 2d section 部署部署上线 :deploy, after dev2, 1d

注意事项链接到标题

必须使用 Hugo Shortcode 语法 {{< mermaid >}}，不要用 ```mermaid Markdown 代码块
编写时注意 Shortcode 前后各有一个空行，确保 Hugo 正确解析
提交后等待 Cloudflare Pages 自动构建部署（约 1-2 分钟）
如需本地预览，运行 hugo server 后访问 http://localhost:1313

智能监控技术方案：OpenClaw + Prometheus + Loki

Tue, 05 May 2026 13:30:00 +0800

智能监控技术方案链接到标题

概述链接到标题

本文档描述基于开源组件构建的智能监控告警体系，实现从指标采集到飞书通知的完整告警流程。

架构概览链接到标题

告警处理流程

flowchart TD A["node-exporter
:9100"] B["Prometheus
:9090"] C["Alertmanager
:9093"] D["alert-transformer
:9091"] E["OpenClaw
:18789"] F["飞书 Webhook"] G["告警规则
alerts.yml"] A -->|指标采集| B B -->|告警评估| C B -.->|加载| G C -->|Webhook| D D -->|格式转换| E E -->|飞书通知| F

指标采集流程

flowchart LR subgraph 指标 H["node-exporter
:9100"] I["Prometheus
:9090"] H -->|"Prometheus 抓取 (15s)"| I end subgraph 日志 J["Docker 日志"] K["Alloy
:12345"] L["Loki
:3100"] J -->|采集| K K -->|发送| L end

组件职责链接到标题

组件	职责	端口	部署位置
node-exporter	系统指标采集 (CPU/内存/磁盘/网络)	9100	每台被监控主机
Prometheus	指标抓取、存储、告警规则评估	9090	监控服务器
Alertmanager	告警去重、分组、路由、抑制	9093	监控服务器
alert-transformer	告警格式转换为 OpenClaw API	9091	监控服务器
OpenClaw	AI 决策、自然语言处理、飞书通知	18789	OpenClaw 服务器
Loki	日志存储和查询	3100	监控服务器
Alloy	Docker 日志采集	12345	监控服务器

部署配置链接到标题

node-exporter 部署链接到标题

每台被监控主机部署 node-exporter，建议使用 Docker Compose：

Elasticsearch IK 中文分词索引环境的部署

Thu, 16 Apr 2026 19:30:00 +0800

Elasticsearch 中文分词索引环境的部署链接到标题

背景链接到标题

在 RAG（检索增强生成）和中文搜索场景中，Elasticsearch 默认的标准分词器无法正确处理中文文本，会将每个汉字单独切分，导致搜索效果极差。IK 分词器（analysis-ik）是 Elasticsearch 最流行的中文分词插件，支持两种分词模式：

ik_smart：最少切分（粗粒度），适合搜索场景
ik_max_word：最细粒度切分，适合分析场景

本文记录在 Docker Compose 环境下部署带 IK 分词器的 Elasticsearch 单节点服务，并配置安全认证。

版本选择说明链接到标题

为什么选择 Elasticsearch 8.x 而不是 9.x？

本文部署的是 Elasticsearch 8.17.4，主要原因是当时 IK 分词器尚未支持 Elasticsearch 9.x。

根据 infinilabs/analysis-ik 官方发布页面的版本记录：

IK 插件对 ES 8.x 的支持：持续更新到 8.19.x
IK 插件对 ES 9.x 的支持：从 2025 年 5 月才陆续发布（9.0.0 于 2025-05-17 发布）

因此，在 2026 年初进行技术选型时，考虑到 IK 插件的稳定性和生态兼容性，选择了 ES 8.17.4。

由 OpenClaw 驱动的自动化博客生产线

Fri, 03 Apr 2026 22:30:00 +0800

笔记存在本地，由OpenClaw协助编写。如果再让它驱动 Hugo+GitHub+Cloudflare Pages，就可以再提炼出可分享可公开的博客日志。

搭建步骤链接到标题

Hugo 初始化链接到标题

brew install hugo
hugo new site my-blog
cd my-blog
git init

选用 hugo-coder 主题，支持中文，排版干净。

本地写作流程链接到标题

hugo new content/posts/2026-04-03-my-first-post.md
# 编辑文件，将 draft = true 改为 false
hugo server -D  # 本地预览 http://localhost:1313

推送到 GitHub 链接到标题

git remote add origin git@github.com:你的用户名/my-blog.git
git add .
git commit -m "first post"
git push

Cloudflare Pages 接入链接到标题

登录 Cloudflare Dashboard → Workers & Pages → Create application → Pages
Connect to GitHub，选择仓库
Build 设置：
- Build command: hugo
- Build output目录: public
绑定自定义域名（如 blog.ohtly.com）

自动化发布链接到标题

以后只需：

Hello World - 用 Hugo 建博客

Fri, 03 Apr 2026 19:30:00 +0800

Hugo 初体验链接到标题

Hugo 是一个用 Go 语言写的静态网站生成器，速度极快，主题丰富，适合搭建博客、文档、个人站点。

只需要一个 hugo.toml 配置文件 + content/ 目录下的 Markdown 文件，几秒钟就能编译出完整的静态网站。

部署流程：Hugo → GitHub → Cloudflare Pages，完全自动化，域名和托管都不依赖任何单一平台，永久可访问。

Hello World（Go 语言）链接到标题

package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}

运行：

go run hello.go

输出：

Hello, World!

博客搭好了，接下来会陆续把一些可公开的笔记整理发上来。

信息技术 on OHTLY Blog

Hugo 博客配置 Mermaid 图表支持

Hugo 博客配置 Mermaid 图表支持 链接到标题

前提条件 链接到标题

正确写法 链接到标题

图表类型示例 链接到标题

流程图 链接到标题

时序图 链接到标题

甘特图 链接到标题

注意事项 链接到标题

智能监控技术方案：OpenClaw + Prometheus + Loki

智能监控技术方案 链接到标题

概述 链接到标题

架构概览 链接到标题

组件职责 链接到标题

部署配置 链接到标题

node-exporter 部署 链接到标题