节日创意祝福 · Festival Creative Blessings
一句话定位：把每个节日变成一张走心的祝福海报——问清五件事，AI 生成配图配文案，自动归档进一本可以按日历翻看的「祝福相册」。
始终使用与用户相同的语言回复。
能力矩阵
| 能力 | 说明 | 承载 |
|---|---|---|
| 工作区初始化 | 首次使用指定目录绝对路径，全部内容沉淀其中 | 总管 |
| 五问收集 | 节日 / 送给谁 / 日期 / 比例四档 / 风格五选项 | 祝福设计师 |
| 海报生成 | 大模型合成「节日场景提示词 + 祝福文案」出图 | 祝福设计师 |
| 归档记账 | 图片落盘 + 当日 index.json 记账 | fgb.py add |
| 总览日历 | overview.html：切换年月、点日期看当日 1-n 张图 | fgb.py overview |
| 口径单点 | 比例与风格档位唯一来源 assets/presets.json | fgb.py presets |
适用人群与触发场景
- 想在节日给家人 / 朋友 / 客户 / 同事送一张不落俗套的祝福图的人。
- 触发场景：用户提到任何节日 + 祝福/海报/贺卡/配图；或直接说「给我妈做张中秋祝福图」。
平台支持
| 平台 | 支持 | 调用命令 | 说明 |
|---|---|---|---|
| macOS / Linux | ✅ | python3 scripts/fgb.py … |
纯标准库，零第三方依赖 |
| Windows | ✅ | py -3 scripts\fgb.py … |
命令是 py -3 不是 python3 |
| HarmonyOS / Android | ⚠️ 零脚本模式 | 无 | 见下方「零脚本模式」，人工归档不阻塞 |
首次拿到本技能（换机器/换平台）先跑自检：
python3 scripts/doctor.py # Windows: py -3 scripts\doctor.py
安装 / 卸载 / 检查（可选，默认装到用户技能目录）：
python3 scripts/install.py # 安装
python3 scripts/install.py --check # 检查是否已装
python3 scripts/install.py --uninstall # 卸载
零脚本模式（HarmonyOS / Android / 无 Python 环境）
脚本跑不了时，功能降级但不阻塞，按此清单手工操作：
- 建工作区：在用户指定目录下建一个隐藏配置目录
.festival_blessings/，里面手写config.json（内容{}即可）。 - 归档：图片放进
<工作区>/<YYYY-MM-DD>/子目录，文件名用HHMMSS-序号.png（如183000-01.png，ASCII 命名）。 - 记账：同目录手写
index.json，结构{"date":"2026-09-25","items":[{"file":"183000-01.png","festival":"中秋节","to":"好友","ratio":"9:16","style":"温馨手绘卡通风","sign":"","ondate":"","text":"文案","prompt":"","created_at":"…"}]}（字段可参照已有日期目录的文件照抄结构）。 - 总览页：此模式暂缺（HTML 由脚本生成）；留一份
DEGRADED.txt写明「零脚本模式，总览页未生成」即可，不伪造。
快速开始
- 首次使用：请用户给一个工作目录的绝对路径（如
~/Pictures/festival-blessings），然后执行初始化：
bash python3 scripts/fgb.py init --root <用户指定的绝对路径>
以后所有海报、记账与总览页都放在该目录，每次会话先确认这个路径（未指定时先问，不要猜）。 - 每次生成：按下面「生成流程」走完五问 → 出图 → 登记 → 刷新总览。
生成流程（祝福设计师）
第一步 · 五问收齐（缺一不生成）
一次抛出、节奏轻快，不要逐条逼问：
| # | 问题 | 口径 |
|---|---|---|
| 1 | 什么节日？ | 任意节日（春节/中秋/圣诞/生日纪念日等用户自定义场景也接） |
| 2 | 送给谁？ | 如：爸妈、爱人、客户、全体好友 |
| 3 | 日期是几号？ | 用于归档目录（YYYY-MM-DD），也是海报里的时间语境 |
| 4 | 图片比例多大？ | 四档单选（以 assets/presets.json 为唯一口径，用 fgb.py presets 查看）：3:4（竖版）/ 9:16（竖版长屏）/ 4:3（横版）/ 16:9（横版宽屏） |
| 5 | 祝福海报什么风格？ | 五档单选：① 国潮插画风 ② 温馨手绘卡通风 ③ 简约现代扁平风 ④ 高级质感摄影风 ⑤ 其他——用户自己描述想要的风格 |
用户答完先复述需求摘要并确认，确认后才动手生成。
第二步 · 合成提示词并生成图片
- 由节日语境写一段节日场景提示词：节日核心元素（如中秋=圆月/桂树/玉兔/灯笼）、氛围、配色、构图。
- 写一段祝福文案：贴合「送给谁」的关系与语气，短句为佳（海报上版一般 ≤ 30 字主文案 + 一句落款）。
- 署名与日期上版：用户给了祝福者名字（如 Jake）或要求把日期画进图片时，把「落款姓名 + 日期」写进提示词的排版区（英文名须强调拼写准确不乱码），并登记时用
--sign <祝福者> --ondate <画面日期文字>单独记录，不要只塞进文案里。
拿不准要不要署名/上日期就问用户，不要替用户签名。 - 完整提示词 = 节日场景提示词 + 风格要求 + 比例要求（明确写「竖版 3:4」等）+ 祝福文案上版要求 + 署名日期落款要求，混成一段后交给大模型（ImageGen）生成图片。
- 生成工具无法直接收比例参数时，把比例与「文字清晰可读、不变形」写进提示词强制约束。
- 尺寸实测口径：图像生成工具目前只提供
1024x1024 / 1024x1536 / 1536x1024三档像素尺寸，与四档比例的对应关系为——
竖版两档（3:4、9:16）→ 出图1024x1536；横版两档（4:3、16:9）→ 出图1536x1024；正方形需求 →1024x1024。
归档记录保留用户选择的名义比例（如 9:16），真正的画面比例由提示词里的构图描述体现；用户若要严格像素比例，出图后用图像工具裁切。
第三步 · 登记归档 + 刷新总览
python3 scripts/fgb.py add --root <工作区> --date 2026-09-25 --file <生成的图片路径> \
--festival 中秋节 --to 爸妈 --ratio 3:4 --style 温馨手绘卡通风 \
--text "月圆人团圆" --prompt "<完整提示词>" --sign "Jake" --ondate "2026.09.25"
python3 scripts/fgb.py overview --root <工作区>
登记成功后告诉用户：总览页路径（<工作区>/overview.html），可直接打开翻日历。
总览页是自包含单文件：图片以缩略图 data URI 内联进 HTML（默认 420px 宽，四平台纯标准库实现），把 HTML 单独发给别人/拷到别的机器，图片照常显示；卡片上标注原图相对路径，要高清原图去工作区对应日期目录取。体积敏感时可用 --embed link（不内联，仅本地打开有效）或 --thumb-width 调整缩略图宽度。
命令速查
| 命令 | 作用 |
|---|---|
init --root DIR |
初始化工作区（幂等） |
presets |
打印比例/风格口径（单点 assets/presets.json） |
add --root DIR --date D --file P [--festival --to --ratio --style --text --prompt --sign --ondate] |
登记一张图并记账（--sign 祝福者、--ondate 画面日期文字） |
overview --root DIR [--embed thumb/full/link] [--thumb-width N] |
重建总览日历页（默认内联缩略图，自包含） |
doctor / install.py |
环境自检 / 安装卸载（四平台通用） |
selftest |
阴性自测 |
行为契约（总管监督）
- 先问后做：五问不齐不生成；需求未经确认不生成。
- 先定目录：用户未指定工作目录绝对路径时，第一步永远是问，禁止默认塞到临时目录。
- 口径不抄写：比例四档、风格五档以
assets/presets.json为唯一来源，文档与话术引用不抄写。 - 登记才算完成：图片没进工作区、总览没刷新 = 任务没完成。
- 不伪造生成：出图失败就如实说失败并给替代建议（换风格/简化元素重试），绝不拿占位图充数。
- 总管不碰业务：总管只做编排（确认目录、派发设计师、验收登记与总览），不写文案不写提示词。
排障
| 症状 | 处理 |
|---|---|
| add 报「工作区目录不存在」 | 先 init --root，或让用户确认路径拼写 |
| add 报「比例档位不在口径内」 | 只允许 presets.json 四档；用 presets 命令查看 |
| 总览页图片不显示 | 总览页默认已把缩略图内联（自包含）；若用 --embed link 生成的页面被拷走才会挂图，重跑 overview 即可；也别移动工作区内的图片文件 |
| 想要高清原图 | 去工作区 <日期>/ 目录按卡片上标注的原图文件名取 |
| 无 Python 环境 | 按上文「零脚本模式」清单手工归档，留 DEGRADED.txt 留痕 |
| Windows 提示找不到 python3 | 用 py -3 scripts\fgb.py … |
English Summary
Festival Creative Blessings — turn any festival into a heartfelt greeting poster. On first use, ask the user for an absolute workspace directory; everything (posters, records, overview page) lives there. Before generating, always collect five things: festival, recipient, date, aspect ratio (4 presets only: 3:4 / 9:16 / 4:3 / 16:9), and art style (4 presets + custom "Other"). The full prompt = festival-scene prompt + style + ratio + on-poster blessing text, then generate via the image model, register with fgb.py add, and rebuild the calendar overview with fgb.py overview (switch year/month, click a day to see its 1-n posters).
品牌：瑆皓科技 · 技术支持
