GEOFlow

GEOFlow 是一个专为 生成式引擎优化 (GEO) 和 搜索引擎优化 (SEO) 场景设计的开源内容生产系统。它将模型配置、素材管理、任务调度、AI 生成、草稿审核及前台发布整合成一条完整的自动化链路，非常适合用于搭建自动化的内容站点、内部运营后台或大规模 SEO 矩阵站。

通过 GEOFlow，你可以实现从“关键词/标题”到“高质量 SEO 文章”的全流程自动化，支持多模型接入、批量任务调度及严格的审核工作流。

核心功能亮点

1. 多模型兼容与灵活配置

• OpenAI 风格接口：兼容任何提供 /v1/chat/completions 接口的 AI 服务商。
• 广泛支持：原生支持 OpenAI (GPT-4o), DeepSeek, MiniMax, Claude 等主流模型，也可接入本地 Ollama 或私有化部署模型。
• 动态切换：可在后台为不同任务配置不同的模型和提示词模板，平衡成本与质量。

2. 强大的任务调度与队列

• 批量处理：支持创建大规模生成任务，系统自动将其拆分为子任务进入队列。
• 定时与重试：支持定时执行任务，具备失败自动重试机制，确保高可用性。
• 并发控制：基于 Worker 架构，可水平扩展以应对高并发生成需求。

3. 统一的素材管理中心

• 集中化管理：内置标题库、关键词库、图片库、知识库（RAG 基础）和提示词模板库。
• 结构化组装：在创建任务时，可灵活组合不同的素材包，实现内容的多样性和差异化，避免重复内容惩罚。

4. 严谨的审核与发布工作流

• 三段式流程：草稿 (Draft) → 审核 (Review) → 发布 (Publish)。
• 灵活策略：支持全自动发布（适合低风险场景）或人工审核后发布（适合高质量要求场景）。
• SEO 优化输出：自动生成文章 SEO 元信息（Title, Description, Keywords）、Open Graph 标签及结构化数据（JSON-LD），提升搜索可见性。

5. 易于部署与维护

• Docker Compose：一键部署全套环境（Web, PostgreSQL, Scheduler, Worker）。
• PostgreSQL 驱动：采用稳定的关系型数据库，适合结构化内容存储和高并发写入。
• CLI 支持：提供 bin/geoflow 命令行工具，方便集成到 CI/CD 或其他自动化脚本中。

系统架构

GEOFlow 采用经典的生产者-消费者架构：

graph TD
    A[后台管理 / API] -->|创建任务| B(Scheduler 调度器)
    B -->|入队| C{Job Queue}
    C -->|领取任务| D[Worker 执行节点]
    D -->|调用 API| E[AI 模型服务]
    E -->|返回内容| D
    D -->|保存草稿| F[(PostgreSQL)]
    F -->|审核/发布| G[前台站点 / SEO 页面]

• Web / Admin: 前端展示与后台管理界面。
• API / CLI: 提供机器接口和本地命令行操作能力。
• Scheduler / Worker: 核心引擎，负责任务分发与实际生成。
• Domain Services: 承载业务逻辑的核心服务层。
• Persistence: PostgreSQL 数据库，持久化所有数据。

快速开始

方式一：Docker Compose（推荐）

1. 克隆项目：

   git clone https://github.com/yaojingang/GEOFlow.git
   cd GEOFlow
   

2. 配置环境变量：

   cp .env.example .env
   vi .env  # 编辑数据库密码、App Secret 等关键配置
   

3. 启动服务：

   # 启动 Web, DB, Scheduler 和 Worker
   docker compose --profile scheduler up -d --build
   

4. 访问系统：
   • 前台站点: http://localhost:18080
   • 后台管理: http://localhost:18080/geo_admin/
   • 默认账号: admin / admin888 (请务必首次登录后修改密码)

方式二：本地 PHP 开发环境

1. 前置要求：PHP 7.4+, PostgreSQL, 启用 pdo_pgsql 和 curl 扩展。
2. 配置数据库：设置环境变量 DB_DRIVER, DB_HOST, DB_NAME 等。
3. 启动服务：

   php -S localhost:8080 router.php
   

4. 访问后台: http://localhost:8080/geo_admin/

使用流程指南

1. 配置 AI 模型：
   • 进入后台 “AI 配置中心 → AI 模型管理”。
   • 添加模型 API Key、Base URL 和 Model ID。支持 MiniMax, OpenAI, DeepSeek 等一键预填。
2. 准备素材库：
   • 在 “素材管理” 中录入标题库、关键词、上传图片、编写提示词模板。
   • 建议：准备多样化的标题和提示词，以增加生成内容的独特性。
3. 创建生成任务：
   • 进入 “任务管理”，选择目标标题库、关联的模型、提示词模板及发布规则。
   • 设置任务规模（如生成 100 篇文章）。
4. 监控与审核：
   • 任务提交后，Scheduler 会自动调度，Worker 开始生成。
   • 生成的文章进入 “草稿箱”。
   • 人工或自动审核后，点击 “发布”，文章即可在前台展示并生成 SEO 友好页面。

配套 Skill：geoflow-cli-ops

GEOFlow 还提供了配套的 Claude Code Skill，允许你通过自然语言直接操作后台：

• 仓库: yaojingang/yao-geo-skills
• 功能:
  • /geoflow create-task: 创建新的生成任务。
  • /geoflow upload-draft: 上传本地文章草稿。
  • /geoflow review: 审核待发布文章。
  • /geoflow status: 检查任务队列状态。