artifact-sandbox 的输出契约是仅生成一个 .html 文件(不是 .md,也不拆分 CSS/JS 文件),文件名通常是 <technique>-sandbox.html。每个沙盒只演示一种 CSS/JS 技术,页面包含六部分:标题(eyebrow + 技术名 + 一句话说明)、演示舞台(居中,按钮触发或加载后循环)、控制面板(滑杆与下拉,每个参数变化立即更新舞台,并配 <output> 显示当前值)、实时源码(随控制状态更新的 .code-block,带复制按钮)、预设行(3-5 个预设按钮,如 Subtle、Default、Bold、Bouncy)、说明(何时使用该效果、注意事项如 prefers-reduced-motion 与约束)。
常见可调技术:CSS transition(duration、easing、property、delay)、CSS keyframe(duration、iteration、easing、fill mode、keyframe stops)、transform 组合(translate、rotate、scale 各自滑杆)、颜色过渡(from-color、to-color、duration)、错峰/级联(item count、stagger delay、per-item duration)。一个沙盒只选一种技术,控制项全部同屏可见,默认状态即推荐预设。使用前应先阅读 artifact-css/SKILL.md 了解输出契约、设计令牌和交互层(jQuery + jQuery UI 加载模式,沙盒按需启用滑杆)。
适用场景:用户说“让我调调缓动”“实时调这个动画”,需要输出可交给设计师或 PM 收敛数值的动作规格,或为某效果附带实时预览页。若要做多数据结构的三栏看板或表单编辑器,应使用 artifact-editor;若要做动画原理的幻灯片,应使用 artifact-deck。
限制与要求:禁用 JS 时舞台仍渲染(纯 CSS 效果播放,JS 驱动效果显示静态末态),滑杆为原生 <input type="range">,实时源码显示默认预设;必须尊重 prefers-reduced-motion 并加媒体查询禁用循环动画;循环动画要配播放/暂停按钮;舞台尺寸 200-400px;需提供“重置为默认”按钮;避免自动全速循环、无输出值的滑杆、无 prefers-reduced-motion、过小演示元素等常见错误。完成后可提供两个衍生:当前 CSS 规格的可复制片段,以及针对调校值的浏览器支持/性能说明。原文未提供具体代码、安装命令、收费或平台信息。