# Adaptive Matrix

> Adaptive Matrix 是一个 PostCSS 8 插件：每个 px 按它所在设计稿的宽度换算，而不是按全局唯一的宽度换算。页面、移动端组件库、桌面端组件库来自不同的设计稿，给每张稿子一张自己的画布，是让三者同时缩放正确的前提。产物是有上下界的 clamp()，文字保持可缩放以满足 WCAG 1.4.4。常见组件库的画布已经内置，用了组件库的项目默认配置就是对的。

每个链接都指向该页的原始 Markdown，可以直接抓取。整套文档拼在一起是 https://moresyl.github.io/postcss-adaptive-matrix/llms-full.txt。

## 文档

- [快速上手](https://moresyl.github.io/postcss-adaptive-matrix/zh/docs/getting-started.md): 装上去，配一张设计稿的宽度，把第一个页面跑通。
- [在线试验场](https://moresyl.github.io/postcss-adaptive-matrix/zh/docs/playground.md): 在浏览器里用任意配置编译一段 CSS，直接读输出。
- [构建工具集成](https://moresyl.github.io/postcss-adaptive-matrix/zh/docs/integration.md): Vite、Nuxt、Webpack、Rspack、Taro、uni-app，每个都给可用的配置。
- [命令行预览](https://moresyl.github.io/postcss-adaptive-matrix/zh/docs/cli.md): 改配置之前先编译一份样式表，把输出看清楚。
- [组件库适配](https://moresyl.github.io/postcss-adaptive-matrix/zh/docs/libraries.md): 内置了哪些画布、组件库是怎么识别的、怎么自己加一个。
- [配置参考](https://moresyl.github.io/postcss-adaptive-matrix/zh/docs/configuration.md): 每个选项的类型、默认值，以及改了它输出会变成什么样。
- [架构与转换公式](https://moresyl.github.io/postcss-adaptive-matrix/zh/docs/architecture.md): 每个数字是怎么来的：多画布模型与换算公式。
- [可选运行时](https://moresyl.github.io/postcss-adaptive-matrix/zh/docs/runtime.md): 软键盘、会收起的地址栏、WebView——需要时才引入的那一小段运行时。
- [浏览器支持与降级](https://moresyl.github.io/postcss-adaptive-matrix/zh/docs/compatibility.md): clamp()、vi、env()、@layer、容器查询的支持情况与降级路径。
- [迁移指南](https://moresyl.github.io/postcss-adaptive-matrix/zh/docs/migration.md): 从现有的 px 换算方案换过来，且不改设计稿。
- [发布与兼容性](https://moresyl.github.io/postcss-adaptive-matrix/zh/docs/release.md): 发布产物、支持的 Node 版本、版本号策略。
- [面向 AI 的文档](https://moresyl.github.io/postcss-adaptive-matrix/zh/docs/agents.md): 所有机器可读的入口，以及提示词里该写什么才能得到对的答案。

## 规范与示例

- [一致性套件](https://moresyl.github.io/postcss-adaptive-matrix/zh/conformance/index.md): 语言无关的行为定义，纯数据，任何语言的实现都能拿它做验收。
- [可运行示例](https://moresyl.github.io/postcss-adaptive-matrix/zh/examples/app-pc/index.md): App 375 + PC 1440 的完整工程。
- [更新日志](https://moresyl.github.io/postcss-adaptive-matrix/zh/CHANGELOG.md): 每个已发布版本的改动，最新在前。

## 机器可读

- [配置项 JSON Schema](https://moresyl.github.io/postcss-adaptive-matrix/schema/options.json)：全部配置项的类型、取值范围与默认值。默认值取自编译器本身，中文描述在 `x-description-zh`。