用途
Superdesign 是一个面向设计的命令行工具，核心用途是在无限画布上查找设计灵感、生成或迭代设计稿。它覆盖前端 UI、演示文稿（presentation）和平面图形（graphics）三类设计工作，并可在设计需要新视觉素材时提供图像与视频生成。
主要能力
- 设计、还原或改进 UI：在画布上创建页面、功能、流程与新产品。
- 选择与比较前沿设计模型：通过 list-models 查看可用模型，为任务选择合适模型，或用不同模型探索独立方向。
- 创建设计系统与可复用组件：建立视觉基础、提取模式，设计相互连接的多页体验。
- 基于在线网站或参考 URL 设计：提取并应用该站点的设计语言。
- 创建或导出演示文稿：规划可编辑的幻灯片大纲，在对话中确认，生成真实演示稿，进行幻灯片安全编辑，或在被要求且支持时重建可编辑的 PPTX。
- 创建平面图形：海报、封面、社交帖子、缩略图、传单和广告。
- 生成辅助图像或视频：在合适时使用原生图像生成，或从 Superdesign 的生成模型中选择。
- 继续或直接修正已有工作：通过 resume 机制恢复已保存目标，或使用直接创作路径。
使用方式
Superdesign 完全通过其 CLI 运行，因此需要能够执行 shell 命令的环境。
- 环境预检：先确认是否具备执行 shell 命令的能力。若环境完全无法运行命令，应停止操作，并提示用户改用支持 Work 模式的界面，或在 https://superdesign.dev 的网页应用中设计。
- 判断是否存在代码库：根据是否存在 .superdesign/init/ 文件、是否包含前端依赖的依赖清单、是否存在前端源码，区分“无代码库”与“有真实代码库”两种路径。无代码库时跳过仓库初始化，改为对话式收集设计上下文后设计；有真实代码库时，设计前必须至少完成一次仓库初始化。部分独立场景（仅提取站点设计基因、平面图形、演示文稿、图像/视频生成）可跳过初始化。
- 恢复优先于重新发现：在真实代码库 UI 路径下，先检查 .superdesign/resume.json 中是否有请求目标，匹配时默认走恢复流程，而非冷启动重新发现。
- 仓库初始化：当存在真实代码库且未完成初始化时，自动创建 .superdesign/init/ 目录、阅读 INIT.md 并按其说明分析仓库、写入上下文文件。初始化完成的判定标准为六个指定文件全部存在且非空，否则重新运行完整初始化。
- 运行 CLI：按需使用
npx --yes @superdesign/cli@latest。每次会话先运行裸命令作为预检，它会检查 CLI 是否可运行、显示 auth 状态行（已认证的团队或未认证）、并列出最近项目。若未认证，需先运行npx --yes @superdesign/cli@latest login并等待登录成功。所有命令使用相同前缀，例如npx --yes @superdesign/cli@latest create-project --title "X"。命令默认输出面向智能体的紧凑格式，需要完整机器可读数据时加 --json。 - 展示画布 URL：每个项目/草稿命令的默认输出都会包含 canvas 链接（https://superdesign.dev/teams/<teamId>/projects/<projectId>），草稿另含 preview 链接（https://superdesign.dev/preview/draft/<draftId>）。这些链接应从命令输出中读取，不应手工构造。给用户可点击链接，邀请其打开画布观看设计生成并留下反馈；在画布 URL 后加 ?live=1 可打开实时视图。
- 浏览器行为：create-project 默认在用户浏览器中自动打开画布，应保持开启并告知用户；仅在无面向用户浏览器的环境（CI、无头环境）使用 --no-open。
适用场景
- 分析代码库以服务于设计工作（superdesign init 在 .superdesign/init/ 中构建可复用 UI 上下文，阅读 INIT.md）。
- 为前端设计、还原或改进现有页面与流程。
- 建立设计系统与可复用组件。
- 从参考网站提取设计语言。
- 制作并导出演示文稿。
- 制作海报、封面、社交帖子等平面图形。
- 生成设计所需的图像与视频。
- 继续迭代或修正已有设计草稿。
限制
- 工具完全依赖 CLI 与 shell 命令执行能力，无法运行 shell 命令的环境不可用。
- 每次生成都会消耗 credits，因此应在用户确认选择后再进行生成。
- 使用前需要认证登录；会话可能中途过期，需按失败处理流程重新登录并最多重试一次。
- 命令失败时的一般规则为最多重试一次。
- 图片与本地资源需按用途路由：临时截图/参考图作为画布参考节点，logo、字体等可复用身份图像作为 Brand Assets，最终内容图像作为项目内容；不得批量上传整个仓库，不得在草稿 HTML 中写入本地文件系统路径。
- 关于具体收费方式、价格、可用模型清单、平台支持范围等细节，资料中暂未提供具体说明。