跳至正文
Design — Paper.design 最佳实践:从网页画布到代码,兼谈 Figma 与 Pencil

Paper.design 最佳实践

Paper Docs · Paper Roadmap · Paper vs Figma · Paper vs Pencil

AI 参与说明(Agent:Codex)。依据三家官方文档、发布记录和团队原文整理,产品状态核对至 2026-11-19。工作流与案例是本文建议。Paper 画布内的导入、Agent 写入及交付流程供读者按步骤复现。

如果要重做一个已经上线的网页区块,Paper 最值得尝试的地方是可以从实际网页取样,在画布上并排比较方案,再把选中的设计交给 Agent 和工程师实现。HTML/CSS 画布让布局、字体与颜色的表达更靠近 Web。团队仍要决定解决什么问题,并在真实浏览器中验证交互。已有共享组件库、多角色评审和可点击原型的团队,可以继续用 Figma 承担这些工作。希望设计文件随功能代码进入同一个 Git PR 的团队,则更适合考察 Pencil(现名 pen.dev)。

英文术语中文名称简要解释
Canvas画布并排摆放方案、状态和说明的工作区
Paper Snapshot网页捕获扩展将浏览器里看到的网页区域转成 Paper 中的可编辑图层
Design Token设计令牌为颜色、间距等设计决策命名,供多个位置引用
MCP模型上下文协议让 Agent 调用工具来读取设计上下文或修改画布
Handoff设计交付把选定方案、状态和行为规则交给实现者

Paper 的设计哲学

先保留选择,再决定实现

Paper 团队的 Agu Seguí 把画布视作思考和协作的空间。Agent 能快速生成方案,设计师仍要同时看见几个方向,判断各自适合什么情境。改版时可以把线上版本、两个候选方案和取舍理由放在一起。让 Agent 扩充内容或整理图层,再由设计师判断哪一个方案能让访客更快理解、薄弱环节在哪里。这个方法也适用于手工设计,MCP 减少的是重复操作。 Paper 团队原文

让画布采用 Web 的表达方式

Paper uses HTML and CSS as its rendering foundation. 例如订阅卡片用 Flexbox 的容器方向、gap 和 padding 表达结构,开发者可以沿用这些布局关系,Agent 也能从节点读取样式。Paper 还强调 CSS 原生颜色表达与视觉效果,例如在画布中使用 oklch()、Display P3 与 CSS filters。用于品牌页面时,可以先选定色彩和材质方向,再回应用检查目标浏览器与显示设备上的实际效果。 Paper 团队对渲染选型的说明 · Paper 对比 Figma

画布里排得下的按钮,部署后还要支持键盘焦点、长文案、提交中和失败重试。Paper 可以让视觉结构更容易传递,应用组件、断点规则与运行时状态依然由代码表达。把画布当作评审视觉意图和布局的地方,把代码仓库当作生产行为与共享组件的依据。

同一项改版,三种工作方式

假设要把 Newsletter 的订阅表单改成窄屏纵排,并补齐提交失败的提示。选择工具前,先问团队打算在哪里决定方案,又在哪里审核一次完整的改动。

  • Paper 适合先在画布上决定界面怎么改。 用 Snapshot 把线上区块带进 Paper,将原版和两个候选方案并排放在同一张 HTML/CSS 画布上。团队用同一个画布链接选版、对照状态,可以用 MCP 读取定稿的布局和样式,再到代码仓库修改现有表单。画布是这次视觉评审的记录,运行行为由应用代码交付。
  • Pencil 适合让设计文件随功能代码一起进入 Git 评审。 在本地工程中把 newsletter.pen 和表单组件放进同一个功能分支。PR 可以包含设计稿、表单实现与测试。开发者切回该提交时,也能在 Pencil 打开当时的设计;无需本地工程的评审者可以看桌面端生成的共享快照。并行修改同一份 .pen 时,要像管理其他仓库文件一样安排冲突处理。
  • Figma 适合沿用团队的共享组件库与交互评审。 使用库里的字段和按钮实例做出成功与失败状态,将它们连成可点击的流程,产品经理先在原型里走完一次订阅,再把定稿标记为 Ready for dev。

Paper 和 Pencil 都能导入网页、让 Agent 编辑并交付代码。两者的画布表达和工作产物各有侧重。Paper 以 HTML/CSS 渲染画布,便于在设计评审中讨论 Flexbox、间距和颜色。Pencil 使用专用的 .pen 节点模型和 WebGL 画布,设计文件可以跟着源码做分支和版本回溯。导入与导出发生在各自的工作流里,设计变化是否落实到应用,最终看代码 PR。 Paper 官方对比 · pen.dev 官网 · pen.dev 的 .pen 文件与 Git · pen.dev Design ↔ Code

