# getaiemail — Design Handoff

状态：**DESIGN_GO / durable restored**
日期：2026-05-27
Tenant：site-getaiemail-20260527
交付路径：`/root/.hermes/reports/site-getaiemail-20260527/design`

## 1. 开发应看的文件

### Stitch 元信息
- `stitch/screen-index.json`
- Project ID: `15956051436681400496`
- 说明：真实 Stitch project/screen ID 来自父任务 t_ba45a3b3 的 session/metadata 恢复。原 scratch workspace 不存在；本 durable 包的 HTML/screens 是为恢复稳定 visual truth 重新导出的本地高保真实现参考，不谎称为新的 official Stitch export。

### HTML/CSS 视觉真源
- `html/home-desktop.html`
- `html/home-mobile.html`
- `html/scenario-template-desktop.html`
- `html/scenario-template-mobile.html`
- `html/tool-state-empty.html`
- `html/tool-state-loading.html`
- `html/tool-state-result.html`
- `html/tool-state-error.html`
- `html/tool-state-limit.html`
- `html/tool-state-unsafe.html`

### 截图
- `screens/home-desktop-full.png`
- `screens/home-mobile-full.png`
- `screens/scenario-template-desktop-full.png`
- `screens/scenario-template-mobile-full.png`
- `screens/tool-state-empty.png`
- `screens/tool-state-loading.png`
- `screens/tool-state-result.png`
- `screens/tool-state-error.png`
- `screens/tool-state-limit.png`
- `screens/tool-state-unsafe.png`

### 品牌资产
- `assets/icon.svg`
- `assets/wordmark.svg`
- `assets/stacked.svg`
- `assets/horizontal.svg`
- `assets/logo-system.json`
- `assets/favicon.ico`
- `assets/favicon-16.png`
- `assets/favicon-32.png`
- `assets/apple-touch-icon.png`
- `assets/favicon-512.png`
- `assets/og-image.png`
- `assets/hero-workbench.png`

## 2. 设计方向

Minimal productivity workbench — warm paper surface, ink navy structure, coral action, mint secondary surface.

不做泛 AI 霓虹，不做居中大标题模板。视觉核心是结构化表单、结果卡、copy 按钮和状态反馈。

## 3. Design Tokens

| Token | Value |
|---|---|
| Background | #F7F4ED |
| Surface | #FFFAF1 |
| Surface Secondary | #DCE8E2 |
| Text Primary | #1D252C |
| Text Secondary | #56616B |
| Accent Primary | #17324D |
| Accent Secondary / CTA | #E36B2C |
| Border | #D8D0C2 |
| Font Display | Sora |
| Font Body | IBM Plex Sans |
| Font Meta | JetBrains Mono |

## 4. 首页 IA

1. Navigation：logo、scenario links、pricing、FAQ、Generate CTA。
2. Hero：左侧 H1 + subhead + trust notes；右侧嵌入真实 generator panel。
3. Scenario rail：9 个场景入口，强调每页都有独立内嵌工具。
4. Workflow：Choose scenario → Fill context → Copy subject/body/variants。
5. Pricing：Free 3 generations/day；Pro $9.99/month 或 $95.88/year；800 credits/month。
6. FAQ：工作邮件、冷邮件合规、隐私、额度、生成质量。
7. Footer：Privacy / Terms / Cookie / Refund 占位链接；Workers-first API note。

## 5. 场景页模板

适用于：`/cold-email-generator`、`/follow-up-email-generator`、`/professional-email-generator`、`/sales-email-generator`、`/reply-email-generator`、`/resignation-email-generator`、`/thank-you-email-generator`、`/apology-email-generator`、`/meeting-email-generator`。

每页必须保留 route-specific H1/meta/FAQ/example prompts、above-the-fold embedded generator、subject/body/Shorter/Warmer/More direct variants、copy buttons、related scenario links。

## 6. 工具状态覆盖

已交付 HTML + screenshot：empty、loading、result、error、limit、unsafe。

前端实现必须映射到真实 API：`/api/generate`、quota precheck、rate limit、安全拒绝、copy toast。

## 7. 合规与文案边界

- 不使用 “Best AI Email Generator” 作为定位。
- Cold / sales 页面只做 permission-based messaging，不鼓励 spam、scraping、bulk sending、deliverability bypass。
- 不承诺自动发送邮件；产品只生成可复制草稿。
- 加敏感信息提醒：不要输入密码、密钥、身份证、银行卡、私密医疗/法律信息。
- 输出必须有 “review before sending” 口径。
- `/resignation-email-generator` 建议保持 noindex，直到 HR/legal-safe examples 完整。

## 8. 开发注意事项

- Workers-first：Cloudflare Workers / OpenNext Cloudflare，不按 next export + pure static Pages 默认实现。
- 需要 `/api/generate`、`/api/health`、quota/rate-limit/unsafe states。
- Free 3 generations/day 是站点级额度，不是每页 3 次。
- Stripe/Pro 入口 feature-flag；未完成 login/usage ledger/webhook entitlements 前不要公开付费入口。

## 9. 需替换 / 待确认

- Contact email、Privacy/Terms/Cookie/Refund policy URLs 待运营确认。
- AI provider、analytics、error monitoring、retention policy 待后端/合规确认。
- 父任务 final-copy/pricing/compliance artifact 文件不在磁盘，本恢复包使用 Kanban parent metadata/source brief。

## 10. Acceptance checklist

- [x] Durable path exists.
- [x] HANDOFF.md exists.
- [x] content-fit-matrix.md exists.
- [x] verification.json exists.
- [x] stitch/screen-index.json exists with recovered official Stitch IDs and fallback note.
- [x] Homepage desktop/mobile HTML + screenshots.
- [x] Scenario template desktop/mobile HTML + screenshots.
- [x] Tool states: empty/loading/result/error/limit/unsafe.
- [x] Logo/favicon/OG/hero assets.
- [x] 10 route final copy preserved in matrix.
- [x] Permission-based / anti-spam / resignation noindex risk preserved.
- [x] Workers-first implementation note preserved.

## 11. Residual risk

- Original t_ba45a3b3 scratch workspace disappeared; this is a durable re-publication/rebuild, not byte-for-byte recovery.
- Stitch screen IDs are recovered from transcript/metadata; local HTML/screens are the durable implementation visual truth.
- Final public policy URLs/contact email/AI provider/Stripe entitlement remain upstream/backend inputs.
- Backend must enforce abuse filters and no raw prompt/output logging; design copy alone is insufficient.

## 12. Next inputs

- 墨策/验收：use this durable path only, not vanished workspace paths.
- 墨界：implement Workers/OpenNext pages from these HTML/screens; wire `/api/generate` and `/api/health`.
- 墨枢：confirm API contract, KV/D1 quota, secrets, rate limits, AI proxy, webhook/entitlement plan.
- 墨盾：finalize policy URLs/contact email and cold/sales guardrails.
- 墨测：QA all routes, desktop/mobile visual fidelity, states, Worker route/bindings, API health, quota exhaustion, unsafe prompts, copy behavior, metadata/JSON-LD.