# Release Notes · v1.0.0 · 旅游明信片

> 按 Keep a Changelog 1.1.0 + SemVer 2.0 规范。
> 长度：178 字（content-writer 铁律：≤ 200 字）。
> 读者画像：① 业务方 / 早期用户（看"我能用什么"）② 团队同事（看技术演进）。
> 触发：tag `v1.0.0` push 后由 product-lead 调 `gh release create --notes-file CHANGELOG.md --latest`。
> deck 集成：spec §14.1 slide 24（§1 p21.5 GitHub Release 实战）+ slide 71（§5 p70.5 CHANGELOG 6 节规范）。

---

# v1.0.0 — 2026-05-20

首版发布！旅游明信片生成器上线，3 步走拿到能发朋友圈的明信片。

## Added

- **旅游明信片生成器**（核心 feature）：用户上传照片 + 一句话 → 30s 内出 200 字文案 + 1024×1024 风格化卡片图
- 5 AC 全过：Vision 准确率 92% / 文案评分 4.3/5 / 风格色调匹配 0.81 / 单次成本 ¥0.21（含 30% 安全余量）
- 全豆包 2.0 栈：Doubao-Seed-2.0-Pro（多模态 + LLM）+ Doubao-Seedream-4.5（文生图）
- 同厂商 fallback 链：Pro → Lite → Mini（latency 升 18% 但能用）

## Fixed

- 用户 prompt 日志含明文 PII → 改为 `[REDACTED]` + log level 降 DEBUG（合规修复）
- Vision 返回内容直接拼 LLM prompt → 加 prompt-injection 防护（安全修复）

---

## 命令样例（团队同事用）

```bash
# 1. 写 CHANGELOG.md（已写在本文件）
# 2. 打 tag（同会话内必走）
git tag -a v1.0.0 -m "Release v1.0.0 · 旅游明信片首版

Tagged-along commits:
- abc1234 feat: postcard three-step pipeline (PR #287)
- def5678 feat: postcard API + DB schema (PR #288)
- ghi9012 fix: PII redact in vision call log (PR #295)
- jkl3456 fix: prompt-injection防护 in LLM stage (PR #296)"

# 3. push tag
git push --tags

# 4. 创建 GitHub Release
gh release create v1.0.0 --notes-file CHANGELOG.md --latest

# 5. 同会话内必走 retro（MAJOR 强制）
/agf-release-retro v1.0.0
```

详见 deck slide 71 [A16 Release 全流程图](../../diagrams/png/A16-release-changelog.png)：CHANGELOG 6 节 → SemVer 判定 → tag annotation → gh release。

---

## 反模式预警（v1.0.0 没踩，但下次提醒）

- ❌ **tag-orphan**：commit 后未同会话 `git tag -a` → 必须 PL 当次会话补打或解释延期
- ❌ 形容词堆砌（"全新升级 / 极致体验"）→ 用数字（"30s 内出图 / cost ¥0.21"）
- ❌ release notes 标题用"功能优化"→ 用动词（Added / Fixed / Changed / Removed / Deprecated / Security）

---

## 下一版预告（v1.1.0，~6 周后）

- **Added**：文案 cliché 模板优化（针对"咖啡馆 / 夜色"等套话约束，对应 issue #312）
- **Added**：跨厂商 fallback backup（Qwen3.6-VL 作 Vision backup）
- **Changed**：单次调用从 3 步进阶为 2 步（Seed-2.0-Pro 原生多模态优化）
- **Considered**：多人合影智能识别（v2 候选）

---

## 反馈渠道

- **GitHub Issues**：https://github.com/org/agf/issues（label: postcard-feature）
- **直接试用**：https://...（5 张测试照片提供，免登录体验）
- **完整 retro 公开版**：[`docs/reviews/retro-v1.0.0-2026-05-20.md`](../../../docs/reviews/retro-v1.0.0-2026-05-20.md)

---

## 引用与上下游

- **PRD**：[00-prd.md](./00-prd.md)
- **架构决策**：[01-adr-model-selection.md](./01-adr-model-selection.md)
- **派单**：[02-dispatch.md](./02-dispatch.md)
- **dev 进展**：[03-progress.md](./03-progress.md)
- **Code Review**：[04-review-report.md](./04-review-report.md)
- **UAT 签字**：[05-uat-report.md](./05-uat-report.md)
- **Release Retro**：[06-retro.md](./06-retro.md)
- **deck slide 引用**：slide 24（GitHub Release 实战）+ slide 71（CHANGELOG 6 节）+ slide 72（A16 release 全流程图）

---

## SSoT 校对

引用的所有功能名 / 数据点 / 版本号已对照：
- PRD v1.0 → ✓ 5 AC 全过实测
- ADR-001 → ✓ 豆包栈选型
- 03-progress.md → ✓ SIT 数据
- 05-uat-report.md → ✓ E2E + UAT 数据
- 06-retro.md → ✓ Owner + Due 跟进项

*由 content-writer 撰写 · 2026-05-20 · 178 字（≤ 200 字 content-writer 铁律）*
