Skip to content

Quality Gate

packy edited this page Jun 18, 2026 · 1 revision

质量门禁(13 项检查)

主题 CSS 生成后自动执行 13 项检查,分为 4 个维度。不通过的项目自动修正(最多 3 轮)。

维度 A:微信兼容性(4 项)

ID 检查项 原因
A1 <style><script><iframe> 标签 微信过滤这些标签,破坏布局
A2 position: absolute/fixed/relative 微信移除 position 属性
A3 @media@keyframes 微信不支持 CSS @ 规则
A4 选择器含 #wenyan 缺少前缀则样式不命中

维度 B:可读性基准(7 项)

ID 检查项 期望值 说明
B1 根 line-height 1.75 中文阅读黄金行距
B2 根 font-size 16px 移动端最小舒适字号
B3 图片 max-width 100% 防止图片溢出屏幕
B4 表格 border-collapse collapse 表格线对齐
B5 blockquote 左边框 border-left: ... 引用块视觉标识
B6 行内代码区分 background: ... 行内 <code> 与正文区分
B7 标题层级区分 h1/h2 各自定义 至少 font-size 不同

维度 C:移动端中文阅读(1 项)

ID 检查项 建议值 原因
C1 正文避免纯黑 #3f3f3f 纯黑 #000 在 OLED 屏刺眼

维度 D:代码高亮协调(1 项)

ID 检查项 说明
D1 hljs 主题背景与文章背景协调 深色文章搭配深色 hljs 主题

wenyan-core 内置 9 个 hljs 主题,提取脚本会输出推荐的代码高亮主题:

文章背景 推荐 --hl-theme 备选
深色 atom-one-dark dracula, github-dark, monokai, solarized-dark
浅色 atom-one-light github, solarized-light, xcode

修正协议

  1. 验证不通过 → 读取 failDetails 中的 name/detail/suggestion
  2. 逐项修正 CSS 选择器和属性
  3. 重新运行验证
  4. 最多重试 3 轮
  5. 3 轮仍不通过 → 展示失败项清单,由用户决定是否接受

Clone this wiki locally