用途:这是 PKM 发布链中的封面生成环节,为已写好或即将发布的文章产出一张封面位图;公众号场景的 cover.png 可直接作为下游 soia-pkm-publish-wechat-draft 的 --cover 输入。仅做封面,不做排版、发布,不接触账号凭据。
主要能力:Agent 分析内容后推荐五维参数(type/palette/rendering/text/mood)与比例,经确认闸门后生成。默认公众号 2.35:1(900×383),提 X 用 16:9,提小红书用 1:1。生成前须把最终 prompt 落盘 prompts/NN-cover-<slug>.md,重生成使用 cover-v2.png 等递增文件名并保留旧版。
使用方式:安装 npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-cover-image -y。需在 PATH 上有已登录的 codex CLI 作为 v1 唯一生图后端;调用 codex exec 后图片默认落在 ~/.codex/generated_images/<session-id>/,须定位并复制到约定输出路径。若报模型不支持,可读 ~/.codex/models_cache.json 找 supported_in_api=true 的模型,显式加 -m 重试。输出路径优先用户指定,其次 COVER_IMAGE_OUTPUT_DIR,否则与草稿文章同目录;三者皆无时先询问。
适用场景与限制:适用于单张封面生成。禁止用 SVG/HTML/canvas 代码渲染冒充位图;禁止在原图上描字改字,文字问题只能改 prompt 重新生成。不生成插画、文中配图、长图,不做发布。生图效果具不确定性,不保证一次满意。文中配图属 v2 路线图。配置位于 ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-cover-image/config.yml,可用 SOIA_PKM_COVER_IMAGE_CONFIG_FILE 覆盖,不存放秘密值。