安装
/plugin marketplace add ckryptickunal/OpenDesigner
/plugin install opendesigner@opendesigner适合谁
适合已经在用 AI 编程助手、但项目还缺一套统一视觉规范的开发者与小型团队：你手里可能只有几页设计稿或几句口头描述，代码里的颜色、字体、间距却在各个页面各写各的；也可能项目刚起步，谁都抽不出时间先做一整套设计系统。它是加装在你现有 AI 工具里的附加包，作用是把讲不清的审美偏好变成代码能直接消费的文件，而不是另开一个设计软件；它是 MIT 许可的免费开源项目，不会替换掉你正在用的编辑器，只是往里加一层能力。凡是愿意回答几个简短问题、接受结果落到项目目录、并愿意在合入前自己再过一遍的人，都适合先跑一次。刚接手别人写的代码、想先摸清视觉基调的人，也可以拿它做一次快速勘察。
3 分钟完成第一次尝试
先检查前置条件：机器上要有 Python 3.10 或更高版本。引擎只是一个 Python 文件，无需安装依赖。
第一步，装技能。推荐路径是 Claude Code 的插件市场：在对话里输入 /plugin marketplace add ckryptickunal/OpenDesigner，回车后再输入 /plugin install opendesigner@opendesigner。
第二步，认准安装位置。支持 Agent Plugins 的工具会读取根目录的 plugin.json，而读取技能的客户端约定从 .agents/skills/ 目录取文件；不走插件市场路径的客户端，需要你自己把技能复制进项目的 .agents/skills/。
第三步，触发一个低风险任务。打开你的项目，在对话里说「Create a design system for this project.」，它会抛出最多五个简短问题，每个问题都附上建议答案和理由，你逐条确认或改写即可。第一次尽量挑一个干净目录跑，或者先开一个分支，这样生成的令牌不会和既有代码混在一起。
第四步，先约好副作用与确认点。引擎会把结果写成 DESIGN.md、PRODUCT.md 以及 opendesigner/ 目录，里面装着令牌、各类导出和一个概览页。落盘会直接改写仓库内容，所以先建分支或提交一次；确认完答案再让它写。
第五步，看可观察的成功信号。项目里出现上面那三个产物，并且自检环节没有报错——文字对比度按 WCAG 2.2 AA 校验、点击目标不小于 24 px、键盘焦点可见、并处理了减弱动效偏好；只要出现错误，构建就会停下来。
使用案例
案例一：为新项目铺出第一版设计系统。装好插件后，在项目里说出上面那句英文触发语，回答它提出的最多五个简短问题，就能拿到一版完整的设计系统，而不是零散片段。第一版不必追求完美，它本来就是给你继续追问和迭代的起点。接着可以往下钻：颜色、字体、间距、动效这四类都能单独再问一轮去细化，产物始终落在同样那三个文件与目录里。证据止于此处——官方写明了问题上限是五个、细化维度就是这四类，但没有说明能否调整问题数量，也没有描述每一轮细化的交互形式。
案例二：在没有插件市场的客户端里复用同一套技能。把技能复制进项目的 .agents/skills/ 目录，然后照旧在对话里请求生成设计系统并回答问题，产出与自检规则和案例一完全一致。如果项目里已有令牌约定，动手复制前先确认两套命名不会打架。官方只说明了这些客户端从该目录读取技能，没有交代复制之后如何更新，也没有给出额外的依赖或配置步骤。
使用边界
引擎的硬性要求只有一条：Python 3.10 或更高版本，除此之外不装任何依赖。安装方式也只有官方写明的那几条：插件市场之外必须手动复制技能，官方并没有为手动路径提供自动更新或校验命令。它运行时会直接改写项目文件，所以动手前先留好分支或提交。内置自检是硬门槛，对比度不达 WCAG 2.2 AA、点击目标小于 24 px、键盘焦点不可见、或者没有处理减弱动效，都会让构建停下；它不会替你修，改完得重跑一遍。五题问答的前提是问题本身能被简短回答，涉及复杂业务规则时，引擎给不出判断。设计系统也不是最终产物：令牌与文档落在仓库里，如何与既有组件库合并、是否纳入版本管理，官方文档都没有交代，需要你自己判断。仓库地址：<https://github.com/ckryptickunal/OpenDesigner >。