Languages: 简体中文 | English | 日本語 | Español | Русский | Português (BR)
GEOFlow 是一套专门面向 GEO（生成式引擎优化）的开源智能内容工程与多站点分发系统。它把知识库、素材库、提示词、AI 生成任务、审核发布、数据分析、目标渠道站点包和远端静态页面分发串联为一条可持续运营的工作链路，目标是帮助团队把可信资料沉淀为可管理、可发布、可追踪、可同步到多端的 GEO 内容资产。
GEOFlow 以 Apache License 2.0 开源发布。你可以自由使用、复制、修改和分发本项目，包括商业使用；请保留版权声明和许可证文本，并遵守 Apache-2.0 的专利授权、商标与免责声明条款。
| 特性 | 说明 |
|---|---|
| 🤖 多模型内容生成 | 兼容 OpenAI 风格接口，支持 chat / embedding 模型、Provider URL 自动适配、智能模型切换、失败重试和调用统计 |
| 🧠 知识库与 RAG | 知识库上传后自动切片；配置 embedding 模型后写入向量，在文章生成时召回相关资料 |
| 🗂 素材与提示词体系 | 标题库、关键词库、图片库、作者库、知识库、正文提示词、特殊提示词集中管理 |
| 📦 任务自动化 | 支持任务创建、生成数量、草稿池、审核开关、发布节奏、队列执行、失败重试和任务文章筛选 |
| 📋 审核与文章管理 | 草稿、审核、发布、回收站、作者、分类、SEO 字段和任务来源统一管理 |
| 📡 多站点分发管理 | 支持分发渠道、Agent 密钥、目标站点包、静态模式、伪静态规则、远端文章编辑/删除和队列日志 |
| 🧾 目标站点包 | 为每个渠道生成预配置 PHP Agent 包，内置首页、详情页、静态资源、sitemap、llms.txt / TXT 地图和 Schema |
| 📊 数据分析 | 集中展示系统总览、单站内容运营、多站分发、访问日志、Top 内容、AI 爬虫识别和趋势图 |
| 🔍 SEO 与 LLM 抓取友好输出 | 文章 SEO 元信息、Open Graph、Schema、GFM Markdown、独立 CSS、图片同步、sitemap 和 TXT 地图 |
| 🎨 前台与主题 | 默认主题、主题包、预览路径、后台主题切换；远端渠道可同步站点标题、版权、主题和分类设置 |
| 🌍 后台多语言 | 后台支持中文、英文、日语、西班牙语、俄语、葡萄牙语（巴西）切换，并覆盖 2.0 新模块 |
| 🔔 版本提醒 | 后台可按 version.json 检查 GitHub 新版本，并在有新版本时提醒管理员 |
| 🐳 可直接部署 | Docker Compose 一键拉起 PostgreSQL（pgvector）、Redis、应用、队列、调度、Reverb 和生产 Nginx/php-fpm |
上述页面覆盖站点首页、任务调度、文章流程与模型配置等主链路；更多后台说明见 docs/（若目录中暂无截图资源，请本地补全或替换为你的截图路径）。
GEOFlow 2.0 重点变化包括：
- 后台首页改为运营导航：保留三步上手引导，并按单站点运营、多站点分发和配套 skill 资源组织入口。
- 数据分析独立成页：系统总览、内容运营、任务健康、素材健康、分发状态、访问日志和 AI 爬虫趋势集中到
/admin/analytics。 - 分发管理进入可运行闭环：支持渠道新建、密钥管理、测试连接、目标站点包下载、静态/伪静态模式、远端设置同步、队列、日志、远端文章编辑与删除。
- 目标渠道站点支持静态页面：文章分发后生成远端首页、详情页、sitemap、TXT 地图和
llms.txt，并同步图片与独立 CSS。 - 素材与 RAG 更完整：知识库切片、向量化状态、标题库、关键词库、图片库、作者和提示词体系形成任务生产输入。
- 部署与安全增强：生产 Docker 使用 Nginx + PHP-FPM，默认管理员 seed 不覆盖已有账号，Docker 镜像和 Composer 镜像可配置。
- 多语言覆盖补齐：后台语言包覆盖 2.0 新增模块，减少界面中出现裸翻译 key 或英文兜底。
后台管理页面
↓
AI 配置 / 素材库 / 提示词 / 任务配置
↓
调度器 / 队列 / Worker 执行 AI 生成
↓
草稿 / 审核 / 发布
↓
本地前台文章与 SEO 页面
↓
分发队列 / 目标站点 Agent
↓
远端静态首页、详情页、sitemap、TXT 地图与 llms.txt
| 层级 | 说明 |
|---|---|
| Web / Admin | Laravel 路由与控制器；前台文章站点、Blade 后台、数据分析、分发管理、素材与任务入口 |
| API / Agent | 本地 API 与目标站点 PHP Agent；负责分发健康检查、文章接收、远端设置同步和静态文件生成 |
| Scheduler / Queue / Reverb | Laravel Scheduler 扫描与入队；queue:work / Horizon 消费生成与分发任务；Reverb 按需启用 |
| Domain & Jobs | app/Services、app/Jobs、app/Http/Controllers 等承载 AI 生成、RAG、发布、分发和日志分析规则 |
| Persistence | PostgreSQL（推荐 pgvector 镜像与线上实例一致）+ Redis（队列/缓存等）+ 目标站点本地 JSON/静态文件 |
核心链路：
- 在后台配置模型、提示词与素材库
- 准备知识库、标题库、关键词库、图片库和作者库
- 创建任务并进入调度与队列
- Worker（队列进程）调用模型生成正文与元数据
- 文章进入草稿、审核、发布链路
- 本地前台输出文章与 SEO 页面
- 如选择分发渠道，文章进入分发队列并同步到目标站点
- 数据分析页持续查看内容生产、分发状态、访问日志和 AI 爬虫趋势
登录后台后，建议按仪表盘里的「快速开始」完成第一轮验证：
- 配置 API：至少添加一个可用 chat 模型；如果需要知识库 RAG 召回，再添加一个 embedding 模型。
- 配置素材库：准备知识库、标题库、关键词库、图片库和作者。知识库建议先用真实、可验证的业务资料。
- 新建任务：选择标题库、素材、模型、生成数量和发布频率，先让文章进入草稿或审核流程，再逐步开启自动发布。
GEOFlow 适合这些真实且可落地的场景：
- 独立 GEO 官网 把官网内容、产品资料、FAQ、案例和品牌知识组织成一个可持续更新的内容系统。目标是提升 AI 搜索可见度、品牌信源覆盖和内容运营效率，而不是堆砌低质量页面。
- 官网中的 GEO 子频道 在现有官网下搭建一个独立的资讯、知识或解决方案频道。目标是让品牌内容更结构化、更适合搜索引用，也方便不同团队协同更新。
- 独立 GEO 信源站点 面向某个行业、主题或问题域，持续沉淀高质量文章、榜单、解读、指南和资料。目标是构建稳定可信的外部内容资产，而不是做信息污染。
- GEO 内容管理系统 作为内部内容生产后台，统一管理模型、素材、标题、图片、知识库、审核和发布。目标是提升团队提效、降低重复劳动、减少分散工具切换。
- GEO 多站点 / 多栏目部署 用同一套系统管理多个站点、多个栏目或多个主题模板。目标是让内容生产、模板切换、分发和维护更标准化。
- 自动化信源管理与内容分发 对知识库、专题内容、资讯更新和内容分发流程进行工程化管理。目标是让真正有价值的信息更稳定地被用户和 AI 理解、引用和检索。
这套系统的收益，应该建立在真实、优质、持续维护的知识库之上。 我们不鼓励利用系统制造信息噪音、批量污染互联网或堆积虚假内容。GEOFlow 的本质是帮助团队更高效地管理、生产和分发可信内容，提升 AI 营销效率和 GEO 运营效率，而不是替代事实、替代判断或替代内容质量本身。
不同场景下，建议这样使用 GEOFlow：
- 作为独立 GEO 官网运行 直接部署完整前台与后台，围绕官网栏目、产品页延展内容、FAQ、案例和专题进行运营。适合希望把官网做成 AI 搜索友好型内容资产的团队。
- 作为官网中的 GEO 子频道运行 将 GEOFlow 作为一个相对独立的内容频道部署，再通过导航、子域名或目录与主站打通。适合不想重构主站、但需要快速上线内容频道的团队。
- 作为 GEO 信源站运行 单独维护一个面向特定主题的内容站点，把知识库和资料建设放在首位，再通过任务系统做稳定更新。适合想做行业型、专题型或问题导向型内容资产的团队。
- 作为内部 GEO 内容管理后台运行 把前台弱化，重点使用后台的模型配置、素材库、任务调度、审核发布与 API 能力。适合内容团队、增长团队、品牌团队做内部生产系统。
- 作为多站点 / 多频道系统运行 使用不同模板、栏目、域名或部署实例，管理多个内容出口。适合需要同时维护多个品牌频道、多个主题站或多个实验站点的团队。
- 作为自动化信源管理系统运行 重点建设知识库、标题库、图片库和提示词体系，把系统当作一个内容工程与分发操作台。适合希望长期沉淀可信知识资产、再逐步扩展自动化能力的团队。
建议的使用顺序是：
- 先确定真实的业务目标和目标读者
- 先建设知识库，再建设自动化流程
- 先确保内容真实、可核验、可维护
- 再用模型、任务和模板能力去提效
如果知识库本身不真实、不完整、不稳定，再强的自动化也只会放大噪音。 所以在 GEOFlow 里，知识库建设应该始终排在最前面。
# 1. 克隆仓库
git clone https://github.com/yaojingang/GEOFlow.git
cd GEOFlow
# 2. 复制环境变量
cp .env.example .env
# 3. 按需编辑 .env（数据库、Redis、APP_URL、ADMIN_BASE_PATH、REVERB_* 等）
vi .env
# 4. 构建并启动（含 postgres、redis、init、app、queue、scheduler、reverb）
docker compose build
docker compose up -d- 前台默认访问：
http://localhost:18080（端口由环境变量APP_PORT控制，默认18080） - 后台登录：
http://localhost:18080/geo_admin/login（前缀由ADMIN_BASE_PATH控制，默认geo_admin）
首次启动会运行 init 容器：在数据库就绪后执行首次迁移与种子（默认管理员见下文「默认管理员」）。
生产环境建议使用 docker-compose.prod.yml，改为 Nginx + php-fpm，而不是 php artisan serve。
如果希望在常见云服务器上自动完成环境自检、Docker 检测、.env.prod 生成、容器部署和部署后健康检查，可以使用参考部署脚本：
curl -fsSL https://raw.githubusercontent.com/yaojingang/GEOFlow/main/deploy-scripts/geoflow-docker-deploy.sh -o geoflow-docker-deploy.sh
bash geoflow-docker-deploy.sh脚本说明见 deploy-scripts/README.md。
cp .env.prod.example .env.prod
vi .env.prod
docker compose --env-file .env.prod -f docker-compose.prod.yml build
docker compose --env-file .env.prod -f docker-compose.prod.yml up -d postgres redis
docker compose --env-file .env.prod -f docker-compose.prod.yml up -d init
docker compose --env-file .env.prod -f docker-compose.prod.yml up -d app web queue scheduler reverb- 前台 / 后台统一经
web（Nginx）访问 - PHP 由
app（php-fpm）解析 - 默认管理员：生产
init服务会在迁移后执行一次db:seed，只在目标用户名不存在时写入默认后台账号；重复执行不会覆盖已有账号或密码 - 详细说明见
docs/deployment/DEPLOYMENT.md
前置要求： PHP 8.2+，启用 pdo_pgsql、redis 等 Laravel 常用扩展；本机已安装 PostgreSQL 与 Redis；已安装 Composer 2.x。
# 1. 克隆仓库
git clone https://github.com/yaojingang/GEOFlow.git
cd GEOFlow
# 2. 环境与依赖
cp .env.example .env
# 编辑 .env：将 DB_HOST/DB_* 指向本机 Postgres，REDIS_* 指向本机 Redis，QUEUE_CONNECTION=redis 等
composer install --no-interaction --prefer-dist
php artisan key:generate
# 3. 数据库与存储
php artisan migrate --force
php artisan db:seed --force # 可选：写入默认管理员等
php artisan storage:link
# 4. 开发用 HTTP（仅本地调试；生产请用 Nginx + PHP-FPM，站点根目录 public/）
php artisan serve --host=127.0.0.1 --port=8080另开终端启动常驻进程（与 Docker 中 queue / scheduler / reverb 对应）：
php artisan queue:work redis --queue=geoflow,distribution,default --sleep=1 --tries=1 --timeout=300
php artisan schedule:work
php artisan reverb:start- 后台：
http://127.0.0.1:8080/geo_admin/login（若修改了ADMIN_BASE_PATH请替换路径） - 生产可用
php artisan horizon替代queue:work（需按项目配置托管进程）
| 组件 | 说明 |
|---|---|
| PHP | 8.2+（Docker 镜像可为 8.4） |
| 扩展 | Laravel 常规扩展；PostgreSQL 需 pdo_pgsql；Redis 队列需 redis |
| Composer | 2.x |
| 数据库 | PostgreSQL（推荐 pgvector，与 docker-compose.yml 中镜像一致） |
| Redis | 队列、缓存等（本地极简调试可将 QUEUE_CONNECTION 改为 sync，生产不推荐） |
目录权限（Linux / macOS 常见）：
chmod -R ug+rwx storage bootstrap/cache默认管理员（执行 php artisan db:seed 后，以 Database\\Seeders\\AdminUserSeeder 为准）：
| 字段 | 值 |
|---|---|
| 用户名 | GEOFLOW_ADMIN_USERNAME，默认 admin |
| 密码 | 本地开发默认 password；生产环境请设置 GEOFLOW_ADMIN_PASSWORD。若生产环境留空且账号尚不存在，seed 会生成一次性随机密码并输出到初始化日志 |
补充规则：AdminUserSeeder 只在目标用户名不存在时创建账号；重复执行不会覆盖已有用户名、邮箱或密码。若账号已存在，即使生产环境 GEOFLOW_ADMIN_PASSWORD 为空，也不会重新生成或打印密码。
- 后台账号连续登录失败 5 次 会自动锁定（
status=locked）。 - 被锁定账号无法继续登录，需管理员手动解锁。
- 解锁命令：
php artisan geoflow:admin-unlock <username>例如：
php artisan geoflow:admin-unlock admin生产环境 Web： 使用 Nginx / Apache + PHP-FPM，网站根目录指向项目 public/，勿将仓库根目录直接暴露为文档根。
| 服务 | 作用 |
|---|---|
postgres |
PostgreSQL 16 + pgvector |
redis |
Redis 7 |
init |
一次性初始化（restart: "no"） |
app |
php artisan serve，映射 ${APP_PORT:-18080}:8080 |
queue |
queue:work redis |
scheduler |
schedule:work |
reverb |
WebSocket，映射 ${REVERB_EXPOSE_PORT:-18081}:8080 |
宿主机仅绑定 127.0.0.1 暴露数据库 / Redis 端口时，见 docker-compose.yml 中的 DB_EXPOSE_PORT、REDIS_EXPOSE_PORT。
| 变量 | 默认 | 含义 |
|---|---|---|
COMPOSER_ON_START |
true |
容器启动时执行 composer install |
AUTO_MIGRATE |
true |
每次启动执行 php artisan migrate --force |
AUTO_INIT_ONCE |
仅 init 为 true |
新库时执行一次 migrate + db:seed |
AUTO_GENERATE_APP_KEY |
init 内为 true |
无有效 APP_KEY 时自动生成 |
AUTO_SEED |
false |
为 true 时每次启动都 db:seed（慎用） |
Compose 将 ./storage 与 ./.env 挂载进容器；应用代码在镜像内。若要用于正式生产，请改用仓库新增的 docker-compose.prod.yml（Nginx + php-fpm），并参见 docs/deployment/DEPLOYMENT.md。
升级建议： git pull → docker compose build → docker compose up -d。
composer test
./vendor/bin/pint本项目采用 Apache License 2.0。该协议允许个人和企业在遵守许可证声明、版权保留、修改说明、专利授权和免责声明等条款的前提下使用、修改、分发和商用 GEOFlow。