通用踩坑与技巧清单

两个项目跑下来，沉淀出一份通用的「踩坑与技巧清单」。不管你做什么类型的小工具，这几条都能直接避坑。

红线类（必被 check 拦 / 审核驳回）

  1. 外链 / iframe / 跳转：想「打开网站」是头号雷，改用内置快照 + 本地交互。
  2. CSS 硬编码颜色：写 #fff、rgb() 必被拦，全部改 --cos-color-* token。
  3. 字号 < 14px：小于 --cos-text-body 必被拦，统一用 token 字号。
  4. 第三方脚本 / CDN：任何外链脚本标签（script 的 src 指向 http）都违规，库要离线内联。
  5. localStorage / eval / alert：运行时存储、动态执行、系统弹窗一律禁。

工程类（不拦但会翻车）

  1. 中文编码：文本/二维码里的中文必须按 UTF-8 处理，否则乱码（详见 a4-01）。
  2. 第三方库风险 API：内联前人工核查是否含 eval / 网络 / 存储，光靠 check 不够。
  3. 剪贴板方向：写入允许、读取禁止，别搞反。
  4. sendLog 守卫：调用前必须判 window.genui 存在性，否则本地/平台外打开会报错中断。
  5. 组件路径：照搬 assets/components/ 里的 layout/radio/tabs，别自己造轮子。

提效技巧

  • 边写边 check：把 genui check 当本地 lint，每完成一个模块跑一次，避免最后堆积。
  • 单 HTML 内联：能单文件就别 ZIP，最不容易踩资源路径坑。
  • 截图反解验证：生成类（二维码/图片）用「无头浏览器截图 → 程序反解」做真实验证，别只看渲染。
  • 数据快照化：需要展示远程内容就提前抓取内置，万象云档 440 本仅 29.8KB，轻量无压力。
  • 表头与表单一致：界面表头、提交名称、简介三者语义对齐，避免审核「表里不一」。

一个自查小口诀

颜色用 token，字号十四起； 外链全掐断，库要离线内； 中文 UTF-8，剪贴板只写； 组件照搬用，check 过再提交。

把这八句背下来，能cover住 80% 的合规问题。剩下 20% 交给 genui check 和审核反馈补足。