SuperAPI AI 工具集

preview-screens

通用与其它

查看项目

更新于 10-16 00:31

技能介绍

用途:在生成界面后,不启动 Metro 或模拟器,直接在浏览器中以手机外框(375×812)查看每个屏幕的静态预览,便于向相关方分享可截图的稿样或在部署前核对布局。

主要能力:扫描工作目录下 app/**/*.tsx,排除 _layout.tsx、+not-found.tsx、以 . 开头的目录文件等非屏幕文件,并从文件路径推导屏幕名称;按 Home 优先、最多两个详情屏、其余顺延的规则排序并生成标签按钮。通过读取 TSX 与 Tamagui 组件树,按 tamagui-html-mapping.md 将其转换为等价的 HTML/CSS,支持深浅色切换;若存在 tamagui.config.ts 中的自定义颜色 token 会作为 CSS 变量加入。生成的 preview.html 会写入工作目录,并按 memory-bank.md 中 visual_companion 标志决定是否自动打开(标志缺失或为 yes 时自动打开,为 no 时仅打印链接)。

使用方式:技能会先检查插件版本脚本,读取共享说明;定位项目时可用 --working-dir 指定目录,否则使用当前目录;随后发现屏幕、读取映射参考、逐个转换屏幕、组装并写出 preview.html。自动打开命令依次尝试 open、xdg-open、powershell.exe Start-Process,均失败则输出手动链接。

适用场景:生成屏幕后快速查看视觉预览、向相关方分享可截图稿样、部署前核对布局。

限制:对源代码只读,仅创建或覆盖 preview.html,不改动 TSX、布局、配置或 memory-bank;预览为静态近似,不执行 React、不处理状态、不获取数据,动态列表仅显示占位项,按钮与导航等交互不可用;PDF 查看、PDF 报告、分享、打印、手写签名捕获等原生能力仅以静态状态占位,不得暗示浏览器中可用;重复运行会覆盖上一份 preview.html,且不更新 memory-bank。运行真实应用应使用 npm run dev,修改屏幕应使用 /edit-app。