Geo Mass Publish Check

SKILL.md

---
name: geo-mass-publish-check
description: GEO 待群发检查 — 查询范文/仿写双状态，可群发时提示用户用融媒宝发布。供 QClaw 定时或 autopilot 之后执行；消息发送由 QClaw/微信完成。
---

# GEO 待群发检查

在 **geo-cycle-autopilot** 之后运行，或由用户单独配置定时（例如每日 8:05）。

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

### 读取密钥

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

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

### 验证密钥（查询前必做）

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

- 返回 `code: 0` → 继续下文
- HTTP 401/403 或 `code != 0` → **立即停止**，告知用户密钥无效或已吊销，请到 SaaS 重新创建并更新本机 key 文件

## 1. 查询可群发任务

```bash
curl -s "$BASE/api/geo/optimization/mass-publish/pending" \
  -H "Authorization: Bearer $GEO_KEY"
```

返回 `data.items[]`，每项含：

- `brandName`、`productName`、`cycleNumber`
- `fanwenStatusLabel`、`fangxieStatusLabel`（**必须同时回报两个状态**）
- `fanwenLocalPath`、`fangxieLocalPath`（已完成导出时的本机路径提示）

**可群发**条件：范文或仿写**任一侧**已 `completed`（已导出并上报）。

## 2. 回报用户（固定话术模板）

对每条 `items` 输出（由 QClaw 发到微信或桌面，本项目不实现推送通道）：

```text
【GEO 待群发】{brandName} · {productName} · 第 {cycleNumber} 周期
范文：{fanwenStatusLabel}
仿写：{fangxieStatusLabel}
范文文件：{fanwenLocalPath 或「—」}
仿写文件：{fangxieLocalPath 或「—」}
请打开融媒宝 → 批量导入 Word/ZIP → 选择上述目录中的文件发布。
安装说明见 SaaS「群发助手（融媒宝）安装指南」。
```

若无 `items` 或为空：简短说明「当前没有待群发任务，范文/仿写仍在生成或待导出」。

## 3. 可选：全量列表对照

也可 `GET /api/geo/optimization/tasks`，逐条读取 `latestCycle.cycleStepResults.massPublish` 与 `openclawActions`，对 `canMassPublish=false` 的任务仅汇报双状态、不强调融媒宝。

## 约束

- 勿要求用户输入 OPT-ID
- 不执行发帖；发布结果不回写 SaaS