--- name: wanjie-api-key description: WanJie/WanJieData API key 三层回退链 — 环境变量占位符 → hermes_env.sh占位符 → config.yaml真key。触发词:WANJIE_API_KEY、apiKey not found、wanjie key、万界方舟 key、GPT Image 2 认证失败。 category: wechat --- # WanJie API Key 管理 ## 问题 GPT Image 2(日报图片生成)通过 WanJie API (`maas-openapi.wanjiedata.com`) 调用,需要 `WANJIE_API_KEY`。但该 key 存在三层来源,前两层在 cron 环境下**都是占位符**。 ## 三层回退链(优先级从高到低) | 层 | 来源 | cron 下行为 | 长度 | 状态 | |---|------|-----------|------|------| | 1 | 环境变量 `WANJIE_API_KEY` | `.bashrc` export 的占位符 | 13 字符 | ❌ 占位符 | | 2 | `su -c 'cat ~/.hermes_env.sh'` | `.hermes_env.sh` 内容同 `.bashrc` | 13 字符 | ❌ 占位符 | | 3 | `~/.hermes/config.yaml` → `model.api_key` | 真实 key | 67 字符 | ✅ 可用 | ## 验证 key 是否有效 ```bash # 检查长度 — 13 = 占位符, 67 = 真 key echo ${#WANJIE_API_KEY} # 运行验证脚本 python3 ~/.hermes/skills/gpt-image-gen/scripts/verify_wanjie_image_key.py ``` ## 修复命令 ```bash # 从 config.yaml 提取真 key 并覆盖环境变量 export WANJIE_API_KEY=$(python3 -c "import yaml; print(yaml.safe_load(open('$HOME/.hermes/config.yaml'))['model']['api_key'])") # 然后运行日报图片生成 python3 ~/.hermes/skills/gpt-image-gen/scripts/gen_daily_1tgo_image.py ``` ## 诊断 - `apiKey not found` + key 长度 13 → 占位符,需要从 config.yaml 提取真 key - `apiKey not found` + key 长度 67 → key 过期或被撤销 - `文生图获取失败` + key 有效 → WanJie 图片服务端故障,等几小时重试 ## Pitfall `gpt-image-gen` skill 的 `scripts/get_wanjie_key.py` 实现了 env → hermes_env.sh 两层回退,**但没有 config.yaml 第三层**。在 cron 下它的 `get_key()` 返回占位符,导致图片生成静默失败(API 返回 400,脚本写空状态文件而不报错)。 由于 `gpt-image-gen` 是手动创建的保护 skill,此脚本暂未修复。cron 调度器在运行日报图片生成前应先覆盖 `WANJIE_API_KEY`。