AWS Wechat Article Assets

公众号素材与预设（Assets）

素材与预设统一管理 —— 图片入库 + .aws 预设包导入，多 skill 复用同一套内容资产。

套件说明 · 本 skill 属 aws-wechat-article-* 一条龙套件（共 9 个 slug，入口 aws-wechat-article-main）。跨 skill 的相对引用依赖同一 skills/ 目录，建议一并 clawhub install 全套。源码：https://github.com/aiworkskills/wechat-article-skills

能力披露（Capabilities）

本 skill 管理本地素材与预设包，可选从 aiworkskills.cn 域下载 .aws 预设包（ZIP 格式）。

• 凭证：无
• 网络：可选 https://*.aiworkskills.cn/**/*.aws 下载预设包。白名单强制：仅 HTTPS + aiworkskills.cn 子域，非白名单会直接报错退出。调试参数 --allow-any-host 可放宽但不推荐生产使用
• 文件读：用户指定的本地图片路径或 .aws 文件
• 文件写：仓库内 .aws-article/assets/stock/images/*（图片 + 同名 .md）、.aws-article/presets/<子目录>/*（预设文件）、.aws-article/downloads/*.aws（下载缓存）、.aws-article/tmp/*（解压临时目录）
• 归档：解压 .aws 扩展名的 ZIP 到 .aws-article/tmp/，按白名单子目录合并到 .aws-article/presets/。已内置 ZIP slip 防御：逐项校验 ZIP 成员路径，拒绝含绝对路径、.. 段或解析后指向解压目录外的路径，任一违反立即退出不写入任何文件
• shell：仅 python3 {baseDir}/scripts/stock_image_ingest.py、import_presets_aws.py

所有写入限制在仓库根下的 .aws-article/ 内。

配套 skill（informational）

本 skill 是 aws-wechat-article-* 一条龙公众号套件的素材与预设环节（入口 aws-wechat-article-main）。

• 单独安装可用：素材入库 / .aws 预设导入两个脚本都不依赖兄弟 skill，只要 .aws-article/ 目录就能工作。
• 其他 skill 读取 .aws-article/assets/stock/images/ 和 .aws-article/presets/ 里由本 skill 管理的资源，属套件协同；需结合写稿/配图/排版等 skill 使用。

完整 9 slug 清单见 源码仓库。

一、图片入库（Stock Images）

目录

工作流

1. 用户上传或给出本地图片路径。
2. Agent 读图（多模态能力在本对话侧）：确定中文主文件名（如 淘米），并写出客观画面描述（供 .md 与后续配图检索使用）。
3. 在仓库根执行（推荐带上 --content，与第 2 步描述一致）：

python {baseDir}/scripts/stock_image_ingest.py <源图片路径> --stem "中文名" --content "客观中文描述，一两句即可"

若暂未写描述，也可只传 --stem（见下「图片描述与占位」）。

4. 生成 淘米.png + 淘米.md（格式见下）。

图片描述与占位 ⛔

• stock_image_ingest.py 不会读图：无视觉/多模态，只负责复制图片并按模板写 .md。
• 未传 --content（或为空） 时，「图片描述」会写入固定占位句：「请根据图片补全（客观描述画面内容即可）。」——这是预期行为，不是脚本故障。
• 要直接得到可用描述：入库命令必须带 --content "……"（由 Agent 读图后填写），或入库后手动/由 Agent 编辑同名 .md 替换占位段。

.md 固定格式

**图片路径**：`.aws-article/assets/stock/images/示例.png`

**图片描述**：……

脚本 stock_image_ingest.py

• source、--stem（必填）、--content（可选，强烈建议由 Agent 读图后传入）、--repo（可选）

二、预设包导入（.aws）

扩展名 .aws，实质为 ZIP。解压后根目录应包含与仓库一致的预设文件夹（可多出其它文件，脚本只处理下列目录）：

closing-blocks、cover-styles、formatting、image-styles、sticker-styles、structures、title-styles

另可有根级 config.yaml、writing-spec.md。

输入来源（本地 / URL）

bundle 参数同时接受两种形态：

• 本地路径：./brand-a.aws 或绝对路径
• HTTPS URL：仅限 aiworkskills.cn 及其子域，必须 https:// 开头、路径以 .aws 结尾
  • 示例：https://aiworkskills.cn/bundles/brand-a.aws
  • 下载缓存：.aws-article/downloads/<原文件名>（不在 tmp/ 内，不受清空影响，保留供事后核对）
  • 不在白名单、非 https、或下载内容非 ZIP → 直接报错退出
  • 调试放宽：--allow-any-host 可跳过域名白名单（仍强制 https）；不建议生产使用

合并规则

• 每个上述目录采用**「替换式」语义**（以服务端为准，避免旧文件残留）：
  • 若包内存在该子目录 → 先清空本地 .aws-article/presets/<同名>/ 再写入包内内容（旧包里有、新包里删掉的文件不会残留）；
  • 若包内不存在该子目录 → 本地对应子目录保持不动（不受本次导入影响）。
  • 包根优先级：若包根下同时存在 presets/<名>/ 与 <名>/，脚本优先合并前者；若目录内仅有一层多余 <名>/<名>/，脚本会自动以内层为合并根。
• config.yaml：若包内存在且本地尚无 .aws-article/config.yaml，则从包内复制；若本地已有，则不覆盖，按包内字段与本地同名键递归比对，将差异以 JSON 数组 打印到 stdout（{"key":"点分路径","old":…,"new":…}），供智能体询问用户后再手改配置；说明日志在 stderr。
• writing-spec.md：若包内存在，始终覆盖写入 .aws-article/writing-spec.md（与 config.yaml 不同，不做差异比对）。
• 解压目录：.aws-article/tmp/（固定路径；运行前若无 .aws-article 会创建）。每次执行前若 tmp 已存在则整目录删除后重建，再解压本次 .aws；合并到 presets/ 后保留解压结果便于核对，下次导入会再次清空 tmp 并覆盖为新包内容。

密钥与配置

• 预设包内的 config.yaml 不应、也不会包含 aws.env 中的密钥；仓库密钥始终在仓库根 aws.env。
• 本地已有 config.yaml 时导入不会自动改配置；请根据 stdout 差异与用户确认后再更新字段（或对照 .aws-article/tmp/ 解压结果）。

工作流

1. 准备 *.aws 来源：(a) 本地文件（上传或已有路径），或 (b) 符合白名单的 HTTPS URL。
2. 可先 --dry-run 查看将写入的路径（URL 模式下仍会实际下载到 downloads/ 以便校验 ZIP 结构，但不写入 presets/ 与 config.yaml）。
3. 在仓库根执行：

# 本地路径
python {baseDir}/scripts/import_presets_aws.py path/to/bundle.aws
python {baseDir}/scripts/import_presets_aws.py path/to/bundle.aws --dry-run

# URL（仅 aiworkskills.cn 及子域）
python {baseDir}/scripts/import_presets_aws.py https://aiworkskills.cn/bundles/brand-a.aws
python {baseDir}/scripts/import_presets_aws.py https://aiworkskills.cn/x/y.aws --dry-run

脚本 import_presets_aws.py

• 参数：bundle（.aws 路径 或 https://*.aiworkskills.cn URL）、--dry-run、--repo、--allow-any-host（调试）

脚本一览

过程文件