Agent设计执行说明 · V2.3
无需JavaScript或安装skill即可读取。先读本页与执行规范，按任务再读场景与图像。
支持读取原始文件时，用版本清单核对版本与摘要，再读Markdown和组件API。
造物云设计与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.3
- 品牌资产或图像：读取 场景与图像规范，离线读取 [references/design-system-usage.md](references/design-system-usage.md)，再按需读取Logo规范。
- 页面设计：先用一句话说明受众、页面类型与主要任务，选择品牌表达/产品操作/内容阅读模式，再读取对应布局、排版与状态章节。保留已确认的VI，不默认换字体、紫蓝或技术栈。
- 组件实现：读取manifest中的component_status核对实际可用程度，不把静态示意当作已实现API。新组件记录复用用途、尺寸/变体/状态、键盘行为和验证。
- 审查任务：输出文件位置、具体问题、用户影响、建议及验证证据。按任务选择相关检查，未执行的检查明确注明。
- 外部系统和skill仅作方法参考；来源与采纳理由见 研究记录。真实截图用于证据，简化UI用于明确标记的流程解释，不伪造已上线能力。
基础行为模块 · V2.3
开合导航与原生dialog示例使用design-system.js；模板挂载后调用ZaowuyunUI.mount(root)，卸载时调用返回的清理函数。需支持原生dialog。
表单仅在本地模拟校验、成功、失败与重试，不发送请求。完整营销导航仍需单独实现，演示不等同生产服务接通。