博客发布流程指南

引言

本文档详细介绍 AutoAgent 技术博客系统的使用方法，包括博客文章的创建、编辑、发布和 SEO 优化流程。无论您是技术作者还是内容运营人员，都可以按照本指南快速上手。

博客系统架构

┌─────────────────────────────────────────────────────────────────┐
│                     AutoAgent 博客系统                           │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌─────────────────┐    ┌─────────────────┐                    │
│  │   内容存储       │    │    前端展示      │                    │
│  │  (Markdown)     │───▶│  (Astro)        │                    │
│  └─────────────────┘    └─────────────────┘                    │
│          │                      │                               │
│          ▼                      ▼                               │
│  ┌─────────────────┐    ┌─────────────────┐                    │
│  │   SEO 优化      │    │   搜索引擎推送   │                    │
│  │  (自动化脚本)   │    │  (百度/Google)  │                    │
│  └─────────────────┘    └─────────────────┘                    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

快速开始

环境准备

确保已安装以下依赖：

# 克隆项目
git clone <repo_url>
cd wy-AutoAgent

# 安装依赖
npm install

# 验证 Python 脚本
python3 scripts/create_blog_template.py --help

创建第一篇博客

使用交互式命令创建新博客：

npm run blog:create

按照提示输入：

• 文章标题：输入文章标题
• 文章描述：简短描述文章内容
• 分类：选择分类（技术分享/硬件评测/技术解析/案例分享/行业洞察/产品更新）
• 标签：输入标签（逗号分隔）

或者使用命令行参数：

python3 scripts/create_blog_template.py \
  --title "我的新文章" \
  --description "文章描述..." \
  --category "技术分享" \
  --tags "自动化,教程" \
  --keywords "SEO关键词1,SEO关键词2"

手动创建博客

在 src/content/blog/ 目录下创建 .md 文件：

---
title: '文章标题'
description: '文章描述（150字符以内）'
pubDate: 2024-01-27
updatedDate: 2024-01-27
category: '技术分享'
tags: ['标签1', '标签2']
author: 'AutoAgent Team'
keywords: ['关键词1', '关键词2']
featured: false
---

## 一级标题

在此处编写正文内容...

## 二级标题

- 列表项1
- 列表项2

Frontmatter 字段说明

分类列表

• 技术分享
• 硬件评测
• 技术解析
• 案例分享
• 行业洞察
• 产品更新

编写规范

标题结构

## 一级标题（页面主标题，自动生成，跳过）

## 二级标题（文章主要章节）

### 三级标题（小节）

#### 四级标题（极少使用）

代码块

使用语言标识的代码块：

def hello_world():
    print("Hello, AutoAgent!")

// 带行号的代码示例
const greeting = "Hello, AutoAgent!";
console.log(greeting);

# 终端命令
npm run dev

表格

| 功能 | 状态 | 说明 |
|------|------|------|
| 博客列表 | ✅ 已完成 | 展示所有文章 |
| 详情页 | ✅ 已完成 | 展示单篇文章 |
| SEO优化 | ✅ 已完成 | 自动生成 meta |

提示框

> 💡 **提示**：这是一条提示信息

> ⚠️ **注意**：这是一条警告信息

> 📚 **参考**：这是一条参考信息

链接

