yaojingang/GEOFlow：README 来源编辑指南

yaojingang/GEOFlow 的 README 将项目描述为"Open-source GEO content engineering and multi-site distribution system with AI tasks, RAG/semantic chunking, analytics, GEOFlow Agent and WordPress target publishing."。本文只整理仓库能直接核验的内容，不把星标、Fork 或宣传语当成质量证明。README 在"GEOFlow"下的说明是：> GEOFlow 是一套专门面向 GEO（生成式引擎优化）的开源智能内容工程与多站点分发系统。它把知识库、素材库、提示词、AI 生成任务、审核发布、数据分析、GEOFlow Agent 目标站点包、WordPress REST 渠道、通用 HTTP API 渠道和远端静态页面分发串联为一条可持续运营的工作链路，目标是帮助团队把可信资料沉淀为可管理、可发布、可追踪、可同步到多端的 GEO 内容资产。。这给出的首先是项目边界，而不是已经完成的生产验证。

从 README 的"🆕 新版本重点"和相关条目看，读者可以先判断它是否解决自己的具体问题：Gemini 与 OpenAI-compatible 接入更完整：AI 模型配置同时覆盖 OpenAI 风格 Provider 与 Gemini 原生 chat / embedding 路径。。如果你的目标与这段说明不一致，就不应仅凭项目热度采用它。这里保留原项目名、命令和组件名，方便回到一手来源核对。 README 还列出了另一条可核对的信息：后台首页改为运营导航：保留三步上手引导，并按单站点运营、多站点分发和配套 skill 资源组织入口。。这类原文条目可以帮助读者设计试运行步骤，但不能代替自己的环境测试。

README 把工作方式分散写在"匿名使用统计"等段落中。可确认的线索包括：GEOFlow 支持可关闭的匿名使用统计，用于了解项目部署量、活跃部署、后台日活和版本分布。启用后，首次安装会发送 installed，版本变化会发送 updated，调度器每天最多发送一次 heartbeat；已登录后台页面保留每日一次 adminactive Pulse。。这篇整理没有把未写出的架构、性能或安全边界补成结论；真正的运行链仍应结合仓库目录、配置文件和版本标签检查。

第一次安装应从 README 给出的入口开始。当前可复核的命令是： # 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 如果仓库没有提供命令，本文不会替它编造安装步骤，而是建议先打开 README 的"匿名使用统计"部分，确认系统依赖、默认端口和首次初始化动作。

日常使用的细节取决于项目实际文档。README 的"匿名使用统计"段落提到：服务端事件只包含随机实例 ID、GEOFlow 版本和事件类型；后台 Pulse 额外包含管理员不可逆摘要。域名、页面路径、管理员账号、邮箱、文章内容、Cookie、APPKEY 和业务密钥不会进入上报载荷。请求失败不会影响安装、升级、调度任务或后台页面；如需关闭，设置：。对于配置文件、环境变量、权限和数据目录，当前稿只记录来源明确的部分；未写明的默认值必须在测试环境中验证，并保留可回滚的配置副本。 同一部分还提到：知识库支持语义切片规划：提供结构化规则切片、自动策略和可选 LLM 语义规划，LLM 只规划边界，最终切片仍从原文稳定重建。。