SuperAPI AI 工具集

design-explorer

设计与创作

查看项目

更新于 10-15 22:40

技能介绍

用途:在提交单一设计方向前,先比较多个可行方案。它生成一次性的 HTML 片段,在本地评审界面中投票、标注,读取记录下来的证据,再把胜出的思路实现到真实产品中。该技能是 houshuang/design-explorer 的 MIT 分支,本地服务器无 npm 依赖,默认只绑定回环地址,除非明确请求 tailnet 访问。

主要能力:先确认固定约束(配色、字体、间距、层级、语气、无障碍底线),有设计系统时只变化布局语法(密度与留白、扫描顺序与层级、渐进披露、导航与控制提示、媒体位置、交互姿态),没有设计系统则明确说明并做更广的视觉方向轮次。生成 6-10 个 mockup-{slug}.html 片段,每个只含一个裸片段,使用真实产品文案。评审界面支持方向键导航、上下键投票、Tab 聚焦备注、P 添加定位备注、D 绘制(Shift 画框)、C 提交本轮。每次提交的设计都会被捕获,产出 captures/.png、annotations.json、feedback.md、captures/.html 四类证据。

使用方式:需要 Node.js 18 或更高版本。设置 SKILL_DIR 为包含 SKILL.md 的绝对目录,用 git rev-parse --show-toplevel 取项目根,通过 scripts/workspace-path.mjs 与 scripts/register.mjs 注册工作区,然后打开 http://127.0.0.1:10000 评审。端口被不兼容服务占用时用 --port 另选空闲端口,并在评审 URL 与所有 register、status、stop 命令中保持一致。手机或平板评审可用 --tailnet 重启服务器。

适用场景:需要在多个布局方向间做有依据的取舍、希望用投票与标注收集评审证据、或想先做低成本探索再落地组件的设计流程。

限制:mockup 是参考材料,不能直接作为生产代码发布;评审与写入端点无认证,tailnet 模式仅限可信的个人 tailnet,且绝不绑定 0.0.0.0;默认不要把评审产物、笔记或信号台账加入项目树,需用户许可;服务器在 30 分钟无活动后空闲退出;本地服务器不调用模型、不需要付费 API key。Google Fonts 可用时走网络,不可用时回退系统字体。若捕获失败应如实报告,不能仅凭文本产物断定视觉结果。