mpx2ali
Skill4k starsChanged 3 days agoApache-2.0View on GitHub
Mpx 输出支付宝小程序(Mpx2Ali)的差异适配与开发实践。用于以微信语法开发的 Mpx 页面和组件在支付宝端的开发、迁移、方案设计、排障与代码评审,重点处理文本图片样式、输入框键盘、滚动弹层、窗口尺寸、样式隔离和页面配置;不用于未经 Mpx 编译的原生支付宝项目或纯 RN/Web 任务。
Files
Mpx2Ali 开发与适配
以现有微信实现和业务需求为基线,处理输出支付宝时需要业务适配的差异。优先复用 Mpx 已提供的转换能力,只为项目实际存在的差异添加局部适配。
任务识别
- 从构建命令、配置和依赖确认输出目标、源码方言及 Mpx 版本。
mode: 'ali'表示支付宝输出,srcMode: 'wx'表示微信源码方言;支付宝原生方言不能直接套用本 Skill 的转换结论。 - 区分小程序宿主与设备系统。支付宝中的 iOS / Android 通过运行时系统信息判断;
__mpx_mode__ === 'ios'是 RN iOS 编译目标,不能用来判断 iPhone 上的支付宝。 - 按任务读取下表命中的小节。新建或迁移完整页面、组件时核对模板、脚本、样式、JSON 四个区块;局部修复只检查受影响的部分。能力查询和方案讨论无需执行修改或构建。
按需读取
详细示例、版本基准及原始验证状态保存在 微信与支付宝小程序跨端开发最佳实践。先读其开头的适用范围,再定位本次任务相关小节,不默认加载全文。
| 任务线索 | 参考小节 |
| text 换行、省略号、white-space、image padding | 文本与图片样式 |
| input、enableNative、键盘上推、首次聚焦、输入框切换 | 输入框与键盘 |
| show-scrollbar、enhanced、disable-scroll、滚动穿透 | 滚动容器与弹层 |
| getWindowInfo、screenHeight、windowHeight、安全区 | 系统信息与尺寸 |
| 同名类污染、scoped、autoScopeRules | 组件样式隔离 |
| navigationStyle、自定义导航栏、disableScroll、allowsBounceVertical | 页面配置 |
| 自定义组件布局查询、真机回归范围 | 历史问题与验证范围 |
参考未覆盖的组件、API 或配置不能据此判定支持或不支持,需查询目标项目版本的文档、实现或测试。参考中的 RN 文本裁切章节仅保留原始补充材料,不作为支付宝适配规则。
适配原则
- 先核实框架是否已处理:按本地仓库当前实现复用已有转换;自定义导航栏统一声明
navigationStyle,不再要求核实旧版导航转换能力或提供手动替代分支。文本与滚动条等能力仍核对实际产物,避免重复添加框架已有的兼容处理。 - 保留原平台行为:优先共用节点、状态与事件链;单个属性有差异时用
@ali/@wx限定该项,样式使用条件注释,动态 JSON 使用<script name="json">按目标赋值。保留原有组件注册和无关配置,不为局部差异复制整个页面。 - 按场景采用兼容方案:输入框属性按宿主和设备系统选择;优先使用宿主自动上推,需要业务控制位移时避免与自动上推叠加。不要假设键盘事件固定顺序,也不要用统一延迟或固定键盘高度代替状态处理。
- 保留滚动职责:支付宝禁止滚动的蒙层与可滚动弹层采用兄弟节点。关闭纵向回弹不等价于锁定页面滚动或关闭下拉刷新;只有业务需要固定页面框架时才调整根布局。
- 统一尺寸来源:页面布局使用窗口尺寸,安全区计算核对坐标与单位。优先复用工程的公共系统信息封装,不把
@mpxjs/api-proxy当作已包含所有业务尺寸归一和缓存逻辑。 - 保留证据边界:历史机型问题、未复现问题和未真机验证的示例不能作为所有版本的固定限制。资料与工程不符时以目标版本和实际验证为依据,明确仍待核实的部分。
验证与交付
代码修改后,运行工程相关 ESLint、现有测试以及实际目标的构建;同时保留微信输出时检查微信与支付宝两端产物。导航栏重点核对生成的页面 JSON,条件属性和滚动结构重点核对模板产物。
文本默认换行与滚动条隐藏依赖完整 App 的兼容样式入口,不能仅凭单文件编译成功判定生效;独立分包、插件和单独编译的页面、组件需要在对应集成环境验证。滚动条值使用严格布尔值 false 才触发隐藏,true 不保证宿主强制显示滚动条。
涉及宿主渲染或交互时,按参考中的真机验证关注点覆盖项目实际支持的宿主与设备系统组合。交付说明修改点、执行过的检查及未验证范围;没有真机环境时,不声称键盘、滚动或安全区行为已通过验证。
Trending
Quiet since September.about the whole repository
Who's talking about didi/mpx
- ruanyf/weekly“[第 65 期] 自荐项目:小程序开发框架Mpx”GitHub · Jun 6, 2019 · 2 reactions
- thoughtbit/it-note“微信小程序”GitHub · Sep 26, 2016 · 1 reactions
- sudosubin/agents.nix“agent-skills.github.didi.mpx: init at 2.11.1”GitHub · Sep 26, 2026
- mpx-ecology/mpx-cli“Add React Native sourcemap composition and middleware support”GitHub · Jun 12, 2026
- mpx-ecology/mpx-cli“Unocss 插件无法在 VS Code 等IDE中工作”GitHub · Jan 21, 2026
The biggest 5 of 37 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 37
Talked about on GitHub (37 times).
On GitHub · 37
- Jun 6, 2019[第 65 期] 自荐项目:小程序开发框架Mpx — ruanyf/weekly2 reactions · 2 comments
- Sep 26, 2016微信小程序 — thoughtbit/it-note1 reaction
- Sep 26, 2026agent-skills.github.didi.mpx: init at 2.11.1 — sudosubin/agents.nix0 reactions
- Jun 12, 2026Add React Native sourcemap composition and middleware support — mpx-ecology/mpx-cli0 reactions · 1 comment
- Jan 21, 2026Unocss 插件无法在 VS Code 等IDE中工作 — mpx-ecology/mpx-cli0 reactions · 4 comments
32 more on GitHub
- Sep 30, 2025希望支持对模板中 wxs 文件使用 ~@ 方式引入的路径识别 — mpx-ecology/language-tools0 reactions
- Mar 18, 2025Feat: 增加 VSCode IDE 配置文件 — mpx-ecology/mpx-cli0 reactions
- Feb 29, 2024fix: cli依赖修复 — mpx-ecology/mpx-cli0 reactions
- Jan 6, 2023Bump json5, @mpxjs/webpack-plugin and loader-utils — zerowss/mlw-wx0 reactions
- Jan 6, 2023Bump json5, @mpxjs/webpack-plugin and loader-utils — liuzhengtao/mpx-demo0 reactions
- Jan 6, 2023Bump json5, @mpxjs/webpack-plugin and loader-utils — hbsndg/mpx-hello-world0 reactions
- Nov 17, 2022Bump loader-utils and @mpxjs/webpack-plugin — liuzhengtao/mpx-demo0 reactions
- Nov 17, 2022build(deps): bump loader-utils and @mpxjs/webpack-plugin — shengbaise/web-receipt0 reactions
- Nov 17, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — hbsndg/mpx-hello-world0 reactions
- Nov 17, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — shugetsu/store-weapp0 reactions
- Nov 17, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — CQCcq/personalMpx0 reactions
- Nov 17, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — zhaorx/baby-sleep0 reactions
- Nov 17, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — dyby/duanxianwang-mpx0 reactions
- Nov 17, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — sky-admin/mpx-cloud-demo0 reactions
- Nov 17, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — pl2476/mp-mpx0 reactions
- Nov 17, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — jiangzhiwei123/llhn0 reactions
- Nov 16, 2022Bump loader-utils and @mpxjs/webpack-plugin — sky-admin/mpx-subpackage-demo0 reactions
- Nov 10, 2022build(deps): bump loader-utils and @mpxjs/webpack-plugin — shengbaise/web-receipt0 reactions · 1 comment
- Nov 10, 2022Bump loader-utils and @mpxjs/webpack-plugin — liuzhengtao/mpx-demo0 reactions · 1 comment
- Nov 10, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — hbsndg/mpx-hello-world0 reactions · 1 comment
- Nov 10, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — shugetsu/store-weapp0 reactions · 1 comment
- Nov 10, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — zhaorx/baby-sleep0 reactions · 1 comment
- Nov 10, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — sky-admin/mpx-cloud-demo0 reactions · 1 comment
- Nov 10, 2022Bump loader-utils, @mpxjs/webpack-plugin and webpack-cli — pl2476/mp-mpx0 reactions · 1 comment
- Nov 9, 2022Bump loader-utils and @mpxjs/webpack-plugin — sky-admin/mpx-subpackage-demo0 reactions · 1 comment
- Jul 25, 2022前端跨平台框架 — klren0312/daliy_knowledge0 reactions · 5 comments
- Jun 21, 2021Taro2 什么时候支持可选链和空值运算符 — NervJS/taro0 reactions · 3 comments
- Aug 7, 2019store 方案讨论 — zfxmnb/westore0 reactions · 1 comment
- Jul 6, 2019Babelrc not correct — wux-weapp/wux-weapp0 reactions · 1 comment
- Jun 14, 2019chameleon 周报 [ 5.28 - 6.14 ] — didi/chameleon0 reactions
- Jun 13, 2019didi的开源项目下还有一款跨小程序的开源项目mpx(https://github.com/didi/mpx),chameleon如何看待? — didi/chameleon0 reactions · 1 comment
- Jan 2, 2019是否有兴趣支持一下mpx框架 — wx-minapp/minapp-vscode0 reactions · 5 comments
In this repository17 other files it gives its agents.
- AGENTS.mdAGENTS.md
- docs-vitepress/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- docs-vitepress/CLAUDE.mdCLAUDE.md
- changelog-generatorSkill
- doc-add-simple-hashSkill
- karpathy-guidelinesSkill
- mpx2rn-simpleSkill
- mpx2rnSkill
- mpx2skylineSkill
- mpx2webSkill
- mpx-mode-migrationSkill
- mpxSkill
- network-proxySkill
- review-loopSkill
- skill2geneSkill
- skill-creatorSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

