GEOFlow CLI完全指南一行命令远程管理GEO实例的任务、素材与文章【免费下载链接】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 CLI 是 GEOFlow 开源项目内置的命令行工具也是连接 GEO 实例的 API v1 客户端。它让你无需打开浏览器就能用一行命令完成远程管理创建和启动内容任务、批量维护关键词库/标题库/图片库等素材、创建与发布文章还能对文章执行 AI 质检复查与 AI 优化。当前版本0.3.0-preview.1还支持多 profile、显式 scope 登录和任务收据等远程管理能力适合把 GEOFlow 接入自己的自动化流程 GEOFlow CLI 是什么为什么需要它简单说GEOFlow CLI 是一个独立运行的geoflow可执行程序独立 PHAR负责配置文件、登录、HTTPS 策略、密钥脱敏、JSON 校验、删除确认和 API 错误提示。和 Web 后台相比它有 3 个突出优势无需 Core 源码独立安装后可在没有 GEOFlow 源码的机器上连接实例密钥更安全Token 自动脱敏、配置文件权限锁定为0600支持从 stdin 读取密码⚙️可脚本化输出标准 JSON、稳定退出码天然适合 CI 和定时任务CLI 源码位于 app/Console/GeoFlowCli/ 目录API 路由定义在 routes/api.php。GEOFlow CLI 安装步骤两种方式任选方式一源码运行适合开发者前提PHP 8.3、已安装 Composer 依赖、可访问一个启用/api/v1的 GEOFlow 实例。git clone https://gitcode.com/gh_mirrors/geof/GEOFlow cd GEOFlow composer install --no-interaction --prefer-dist bin/geoflow --version # 返回 JSON 版本信息 bin/geoflow --help # 查看完整命令列表方式二独立签名包适合纯运维环境从可信渠道取得install.php安装器和信任公钥用一条命令完成安装php /trusted/installer/install.php \ --bundle/absolute/build-output \ --trusted-keys/absolute/trusted-keys.json \ --bin-dir/absolute/bin安装器会核验 Ed25519 签名、版本和 SHA-256 摘要中断后可用--recover恢复安装。详细流程见 packages/geoflow-cli/README.md 与 packages/geoflow-cli/DISTRIBUTION.md。 平台支持macOS、Linux、WSL 为正式支持环境原生 Windows 需手动限制配置文件权限。3步完成登录与配置profile、Token 与环境变量第 1 步初始化配置。已有 Token 的话一条命令写入默认配置文件bin/geoflow config init --base-url https://geoflow.example.com自动化环境可用--token-stdin从 stdin 读取 Token避免密钥出现在命令行参数里。第 2 步登录实例。交互登录会隐藏密码bin/geoflow login --base-url https://geoflow.example.com --username admin新版还支持--scopes显式申请权限如--scopes sites:read,themes:read并可用--profile staging把登录结果写入指定 profile实现多实例一键切换geoflow whoami --profile staging # 核对当前身份 geoflow capabilities --profile staging # 查看实例支持的能力 geoflow doctor --profile staging # 检查连接健康状况 geoflow profile bind --instance-id UUID --admin-id ID # 固定旧 profile 身份第 3 步核对配置来源。config show会显示脱敏 Token、endpoint 与凭据的来源和绑定状态。CLI 支持的环境变量配置项环境变量系统地址GEOFLOW_BASE_URLTokenGEOFLOW_TOKEN、GEOFLOW_API_TOKEN超时秒数GEOFLOW_TIMEOUT配置文件按优先级选择--profile NAME→--config PATH→ 当前目录.geoflow.json→~/.config/geoflow/config.json。 安全细节CLI 会拒绝可能把 Token 发往错误主机的 endpoint/凭据组合完整规则见 docs/GEOFLOW_CLI.md。任务管理从创建、启动到查看执行记录任务Task是 GEOFlow 内容生产的引擎。用 CLI 管理任务全程无需离开终端# 查看任务列表支持分页、状态过滤、搜索 geoflow task list --status running --search 测试 # 从 JSON 文件创建任务name、title_library_id、prompt_id、ai_model_id、need_review 必填 geoflow task create --json ./task.json --idempotency-key task-create-001 # 启动任务并立即入队查看最近 20 条执行记录 geoflow task start 12 --enqueue-now --idempotency-key task-start-12 geoflow task jobs 12 --limit 20 geoflow job get 88⚠️ 创建任务时必须显式提供need_review1表示每篇人工审核0表示通过风险检查及已启用的 AI 质检后自动发布。CLI 会在请求前拒绝缺少审核策略的输入帮你避免配置疏漏。创建前建议先跑一次geoflow catalog返回模型、提示词、关键词库、标题库、图片库、知识库、作者和分类确认task.json中引用的 ID 都存在。素材管理关键词库、标题库、图片库与知识库批量操作material命令族覆盖 6 种素材类型categories分类、authors作者、keywords关键词库、titles标题库、images图片库、knowledge知识库。geoflow material summary # 一眼看全各素材库总量 geoflow material list keywords --search CRM # 列出关键词库 geoflow material get titles 34 # 查看某个标题库 geoflow material item-create titles 34 --json ./items.json # 批量新增条目上传封面图只需一行仅images类型支持geoflow material item-upload images 9 --image ./cover.png --idempotency-key image-upload-001删除操作需要交互确认非交互环境加--yes支持--ids 101,102批量删除条目。注意知识库条目是系统自动切块的只读资源修改知识库正文后系统会重建切块。文章全流程管理创建、审核、AI 质检到发布article命令族是 GEOFlow CLI 的重头戏覆盖文章从创建到发布含 AI 质检与 AI 优化的完整生命周期命令作用article list按任务、状态、AI 质检状态、作者、关键词检索article create支持--json或--title、--content-file等直接字段article review记录人工审核保留当前发布安排article publish/schedule/hold立即发布 / 按任务间隔排队 / 保留人工发布意图article ai-quality-status查看 AI 质检阶段、耗时与安全错误码article ai-quality-recheck让旧质检结果失效并重新排队article ai-optimize生成影子候选不动正文可再ai-optimization-apply应用article trash移入回收站一个典型的创建 → 审核 → 发布流程geoflow article create --title CLI article --content-file ./article.md \ --author-id 5 --category-id 2 --idempotency-key article-create-001 geoflow article review 101 --status approved --note Reviewed geoflow article publish 101 --idempotency-key article-publish-101 四个动作review/schedule/publish/hold都支持--workflow-version N乐观锁版本冲突返回 409刷新文章后重试即可。AI 优化默认生成影子候选正式文章保持原状应用候选时必须显式提交运行 ID 与候选哈希防止误覆盖。安全设计亮点为什么敢在终端跑生产操作GEOFlow CLI 在安全性上做了不少防御性设计值得了解HTTPS 优先无协议地址自动补https://仅回环地址允许 HTTP远程 HTTP 必须显式--allow-insecure-http且始终验证证书、不跟随重定向密钥脱敏配置文件权限0600、默认配置目录0700输出中的 Token 自动脱敏幂等键与任务收据创建、更新、发布等操作可用--idempotency-key防重复api tasks.enqueue使用--client-request-id续接响应丢失后可查询收据而非盲目重发响应上限拒绝超过 5 MiB 的响应要求 identity 编码杜绝中间人压缩劫持️删除保护task delete、material delete等默认交互确认--yes只确认当前命令的精确目标服务端权限与资源锁仍然有效Docker 环境中运行 GEOFlow CLI如果你用 Compose 部署一行exec即可进入应用容器执行docker compose exec app php bin/geoflow --version docker compose exec app php bin/geoflow --config /path/in/container/profile.json catalog生产环境显式指定 Compose 文件docker compose --env-file .env.prod -f docker-compose.prod.yml exec app php bin/geoflow --version建议通过只读 secret mount 提供 profile避免把 Token 写进镜像层或可公开的环境文件。常见问题快速排障现象处理建议401Token 无效或过期重新login或更新 Token403Token 缺少所需 scope签发最小权限 Token409幂等冲突或版本冲突先读取资源当前状态返回 HTML 而非 JSONbase_url应指向 Web 根地址别带/api/v1或后台路径429按retry_after字段等待勿重复登录删除在非交互环境失败先get确认 ID再为精确删除命令加--yes进阶远程管理预览版能力0.3.0-preview 已新增多 profile、显式 scope、whoami/capabilities/doctor连接核对、当前令牌撤销logout、任务收据以及主站主题草稿、原子文件修改与签名预览通过api theme-workspaces.*系列操作。注意主题发布、统一回滚和完整后台管理尚未开放边界与未开放项见 docs/api/remote-management-preview.md。参考资料 CLI 完整文档docs/GEOFLOW_CLI.md英文版 docs/GEOFLOW_CLI_en.md 独立 CLI 构建与安装packages/geoflow-cli/README.md 远程管理覆盖说明docs/api/remote-management-preview.md️ CLI 源码目录app/Console/GeoFlowCli/ API v1 路由routes/api.php从三行命令登录到一行命令发布文章GEOFlow CLI 让你把 GEO 内容生产的任务、素材与文章管理全部搬进终端。先在测试实例上跑一遍catalog → task list → article list的只读核对再逐步启用写操作是最稳妥的上手路径 【免费下载链接】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），仅供参考 GEOFlow CLI完全指南：一行命令远程管理GEO实例的任务、素材与文章
GEOFlow CLI完全指南一行命令远程管理GEO实例的任务、素材与文章【免费下载链接】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 CLI 是 GEOFlow 开源项目内置的命令行工具也是连接 GEO 实例的 API v1 客户端。它让你无需打开浏览器就能用一行命令完成远程管理创建和启动内容任务、批量维护关键词库/标题库/图片库等素材、创建与发布文章还能对文章执行 AI 质检复查与 AI 优化。当前版本0.3.0-preview.1还支持多 profile、显式 scope 登录和任务收据等远程管理能力适合把 GEOFlow 接入自己的自动化流程 GEOFlow CLI 是什么为什么需要它简单说GEOFlow CLI 是一个独立运行的geoflow可执行程序独立 PHAR负责配置文件、登录、HTTPS 策略、密钥脱敏、JSON 校验、删除确认和 API 错误提示。和 Web 后台相比它有 3 个突出优势无需 Core 源码独立安装后可在没有 GEOFlow 源码的机器上连接实例密钥更安全Token 自动脱敏、配置文件权限锁定为0600支持从 stdin 读取密码⚙️可脚本化输出标准 JSON、稳定退出码天然适合 CI 和定时任务CLI 源码位于 app/Console/GeoFlowCli/ 目录API 路由定义在 routes/api.php。GEOFlow CLI 安装步骤两种方式任选方式一源码运行适合开发者前提PHP 8.3、已安装 Composer 依赖、可访问一个启用/api/v1的 GEOFlow 实例。git clone https://gitcode.com/gh_mirrors/geof/GEOFlow cd GEOFlow composer install --no-interaction --prefer-dist bin/geoflow --version # 返回 JSON 版本信息 bin/geoflow --help # 查看完整命令列表方式二独立签名包适合纯运维环境从可信渠道取得install.php安装器和信任公钥用一条命令完成安装php /trusted/installer/install.php \ --bundle/absolute/build-output \ --trusted-keys/absolute/trusted-keys.json \ --bin-dir/absolute/bin安装器会核验 Ed25519 签名、版本和 SHA-256 摘要中断后可用--recover恢复安装。详细流程见 packages/geoflow-cli/README.md 与 packages/geoflow-cli/DISTRIBUTION.md。 平台支持macOS、Linux、WSL 为正式支持环境原生 Windows 需手动限制配置文件权限。3步完成登录与配置profile、Token 与环境变量第 1 步初始化配置。已有 Token 的话一条命令写入默认配置文件bin/geoflow config init --base-url https://geoflow.example.com自动化环境可用--token-stdin从 stdin 读取 Token避免密钥出现在命令行参数里。第 2 步登录实例。交互登录会隐藏密码bin/geoflow login --base-url https://geoflow.example.com --username admin新版还支持--scopes显式申请权限如--scopes sites:read,themes:read并可用--profile staging把登录结果写入指定 profile实现多实例一键切换geoflow whoami --profile staging # 核对当前身份 geoflow capabilities --profile staging # 查看实例支持的能力 geoflow doctor --profile staging # 检查连接健康状况 geoflow profile bind --instance-id UUID --admin-id ID # 固定旧 profile 身份第 3 步核对配置来源。config show会显示脱敏 Token、endpoint 与凭据的来源和绑定状态。CLI 支持的环境变量配置项环境变量系统地址GEOFLOW_BASE_URLTokenGEOFLOW_TOKEN、GEOFLOW_API_TOKEN超时秒数GEOFLOW_TIMEOUT配置文件按优先级选择--profile NAME→--config PATH→ 当前目录.geoflow.json→~/.config/geoflow/config.json。 安全细节CLI 会拒绝可能把 Token 发往错误主机的 endpoint/凭据组合完整规则见 docs/GEOFLOW_CLI.md。任务管理从创建、启动到查看执行记录任务Task是 GEOFlow 内容生产的引擎。用 CLI 管理任务全程无需离开终端# 查看任务列表支持分页、状态过滤、搜索 geoflow task list --status running --search 测试 # 从 JSON 文件创建任务name、title_library_id、prompt_id、ai_model_id、need_review 必填 geoflow task create --json ./task.json --idempotency-key task-create-001 # 启动任务并立即入队查看最近 20 条执行记录 geoflow task start 12 --enqueue-now --idempotency-key task-start-12 geoflow task jobs 12 --limit 20 geoflow job get 88⚠️ 创建任务时必须显式提供need_review1表示每篇人工审核0表示通过风险检查及已启用的 AI 质检后自动发布。CLI 会在请求前拒绝缺少审核策略的输入帮你避免配置疏漏。创建前建议先跑一次geoflow catalog返回模型、提示词、关键词库、标题库、图片库、知识库、作者和分类确认task.json中引用的 ID 都存在。素材管理关键词库、标题库、图片库与知识库批量操作material命令族覆盖 6 种素材类型categories分类、authors作者、keywords关键词库、titles标题库、images图片库、knowledge知识库。geoflow material summary # 一眼看全各素材库总量 geoflow material list keywords --search CRM # 列出关键词库 geoflow material get titles 34 # 查看某个标题库 geoflow material item-create titles 34 --json ./items.json # 批量新增条目上传封面图只需一行仅images类型支持geoflow material item-upload images 9 --image ./cover.png --idempotency-key image-upload-001删除操作需要交互确认非交互环境加--yes支持--ids 101,102批量删除条目。注意知识库条目是系统自动切块的只读资源修改知识库正文后系统会重建切块。文章全流程管理创建、审核、AI 质检到发布article命令族是 GEOFlow CLI 的重头戏覆盖文章从创建到发布含 AI 质检与 AI 优化的完整生命周期命令作用article list按任务、状态、AI 质检状态、作者、关键词检索article create支持--json或--title、--content-file等直接字段article review记录人工审核保留当前发布安排article publish/schedule/hold立即发布 / 按任务间隔排队 / 保留人工发布意图article ai-quality-status查看 AI 质检阶段、耗时与安全错误码article ai-quality-recheck让旧质检结果失效并重新排队article ai-optimize生成影子候选不动正文可再ai-optimization-apply应用article trash移入回收站一个典型的创建 → 审核 → 发布流程geoflow article create --title CLI article --content-file ./article.md \ --author-id 5 --category-id 2 --idempotency-key article-create-001 geoflow article review 101 --status approved --note Reviewed geoflow article publish 101 --idempotency-key article-publish-101 四个动作review/schedule/publish/hold都支持--workflow-version N乐观锁版本冲突返回 409刷新文章后重试即可。AI 优化默认生成影子候选正式文章保持原状应用候选时必须显式提交运行 ID 与候选哈希防止误覆盖。安全设计亮点为什么敢在终端跑生产操作GEOFlow CLI 在安全性上做了不少防御性设计值得了解HTTPS 优先无协议地址自动补https://仅回环地址允许 HTTP远程 HTTP 必须显式--allow-insecure-http且始终验证证书、不跟随重定向密钥脱敏配置文件权限0600、默认配置目录0700输出中的 Token 自动脱敏幂等键与任务收据创建、更新、发布等操作可用--idempotency-key防重复api tasks.enqueue使用--client-request-id续接响应丢失后可查询收据而非盲目重发响应上限拒绝超过 5 MiB 的响应要求 identity 编码杜绝中间人压缩劫持️删除保护task delete、material delete等默认交互确认--yes只确认当前命令的精确目标服务端权限与资源锁仍然有效Docker 环境中运行 GEOFlow CLI如果你用 Compose 部署一行exec即可进入应用容器执行docker compose exec app php bin/geoflow --version docker compose exec app php bin/geoflow --config /path/in/container/profile.json catalog生产环境显式指定 Compose 文件docker compose --env-file .env.prod -f docker-compose.prod.yml exec app php bin/geoflow --version建议通过只读 secret mount 提供 profile避免把 Token 写进镜像层或可公开的环境文件。常见问题快速排障现象处理建议401Token 无效或过期重新login或更新 Token403Token 缺少所需 scope签发最小权限 Token409幂等冲突或版本冲突先读取资源当前状态返回 HTML 而非 JSONbase_url应指向 Web 根地址别带/api/v1或后台路径429按retry_after字段等待勿重复登录删除在非交互环境失败先get确认 ID再为精确删除命令加--yes进阶远程管理预览版能力0.3.0-preview 已新增多 profile、显式 scope、whoami/capabilities/doctor连接核对、当前令牌撤销logout、任务收据以及主站主题草稿、原子文件修改与签名预览通过api theme-workspaces.*系列操作。注意主题发布、统一回滚和完整后台管理尚未开放边界与未开放项见 docs/api/remote-management-preview.md。参考资料 CLI 完整文档docs/GEOFLOW_CLI.md英文版 docs/GEOFLOW_CLI_en.md 独立 CLI 构建与安装packages/geoflow-cli/README.md 远程管理覆盖说明docs/api/remote-management-preview.md️ CLI 源码目录app/Console/GeoFlowCli/ API v1 路由routes/api.php从三行命令登录到一行命令发布文章GEOFlow CLI 让你把 GEO 内容生产的任务、素材与文章管理全部搬进终端。先在测试实例上跑一遍catalog → task list → article list的只读核对再逐步启用写操作是最稳妥的上手路径 【免费下载链接】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），仅供参考