convez.ai
SkillDesign & UIIntermediário
chuanfan-ai

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 GitHub
InicialPluginScore · de 0 a 100

Pacote 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-typesetter

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 粘进去,十次九次走样。

这个包把以下四件事打包:

  1. 设计规范:阿里蓝 + 日落橙双色体系,11 个组件,色板 / 字号 / 间距全锁死
  2. 微信兼容性硬规则:危险标签 / 属性 / 协议黑名单,全 inline style + <section> 嵌套
  3. 图片卡自动包裹算法:单图加竖滑外框,相邻多图合并成横滑外框
  4. 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 promptHTML(含占位符)
2. 图片卡包裹上一步 HTML04-image-cards.md 的 JS 函数HTML(含 G1/G2 外框)
3. 兼容性过滤占位符回填后的 HTML03-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)副标题、小贴士
whitergb(255, 255, 255)仅用于封面渐变起点 / 组件 K 标题文字

兼容性

  • ✅ 微信公众号编辑器(PC 端 / iOS / Android)
  • ⚠️ 知乎 / Medium / 即刻:未测试,预期需要重新调色板和组件
  • ❌ 任何需要 JS 的场景:本规范明确剥离所有 <script>

致谢

提炼自船帆(@chuanfan-ai)的「公众号排版器 Pro」v4.x。原工具是一个前端单页应用,调 chuanfanai.com Gemini 协议中转生成 HTML,本仓库把其中纯规则部分剥离出来,方便下游 agent 复用。

License

MIT

Ver o original no GitHub

Bom para

Relacionados