工具产品哲学与主要产物在订阅区块上的用法采用前要确认
Paper用 Web 样式表达视觉设计,人与 Agent 在共享画布上比较方案。产物是画布中的可编辑图层、选定状态和样式上下文从现有页面捕获区块,保留基线,用同一组真实文案比较布局并交回前端实测团队与外部评审者各自权限,查清 token 的跨文件更新方式和组件复用条件
Figma Design围绕共享设计文件组织多人协作、原型、设计系统和交付。产物是设计文件、库、原型和 Dev Mode 规范用已发布的组件和变量制作状态,连成可点击流程供产品评审,再标记 Ready for dev核对组件库、Dev Mode 和 MCP 对应席位,以及设计组件与代码组件的映射
Pencil(pen.dev)把可编辑设计和工程文件放在同一工作环境。产物可以是与代码同仓的 .pen 文件及资源在功能分支一起改 .pen、组件代码和测试,由同一个 PR 审核约定相对资源路径、同文件并行修改的处理方式,以及外部评审用哪个快照

Paper Build Log · Figma 对设计流程的说明 · Figma Library 指南 · Figma 原型指南 · Figma Dev Mode 指南 · pen.dev 的 .pen 文件指南

Paper 对比页适合读它怎么定位自己。竞品能力以竞品的现行文档为准。

  • Figma 已支持 Agent 写入。 Figma 的 Remote MCP 将 Write to canvas 标为 Beta。符合客户端、文件编辑权限和席位条件时,可以创建原生图层、使用现有组件和变量。Figma 也区分了把运行界面捕获为图层和用组件库构建设计,两项能力的产物不同。Paper 的差异落在 HTML/CSS 画布及其配套工作流。 Figma Write to canvas
  • Pencil 已有 Web 入口和共享机制。 pen.dev 文档描述的桌面分享会上传带依赖的快照,评审者可以查看、下载或评论,文件所有者更新后需要刷新共享快照。团队若要求实时共同编辑同一份稿件,可以参考 pen.dev 自家的对比页,其将实时共同编辑列为即将推出。.pen 是有公开结构说明的 JSON 设计文档。它和前端代码可以一起版本化,设计与实现之间的转换由 Agent 按请求执行。 pen.dev 官网 · Share a design · pen.dev 对比 Paper · .pen 格式 · Design ↔ Code

如果这次的难点在设计系统,Figma 的库允许维护者发布组件、样式与变量,消费方在自己的文件里评审并接受更新。pen.dev 支持仓库内的 .lib.pen、可替换内容的 slots 和多维主题,依赖文件重新打开时读取库更新。Paper 当前的文件内 Design Tokens 可以先覆盖试点需求,跨文件分发则要计入维护成本。 Figma Library 发布指南 · pen.dev Design Libraries · pen.dev Slots · pen.dev Variables · Paper Tokens

用 Paper 完成一次网页改版

下面以一个邮件订阅区块为例。假设现有 Web 应用已经有表单组件和 CSS Design Tokens。希望在桌面保留紧凑的并排布局,在窄屏把输入和按钮按阅读顺序排开。最终交付包含一张设计评审链接和一个可运行的代码 PR。

1. 从一块有真实内容的界面开始

在浏览器打开自己的页面或测试环境,用 Paper Snapshot 捕获订阅区块,粘贴进 Paper。把结果命名为 Newsletter / Baseline,旁边建两个候选 Frame,并记录来源页面、捕获时的宽度和所处的状态。先核对字体、图片、溢出与图层嵌套,再开始改。用测试数据复现长标题、错误提示和窄屏。遇到本地图片缺失,按 Snapshot 文档检查资源 URL 和开发服务器的 CORS 配置。 Paper Snapshot 说明 · 本地图片排查

如果手里已有 Figma 稿,先复制单个代表性 Frame 到 Paper。官方导入说明指出,粘贴时组件实例和变量会解除关联,图片也可能需要连接有访问权限的 Figma 账号。逐项检查图层结构、图片和样式,再决定是否迁移更多页面。若已有一段自写 HTML,可按官方指南提供带 inline styles 的片段,HTML Paste 会忽略 class 和由选择器应用的样式。 Paste from Figma · Paste from HTML

没有现成页面时,可以把下面的 HTML 保存为 newsletter.html,在该文件所在目录运行 python3 -m http.server 8000 --bind 127.0.0.1,打开 http://127.0.0.1:8000/newsletter.html 后通过 Snapshot 选取订阅区块。这个无依赖样本在窄屏时会把字段与按钮换行,按钮只用于展示版式。导入后,在 Paper 里尝试分别选中标题、字段与按钮,再改长标题。如果粘贴后得到一整张图片,回到浏览器扩展重新捕获可编辑图层。

html
<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>邮件订阅区块</title>
<section style="max-width: 640px; padding: 24px; background: #eff6ff; color: #172554">
  <h1>订阅产品设计简报</h1>
  <p>每月一封,分享值得读的实践。</p>
  <div style="display: flex; flex-wrap: wrap; gap: 12px">
    <input aria-label="邮箱地址" placeholder="name@example.com" type="email"
      style="box-sizing: border-box; flex: 1 1 260px; min-width: 0; padding: 12px">
    <button type="button" style="padding: 12px 24px">订阅简报</button>
  </div>
</section>
</html>

2. 用容器和 Design Tokens 表达约束

