创建苹果备忘录截图 是做什么的?
生成看起来像真实 iPhone 截图的苹果备忘录屏幕——正确的状态栏、浮动工具栏药丸、粗体标题、带有段落间距的正文、黄色文本光标、自动更正下划线、可选的内嵌图片和待办清单,以及可选的 iOS 键盘。
目的
将 JSON 备忘录规格转换为像素级精确的苹果备忘录 (iPhone, 浅色模式) 截图——以原生分辨率 1180×2556 (DPR 2) 输出 HTML + PNG。它是 create-apple-notes-video-ad 模块逐帧驱动以模拟打字动画的确定性、无 LLM 渲染器,也是一个独立的工具,用于在广告、社交媒体帖子和故事板中生成一次性的“自我备注”节拍。编排智能体负责文案,此原子模块负责保真度(状态栏、智能标点、光标、自动更正下划线、工具栏、键盘界面)。
何时使用
- 需要为广告、社交媒体帖子、视频场景或产品原型制作一个假的苹果备忘录截图。
- 需要一系列苹果备忘录帧(仅标题 → 添加段落 → 光标移动)来驱动打字动画视频——由
create-apple-notes-video-ad使用。 - 需要在故事板中创建一个静态的“自我备注”节拍。
如果你正在渲染 iMessage 会话,使用 skills/atoms/messaging/create-imessage-mockup 代替。
输入
此技能是确定性的——它不嵌入 LLM。编排智能体根据下面的模式编写一个备忘录 JSON,然后调用渲染器。
备忘录 JSON 模式
{
"title": "Hello",
"body": [
{ "type": "paragraph", "text": "This is a screen recording of me typing on apple notes app." },
{ "type": "paragraph", "text": "Let's see how this feels." }
],
"cursor": "end",
"autocorrect_underline": ["this", "how"],
"status_bar": {
"time": "9:41",
"battery_pct": 87,
"battery_low": false,
"show_focus_glyph": false
},
"show_keyboard": false,
"keyboard_state": {
"suggestions": ["see", "go", "do"],
"shift": "lower",
"letters_row1": "qwertyuiop",
"letters_row2": "asdfghjkl",
"letters_row3": "zxcvbnm"
},
"with_iphone_frame": false
}
title— 字符串。粗体显示标题,单行。body[]— 块列表。支持的块类型:paragraph—{ "text": "..." }。智能标点会自动应用('→',"→",...→…,--→–,---→—)。image—{ "src": "<路径|网址>", "caption": "可选" }。相对路径相对于规范文件所在目录解析,并内联为 data URI。checklist—{ "items": [{ "text": "...", "checked": true|false }] }。已勾选的项目会显示黄色填充圆圈和删除线;未勾选的显示灰色外圈圆圈。divider— 水平线。
cursor—"title" | "end" | null。"title"将黄色插入符放置在标题末尾;"end"将其放置在最后一行的末尾;null隐藏它。autocorrect_underline[]— 精确大小写词列表。每个匹配项都会获得苹果备忘录打字中的黄色下划线(<span class="spell">)。status_bar—time,battery_pct(0–100),battery_low(将电池颜色设为红色),show_focus_glyph(在时间旁边显示请勿打扰/车辆图标)。不渲染灵动岛。show_keyboard—true会覆盖 iOS QWERTY 键盘和格式工具栏。keyboard_state— 仅当show_keyboard为 true 时使用。shift="lower" | "upper"。with_iphone_frame— 添加一个细的深色边框内嵌(用于主视觉合成)。
CLI
node render.js --note examples/mid.json
node render.js --note examples/long.json --output ./my-exports/ --name todays-note
node render.js --note my-note.json --with-keyboard
node render.js --note my-note.json --viewport 1080x1920 # 9:16 广告交付尺寸
标志
| 标志 | 效果 |
|---|---|
--note <路径> | (必需) 符合上述模式的 JSON 文件 |
--with-keyboard | 强制启用 show_keyboard (覆盖规范) |
--with-iphone-frame | 强制启用硬件边框 |
--no-frame | 强制禁用硬件边框 |
--output <目录> | 带日期输出文件夹的父目录;默认 ./apple-notes-mockup-exports/ |
--name <标识> | 覆盖输出文件夹标识 |
--out-html <路径> / --out-png <路径> | 直接写入显式路径 (跳过日期文件夹) |
--viewport WxH | 覆盖渲染视口 (默认 1180x2556) |
--dpr N | 设备像素比 (默认 2) |
输出
<输出>/<YYYY-MM-DD>-<标识>/
index.html # 完整独立的 HTML (图片内联为 data URI)
screenshot.png # 在选定的视口 × DPR 下渲染的 PNG
spec.json # 输入副本,用于可重现性
默认 <输出> 是当前工作目录中的 ./apple-notes-mockup-exports/。
工作流程
- 接收一个提示或现有的备忘录 JSON。
- 如果只提供了提示:根据模式编写一个
note.json并保存。 - 运行
node render.js --note <路径> [--with-keyboard]。 - 打开生成的 PNG 以验证布局。如果看起来有问题 (错误的换行、错误的光标位置、错误的电池颜色),编辑 JSON 并重新渲染。
一次性设置
cd create-apple-notes-mockup
npm install
npx playwright install chromium
仓库附带一个指向 create-imessage-mockup/node_modules 的符号链接,因此在新克隆上只需要 npm install(如果你希望此技能是自包含的)。
文件
| 文件 | 用途 |
|---|---|
render.js | CLI 入口——解析标志、解析图片路径、生成 HTML、截图 |
generate.js | 备忘录 JSON → 独立 HTML 页面 (在此应用智能标点和自动更正下划线) |
screenshot.js | HTML → PNG 通过 Playwright (Chromium 无头) 以 1180×2556, DPR 2 |
templates/note.css | 所有视觉样式 (状态栏、工具栏、正文、待办清单、图片、键盘) |
templates/icons.js | 内联 SVG 图标 (返回箭头、撤销、分享、更多、完成勾选、信号、Wi-Fi、电池、格式工具栏图标、键盘符号) |
assets/samples/sample-landscape.jpg | examples/with-image.json 使用的示例图片 |
examples/*.json | 6 个参考备忘录,涵盖所有变体 (仅标题、打字中间、长多段落、带待办清单、带图片、框架-1 小写键盘) |
tests/run-all.sh | 将每个示例渲染到 tests/output/ 中供视觉检查 |
apple-notes-skill-build.html | 并排对比板,将参考视频帧与生成的 PNG 进行比较 |
质量检查
在声明备忘录可交付之前:
- 标题渲染为粗体显示标题,而不是常规字重。
- 正文使用苹果的智能标点——
'是弯的,"是弯的,…是单个字符。 - 黄色光标 (
#FFCC00) 紧贴目标文本末尾,大约 5px 宽。 - 正文段落之间由一条空白视觉线分隔 (没有手动
<br>)。 - 自动更正下划线是短黄色线条,紧贴在被标记的词下,区分大小写匹配。
- 状态栏:时间靠左,信号/Wi-Fi/电池靠右。电池为红色当且仅当
battery_low: true。没有灵动岛。 - 滚动遮罩: 状态栏和工具栏具有不透明白色背景,以便模块驱动器滚动的正文内容不会渗透出来。通过在开发者工具中将
.note平移-300px来验证,并确认标题被工具栏完全遮罩——不会在工具栏后面/透过它可见。 - 工具栏:浮动返回箭头药丸 (左侧),带有撤销/分享/更多的白色胶囊,黄色完成圆形 (右侧)。全部投射柔和阴影。
- 键盘 (启用时):QWERTY 布局匹配
shift大小写,建议栏显示 3 个词,格式工具栏药丸在按键上方,底部有麦克风和地球图标。 - 图片块渲染为圆角 (~18px) 并遵循正文左侧内边距。
- 待办清单:已勾选项目显示黄色填充圆圈 + 删除线;未勾选项目显示灰色外圈圆圈。
失败模式
| 症状 | 原因 | 修复 |
|---|---|---|
| 正文换行过早或过晚 | 字体宽度与参考不同 (Chromium 选择了非 SF 回退字体) | 以 2px 步长调整 .note-body 上的 font-size,或通过减少左右内边距来加宽 .note |
| 标题看起来细/不够粗 | 主机没有 SF Pro Display;系统回退到更轻的字重 | 设置 font-weight: 900 (已经是默认值) 并检查 `fc-list |
| "Hello's", "Let's" 渲染为直引号 | 智能标点预处理程序被禁用 | 验证在 generate.js 中的 escapeHtml 之前调用了 smartQuotes() |
| 图片没有渲染 (空白区域) | 远程 URL 被阻止或相对路径未解析 | 使用本地文件路径;render.js 将本地图片内联为 base64 |
| 自动更正下划线也匹配 "This" (当只打算匹配 "this") 时 | 正则表达式是大小写不敏感的 | 正则表达式默认是大小写敏感的。在 autocorrect_underline 中传递精确大小写字符串 |
| 空段落折叠 (没有光标空间) | <p class="note-paragraph"></p> 没有内容,高度为零 | CSS 设置了 margin: 0 0 84px 0,因此空段落仍然占据一个段落间距;确保你没有删除尾部边距 |
| 黄色完成圆形看起来偏橙色 | CSS 颜色漂移 | 纯苹果黄是 #FFCC00。光标和完成共享此值;不要改为 #FFC107 (Material 琥珀色) |
| 键盘建议 "Hello's" 渲染为直撇号 | 智能引号未应用于建议 | 已在 generate.js 中通过 smartQuotes(s) 确认应用 |
参考
视觉规格是从 apple-notes-typing.MP4 (一个 36 秒的 iPhone 屏幕录制,在浅色模式下在苹果备忘录中打字) 提取的。请参阅此文件夹中的 apple-notes-skill-build.html 获取并排证明——每个示例都与它针对的参考帧一起显示。