技能介绍

要解决什么

微信小程序面向境外用户时，常见阻塞不是功能缺失，而是本土化规则把用户挡在外面：手机号只接受 +86 和 11 位校验、姓名只允许汉字、证件类型只有身份证，以及固定宽度容器在英文、西班牙语、法语、德语翻译后出现文案溢出。这些 P0 问题会导致注册、实名、下单或客服流程中断。

技能如何工作

该技能按 P0 -> P1 驱动修复，先运行项目扫描，生成 validation/reports/scan-report.md 与 scan-result.json，再结合账号体系、信息录入、UI 排版三条线给出代码级建议。账号侧关注国际区号、号码位数、邮箱验证入口和国际短信通道，推荐优先使用微信手机号快速验证组件，或在自建区号选择器时按区号动态校验。录入侧会把姓名正则从仅汉字放宽为汉字、英文、空格、连字符、撇号等组合，并把证件类型扩展到护照、永居证、港澳台通行证。UI 侧通过 wx.getAppBaseInfo() 做语言分流，对非中文用户隐藏营销弹窗、裂变分享和积分任务，同时检测固定 width、固定高度、!important、缺少 word-break 等溢出风险，并按估算宽度与容器宽度比率给出 HIGH、MEDIUM、LOW 等级。

适用边界与注意点

它适合微信小程序前端体验适配，尤其适合境外开放、双语名称、实名表单和多语言 UI 优化。它不是完整后端国际化方案；国际短信服务商、邮箱验证、密钥管理与验证码频控仍需要后端和安全策略配合。扫描依赖需正确安装，若出现 Cannot find module 'fast-glob'，应先在 validation 目录安装依赖再运行。