公众号素材与预设（Assets）

能力	说明
图片入库	用户图 → assets/stock/images/，供其它 skill 引用
预设包 .aws	ZIP 包 → 合并 presets/ 子目录；config.yaml 见下

---

一、图片入库（Stock Images）

目录

路径	作用
.aws-article/assets/stock/images/	入库图片 + 同名 .md（固定：图片路径 / 图片描述）

工作流

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。

合并规则

• 每个上述目录：递归合并到 .aws-article/presets/<同名>/（推荐 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 路径。
2. 可先 --dry-run 查看将写入的路径。
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

脚本 import_presets_aws.py

• 参数：bundle（.aws 文件路径）、--dry-run、--repo

---

脚本一览

脚本	路径
stock_image_ingest.py	{baseDir}/scripts/stock_image_ingest.py
import_presets_aws.py	{baseDir}/scripts/import_presets_aws.py

过程文件

场景	产出
图片入库	assets/stock/images/*.{png,...} + 同名 *.md
.aws 导入	更新 .aws-article/presets/**；config.yaml 首次复制或 stdout 差异 JSON；解压缓存在 .aws-article/tmp/