2.1 KiB
2.1 KiB
common 里存放环境的js 如果有参数 ?env=test 就走test api 如果没有参数默认是 线上的api 如果env=local 就是本地的api
H5 通用主题放在 common/theme.css，新页面默认引用该文件。 当前通用主题为浅紫色，不使用流光、彩虹渐变或高饱和装饰效果：主色使用 --hy-theme-primary / --hy-theme-primary-strong，按钮使用 --hy-theme-button，页面背景使用 --hy-theme-bg，卡片使用 --hy-theme-surface。 页面样式不要硬编码主色，优先消费 common/theme.css 里的 CSS 变量；只有 Figma 强制要求 100% 还原时才允许局部覆盖。
H5 多语言能力放在 common/i18n.js 和 common/locales/*.json，当前面向英语 en、阿拉伯语 ar、土耳其语 tr、西班牙语 es。页面文案使用 data-i18n / data-i18n-placeholder / data-i18n-aria 绑定语言包 key；新增页面必须优先复用 common 的语言包机制，不在页面脚本里硬编码多语言字典。
所有逻辑功能配置默认打开；只有密钥、地址、三方账号等必须由环境提供的敏感值使用占位符或环境配置，不在默认配置里伪造可用凭证。
所有业务逻辑、状态流转、权限判断、支付链路、异步流程都保持高密度逻辑注释，注释解释为什么这样处理和失败分支，不复述语法。
Figma / 截图还原超级红线
- 全局永久禁止把整页截图、Figma 根 Frame、整段轮播、整块底栏或包含多个可独立元素的大区块直接作为页面图片实现。
- 设计稿必须拆成独立视觉图层；文字、按钮、状态、列表、动态媒体与交互区域必须使用 DOM、CSS 和真实接口数据实现。
- 导出的设计素材必须能追溯到具体的单一视觉节点，并记录 source node、用途、尺寸和哈希；禁止素材内嵌动态文字、控件或业务媒体。
- 允许使用不包含文字、控件和动态业务内容的纯背景层，但它不能替代其上的任何可拆元素。
- 验收必须按图层、元素边界、间距、样式和交互逐项核对；禁止用整页设计截图覆盖页面，也禁止把整页截图像素差分作为通过依据。