Regras de Formatação para WeChat
chuanfan-ai/wechat-typesetter
Regras HTML/CSS prontas para formatação de artigos no WeChat sem perda de estilo
Ver no GitHubPacote de regras de design e compatibilidade para gerar HTML de artigos formatados no editor de públicos do WeChat, com sistema de cores azul-laranja, 11 componentes reutilizáveis e algoritmo de carrossel de imagens. Inclui templates HTML, validação de compatibilidade e checklist de qualidade.
Instalação
npx convez-ai chuanfan-ai/wechat-typesetter1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integrar formatação de alta qualidade em ferramentas de editor de WeChat
- Gerar HTML compatível com restrições do editor WeChat a partir de prompts de LLM
- Replicar ou adaptar a visual e regras de formatação profissional
- Implementar validação automática de conteúdo antes de publicação
Veredito

Recurso técnico bem estruturado que resolve um problema específico de compatibilidade WeChat. Apropriado para times que desenvolvem ferramentas de publicação, mas requer integração em código — não é plug-and-play para usuários finais.
README
A tradução para o português deste README ainda está na fila.
微信公众号排版规则包(wechat-typesetter)
把任意原文按「阿里蓝 × 日落橙」双色卡片体规范,自动套上 HTML + inline CSS 视觉外衣,输出可直接粘贴进公众号编辑器、零样式丢失的代码片段。
从船帆「公众号排版器 Pro」v4.x 工具提炼的纯规范包——不含可执行代码、不调任何 LLM API,下游 agent 读完即可接入。
这是什么
公众号编辑器对 HTML 的容忍度有限:会剥 <style>、吃掉 class、过滤事件属性,<div> 偶尔丢样式。直接把任意 HTML 粘进去,十次九次走样。
这个包把以下四件事打包:
- 设计规范:阿里蓝 + 日落橙双色体系,11 个组件,色板 / 字号 / 间距全锁死
- 微信兼容性硬规则:危险标签 / 属性 / 协议黑名单,全 inline style +
<section>嵌套 - 图片卡自动包裹算法:单图加竖滑外框,相邻多图合并成横滑外框
- 6 类自检对账:字数 / 段落 / 占位符 / 颜色 / 组件用量 / 输出格式
下游 agent 按四层接入即可端到端跑通。
适合谁用
- 想给自己的端到端公众号工具加一个高质量的排版模块
- 想让 LLM agent 输出符合公众号编辑器约束的 HTML
- 想复刻或改造船帆排版器 Pro 的视觉体系
- 想给自己写的微信排版工具找一份能直接复用的规则文档
核心约束(两条至高原则)
原则 1:原文一字不改
每个字、每个标点、每个语气词、每个空格,字符级锁死。LLM 只能"包"或"圈出强调",不能动原文内部字符。
原则 2:段落结构 DOM 1:1 映射
原文 N 段 → 输出 N 个承载原文文字的块(<p> 或叶子 <section>)。一段不许合并、不许拆分、不许丢弃、不许重排。
违反任一条整篇作废。
11 个组件
| 组件 | 用途 | 占段落额度 |
|---|---|---|
| A 封面双色卡 | 整篇 1 张 | 否 |
| B 章节英文切片 | 每章开头 | 否 |
| C 章节双行大标题 | 紧跟 B | 否 |
| D 正文段 | 1:1 对应原文段 | 是 |
| E1/E2/E3 强调三件套 | 蓝粗体 / 浅蓝下划线 / 橙荧光笔 | / |
| F 阿里蓝引用框 | 全文 ≤ 4 次 | 否 |
| G 图片卡 | 每个图片位置 | 否 |
| H 大数字标题 | 原文有数字序号时 | 是 |
| I 清单分组 | 分组列表 | 是 |
| J 灰色小贴士 | 补充信息 | 是 |
| K 阿里蓝段落标题 | 短标题段 | 是 |
完整 HTML 模板见 reference/02-components.md。
文件结构
wechat-typesetter/
├── README.md 本文件
├── LICENSE MIT
├── SKILL.md skill 入口 + 给融合智能体的说明
└── reference/
├── 01-design-spec.md 完整设计规范本体(用作 LLM system prompt)
├── 02-components.md 11 个组件 A-K 的可复制 HTML 模板
├── 03-wechat-compat.md 微信兼容性黑名单 + JS 实现参考
├── 04-image-cards.md G1/G2 图片卡自动包裹算法 + JS 实现
└── 05-self-check.md 输出前 6 类对账清单
接入方式(四层)
| 层 | 输入 | 用哪份规范 | 输出 |
|---|---|---|---|
| 1. LLM 提示词 | 原文 + 图片占位符 | 01-design-spec.md 全文 → system prompt | HTML(含占位符) |
| 2. 图片卡包裹 | 上一步 HTML | 04-image-cards.md 的 JS 函数 | HTML(含 G1/G2 外框) |
| 3. 兼容性过滤 | 占位符回填后的 HTML | 03-wechat-compat.md 的 JS 函数 | 清洁 HTML |
| 4. 质检对账 | 各步骤输出 | 05-self-check.md 的对账函数 | pass / fail |
图片占位符约定
正文里的图片位置用 【图片位_0】 【图片位_1】 标记,从 0 起编号。容错正则同时识别 [图片位_N] 『图片位_N』 (图片位_N) 图片位 N 图片位-N 等变种。
实际 <img> 标签由后处理流程在 wrapImagesInCards 之后回填。
色板速查
只允许这 12 个颜色 + 白,严禁自创:
| 名称 | RGB | 用途 |
|---|---|---|
| blue-6 主色 | rgb(22, 119, 255) | 章节英文标签、卡片描边、E1 强调 |
| blue-5 亮 | rgb(64, 150, 255) | 进度条渐变起点 |
| blue-2 淡 | rgb(186, 224, 255) | E2 下划线高亮 |
| blue-1 背 | rgb(230, 244, 255) | 引用框背景 |
| blue-0 更淡 | rgb(240, 248, 255) | 封面渐变中间色 |
| blue-8 深 | rgb(0, 80, 179) | 引用框深色文字 |
| orange-6 主色 | rgb(255, 122, 0) | 大数字、关键指标、进度条末端 |
| orange-2 淡 | rgb(255, 213, 145) | E3 荧光笔渐变起点 |
| gray-900 标题 | rgb(17, 24, 39) | 大标题 |
| gray-700 正文 | rgb(55, 65, 81) | 正文 |
| gray-500 次级 | rgb(107, 114, 128) | 副标题、小贴士 |
| white | rgb(255, 255, 255) | 仅用于封面渐变起点 / 组件 K 标题文字 |
兼容性
- ✅ 微信公众号编辑器(PC 端 / iOS / Android)
- ⚠️ 知乎 / Medium / 即刻:未测试,预期需要重新调色板和组件
- ❌ 任何需要 JS 的场景:本规范明确剥离所有
<script>
致谢
提炼自船帆(@chuanfan-ai)的「公众号排版器 Pro」v4.x。原工具是一个前端单页应用,调 chuanfanai.com Gemini 协议中转生成 HTML,本仓库把其中纯规则部分剥离出来,方便下游 agent 复用。
License
MIT