研墨 AI 博客写作助手

Yd Wen2026/5/13大约 5 分钟

基于多智能体编排的 AI 博客写作助手

研墨 DevInk

基于多智能体编排的 AI 博客写作助手。通过协调多个 AI Agent 协作完成博客创作——从标题生成、大纲规划、内容撰写到配图搜索，提供完整的写作工作流，并通过 SSE 实时推送进度。

仓库地址：
- https://github.com/Yd-Wen/devink
- https://gitee.com/yindong-wen/devink
项目地址：https://devink.yindongwen.top

技术栈

层级	技术
前端	Vue 3 + TypeScript + Vite + Ant Design Vue + Pinia + Vue Router + ECharts + Marked
后端	Python 3.11+ / FastAPI + SQLAlchemy + Redis + MySQL
AI	阿里云 DashScope（通义千问 Qwen3-Max）
基础设施	Docker Compose / Nginx / MySQL 8.0 / Redis 7
配图服务	Pexels 图库 / Mermaid 图表 / Iconify 图标 / Emoji 表情包 / SVG 示意图
对象存储	阿里云 OSS

功能特性

多阶段 AI 写作流水线 — 标题生成（多方案）→ 大纲规划（可编辑）→ 正文撰写 + 配图搜索 → 合并为完整图文
SSE 实时进度推送 — 前后端通过 Server-Sent Events 长连接，实时展示各阶段生成状态
多 Agent 协作编排 — Title / Outline / Content / Image Analyzer / Merger 五个 Agent 分工协作
丰富的配图来源 — 支持 Pexels 免费图库、Mermaid 图表渲染、Iconify 图标、Emoji 表情包、SVG 示意图五种图片来源
用户配额管理 — 每日自动重置配额，管理员无限配额
管理员面板 — 用户管理、系统数据统计
Docker 一键部署 — 前后端 + MySQL + Redis 容器化，自动初始化数据库

项目结构

devink/
├── frontend/                   # Vue 3 前端
│   └── src/
│       ├── pages/              # 页面组件 (Home, Blog, User, Admin)
│       ├── components/         # 全局组件
│       ├── api/                # API 调用（从 OpenAPI 自动生成）
│       ├── stores/             # Pinia 状态管理
│       ├── router/             # Vue Router 路由配置
│       ├── utils/              # 工具函数 (SSE, Markdown, 权限等)
│       └── styles/             # CSS 样式
├── backend/                    # FastAPI 后端
│   └── app/
│       ├── routers/            # API 路由 (user, blog, health, statistics)
│       ├── services/           # 业务逻辑层
│       ├── agent/              # 多 Agent 系统
│       │   ├── orchestrator.py # Agent 编排器
│       │   ├── agents/         # 各 Agent 实现
│       │   ├── parallel/       # 并行图片生成
│       │   └── context/        # SSE 流式处理
│       ├── models/             # SQLAlchemy 数据模型
│       ├── schemas/            # Pydantic Schema
│       └── constants/          # 提示词模板、枚举
├── sql/                        # 数据库初始化脚本
├── docker-compose.yml          # Docker 容器编排
├── .env.example                # Docker 环境变量示例
└── CLAUDE.md                   # Claude Code 项目指南

安装部署

环境要求

前端: Node.js 22.12+
后端: Python 3.11+（推荐使用 uv 包管理器）
数据库: MySQL 8.0 + Redis 7
可选: Docker & Docker Compose（容器化部署）

环境变量配置

后端启动前需要配置 backend/.env，以下为关键环境变量：

变量	必填	说明
`DB_HOST`	✓	MySQL 主机地址
`DB_PORT`		MySQL 端口，默认 `3306`
`DB_NAME`	✓	数据库名称
`DB_USER`	✓	数据库用户名
`DB_PASSWORD`	✓	数据库密码
`REDIS_HOST`	✓	Redis 主机地址
`REDIS_PORT`		Redis 端口，默认 `6379`
`REDIS_PASSWORD`		Redis 密码，无密码留空
`SESSION_SECRET_KEY`	✓	Session 加密密钥，生产环境请修改
`PASSWORD_SALT`	✓	密码加密盐值
`INIT_ADMIN_PASSWORD`		种子用户初始密码，默认 `12345678`
`DASHSCOPE_API_KEY`	✓	阿里云百炼 API Key
`DASHSCOPE_MODEL`		AI 模型，默认 `qwen3-max`
`PEXELS_API_KEY`	✓	Pexels 图片搜索 API Key
`ALICLOUD_OSS_SECRET_ID`	✓	阿里云 OSS AccessKey ID
`ALICLOUD_OSS_SECRET_KEY`	✓	阿里云 OSS AccessKey Secret
`ALICLOUD_OSS_REGION`	✓	OSS 地域，如 `cn-hangzhou`
`ALICLOUD_OSS_BUCKET`	✓	OSS 存储桶名称

API Key 获取

项目依赖以下外部服务，需要提前申请 API Key：

1. DashScope（阿里云百炼）— AI 文本生成

前往阿里云百炼控制台开通 DashScope 服务，在 API Key 管理中创建 Key，模型推荐使用 qwen3-max。

2. Pexels — 免费图库搜索

前往 Pexels API 注册账号并申请 API Key，用于博客配图搜索。

3. 阿里云 OSS — 图片上传存储

前往阿里云 RAM 控制台创建 AccessKey，并在 OSS 控制台创建存储桶（Bucket），设置为公共读。

本地开发

1. 克隆项目

git clone https://github.com/Yd-Wen/devink.git
cd devink

2. 启动后端

cd backend
cp .env.example .env    # 编辑 .env 填入数据库、AI 等配置
uv sync                 # 安装依赖
uv run python ../sql/init_db.py --execute  # 初始化数据库
uv run python -m app.main  # 启动开发服务器 (http://localhost:8567)

3. 启动前端

cd frontend
npm install
npm run dev             # 启动开发服务器 (http://localhost:5173)

Docker 部署

cp backend/.env.example backend/.env    # 编辑填入配置
cp .env.example .env                    # 编辑填入数据库密码
docker compose up -d                    # 启动所有服务

Docker 常用命令

# 查看服务状态
docker compose ps

# 查看服务日志
docker compose logs -f backend    # 后端日志
docker compose logs -f frontend   # 前端日志
docker compose logs -f mysql      # 数据库日志

# 重启单个服务
docker compose restart backend

# 停止所有服务
docker compose down

# 停止并删除数据卷（清空数据）
docker compose down -v