核心用法
Wireframe 是一款面向 UI/UX 设计师与产品经理的原型线框图生成工具,支持通过命令行快速产出页面布局、组件草图、用户流程图及标注文档。核心功能覆盖六大场景:
| 命令 | 用途 |
|------|------|
| `page` | 生成整页线框(header/hero/features/cta/footer 等区块) |
| `component` | 单组件草图(卡片、表单、导航、表格等) |
| `flow` | 用户流程图,支持决策分支(如 auth:yes/no) |
| `annotate` | 为现有 SVG 添加编号标注与图例 |
| `export` | 导出为独立 HTML(内联样式) |
| `template` | 内置模板快速启动(落地页、仪表盘、博客、电商等) |
输出格式灵活:ASCII 直接打印到终端,SVG 保存为矢量文件,HTML 则生成可分享的独立页面。
显著优点
1. 轻量高效:纯 Bash 脚本,依赖极少(仅需 bash 4+),无需 Docker 或复杂运行时。
2. 格式多元:ASCII 适合快速草稿与代码仓库文档,SVG 适合设计工具导入,HTML 适合演示与分享。
3. 模板驱动:内置 landing、dashboard 等模板,降低从零开始的决策成本。
4. 可组合性:命令设计遵循 Unix 哲学,可链式调用(如生成 SVG → 标注 → 导出 HTML)。
潜在缺点与局限性
- 交互性有限:生成的是静态线框,无法实现点击跳转或交互动效,需配合 Figma/Axure 等工具补充。
- 样式自定义弱:ASCII/SVG 的视觉风格固定,难以深度定制主题色、字体或间距系统。
- 版本依赖:虽仅需 bash 4+,但部分企业级 macOS 默认 bash 3.x 需手动升级。
- 无协作功能:不支持实时多人编辑或版本管理,需借助 Git 等外部工具。
适合人群
- 早期创业团队:快速产出可阅读的页面结构,用于投资人演示或开发对齐。
- 后端主导的全栈开发者:在缺乏专职设计师时,自主生成可交付的 UI 文档。
- 技术写作者:为开源项目或技术博客生成中性的界面示意图。
常规风险
- SVG 注入风险:若将用户输入直接拼接到 SVG 路径或文本节点,可能存在 XSS 隐患;建议对
--notes等参数做 HTML 实体转义。 - 文件覆盖:
--output参数若指向已有文件,默认行为是覆盖而非追加,需留意版本控制。 - HTML 导出体积:内联样式可能导致单文件较大,在邮件或 IM 传输时需注意大小限制。