# 月与人间 · 中秋祝福 Skill

**48 张实际样图，48 套可定制提示词，12 个设计系列。**

A Mid-Autumn greeting skill with 48 generated poster examples, parameterized prompts, and an offline gallery. Chinese aesthetics, thoughtful composition, and ready-to-use blessings.

[在线图册](https://ToBeWin.github.io/mid-autumn-greetings-skill/) · [下载完整包](https://github.com/ToBeWin/mid-autumn-greetings-skill/releases/latest) · [48 款选款目录](references/catalog.md) · [Skill 指令](SKILL.md)

<table>
<tr>
<td><img src="assets/images/33.png" alt="团扇藏秋" width="240"></td>
<td><img src="assets/images/37.png" alt="舟载月明" width="240"></td>
<td><img src="assets/images/41.png" alt="折一轮月" width="240"></td>
<td><img src="assets/images/44.png" alt="云山共月" width="240"></td>
</tr>
<tr><td>33 · 团扇藏秋</td><td>37 · 舟载月明</td><td>41 · 折一轮月</td><td>44 · 云山共月</td></tr>
<tr>
<td><img src="assets/images/06.png" alt="螺钿映月" width="240"></td>
<td><img src="assets/images/17.png" alt="桂影成诗" width="240"></td>
<td><img src="assets/images/25.png" alt="月亮外带" width="240"></td>
<td><img src="assets/images/47.png" alt="千里一卷" width="240"></td>
</tr>
<tr><td>06 · 螺钿映月</td><td>17 · 桂影成诗</td><td>25 · 月亮外带</td><td>47 · 千里一卷</td></tr>
</table>

## 可以做什么

- 直接浏览、下载已有祝福海报。
- 按送给谁、语气、风格或编号挑选设计。
- 替换标题、祝福和署名，调用宿主的生图能力生成个性化图片。
- 使用离线图册填写文案并复制完整提示词。
- 将提示词库作为自己的节日图片项目的起点。

每款包含实际 PNG、默认文案、参数模板、实际生成提示词及使用对象。图片随仓库提供，无需外链素材或 Git LFS。完整资源约 111 MiB；单张原图尺寸在模板页中记录。

## 安装到 Codex

需要 Git；提示词脚本可选用 Python 3.9+，无需第三方包。

```bash
git clone --depth 1 https://github.com/ToBeWin/mid-autumn-greetings-skill.git "${CODEX_HOME:-$HOME/.codex}/skills/mid-autumn-greetings"
```

同名目录已存在时先检查已有内容，不覆盖。安装后在新会话中调用：

```text
使用 $mid-autumn-greetings，给父母做一张典雅的中秋祝福图，署名小林。
```

也可以下载 Release ZIP，把其中的 `mid-autumn-greetings` 文件夹放入 Codex 的 skills 目录。其他支持 `SKILL.md` 的 agent 可以按各自的安装机制加载；实际生图能力由宿主提供，未逐一测试所有 agent。

## 不安装也能用

打开[在线图册](https://ToBeWin.github.io/mid-autumn-greetings-skill/)，或下载完整包后双击 `index.html`。选款、填祝福、复制提示词，粘贴到支持生图的对话里。

图册不会自行调用模型、上传输入内容或直接修改原图。若要贴近样图，可同时附上对应 PNG 作为参考。修改文字后需要重新生成。

## 使用示例

```text
用 33 号《团扇藏秋》，祝福写“中秋安康，阖家团圆”，署名“阿宁”。
给远方的朋友做一张有留白的中秋海报，用《舟载月明》。
给客户做一张简洁的中式祝福图，不要署名。
先给我看三款纸艺方向，我选好再生成。
```

在仓库目录中也可以直接整理提示词：

```bash
python3 scripts/mid_autumn.py list --series 宋意清供
python3 scripts/mid_autumn.py list --query 异地
python3 scripts/mid_autumn.py show 33
python3 scripts/mid_autumn.py render --id 33 --blessing '中秋安康，阖家团圆' --signature '小林'
python3 scripts/mid_autumn.py render --id 41 --ratio 1:1 --out dist/prompt.txt
```

脚本只处理提示词，不调用付费接口。13–16 号的大字参与构图，默认固定标题；明确需要改题时可传 `--allow-title-change`，并重新排版。

## 十二个系列

| 系列 | 编号 | 视觉方向 |
|---|---|---|
| 诗性编辑 | 01–04 | 纸张拼贴、私密祝福、大留白 |
| 当代工艺 | 05–08 | 瓷釉、螺钿、丝织、拓印 |
| 概念静物 | 09–12 | 茶、柿子、信封、月饼 |
| 字体实验 | 13–16 | 大字、圆形、强烈色彩 |
| 东方印象 | 17–20 | 蓝晒、矿物重彩、墨迹、木刻 |
| 生活电影 | 21–24 | 家、归途、窗、屋顶 |
| 轻巧奇想 | 25–28 | 外带月亮、火柴盒、月亮营业、折纸 |
| 光与空间 | 29–32 | 圆窗、楼梯、庭院、海边框景 |
| 宋意清供 | 33–36 | 团扇、砚池、桂枝、竹帘 |
| 借景成诗 | 37–40 | 舟、廊桥、花窗、曲水 |
| 纸上造境 | 41–44 | 经折册页、剪纸、灯笼、压纹 |
| 文人雅趣 | 45–48 | 墨、琴、书、香 |

## 文件结构

```text
SKILL.md                     技能入口
agents/openai.yaml           Codex 显示信息
assets/images/              48 张原图
assets/templates.json        规范模板数据
references/catalog.md        精简选款目录
references/templates/        每款完整提示词
references/design-notes.md   设计思路与检查范围
scripts/mid_autumn.py         检索、填参与校验
scripts/build_catalog.py     重建模板文档和图册数据
index.html                   离线可用图册
```

## 质量与来源

样图由内置图片生成工具根据随附提示词生成，经过逐张视觉与中文字形复核。没有绑定特定后台模型版本。生成存在随机性；不同模型、较长文案、署名和改比例后的效果需要重新检查，不保证与样图完全一致。

器物和宋意等风格是当代艺术化表达，不作为历史器物复原。更多说明见 [设计说明](references/design-notes.md) 与 [素材来源](NOTICE.md)。

## 参与改进

欢迎补充新的构图，或提交带有实际结果的改进。请一并提供样图、实际提示词、默认文案及适用场景；不要把单纯换色、换署名计为新的设计。

修改 `assets/templates.json` 和相应图片后运行：

```bash
python3 scripts/build_catalog.py
python3 scripts/mid_autumn.py check
python3 -m unittest discover -s tests -v
```

当前检查覆盖资源完整性、模板填参、空署名、标题保护和比例重排指令，不替代生成结果的审美和文字复核。

## License

[MIT](LICENSE)。代码、提示词、文档和随附生成图片均按仓库 MIT 许可提供；请保留许可文本。没有打包任何第三方字体文件或独立素材库。