GEOFlow多站点内容分发教程：WordPress REST、Agent与通用API一处发布全渠道触达

GEOFlow多站点内容分发教程WordPress REST、Agent与通用API一处发布全渠道触达【免费下载链接】GEOFlowOpen-source GEO content engineering and multi-site distribution platform with AI quality inspection, illustrated admin help, hosted sites, browser-assisted publishing, and signed updates.项目地址: https://gitcode.com/gh_mirrors/geof/GEOFlowGEOFlow 是一款开源的 GEO 内容工程与多站点分发平台内置“分发管理”模块支持通过 WordPress REST API、GEOFlow Agent 目标站协议和通用 HTTP API 三类渠道把本地已发布的文章自动同步到多个外部站点实现一处生产、全渠道触达。本教程带你用最少的步骤把三条分发通道全部跑通。为什么需要 GEOFlow 多站点内容分发很多团队的内容流程是这样的GEOFlow 后台生成并审核文章 → 发布到自有站点 → 再手动登录 WordPress、其他 CMS 或自动化平台逐篇复制。手动搬运不仅慢还容易漏发、错发更没有统一的失败记录。GEOFlow 的分发层设计为“文章发布后的外部分发”本地发布不受影响文章本地发布成功后才触发分发远端失败只会把分发记录标记为失败不会回滚站内文章。三种渠道类型geoflow_agent目标站 Agent、wordpress_restWordPress REST、generic_http_api通用 API另有托管站点作为内置渠道。统一队列与日志所有分发走同一个distribution队列状态机为queued → sending → synced / failed支持重试和日志追踪。分发能力由 app/Services/GeoFlow/DistributionPublisherManager.php 按渠道类型分派到对应发布器核心入口代码app/Services/GeoFlow/WordPressRestPublisher.phpapp/Services/GeoFlow/GeoFlowAgentPublisher.phpapp/Services/GeoFlow/GenericHttpApiPublisher.php三种分发渠道怎么选渠道适合场景认证方式特点WordPress REST公司博客、GEO 子频道等 WordPress 站点Application Password文章发布/更新/删除、图片上传媒体库、分类匹配与创建、标签同步、站点设置同步GEOFlow Agent自研站点、静态站或任何能跑一段 PHP 的目标站HMAC 签名密钥目标站只需实现两个接口签名校验、时间窗口、幂等键齐全通用 API第三方 CMS、n8n/Zapier 类自动化平台、自研内容系统无认证 / Bearer / Basic / Header Key / HMAC每个动作可独立配置方法与路径支持响应字段映射官方方案文档docs/distribution/unified-distribution-implementation-plan.md 和 docs/distribution/generic-api-distribution-implementation-plan.md。渠道一连接 WordPress REST 站点最快上手WordPress 渠道不需要任何目标站插件全程后台配置在 WordPress 创建应用密码进入 WordPress 后台 → 用户资料 → “Application Password应用密码”新建一个只授予文章管理权限的密码。GEOFlow 不保存你的 WordPress 登录密码。在 GEOFlow 新建渠道后台左侧进入“分发管理”→ 点击“新建外部渠道”→ 类型选择WordPress REST填写站点地址、用户名和 Application Password。测试连接点击“测试连接”系统会检查/wp-json可达性并验证当前用户的编辑、发布、上传权限。绑定任务在任务创建/编辑页勾选该渠道即可。配好之后WordPress 渠道会自动完成文章发布与更新/wp/v2/posts、正文本地图片上传到媒体库并替换链接、分类匹配或自动创建、关键词转标签以及站点标题、描述等基础设置同步。渠道二部署 GEOFlow Agent 到目标站如果你的目标是自研站点、静态站或其他 CMSGEOFlow 提供了一个开箱即用的最小 PHP Agent 示例位于 docs/distribution/agent-sample/包含 geoflow-agent.php 入口文件和 config.example.php 配置模板。后台操作只需 5 步在“分发管理”新建渠道类型选GEOFlow Agent填写目标站地址如https://www.example.com。保存后复制密钥 ID和密钥明文密钥只展示一次忘记后超级管理员可用密码重新显示。在目标站部署 Agent 文件配置GEOFLOW_KEY_ID、GEOFLOW_SECRET和存储目录。回到渠道详情页点击“测试连接”通过健康检查。在任务页绑定该渠道之后本地文章发布即自动同步。Agent 协议很简单目标站只需实现两个接口GET /geoflow-agent/v1/health POST /geoflow-agent/v1/articles每个请求都携带X-GEOFlow-Key-Id、时间戳、Nonce、幂等键、请求体 SHA256 和 HMAC-SHA256 签名Agent 必须拒绝过期时间戳、重复 Nonce 和签名不匹配的请求保证重复推送不会产生重复文章。正式接入时可以把默认的“保存 JSON 到本地”逻辑替换为你自己的 CMS 写入代码但不要移除签名校验和幂等键处理。完整说明见 docs/distribution/agent-sample/README.md。渠道三通用 API 对接任意 HTTP 系统第三方 CMS 或自动化平台没有现成适配“通用 API”渠道让你用纯配置完成对接端点配置填写 API 基础地址再为健康检查、发布、更新、删除分别配置 HTTP 方法和路径如POST /articles、DELETE /articles/{remote_id}路径支持{article_id}、{slug}、{remote_id}、{channel_id}变量。认证配置支持无认证、Bearer Token、Basic Auth、Header API Key 和 GEOFlow HMAC 签名五种方式敏感值加密存储。响应映射用点路径如data.id、post.link从外部响应中提取远端 ID 和链接默认成功状态码为200,201,202,204。标准载荷GEOFlow 发送统一的文章载荷Markdown、HTML、分类、作者、图片资产第三方系统按约定解析即可。这样即使没有官方 Provider也能让 GEOFlow 成为 n8n、Zapier、自研内容系统的内容上游。在任务中绑定渠道让文章自动分发渠道建好后绑定动作发生在任务级别而不是单篇文章级别。打开任务创建或编辑页底部有“内容分发”区块——“选择文章本地发布后要同步到的目标站 Agent”勾选一个或多个活跃渠道即可绑定后的自动链路任务生成文章并走本地审核、发布流程文章本地状态变为published时系统创建article_distributions记录并投递ProcessArticleDistributionJob到队列队列按渠道类型选择发布器调用 WordPress / Agent / 通用 API成功后写入远端 ID 与 URL失败则记录错误信息本地文章保持已发布。手动创建或批量改状态发布的文章同样会触发分发同一文章、同一渠道、同一动作重复触发时走幂等更新不会产生重复记录。查看分发状态与排查失败回到“分发管理”首页四个统计卡直接回答日常运营问题外部渠道总数 / 活跃外部渠道渠道是否可用待处理分发有多少在排队或发送中失败分发哪些失败了、原因是什么。渠道详情页展示该渠道最近的分发记录和日志日志记录了 HTTP 方法、端点、状态码和响应摘要方便排查“权限不足、Token 过期、图片上传失败”等问题。文章列表和任务列表也会显示分发摘要失败的任务可以被快速发现并重试。相关实现app/Services/GeoFlow/DistributionOrchestrator.php入队与幂等、app/Jobs/ProcessArticleDistributionJob.php队列执行、app/Http/Controllers/Admin/DistributionController.php后台入口。安全与合规要点渠道密钥使用独立 key/secret不复用后台登录态或 API Tokensecret 加密入库后台只显示掩码。分发日志不记录密钥明文、Authorization 请求头和 Cookie。只分发已发布/已审核文章默认不分发未审核草稿建议保留站内原文链接。使用通用 API 时请自行遵守目标平台的规则多平台分发会放大内容影响GEOFlow 明确反对批量搬运和低质量污染。相关资料与源码路径统一分发方案docs/distribution/unified-distribution-implementation-plan.md多平台长期路线docs/distribution/multi-platform-distribution-plan.md通用 API 方案docs/distribution/generic-api-distribution-implementation-plan.mdAgent 示例包docs/distribution/agent-sample/README.md发布器实现app/Services/GeoFlow/总结GEOFlow 的多站点内容分发把“发一篇、同步 N 站”变成后台点选的事WordPress 用 REST 渠道最快自研站点用 Agent 协议最稳任意 HTTP 系统用通用 API 兜底。配合统一的队列、日志与幂等机制本地发布与远端分发互不干扰——一处发布全渠道触达还随时可查、可重试、可审计。【免费下载链接】GEOFlowOpen-source GEO content engineering and multi-site distribution platform with AI quality inspection, illustrated admin help, hosted sites, browser-assisted publishing, and signed updates.项目地址: https://gitcode.com/gh_mirrors/geof/GEOFlow创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考