延伸阅读
Pi 延伸阅读
用于 Pi 设计的教程、文档与实操指南，均列于已发布的指南中。
Pi 
OpenDesign 用 Pi
在 OpenDesign
做设计。
如何在 OpenDesign 中用 Pi 设计界面：可移植的 skill、你选择的模型与密钥、一个从 brief 到已审核文件的方案对比任务，以及开始前需要了解的限制。
从 brief 到界面01 / Pi
您带来想法↗
“用一个可移植的
skill 进行方案比较，适用于任意模型。”
一个完整的 Pi 设计任务
一个 Pi 设计任务：从 brief 到界面
一个完整呈现的任务：你交付的 brief 与约束条件、返回的产物，以及在完成前你仍需运行的检查。下方的界面是为本页面制作的示意示例，并非 Pi 的实际运行记录。
1设计 Brief 与约束条件
Brief为一款笔记应用设计方案对比页面：免费版、个人版和团队版，一个功能对比表和一个简短的常见问题。桌面端和手机端。
- 设计系统OpenDesign 纸感画布：Albert Sans，单一绿色强调色
- 断点1440px 桌面端与 390px 移动端，无横向滚动
- 交互账单切换开关、方案 CTA、对比行展开
- 输出一个自包含的 HTML 文件，带有稳定的
data-od-id挂钩
2分工：你、Pi 和 OpenDesign
- 你
撰写 brief，选择设计系统并定义验收标准。
- Pi
规划布局，编写 HTML、CSS 和 JavaScript，并按要求进行修改。
- OpenDesign
提供设计系统与 skill，渲染预览，并将每个版本作为文件存储在项目中。
- 审查
在交付前，检查视觉层级、8px 网格上的间距、两个断点以及每一项交互。
3Pi 产物：1440px 与 390px 下的方案对比页面
4交付前审查
Layout
网格与间距
三种方案与对比表共用 8px 网格；功能行在各列间对齐。
Hierarchy
视觉层级
价格和方案名称优先显示；强调色标示出最受欢迎徽章及其按钮。
Responsive
移动端布局
个人版在前，其次是免费版，然后是团队版；切换开关保持在顶部。
Interaction
交互检查
切换开关，用 Tab 键遍历 CTA，展开一行对比内容。
Fit
Pi 适合该任务的情况，以及不适合的情况
Pi 适用于以下情况
- 任意模型，您的 key。 使用您自己的 key 接入 Anthropic、OpenAI、Google 等；为截图转 UI 选择一个强大的多模态模型，并用 /model 切换。
- 可移植的 Skill。 将您的设计约定编码为符合 Agent-Skills 标准的 Skill，不仅限于 Pi，还可在兼容的 Agent 之间迁移。
- MCP + 扩展。 通过 Figma MCP 服务器引入真实的设计上下文，并用 TypeScript 扩展编写验证循环脚本。
- 开放且 BYOK。 MIT 许可、本地优先；您只需为底层模型付费，凭证始终留在您自己的机器上。
选择其他工作流的场景
- 你需要可编辑的矢量文件。 产物是 HTML，而非可编辑的设计文档。请查看其他矢量工作流以获取所需的资源格式。
- 没有参考图也没有约束条件。 缺少设计系统或示例时，输出往往趋于千篇一律；请先写好 brief。
- 您没有该 Agent 所需的凭证。 必需：您自己的服务商 API key（自带 key）或通过 /login 进行订阅登录。OpenDesign 不提供也不代理凭证。
- 您的团队使用 Aider 或 OpenCode 工作。 这些 Agent 都有各自的页面；工作区相同，配置方式不同。参见相关 Agent。
兼容性
开始使用 Pi 之前的要求
本指南介绍通过 OpenDesign 桌面应用连接的 Pi。已核实的公开参考资料截至 2026 年 9 月 6 日。
工具范围Pi，由社区打造
Pi 是 earendil-works 推出的开源（MIT）终端 AI 编程 Agent。它基于一个精简的四工具核心——read、write、edit、bash——读取你的代码库、编辑文件并运行命令。本页介绍的是通过 OpenDesign 使用 Pi 设计界面，而非 Pi 自身的界面。OpenDesign 的设置说明列出了可用的 Agent。
账户与身份验证你自己的服务商 API key（BYOK）或
你自己的服务商 API key（BYOK）或通过 /login 进行的订阅登录。使用你自己的服务商 API key（BYOK）或订阅登录进行身份验证——凭据始终留在你自己的机器上。本页不承诺任何配额或价格。
系统与版本桌面应用或源码
请查看下载页面获取桌面版构建。源码快速入门中的 Node.js 和 pnpm 要求适用于从源码运行，而非安装桌面安装包。最低兼容的 Pi 版本：本文未做验证。
连接检查成功的标志
按照你所安装版本显示的连接说明操作，然后运行一个小任务。确认 Pi 已处理该任务，且产物可以正常打开。仅完成下载并不能建立有效连接。
从桌面应用开始
三步完成 Pi 设置
先下载，为你安装的版本完成 Pi 设置，然后检查一个小结果。按照这条路径操作，你不需要从源码构建 OpenDesign。
- 1
下载 OpenDesign 桌面应用
选择适合您电脑的软件包，安装并打开该应用。
下载 OpenDesign检查点桌面应用会打开。已经安装过？请进入下一步；无需再次下载。 - 2
准备你的 Pi 连接
按照你所安装版本中的 Pi 说明操作。使用你自己的服务商 API key（BYOK）或订阅登录进行身份验证——凭据始终留在你自己的机器上。
Pi 服务商与身份验证文档# 1. Install the Pi coding agent CLI (Node) npm install -g --ignore-scripts @earendil-works/pi-coding-agent # 2. Authenticate with your own provider key (BYOK) export ANTHROPIC_API_KEY=sk-ant-... # or OPENAI_API_KEY=sk-... # (or run /login inside Pi for a Claude / ChatGPT / Copilot subscription)来自已发布指南中的 Pi 设置说明；请查阅厂商文档以获取当前命令。
检查点确认目标 Agent 与账户。如果不可用，请在尝试更大任务之前先检查兼容性。 - 3
运行一个小型 Pi 任务
使用一个小 brief，以便您评估整个流程，包括一次修改。
入门 brief构建一个设置页面，包含个人资料表单和保存确认提示。使用我的设计规则。在桌面和移动端宽度下进行检查。
检查点打开结果，测试保存状态，并提出一个具体的修改请求。生成的文件是评审的开始，而不是结束。
若要从源代码运行 OpenDesign，请参阅技术快速入门。
Pi 设计工作流
Pi 设计工作流的五个步骤
同一个方案对比页面任务，从 brief 到可验证文件的完整流程。每一步列出你提供的内容、Pi 完成的工作、OpenDesign 贡献的部分，以及你需要检查的内容。
- 1
设计 Brief
用简明语言写三到六行，说明目标受众、该界面要完成的任务，以及适用的平台。
- 您撰写 brief；如有参考截图，请附上。
- Pi读取 brief 和项目的指令文件；遇到模糊之处时会提问。
- OpenDesign提供项目、prompt 界面，以及对应产物类型的 skill。
- 检查确认 brief 中已写明验收标准。现在补充比生成之后再补充成本更低。
- 2
设计约束
一套设计系统加几条硬性规则。正是这些将符合品牌调性的产出与千篇一律的效果区分开来。
- 您选择一个设计系统；说明断点及必须使用的组件。
- Pi在编写第一行代码之前，将 DESIGN.md 中的 token 和风格规则加载到上下文中。
- OpenDesign提供设计系统库，并将所选设计系统绑定到 skill 模板中。
- 检查确认 token 与您的品牌相符：单一强调色、正确的字体、正确的圆角。
- 3
生成界面
Pi 编写一个自包含的 HTML 文件：布局、样式、交互与稳定的 hooks。
- 您等待即可，或回答澄清性问题。无需进行任何配置。
- Pi规划各个区块，编写 HTML、CSS 和 JavaScript，运行该文件并修复失败之处。
- OpenDesign将产物保存到项目文件夹中，并为预览建立索引。
- 检查此步骤暂无需检查。请在文件渲染后进行判断，而非查看源代码。
- 4
预览
文件会以你要求的宽度在 OpenDesign 中渲染。设计的好坏就在这里被检验。
- 你切换宽度，点击交互，在元素上留下评论。
- Pi读取你在预览上的评论，并准备下一版修订。
- OpenDesign渲染预览，暴露
data-od-id目标以供评论和编辑。 - 检查层级结构、对比度、390px 下的溢出、焦点状态，以及强调色是否使用得克制。
- 5
修订与验证
通过在预览中指向元素来请求修改。每次修订都是一个新文件，绝不会被静默覆盖。
- 你把评论转化为请求；决定任务何时完成。
- Pi就地应用更改并重新运行该文件。
- OpenDesign将各版本并排保留；完成后导出图片或 HTML。
- 检查只重新检查发生变化的区域，然后在每个断点上完整检查一次整页。
资源
Pi 设计资源
限制
Pi 的局限性、人工检查与后备方案
- 范围它与提供方无关：可在 Anthropic、OpenAI、Google 及 20 多个提供方之间统一调用，因此你可自带密钥并在会话中切换模型。本页只涉及作为 Agent 连接到 OpenDesign 的 Pi，并非 Pi 的全部功能。
- 使用限额使用限额与费用取决于你所使用的凭据（自有的提供方 API key，或通过 /login 进行的订阅登录）。本页不对免费额度作任何说明。
- 网络本地项目文件并不代表离线推理。在分享敏感输入之前，请检查你的 Agent 供应商设置和数据政策。
- 输出为 HTML产物是 HTML 文件，而非矢量设计文件。
- 人工审查可访问性、真实内容、品牌契合度和交互正确性均由你在预览中审查。将 Agent 的任何自检视为初步检查。
- 后备方案如果 Agent 不可用或任务失败，请检查所安装版本的连接说明和身份验证。在更改配置前，请保留错误信息和最后一个可用的产物。
常见问题
关于 Pi 与 OpenDesign 的常见问题
Pi 真的能胜任设计工作吗？
可以——在具备审美 skill、设计系统以及上下文中真实参考图像的情况下，Pi 能产出生产级、响应式的 UI，你还可以将其路由到强大的多模态模型，用参考图像来核对输出结果。若缺少这些上下文，它往往会退回到通用的外观，而这正是 OpenDesign 所填补的差距。
用 Pi 做设计需要付费吗？
Pi 本身是免费且开源的（MIT 许可）。你只需为底层模型付费——自带提供方 API key（BYOK），或通过 /login 使用 Claude Pro/Max、ChatGPT Plus/Pro 或 GitHub Copilot 订阅。无论哪种方式，OpenDesign 都不会代理你的凭据。
是什么让 Pi 特别适合设计工作？
它与提供方无关：你可自带密钥，并路由到 20 多个提供方中的任意一个，根据任务所需的优势挑选模型，并在会话中切换。但审美水准始终来自你提供的设计系统、skill 与参考资料，而不是来自模型本身。
在 Pi 中做前端设计应选用哪个模型？
Pi 可路由到许多提供方，因此应按任务选择——强大的多模态模型能很好地读取参考截图，而其他模型可能更适合重构。Pi 的优势在于你可以切换模型而无需改变工作流。OpenDesign 让你无论选择哪个模型，都能保持相同的设计上下文。
如何将 Pi 连接到 Figma？
Pi 支持 MCP 服务器，因此你可以添加 Figma MCP 服务器并拉取真实的设计上下文——组件、变量、布局数据——从而让生成的代码匹配源文件，而不是近似还原。
用 Pi 开始第一个设计任务
从一个小任务开始，评估往返效果，然后再提交真实的 brief。请选择与您的环境相符的选项；本页不会自动检测。