文档

English · 简体中文

按你现在要做的事情挑一篇：

你想做的事	读这里
装上去，跑通第一个页面	快速上手
什么都不装，先试一份配置	在线试验场
接进 Vite / Nuxt / Webpack / Taro	构建工具集成
改完配置，先看看输出对不对	命令行预览
项目里用了 Vant / Element Plus / antd…	组件库适配
查某个选项叫什么、默认值是多少	配置参考
想知道数字是怎么算出来的	架构与转换公式
软键盘 / 地址栏 / WebView 把布局顶歪了	可选运行时
要支持某个旧 Safari / WebView	浏览器特性支持与降级
从现有的 px 换算方案换过来	迁移指南
发版、产物、Node 版本	发布与兼容性
让编码 Agent 接手这个项目	面向 AI 的文档

规范与示例：

• 一致性套件——语言无关的行为定义，纯数据，任何语言的实现都能拿它做验收
• 可运行示例——App 375 + PC 1440 的完整工程

核心模型

整个项目只解决一件事：一个 px 要先知道自己画在哪张设计稿上，才谈得上换算。

页面、移动组件库、桌面组件库来自三张不同的稿子——甚至第三张根本没有稿子。给每张稿子一个画布（profile），每个 px 按自己画布的宽度换算，是唯一不需要在「页面缩放但组件不动」和「组件被按错误比例拉变形」之间二选一的做法。

画布归属由三条通道判定：类名前缀、自定义属性前缀、文件路径。内置组件库的通道已经写好，所以默认配置就是对的。