GEOFlow多站點內(nèi)容分發(fā)教程WordPress REST、Agent與通用API一處發(fā)布全渠道觸達【免費下載鏈接】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 內(nèi)容工程與多站點分發(fā)平臺內(nèi)置“分發(fā)管理”模塊支持通過 WordPress REST API、GEOFlow Agent 目標(biāo)站協(xié)議和通用 HTTP API 三類渠道把本地已發(fā)布的文章自動同步到多個外部站點實現(xiàn)一處生產(chǎn)、全渠道觸達。本教程帶你用最少的步驟把三條分發(fā)通道全部跑通。為什么需要 GEOFlow 多站點內(nèi)容分發(fā)很多團隊的內(nèi)容流程是這樣的GEOFlow 后臺生成并審核文章 → 發(fā)布到自有站點 → 再手動登錄 WordPress、其他 CMS 或自動化平臺逐篇復(fù)制。手動搬運不僅慢還容易漏發(fā)、錯發(fā)更沒有統(tǒng)一的失敗記錄。GEOFlow 的分發(fā)層設(shè)計為“文章發(fā)布后的外部分發(fā)”本地發(fā)布不受影響文章本地發(fā)布成功后才觸發(fā)分發(fā)遠端失敗只會把分發(fā)記錄標(biāo)記為失敗不會回滾站內(nèi)文章。三種渠道類型geoflow_agent目標(biāo)站 Agent、wordpress_restWordPress REST、generic_http_api通用 API另有托管站點作為內(nèi)置渠道。統(tǒng)一隊列與日志所有分發(fā)走同一個distribution隊列狀態(tài)機為queued → sending → synced / failed支持重試和日志追蹤。分發(fā)能力由 app/Services/GeoFlow/DistributionPublisherManager.php 按渠道類型分派到對應(yīng)發(fā)布器核心入口代碼app/Services/GeoFlow/WordPressRestPublisher.phpapp/Services/GeoFlow/GeoFlowAgentPublisher.phpapp/Services/GeoFlow/GenericHttpApiPublisher.php三種分發(fā)渠道怎么選渠道適合場景認證方式特點WordPress REST公司博客、GEO 子頻道等 WordPress 站點Application Password文章發(fā)布/更新/刪除、圖片上傳媒體庫、分類匹配與創(chuàng)建、標(biāo)簽同步、站點設(shè)置同步GEOFlow Agent自研站點、靜態(tài)站或任何能跑一段 PHP 的目標(biāo)站HMAC 簽名密鑰目標(biāo)站只需實現(xiàn)兩個接口簽名校驗、時間窗口、冪等鍵齊全通用 API第三方 CMS、n8n/Zapier 類自動化平臺、自研內(nèi)容系統(tǒng)無認證 / Bearer / Basic / Header Key / HMAC每個動作可獨立配置方法與路徑支持響應(yīng)字段映射官方方案文檔docs/distribution/unified-distribution-implementation-plan.md 和 docs/distribution/generic-api-distribution-implementation-plan.md。渠道一連接 WordPress REST 站點最快上手WordPress 渠道不需要任何目標(biāo)站插件全程后臺配置在 WordPress 創(chuàng)建應(yīng)用密碼進入 WordPress 后臺 → 用戶資料 → “Application Password應(yīng)用密碼”新建一個只授予文章管理權(quán)限的密碼。GEOFlow 不保存你的 WordPress 登錄密碼。在 GEOFlow 新建渠道后臺左側(cè)進入“分發(fā)管理”→ 點擊“新建外部渠道”→ 類型選擇WordPress REST填寫站點地址、用戶名和 Application Password。測試連接點擊“測試連接”系統(tǒng)會檢查/wp-json可達性并驗證當(dāng)前用戶的編輯、發(fā)布、上傳權(quán)限。綁定任務(wù)在任務(wù)創(chuàng)建/編輯頁勾選該渠道即可。配好之后WordPress 渠道會自動完成文章發(fā)布與更新/wp/v2/posts、正文本地圖片上傳到媒體庫并替換鏈接、分類匹配或自動創(chuàng)建、關(guān)鍵詞轉(zhuǎn)標(biāo)簽以及站點標(biāo)題、描述等基礎(chǔ)設(shè)置同步。渠道二部署 GEOFlow Agent 到目標(biāo)站如果你的目標(biāo)是自研站點、靜態(tài)站或其他 CMSGEOFlow 提供了一個開箱即用的最小 PHP Agent 示例位于 docs/distribution/agent-sample/包含 geoflow-agent.php 入口文件和 config.example.php 配置模板。后臺操作只需 5 步在“分發(fā)管理”新建渠道類型選GEOFlow Agent填寫目標(biāo)站地址如https://www.example.com。保存后復(fù)制密鑰 ID和密鑰明文密鑰只展示一次忘記后超級管理員可用密碼重新顯示。在目標(biāo)站部署 Agent 文件配置GEOFLOW_KEY_ID、GEOFLOW_SECRET和存儲目錄?；氐角涝斍轫擖c擊“測試連接”通過健康檢查。在任務(wù)頁綁定該渠道之后本地文章發(fā)布即自動同步。Agent 協(xié)議很簡單目標(biāo)站只需實現(xiàn)兩個接口GET /geoflow-agent/v1/health POST /geoflow-agent/v1/articles每個請求都攜帶X-GEOFlow-Key-Id、時間戳、Nonce、冪等鍵、請求體 SHA256 和 HMAC-SHA256 簽名Agent 必須拒絕過期時間戳、重復(fù) Nonce 和簽名不匹配的請求保證重復(fù)推送不會產(chǎn)生重復(fù)文章。正式接入時可以把默認的“保存 JSON 到本地”邏輯替換為你自己的 CMS 寫入代碼但不要移除簽名校驗和冪等鍵處理。完整說明見 docs/distribution/agent-sample/README.md。渠道三通用 API 對接任意 HTTP 系統(tǒng)第三方 CMS 或自動化平臺沒有現(xiàn)成適配“通用 API”渠道讓你用純配置完成對接端點配置填寫 API 基礎(chǔ)地址再為健康檢查、發(fā)布、更新、刪除分別配置 HTTP 方法和路徑如POST /articles、DELETE /articles/{remote_id}路徑支持{article_id}、{slug}、{remote_id}、{channel_id}變量。認證配置支持無認證、Bearer Token、Basic Auth、Header API Key 和 GEOFlow HMAC 簽名五種方式敏感值加密存儲。響應(yīng)映射用點路徑如data.id、post.link從外部響應(yīng)中提取遠端 ID 和鏈接默認成功狀態(tài)碼為200,201,202,204。標(biāo)準(zhǔn)載荷GEOFlow 發(fā)送統(tǒng)一的文章載荷Markdown、HTML、分類、作者、圖片資產(chǎn)第三方系統(tǒng)按約定解析即可。這樣即使沒有官方 Provider也能讓 GEOFlow 成為 n8n、Zapier、自研內(nèi)容系統(tǒng)的內(nèi)容上游。在任務(wù)中綁定渠道讓文章自動分發(fā)渠道建好后綁定動作發(fā)生在任務(wù)級別而不是單篇文章級別。打開任務(wù)創(chuàng)建或編輯頁底部有“內(nèi)容分發(fā)”區(qū)塊——“選擇文章本地發(fā)布后要同步到的目標(biāo)站 Agent”勾選一個或多個活躍渠道即可綁定后的自動鏈路任務(wù)生成文章并走本地審核、發(fā)布流程文章本地狀態(tài)變?yōu)閜ublished時系統(tǒng)創(chuàng)建article_distributions記錄并投遞ProcessArticleDistributionJob到隊列隊列按渠道類型選擇發(fā)布器調(diào)用 WordPress / Agent / 通用 API成功后寫入遠端 ID 與 URL失敗則記錄錯誤信息本地文章保持已發(fā)布。手動創(chuàng)建或批量改狀態(tài)發(fā)布的文章同樣會觸發(fā)分發(fā)同一文章、同一渠道、同一動作重復(fù)觸發(fā)時走冪等更新不會產(chǎn)生重復(fù)記錄。查看分發(fā)狀態(tài)與排查失敗回到“分發(fā)管理”首頁四個統(tǒng)計卡直接回答日常運營問題外部渠道總數(shù) / 活躍外部渠道渠道是否可用待處理分發(fā)有多少在排隊或發(fā)送中失敗分發(fā)哪些失敗了、原因是什么。渠道詳情頁展示該渠道最近的分發(fā)記錄和日志日志記錄了 HTTP 方法、端點、狀態(tài)碼和響應(yīng)摘要方便排查“權(quán)限不足、Token 過期、圖片上傳失敗”等問題。文章列表和任務(wù)列表也會顯示分發(fā)摘要失敗的任務(wù)可以被快速發(fā)現(xiàn)并重試。相關(guān)實現(xiàn)app/Services/GeoFlow/DistributionOrchestrator.php入隊與冪等、app/Jobs/ProcessArticleDistributionJob.php隊列執(zhí)行、app/Http/Controllers/Admin/DistributionController.php后臺入口。安全與合規(guī)要點渠道密鑰使用獨立 key/secret不復(fù)用后臺登錄態(tài)或 API Tokensecret 加密入庫后臺只顯示掩碼。分發(fā)日志不記錄密鑰明文、Authorization 請求頭和 Cookie。只分發(fā)已發(fā)布/已審核文章默認不分發(fā)未審核草稿建議保留站內(nèi)原文鏈接。使用通用 API 時請自行遵守目標(biāo)平臺的規(guī)則多平臺分發(fā)會放大內(nèi)容影響GEOFlow 明確反對批量搬運和低質(zhì)量污染。相關(guān)資料與源碼路徑統(tǒng)一分發(fā)方案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發(fā)布器實現(xiàn)app/Services/GeoFlow/總結(jié)GEOFlow 的多站點內(nèi)容分發(fā)把“發(fā)一篇、同步 N 站”變成后臺點選的事WordPress 用 REST 渠道最快自研站點用 Agent 協(xié)議最穩(wěn)任意 HTTP 系統(tǒng)用通用 API 兜底。配合統(tǒng)一的隊列、日志與冪等機制本地發(fā)布與遠端分發(fā)互不干擾——一處發(fā)布全渠道觸達還隨時可查、可重試、可審計?！久赓M下載鏈接】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創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考