本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

superdesign-skill

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:superdesigndev/superdesign-skill

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• What it does — finds design direction, sets up design systems, approves presentation outlines, and generates + iterates high-quality UI, slide decks, and graphics on an infinite canvas.
• Who it's for — developers, indie hackers, and product/UI designers who want to go from idea to shippable UI fast without leaving their coding agent.
• Two ways in — this skill from any coding agent, or the web app at superdesign.dev.
• Search prompt library (style/components/pages)
• Get prompt details — read the compact index first, then fetch the full body only for the slug(s) you pick

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件装上后能用了吗，还需要做什么？

插件本身只把 Superdesign 技能说明注册进 dsh 的技能列表，具体的生成/迭代由 Superdesign CLI 负责。所以装好本插件后，还需要全局安装 @superdesign/cli（npm install -g @superdesign/cli@latest）并完成一次 superdesign login，技能在第一次实际出图前会引导你走完这一步。

这个插件会读取我的代码吗？会把代码上传到哪吗？

技能会读取你本地仓库的源码、样式、配置来理解当前 UI（写在 .superdesign/init/ 里），生成时按需把相关文件作为上下文通过 CLI 提交给 Superdesign 后端。它不会整库批量上传，也不会把本地路径直接写进生成的 HTML —— 所有图片素材都必须先走上传拿到公开 https:// URL 才会被嵌入。

为什么设计文件都写在我的仓库里？卸载会留下什么？

技能把初始化产物写到 .superdesign/init/（六个上下文文件）、.superdesign/design-system.md、.superdesign/replica_html_template/ 和 .superdesign/resume.json，全部在项目根的 .superdesign/ 目录下。卸载插件不会自动清掉这些本地文件，需要的话手动删除即可；删除后 dsh 看不到技能，但其他 harness（Claude Code、Cursor、Codex 等）如果之前装过同名技能也仍然保留。

跟直接用网页版 superdesign.dev 有什么区别？

网页版是图形化编辑器，支持像素级"克隆"和可编辑画布。本插件走的是 CLI，技能侧能做到的是"风格借鉴式重建"——根据参考站点提取设计 DNA 之后做一份新的可编辑草图；如果用户要 1:1 的可编辑克隆，得去网页版。CLI 这边所有改动都在 superdesign.dev 的画布上可视化，技能只负责发起调用和返回 canvas/preview 链接。

没有前端代码的空目录能用吗？

能。SKILL.md 的 Step 1 把"空仓库/沙盒"识别为无代码路径，会跳过 init，直接通过对话收集设计上下文（目标用户、平台、风格偏好、参考站点），再走 BRAND NEW PROJECT 工作流生成草图。已有前端代码的真实仓库则会强制先跑 init，六个上下文文件不全就跑不动。

报错了怎么排查？需要重装吗？

先按 SKILL.md 的"When a command fails"分情况处理：登录错误就重跑一次 npx --yes @superdesign/cli@latest login；extract-website 超时（60–120 秒）允许重试一次；生成命令（create-design-draft / iterate-design-draft）失败一次后可走 references/design-with-your-model.md 自己导入 HTML 重试。任何命令连续失败都不应该再继续硬试，直接停下来告诉用户当前错误。

哪些 AI 工具能用到这个技能？

这个 DSH 插件只对 DeepSeek Harness 体系生效。同一份 skills/superdesign/ 树同时也被打包成 Claude Code 插件、Codex 插件、Cursor 插件发布，根 package.json 和 .claude-plugin/、.codex-plugin/、.cursor-plugin/ 四份 manifest 共用一个版本号，所以其他宿主只要走对应的插件市场或 npx skills add 也能装到同样的技能。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明（package.json 没有 peerDependencies；按 dsh plugin --profile web add github:... 通用协议接入）
• Node: 未声明（package.json 没有 engines；dsh/index.js 仅使用 node:fs/promises 与 node:url 内建模块；Node >=18 即可加载）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则