用途:zul-writer 用于创建结构良好的 ZK Framework ZUL 页面(.zul),并提供一套五步工作流。依据资料,五个步骤为:澄清需求、生成 ZUL、校验 ZUL、生成控制器类(ViewModel 或 Composer)、预览与自查(将页面渲染为图片并对照需求检查)。当用户提供 UI 截图或原型图时,先进行可视化分析,再进入五步流程。
主要能力:可将 UI 元素映射为 ZK 组件,优先使用 ZK 组件而非原生 HTML,并建议采用 borderlayout、vlayout、hlayout 等布局组件。生成时建议通过类名(sclass)设置样式而非 style 属性;尺寸与间距交由组件自身的 hflex/vflex、width、height 等 API 处理。可使用 bundled 校验脚本 validate-zul.py 以 --describe 查询组件与属性,以及 --zk-version 指定版本;预览脚本为 preview-zul.py,默认 ZK 版本为 10,预览默认 10.2.1。可借助 detect-pattern.py 检测项目既有页面的 MVC/MVVM 模式。若涉及 ZK Charts,需先参考 charts-guidelines.md。
使用方式:五步是入口而非固定链条,可按请求只执行需要的步骤。例如仅要求预览某 .zul 时只执行第 5 步;仅校验有效性时执行第 3 步;生成页面时执行第 1 到第 5 步。从已有文件推断 MVC/MVVM 模式、布局与 ZK 版本,只询问无法推断的信息。若无人可问,资料给出默认值:ZK 版本 10.x;页面用途无默认,需从请求读取;模式默认 MVC(除非项目一致为 MVVM);数据默认静态;布局无默认,需从用途推导;主题保持项目现有主题,并可提示 iceblue_c 存在。
限制:无官方文本;具体收费、价格、平台支持与效果暂未提供。资料中的路径与命令需按原样使用;未提供的功能与步骤不应推测。