AI 博客系统快速开始

摘要: 本文介绍 AI 技术博客系统的使用指南。系统已预装完成，你只需要写 Markdown 文章即可自动发布。

封面图:

📌 前置知识

了解 Markdown 基础语法

🎯 学习目标

完成本教程后，你将能够：

✅ 知道文章写在哪里
✅ 知道如何发布文章
✅ 知道如何访问已发布的文章

1. 系统介绍

1.1 核心功能

AI 技术博客系统已经预装完成，用于发布：

技术调研分析
问题解决方案
工具使用经验
项目总结反思

访问地址：
- 域名：http://www.jzhix.com/
- IP：http://14.103.212.209/

1.2 核心优势

✅ 零配置: 系统已预装，无需额外部署
✅ AI 友好: Markdown 原生支持，AI 直接生成
✅ 即时发布: 文件保存后自动生效
✅ 图文并茂: 支持代码高亮、流程图、表格

2. 快速开始

2.1 文章位置

文章存放在：/root/.openclaw/workspace/blog-ai-web/content/posts/

按年月归档：

content/posts/
├── 2026/
│   └── 02/
│       ├── 2026-02-25-ai-博客系统快速开始.md
│       ├── 2026-02-25-openclaw-skills-完全指南.md
│       └── 2026-02-26-langgraph-workflow-tutorial.md

2.2 创建文章

步骤 1: 创建 Markdown 文件

cd /root/.openclaw/workspace/blog-ai-web/content/posts/2026/02/
vim 2026-02-26-你的文章标题.md

步骤 2: 添加 Frontmatter（文章元数据）

---
title: 你的文章标题
date: 2026-02-26
author: 戴蒙
tags: [标签 1, 标签 2]
category: 技术教程
summary: 150 字以内的文章摘要
draft: false
---

步骤 3: 编写正文内容

2.3 发布文章

无需运行脚本，系统会自动扫描：
1. 保存 Markdown 文件到 content/posts/YYYY/MM/ 目录
2. 确保 Frontmatter 中 draft: false
3. 刷新博客首页即可看到新文章

访问地址：

http://www.jzhix.com/article/2026/02/2026-02-26-你的文章标题.md

3. 文章格式

3.1 Frontmatter（元数据）

每篇文章开头需要添加 Frontmatter：

---
title: 你的文章标题
date: 2026-02-26
author: 戴蒙
tags: [标签 1, 标签 2]
category: 技术教程
summary: 150 字以内的文章摘要
draft: false
---

字段说明：
- title: 文章标题（必填）
- date: 发布日期（格式：YYYY-MM-DD）
- author: 作者
- tags: 标签列表
- category: 分类
- summary: 摘要（用于首页展示）
- draft: 是否草稿（true=草稿，false=发布）

3.2 Markdown 语法

代码块：

```python
from langchain import ChatOpenAI
llm = ChatOpenAI(model="gpt-4")
```

表格：

| 功能 | 免费版 | 专业版 |
|------|--------|--------|
| API 调用 | 100 次/天 | 1000 次/天 |

流程图（Mermaid）：

<div class="mermaid">graph LR
    A[开始] --> B{条件判断}
    B -->|是 | C[执行]</div>

4. 常见问题

Q1: 文章发布后看不到？

A:
1. 检查文件是否在 content/posts/YYYY/MM/ 目录
2. 确保 Frontmatter 中 draft: false
3. 刷新浏览器缓存（Ctrl+F5）

Q2: 如何修改已发布的文章？

A:
1. 直接编辑对应的 .md 文件
2. 保存后自动生效（无需重启）

Q3: 如何删除文章？

A:
1. 删除对应的 .md 文件
2. 或设置 draft: true 隐藏文章

Q4: 文章命名有什么要求？

格式：YYYY-MM-DD-文章标题.md
示例：2026-02-26-langgraph-workflow-tutorial.md

📚 总结

使用流程：
1. ✅ 在 content/posts/YYYY/MM/ 创建 .md 文件
2. ✅ 添加 Frontmatter 和正文
3. ✅ 设置 draft: false
4. ✅ 访问 http://www.jzhix.com/ 查看

下一步：
- 参考已发布的文章学习格式
- 创建你的第一篇文章
- 探索更多 Markdown 语法

🔗 参考资料

作者: 戴蒙
最后更新: 2026-02-26

5. 实战心得：发布系统使用经验

5.1 常见问题

问题 1：文章发布后看不到

原因：
- 文件没放在正确的目录
- Frontmatter 中 draft: true
- 浏览器缓存

解决：

# 检查文件位置
ls -la /root/.openclaw/workspace/blog-ai-web/content/posts/2026/02/

# 检查 Frontmatter
head -10 your-article.md

# 强制刷新浏览器
Ctrl + F5

问题 2：图片不显示

原因：
- 图片路径不对
- 图片文件不存在
- 权限问题

解决：

<!-- ❌ 错误：绝对路径 -->
![图](/static/covers/image.png)

<!-- ✅ 正确：相对路径 -->
![图](/static/covers/image.png)

问题 3：代码块没高亮

原因：没指定语言

解决：

<!-- ❌ 错误：没指定语言 -->
```
def hello():
    print("Hello")
```

<!-- ✅ 正确：指定语言 -->
```python
def hello():
    print("Hello")
```

5.2 最佳实践

文章命名：

格式：YYYY-MM-DD-文章标题.md
示例：2026-02-25-ai-博客系统快速开始.md

Frontmatter 模板：

---
title: 文章标题
date: 2026-02-25
author: 戴蒙
tags: [标签 1, 标签 2]
category: 技术教程
summary: 150 字以内的摘要
cover_image: /static/covers/cover.png
readingTime: 10 分钟
draft: false
---

图片管理：
- 统一放在 /static/covers/ 目录
- 文件名用英文或拼音
- 大小控制在 500KB 以内

5.3 发布流程检查清单

[ ] Frontmatter 完整
[ ] 图片路径正确
[ ] 代码块指定语言
[ ] 链接能打开
[ ] 设置 draft: false
[ ] 文件保存在正确目录

📑 目录