SKILL.md 2.14 KB

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 是否有效

# 检查长度 — 13 = 占位符, 67 = 真 key
echo ${#WANJIE_API_KEY}

# 运行验证脚本
python3 ~/.hermes/skills/gpt-image-gen/scripts/verify_wanjie_image_key.py

修复命令

# 从 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。