把标题与说明放在一个容器,把字段与按钮放在另一个容器。使用 Flexbox 的方向和 gap 表达布局,让长文案能改变内容占用的空间。画出 390 px 与 1024 px 的参考 Frame,并写清中间宽度的规则,例如表单容器够宽时字段和按钮并排,空间不足时换成上下排列。参考 Frame 是两个观察点,真正的切换条件要在浏览器里检查。 Paper MCP 的布局与交付指南

在 Theme 面板中绑定来自仓库的语义化 Design Tokens,例如 --color-surface、--color-text 和 --space-form-gap。先只同步这个区块用到的几个值,改一个间距值,确认引用它的候选方案一起更新。Paper 文档说明跨文件复制的是值与定义,之后单个文件中的更新不会传播到其他文件。团队可把 CSS 文件定为每次同步的依据,记录来源提交,并在设计确定后审阅涉及 token 的代码差异。 Paper Tokens

3. 让 Agent 先确认目标,再改一组节点

在本机使用 Paper Desktop,打开目标文件后,从编辑器的 MCP 面板连接所用 Agent。新配置以 Paper CLI 的 stdio 接入为主,旧 HTTP 配置按官方迁移指引处理。需要从云端操作时,官方另有 Remote MCP Early Access,连接时需登录 Paper。先让 Agent 报告它看到的文件和选区,确认后再修改画布。 Paper MCP 安装与连接

选中 Newsletter / Baseline,将下面的提示词交给已连接 Paper 的 Agent。若需要并排比较视觉方向,可以先做一个变体并评审,再用同样的样本约束第二个变体。

text
先读取当前选区并报告文件、页面与 Frame 名。确认它是 Newsletter / Baseline 后,复制到同一页,命名为 Newsletter / Stacked。保留 Baseline。
只调整副本的订阅字段与提交按钮容器,使用 Flexbox 和已有 Design Tokens。用 390 px 参考宽度检查标题换成「每月收到产品设计与前端实践精选」后的换行。
在副本旁画出提交中、已提交、失败可重试三个状态。失败状态保留原邮箱。完成后返回可用于评审的 Frame 名,并检查画布截图是否有裁切。

评审时打开基线和副本,核对基线和其他图层是否保持原样,字段和提示能否一起换行,以及各状态下用户是否看得出下一步。视觉判断通过后,交给工程师选定 Frame 及其状态说明。需要评估外部协作时,使用评审者的实际身份打开链接,确认其可见范围和权限。

4. 在应用里验收交互,再回画布比对

让实现 Agent 读取选定 Frame,与仓库现有表单组件和 token 对照后再改代码。Paper 可以复制 React CSS 或 Tailwind 代码作为交付输入。工程侧沿用现有字段、验证和提交逻辑,根据 PR diff 确认没有引入另一套表单或重复定义 token。若最终浏览器效果有偏差,可以用 Snapshot 把实现结果放到候选稿旁边,逐项核对。 Paper Build Log · Paper 的设计转网站示例

验收项操作通过条件
响应式打开本地应用,在 390 px、两种布局的交界和 1024 px 更换长短文案字段与按钮按约定换行,页面无横向溢出,提示信息保持可见
键盘用 Tab 从输入框走到提交按钮,再提交表单焦点可见,顺序符合阅读顺序,字段有可访问名称
提交状态在测试环境模拟慢响应、成功和失败提交中避免重复请求,成功有反馈,失败保留已输入邮箱并允许重试
设计一致性比较 Paper 中的选定 Frame、应用截图和 PR版式取舍一致,新增样式复用已有语义 token,代码评审能定位选定方案

如果要试用一周,可以让同一个团队用同一个真实区块完成以上流程。记录评审后发生了几次视觉返工、实现时复用了哪些现有组件,以及有多少状态需要口头补充。这三项足以检验 Paper 有没有减少当前工作流里的交接成本。

怎样读 Paper 的路线图

Roadmap 展示 Paper 希望减少哪些交接工作。判断能否用于本周的项目时,优先看专项文档、Build Log 和实际文件权限。比如九月的 Build Log 曾把 Remote MCP 列为即将推出,现行 MCP 文档已经给出 Early Access 接入步骤。HTML Paste 的文字说明仍有旧的 Rich Text 限制,十月的 Build Log 已记录 Rich Text Editing 上线。涉及导入保真度时,仍应拿自己的一段混合样式文案实测。 Paper Roadmap · Paper Build Log · Paper MCP · Paste from HTML

官方资料中的状态对当前项目的影响
Snapshot、本地 MCP 和文件内 Design Tokens 有公开使用指南可以先用它们试点一个已有网页区块
Roadmap 将直接使用项目代码组件、Native Tailwind CSS integration 列为进行中现有 Copy as code 可用于生成起点。仍由工程师在仓库里匹配组件并审阅代码
Components with slots 标为即将推出,CSS Grid 标为计划采用 Flexbox 完成本例。项目若依赖 slots 或 CSS Grid 编辑能力,先在所用版本验证
Tokens 已可在文件内使用,Theme Modes 和共享库仍是专项文档中的后续方向有跨团队发布依赖的项目,先保留现有库的发布方式,用代码管理产品主题的最终值

Paper Roadmap · Paper Tokens

关联阅读

博客助手

正在打开博客助手…