动画邮箱签名 是做什么的?
您将为客户的品牌制作两样东西并放到他们的网站上:
- 一个循环 GIF(1200×340,显示为 480×136,约 11 秒,小于 1 MB)。以品牌卡(Logo、名称、标语、域名)开始,展示产品的一项真实工作,然后回到品牌卡。
- 一个团队页面,每个人可以在上面输入姓名、职位和邮箱,在亮色和暗色收件箱中预览签名,并复制签名。姓名和职位保持为实时文本,因此一个GIF可供整个团队使用。该页面会阻止搜索引擎和AI爬虫访问。
技能文件夹包含:
scripts/inspect-site.mjs:读取网站(页面、颜色、字体、Logo、图片、截图)assets/card.html:动画卡片,包含三个场景(聊天、计数、展示),从brand.json填充assets/signature-page.html:团队页面assets/brand.example.json:示例品牌,供复制参考scripts/render.mjs:卡片 → GIF,同时检查大小和循环是否合理scripts/build-page.mjs:brand.json → 团队页面references/deploy.md:将两者部署到网站上的说明;在第6步阅读
为何如此构建
了解以下内容可以帮助您在品牌不符合模板时做出正确判断:
- 邮件中无法运行代码。 Gmail、Outlook 和 Apple Mail 会剥离签名中的脚本、视频和CSS动画,因此唯一能在所有客户端中保留动态效果的是动画GIF。
- 较旧的桌面版Outlook只显示第一帧。 因此第0帧必须是完整的品牌卡,绝不能是空白或半绘制帧。循环也精确地在该卡片上结束,这样重新开始不会出现可见的跳跃。
render.mjs会检查这两点。 - 尺寸很重要。 过大的签名会被截断或加载缓慢,因此请将GIF保持在1 MB以下。GIF只存储帧之间变化的像素,因此任何在大面积区域上每帧都变化的内容都会使文件急剧增大。在一个实际案例中,Logo后面轻微的脉冲辉光使GIF从434 KB增加到1.26 MB。优先选择小区域内的动画:打字文本、图标、短促的淡入淡出。
render.mjs在超过1 MB时会报错。 - 以2倍分辨率绘制,以固定尺寸显示。 这样可以保持视网膜屏幕上的清晰度。签名HTML中设置
width="480" height="136",确保邮件应用不会按照1200像素的文件宽度显示。 - 复制出来的签名必须指向实时的绝对https地址。 邮件应用无法加载本地文件或相对路径。该页面始终复制
gifUrl,即使预览的是本地文件。 - 姓名本身没有颜色。 它采用收件箱的文本颜色,因此在亮色和暗色模式下均可阅读。第二行和邮箱链接使用在两种模式下都能阅读的中性色。
- 故事只展示产品的真实功能。 签名会到达客户和投资者手中,因此其中的虚构功能或数字相当于团队发送的每封邮件中的虚假声明。请从产品自己的网站或文档中获取故事,并在渲染前获得用户的批准。
步骤
1. 创建工作文件夹
使用网站仓库外部的文件夹,避免工具代码进入对方的网站:
mkdir email-signature-work && cd email-signature-work
npm init -y
npm i playwright
npx playwright install chromium
通过 ffmpeg -version 检查 ffmpeg。安装方法:macOS 上 brew install ffmpeg,Windows 上 winget install Gyan.FFmpeg,Linux 上 sudo apt install ffmpeg。
此后所有命令都在此文件夹中运行。brand.json、网站简报、任何裁剪后的图片以及输出结果都存放在此处,与 node_modules 同级。
2. 读取网站
node <skill folder>/scripts/inspect-site.mjs https://their-site.com site-brief --pages 6
它会打开主页以及最多6个其他页面(优先产品、功能、关于、定价),并写入 site-brief/:
brief.json:pages[]包含每个页面的标题、描述、标题、主要文本和按钮标签,以及其palette(实际使用的RGB颜色,按页面覆盖面积排序,分为background、text、button、link)和fonts。顶层的logos和images列出候选文件。空的button列表或system-ui字体表示网站未暴露这些信息:改为从截图中取强调色,并凭视觉选择字体。screens/:每个页面的截图logos/:每个Logo候选文件(头部SVG或图片、应用图标、社交图片)images/:最大的内容图片(产品、菜肴、项目、应用截图、人物)
brief.json → logos 和 images 列出每个文件的像素尺寸 (px),以及当文件尺寸过小或不适合宽横幅时给出 note 提示。
如果只读取到一个页面,说明网站可能通过脚本构建链接或阻止自动化访问。请以产品页面作为起始URL重新运行,或向用户询问。
然后像设计师开始工作前那样实际查看:
- 截图: 打开主页和一两个产品页面的截图。了解页面的整体感觉(暗色还是亮色、活泼还是严肃、照片风格还是扁平UI),并确定哪个颜色是品牌强调色。通常最常用的按钮背景色就是强调色。
- Logo: 打开Logo候选文件。
- 头部SVG通常是最佳来源。
apple-touch-icon可以是简洁的方形标记,但请检查其px:许多网站提供32×32的图标,这在卡片上会模糊。任何标记为“过小不适合卡片”的都不能用。 - 检查您手中的素材。方形标记放入
logo。宽体文字标识放入wordmark,并在品牌卡上取代键入的名称。 - 如果没有方形Logo,卡片会自适应。如果有文字标识,则去掉左列,避免名称显示两次。如果两者都没有,卡片会以强调色绘制品牌的第一个字母。
- 不要使用小于64像素的favicon或模糊的裁剪:改为向用户索要文件。
- 为白色头部设计的Logo在深色卡片上可能会消失。如果出现这种情况,请使用浅色卡片、向用户索要浅色版本,或编辑SVG的填充色。
- 头部SVG通常是最佳来源。
- 图片: 打开用于展示场景的候选图片。跳过看起来像库存照片的图片、人物面部(先询问)以及包含小文字且在168×126上无法阅读的图片。
- 展示帧会裁剪至填满(约4:3)。宽幅英雄横幅通常嵌有文字和按钮,裁剪后会留下字母碎片。请自行先将画面裁剪到主体上:
这里的ffmpeg -i site-brief/images/00.png -vf "crop=900:675:500:110" crop-1.pngcrop=w:h:x:y会在产品周围选择一个4:3的框。然后打开结果文件检查。
- 展示帧会裁剪至填满(约4:3)。宽幅英雄横幅通常嵌有文字和按钮,裁剪后会留下字母碎片。请自行先将画面裁剪到主体上:
- 文本: 阅读主要文本和标题。了解该业务真正为客户做什么(用他们自己的话),以及任何其公开声明的真实数据(服务的客户数、已交付的订单数、运营年数)。
如果网站阻止了脚本(登录墙、机器人保护)或内容单薄,请向用户索要Logo、颜色以及一句关于业务内容的话。
3. 选择场景并编写故事,然后获得批准
brand.json → story.type 从三种场景中选择一种。选择最能展示该业务实际工作的场景:
| 场景 | 适用场景 | 故事字段 |
|---|---|---|
chat | 软件、AI代理、应用、提供回答或修复的服务 | question (≤ 32字符),三个 steps,每个包含 { text ≤ 34, status: "ok" | "warn" },result (≤ 28),details (2–3行,每行 ≤ 40) |
counter | 真实的公开数据:处理的资金、已发送的订单、服务的客户、运营年数 | label (≤ 40),value (数字),prefix/suffix (例如 "₹"、"+"、" 订单"),decimals,result (≤ 28),details |
showcase | 商店、食品、旅行、工作室、作品集、实体产品:任何展示优于叙述的内容 | items:2–3个 { image: "site-brief/images/03.jpg", title ≤ 22, text ≤ 36 }。照片是GIF中最重的部分:在测试中,2张照片约790 KB,3张约940 KB,4张超过1 MB。 |
计数器的数字必须是该业务已公开声明(在其自己的网站上)的,并需获得用户同意。绝不能凭空编造。展示场景使用该业务网站上的自有图片,而非库存图。
如果要添加不同的场景(比如前后对比、地图引脚路线、进度条),请在 card.html 的副本中添加 SCENES 条目,并使用 --card your-card.html 进行渲染。请遵守“为何如此构建”中的规则。
编写 brand.json(复制 assets/brand.example.json;图片路径相对于 brand.json):
- 名称、域名、URL:
name、domain、siteUrl和gifUrl,GIF将要存放的绝对地址(例如https://their-site.com/email/signature.gif)。 - 文本:
tagline,大约五个词描述业务内容。可选email,作为团队页面上显示的占位邮箱。 - 图片:
logo(方形标记,可选)和wordmark(可选)。 - 字体: Google Fonts 字体系列名称。
brief.json列出了网站本身的字体。- 如果这些字体在 Google Fonts 上,就使用它们。
- 如果它们是专有或自托管的,按感觉选择最接近的 Google Font:圆角无衬线字体系列对应圆角无衬线,衬线对应衬线。
- 省略
fonts则使用系统字体。
- 颜色:
colors,从网站的调色板构建:bg:卡片背景。深色调在亮色收件箱中效果良好,在暗色模式下也不会刺眼。如果网站是浅色的,浅色卡片也可行。card:稍有不同的面板颜色line:边框text、muted和subtle:文本颜色,从最强到最暗。它们需要与bg有清晰的对比度。accent:品牌色good和bad:绿色和红色link:在白色收件箱上足够深且可读的强调色
将 story.type 设置为您选择的场景;默认值为 chat。
在渲染前向用户展示计划,并等待他们的批准。包括场景、故事台词(或选择的图片及说明),以及您将使用的Logo。
4. 渲染并检查
node <skill folder>/scripts/render.mjs brand.json signature.gif
它会打印文件大小和 PASS 行,写入 signature-last.png(循环结束帧,必须与第一帧匹配),如果文本超出边缘、文件超过1 MB或循环未在第一帧结束则报错,并写入 signature-first.png(旧版Outlook显示的那一帧)。打开该图片和两三张循环中间帧,检查:
- 右侧边缘没有内容被截断(长文本通常是原因)
- Logo清晰
- 颜色可读
- 第一帧是完整的卡片
要在例如 5 秒处提取一帧,运行 ffmpeg -ss 5 -i signature.gif -frames:v 1 frame5.png。修复并重新渲染,直到通过检查并看起来正确。如果超过1 MB,首先移除大面积动画。降低 --fps 12 是最后的手段。
在进行下一步之前,向用户展示第一帧和一张循环中间帧(或GIF本身)。
5. 构建团队页面
node <skill folder>/scripts/build-page.mjs brand.json email-signature.html
要在部署前预览,在工作文件夹中运行 npx serve .,然后打开 http://localhost:3000/email-signature?preview=signature.gif。省略 .html:serve 会重定向 .html 地址并丢弃 ?preview 部分,导致页面尝试加载尚未上线的GIF。preview 参数仅改变页面显示的内容;复制的签名仍指向 gifUrl。请尝试输入长名称以及 < 和 & 等字符,它们应原样显示。
6. 部署
阅读 references/deploy.md。它涵盖了常见技术栈(静态主机、Next.js、Astro、WordPress、Webflow 等)下两个文件应放置的位置、当用户无法将文件放到其网站时GIF的托管方式、robots.txt 中需要添加的行,以及上线后需要检查哪些内容。请遵循网站正常的变更发布流程:如果是 Git 仓库,则创建分支和合并请求。未经用户许可,不要推送或部署。
7. 交接
告知用户:
- 链接: 团队共享的页面地址,以及GIF地址。
- 已验证项: 您自己检查过的内容,例如渲染检查、查看过的帧以及页面预览。
- 上线后仍需检查: 在 Gmail、Outlook 和 Apple Mail 中粘贴测试,具体列表见
deploy.md。在GIF上线前无法检查真实邮件客户端的任何行为,因此请明确说明,不要暗示一切正常。 - 后续更新: 编辑
brand.json,重新渲染,并在同一地址替换GIF。所有人的签名会自动更新,但邮件客户端的图片缓存可能需要一天或更长时间。