aws-wechat-article-assets

1# 用户业务资料库与预设（Assets）
2 
3**业务资料按产品名分目录** — `.aws-article/products/{产品名}/` 直挂业务介绍 `.md`、`images/` 存配图（含同名说明 `.md`）。**写涉及用户自身业务的文章/配图前必须先查这里；新生成的业务介绍内容应引导用户保存到这里**。预设包合并到 `.aws-article/presets/`。
4 
5> **套件说明** · 本 skill 属 `aws-wechat-article-*` 一条龙套件（共 9 个 slug，入口 `aws-wechat-article-main`）。跨 skill 的相对引用依赖同一 `skills/` 目录，建议一并 `clawhub install` 全套。源码：<https://github.com/aiworkskills/wechat-article-skills>
6 
7## 能力披露（Capabilities）
8 
9本 skill 管理本地业务资料库与预设包，可选从 `aiworkskills.cn` 域下载 `.aws` 预设包（ZIP）。
10 
11- **凭证**：无（但**导入 `.aws` 会把包内密钥写进仓库根 `aws.env`**，见下）
12- **网络**：可选 `https://*.aiworkskills.cn/**/*.aws` 下载预设包。**白名单强制**：仅 HTTPS + `aiworkskills.cn` 及其子域，非白名单**直接报错退出**。`--allow-any-host` 可放宽，调试用
13- **文件读**：用户指定的本地图片或 `.aws` 文件；引导入库前会 `ls .aws-article/products/` 看已有产品名
14- **文件写**：
15  - `.aws-article/products/{产品名}/*.md`（业务介绍，AI 用 Write 工具直接落库）
16  - `.aws-article/products/{产品名}/images/*`（图片 + 同名 `.md`，由脚本写）
17  - `.aws-article/presets/<白名单子目录>/*`、`.aws-article/downloads/*.aws`、`.aws-article/tmp/*`
18  - **仓库根 `aws.env`**：导入 `.aws` 时按映射表增量写入密钥（覆盖现有键前自动备份 `aws.env.bak.{ts}`，stderr 只打印键名不打印值）
19- **归档安全**：解压 `.aws`（ZIP）到 `.aws-article/tmp/`。**已内置 ZIP slip 防御**——逐项校验成员路径，拒绝绝对路径、`..` 段、或解析后指向解压目录外的路径，任一违反立即退出且不写入任何文件
20- **shell**：仅 `{python} {baseDir}/scripts/` 下的 `product_image_ingest.py`、`import_presets_aws.py`
21 
22除 `aws.env` 外，所有写入都限制在仓库根的 `.aws-article/` 内。
23 
24**单独安装可用**：两个脚本都不依赖兄弟 skill，只要有 `.aws-article/` 目录就能工作。
25 
26## 三件事
27 
28| 能力 | 说明 |
29|------|------|
30…