GEO 周期自动协同（Autopilot）

主路径：由用户在 QClaw 配置每日定时（本项目不实现 cron），定时仅加载本 skill。

前置（本 skill 可独立运行，不依赖 geo-opt-coordinator）

读取密钥

1. 依次读取 ~/.qclaw/geo-api-key、~/.openclaw/geo-api-key；存在且非空则使用
2. 若不存在或为空：向用户索要 GEO API Key，提示在 SaaS 账户设置 → 龙虾密钥 创建，并保存：

   echo -n "\x3C用户提供的key>" > ~/.qclaw/geo-api-key
   

3. 用户说「更换 key / 重置 key」时：删除上述文件后重新索要

GEO_KEY=$(cat ~/.qclaw/geo-api-key 2>/dev/null || cat ~/.openclaw/geo-api-key 2>/dev/null)
BASE="https://ai.gaobobo.cn"

验证密钥（业务请求前必做）

curl -s -X POST "$BASE/api/geo/verify-key" \
  -H "Authorization: Bearer $GEO_KEY"

• 返回 code: 0 且 message 含「验证通过」→ 继续下文
• HTTP 401/403 或 code != 0 → 立即停止，告知用户密钥无效或已吊销，请到 SaaS 重新创建并更新本机 key 文件
• 不要在未验证通过时调用 optimization / export 等接口

其他前置

• QClaw web_fetch 可用
• SaaS 智能优化任务已开启 OpenClaw 协同 与（若需仿写）深度仿写

本机目录约定

~/.qclaw/geo-exports/{brand}_{product}_C{cycle}/fanwen/fanwen.zip
~/.qclaw/geo-exports/{brand}_{product}_C{cycle}/fangxie/fangxie.zip

Windows：%USERPROFILE%\.qclaw\geo-exports\...

1. 拉取任务

curl -s "$BASE/api/geo/optimization/tasks" -H "Authorization: Bearer $GEO_KEY"

对每个 items[] 读取 task、latestCycle、openclawActions（勿向用户索要 OPT-ID）。

2. 范文：导出并上报

当 openclawActions.needsFanwenExport == true：

OPT_ID="\x3Ctask.taskId 内部用>"
CYCLE=\x3ClatestCycle.cycleNumber>
BRAND="\x3Ctask.brandName>"
PRODUCT="\x3Ctask.productName>"
DIR="$HOME/.qclaw/geo-exports/${BRAND}_${PRODUCT}_C${CYCLE}/fanwen"
mkdir -p "$DIR"
curl -fsSL -o "$DIR/fanwen.zip" \
  "$BASE/api/geo/optimization/$OPT_ID/cycles/$CYCLE/export/fanwen.zip" \
  -H "Authorization: Bearer $GEO_KEY"
curl -s -X POST "$BASE/api/geo/optimization/$OPT_ID/cycles/$CYCLE/mass-publish-export" \
  -H "Authorization: Bearer $GEO_KEY" -H "Content-Type: application/json" \
  -d "{\"branch\":\"fanwen\",\"local_path_hint\":\"$DIR\"}"

若 openclawActions.fanwenStatus 已为 completed 且本地已有 fanwen.zip，跳过。

3. 仿写：抓信源 → 成稿 → 导出 → 上报

当 openclawActions.needsFangxieRun == true：

1. GET .../diagnosis/imitate-sources?optimization_task_id=$OPT_ID&cycle_number=$CYCLE
2. 对 Top1–3 URL 仅用 web_fetch(url) 取正文（勿用 Firecrawl）
3. POST .../article/generate-deep-imitate（见 geo-deep-imitate）
4. 轮询 GET .../article/{CG-id}，间隔 ≥30s，直至 status=completed

当 openclawActions.needsFangxieExport == true（或上一步刚完成）：

DIR_FX="$HOME/.qclaw/geo-exports/${BRAND}_${PRODUCT}_C${CYCLE}/fangxie"
mkdir -p "$DIR_FX"
curl -fsSL -o "$DIR_FX/fangxie.zip" \
  "$BASE/api/geo/optimization/$OPT_ID/cycles/$CYCLE/export/fangxie.zip" \
  -H "Authorization: Bearer $GEO_KEY"
curl -s -X POST "$BASE/api/geo/optimization/$OPT_ID/cycles/$CYCLE/mass-publish-export" \
  -H "Authorization: Bearer $GEO_KEY" -H "Content-Type: application/json" \
  -d "{\"branch\":\"fangxie\",\"local_path_hint\":\"$DIR_FX\"}"

openclawActions.fangxieStatus == not_enabled 时跳过仿写分支。

4. 结束

不向用户展示 OPT-ID。可输出内部摘要：品牌、产品、范文状态、仿写状态（读 latestCycle.cycleStepResults.massPublish 或 openclawActions.fanwenStatusLabel / fangxieStatusLabel）。

群发提醒由 geo-mass-publish-check 定时或紧随其后执行。

约束

• 不触发 Celery 优化周期；不替代服务端范文生成
• 群发用本机 融媒宝 + 已导出 Word/ZIP，勿加载 geo-social-publish