---
name: zaowuyun-design
description: Apply Zaowuyun brand, layout, responsive and UI rules when creating or updating Zaowuyun websites, product interfaces or visual assets. Use the published design system and preserve the existing content structure.
---

# 造物云设计与VI规范

## 读取当前版本
1. 读取 https://www.zaowuyun.com/design-system-manifest.json ，确认发布版本与文件摘要。
2. 读取 https://www.zaowuyun.com/design.md 。离线包使用 references/design.md，离线版本需在交付时注明。
3. 需要视觉示例时读取 https://www.zaowuyun.com/design-system.html 对应章节；品牌标资源规则见 https://www.zaowuyun.com/logo-guide.html 。

## 执行约束
- 用户任务及仓库约束优先。只改授权范围；发现规则冲突应指出并对照当前源文件，不混用历史版本。
- 沿现有品牌和叙事结构迭代。新增布局规则放在布局章节，组件行为放在组件章节，变更日志放在版本章节。
- 数值从 tokens.css 读取，复用 design-system.css；先令牌后组件。不用截图反推色值或随手发明新数值。
- 容器含内边距：标准1180、文档1280、宽幅/框架1600；正文最多680。移动4栏、平板8栏、桌面12栏，卡片1/2/3列。断点与页边距以执行规范为准。
- 按钮用action-bg/action-fg，信息文字不用fg3；透明背景按最终合成色核验对比度。品牌色不自动等于按钮底色。
- 品牌标不拉伸、不拆白底板；区分内嵌SVG和下载锁版的反色方式。字体与图标遵守现有VI。
- 静态图示不是现成行为组件。菜单、弹窗、表单要有键盘与焦点、状态、错误及重试契约；未实现的功能不能声称可用。
- 外部案例与客户交付分开，作者自述与核验事实分开。示意数字不转述为真实业绩。

## 验证与交付
- 对实际改动测试相关宽度及断点两侧；明暗主题、长文案、键盘焦点、减弱动效与涉及的状态。
- 不靠裁剪隐藏溢出的必要内容；数据表和代码使用有名称、可键盘访问的局部滚动区。
- 报告所用版本、变更文件、真实测试结果、例外与待办。未测就明确未测。
- 发布前备份与核对远端并发变更；发布后复核。更新规范时同步文档、令牌、组件、manifest与变更记录。

## 包内资源
- references/design.md：执行与验收规范。
- references/tokens.css：本次发布的设计令牌。
- references/design-system.css：基础布局与组件API。
- references/design-system-manifest.json：发布信息与摘要。
- references/design-system-changelog.md：历史和迁移说明。

## 按任务读取 · V2.2
- 品牌资产或图像：读取 [场景与图像规范](https://www.zaowuyun.com/design-system-usage.html)，离线读取 [references/design-system-usage.md](references/design-system-usage.md)，再按需读取Logo规范。
- 页面设计：先用一句话说明受众、页面类型与主要任务，选择品牌表达/产品操作/内容阅读模式，再读取对应布局、排版与状态章节。保留已确认的VI，不默认换字体、紫蓝或技术栈。
- 组件实现：读取manifest中的component_status核对实际可用程度，不把静态示意当作已实现API。新组件记录复用用途、尺寸/变体/状态、键盘行为和验证。
- 审查任务：输出文件位置、具体问题、用户影响、建议及验证证据。按任务选择相关检查，未执行的检查明确注明。
- 外部系统和skill仅作方法参考；来源与采纳理由见 [研究记录](https://www.zaowuyun.com/design-system-research.html)。真实截图用于证据，简化UI用于明确标记的流程解释，不伪造已上线能力。

## 基础交互 · V2.3
复用design-system.js前先核对manifest状态：开合导航、原生dialog有行为示例，完整营销导航尚未成为统一组件；表单仅本地模拟，不含真实请求。
挂载后调用ZaowuyunUI.mount(root)，卸载时调用返回的cleanup；不要在相同root重复绑定另一套处理器。
表单与弹窗必须测试错误/失败/重试、Escape、背景焦点隔离、焦点恢复和清理；演示完成不等于生产服务接通。