[本文链接](/blog/blog-publishing-guide/)
[外部链接](https://www.AutoAgent.cc)

图片

![图片描述](/images/blog/image-name.jpg)

图片应放置在 public/images/blog/ 目录下。

发布流程

方式一：一键发布（推荐）

npm run blog:publish

此命令会：

1. ✅ 验证所有博客内容格式
2. ✅ 生成 SEO 报告
3. ✅ 推送到百度搜索
4. ✅ 构建项目
5. ✅ 更新 Sitemap

方式二：分步发布

# 1. 仅验证内容
python3 scripts/publish_blog.py --all

# 2. 仅推送到搜索引擎
npm run blog:push

# 3. 构建项目
npm run build

# 4. 部署（根据实际部署方式）
# scp dist/ user@server:/var/www/

方式三：手动发布单篇

# 验证并发布单篇博客
python3 scripts/publish_blog.py --file src/content/blog/new-post.md --push --build

SEO 优化指南

关键词策略

每篇文章应包含以下关键词：

1. 核心关键词（1-2个）：文章主题相关的核心词汇
2. 长尾关键词（2-3个）：更具体的搜索词组
3. 相关关键词（3-5个）：与主题相关的词汇

示例：

keywords: ['多模态AI', 'UI识别', 'GPT-4V', '视觉自动化']

Meta 标签自动生成

系统会自动为每篇文章生成以下 SEO 标签：

<title>如何使用多模态 AI 提升自动化稳定性？ | AutoAgent 技术博客</title>
<meta name="description" content="探讨 GPT-4V 在 UI 识别中的应用...">
<meta name="keywords" content="多模态AI, UI识别, 稳定性, AutoAgent, 智能体自动化, 技术博客">
<link rel="canonical" href="https://www.AutoAgent.cc/blog/multimodal-ai-stability/">
<meta property="og:type" content="article">
<meta property="og:title" content="如何使用多模态 AI 提升自动化稳定性？">
<meta property" content="探讨="og:description GPT-4V 在 UI 识别中的应用...">

结构化数据

每篇文章都会自动生成 Schema.org 的 BlogPosting 结构：

{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "文章标题",
  "description": "文章描述",
  "datePublished": "2024-01-27",
  "author": {
    "@type": "Organization",
    "name": "AutoAgent"
  }
}

搜索引擎推送

系统支持自动推送到以下搜索引擎：

• 百度：通过 scripts/baidu_push.py 推送
• Google：通过 Sitemap 自动发现

常见问题

Q1: 博客图片不显示？

确保图片路径正确：

• 图片应放在 public/images/blog/ 目录
• 引用路径：![描述](/images/blog/图片名.jpg)

Q2: SEO 关键词应该如何选择？

建议：

1. 参考百度指数、Google Trends
2. 分析竞争对手的关键词
3. 使用文章中自然出现的词汇
4. 避免堆砌关键词（3-5个为宜）

Q3: 文章发布后多久能被搜索引擎收录？

• 百度：通常 1-7 天
• Google：通常 1-3 天

Q4: 如何更新已发布的文章？

1. 编辑 src/content/blog/ 下的 .md 文件
2. 修改 updatedDate 字段
3. 重新发布：npm run blog:publish

Q5: 博客列表顺序如何调整？

博客按 pubDate 自动倒序排列，最新文章排在前面。

命令速查表

内容最佳实践

文章结构

1. 引言（100-200字）：介绍背景和文章目标
2. 核心内容（1500-3000字）：详细展开主题
3. 实践代码（适量）：提供可运行的示例
4. 总结（100-200字）：归纳要点和下一步建议

发布频率

建议：

• 技术分享：每周 1-2 篇
• 硬件评测：每月 1-2 篇
• 案例分享：每月 2-4 篇

内容质量

• ✅ 使用清晰的标题层级
• ✅ 包含实际代码示例
• ✅ 添加图表和图片
• ✅ 提供相关阅读链接
• ✅ 定期更新过时内容

附录

目录结构

src/
├── content/
│   └── blog/              # 博客文章 (Markdown)
│       ├── multimodal-ai-stability.md
│       ├── rk3588-edge-computing.md
│       └── ...
├── pages/
│   └── blog/
│       ├── index.astro    # 博客列表页
│       └── [...slug].astro # 博客详情页
└── content/
    └── config.ts          # 内容集合配置

scripts/
├── publish_blog.py        # 发布和SEO脚本
└── create_blog_template.py # 模板生成脚本

public/
├── robots.txt             # 搜索引擎规则
└── images/blog/           # 博客图片

相关资源

• Astro 文档
• Tailwind CSS
• 百度站长平台
• Google Search Console

如有任何问题，请联系技术团队。

AutoAgent 技术团队