用途:在已部署 GEOFlow API 与 bin/geoflow CLI 的环境中,用本地命令操作现有系统,而非实现或重构后端代码。
主要能力:CLI 预检;查询模型、提示词、标题库、作者、分类与知识库 ID;任务创建、更新、启动、停止、入队与状态查看;作业检查;文章草稿上传、更新、审核、发布与移入回收站;写入操作使用幂等键以保证安全。
使用前提:确认工作区存在 bin/geoflow;确认 CLI 可通过 --config、环境变量或默认路径解析配置。无配置时先向用户获取 GEOFlow 地址与管理员用户名,执行 geoflow login(密码由 CLI 提示输入,不采用明文回显)。若已配置但鉴权读取返回 401/403 或 token 失效,用 geoflow login --force 重新登录,不要默认判定为已登录。新工作区首个写操作前运行预检脚本,只有鉴权读取成功才算通过,config show 仅证明本地配置可解析,不代表 API 可达或 token 有效;预检失败应停止并报告缺失前提。
必要用法:优先直接执行 "/path/to/workspace/bin/geoflow" --config /path/to/config ...;文件存在但不可执行时改用 php "/path/to/workspace/bin/geoflow" --config /path/to/config ...。查询资源先运行 catalog 以从系统获取 ID,不凭记忆填写。写操作须带显式 --idempotency-key,写后立即用对应读取命令核实持久化状态。发布后按系统 slug 路由验证前端 URL,发布 URL 形如 /article/{slug},slug 须为 8 位短 ASCII;若不符则视为 URL 规则不匹配并报告,不要使用 article.php?id=... 兼容链接。
常见流程示例: catalog
task create --json ./task.json --idempotency-key task-create-001 task start 12 --idempotency-key task-start-12 task enqueue 12 --idempotency-key task-enqueue-12 job get 88
article create --title "标题" --content-file ./article.md --task-id 12 --author-id 5 --category-id 2 --idempotency-key article-create-001 article review 101 --status approved --note "CLI review pass" --idempotency-key article-review-101 article publish 101 --idempotency-key article-publish-101
若作业因业务数据失败(如没有可用的标题),应区分 CLI/API 成功与业务数据问题,不要反复重试。用户仅需发布链路冒烟测试时,先停止活跃或排队的任务,再走 article create + article review + article publish 验证发布链路。
限制:不覆盖后端代码实现或重构、直接写数据库或绕过 /api/v1、仅存在于 Web 后台的流程、当前 CLI 之外的 URL 导入/标题异步生成/图片上传编排、以及超出 CLI 与 API 返回范围的 worker 内部调试。也不要凭记忆编造前端文章 URL 规则,应先读取系统当前路由或规范行为。报告中应简明列出执行的命令、涉及的资源 ID 与结果状态,除用户明确要求外不打印完整 token。