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 提取真 keyapiKey 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。