如果 AI 已经替你省下了写初稿的时间,最后却还要在公众号编辑器里重新调标题、引用、图片和代码块,这不叫自动化,只是把体力活挪到了最后。
这次我没有继续转述 gzh-design-skill 的功能列表,而是直接拿这篇文章做样本,完整跑了一遍:
Markdown 定稿 → 选择主题 → 生成公众号 HTML → 脚本校验 → 浏览器预览。
最后拿到两份可以检查的产物:一份干净 HTML,一份带“复制到公众号”按钮的预览页。validate_gzh_html.py 的结果是 0 ERROR、0 半角标点 WARNING。
这个结果只能证明当前 HTML 结构符合项目校验规则,不能代替粘贴进公众号编辑器后的最后一次真实预览。

先判断:你到底需不需要它
下面三种情况,值得测试:
- 你已经用 Markdown 写长文,而且每月不止发布一两篇公众号。
- 文章里经常有代码块、图片、引用、清单或多级标题。
- 你希望团队成员或不同 Agent 排出来的文章,仍然遵守同一套主题和检查标准。
下面三种情况,不必为了跟风安装:
- 你偶尔才发一篇,而且直接在公众号编辑器里写已经够用。
- 你要做的是海报、社交卡片、网页或 PPT,而不是公众号长文。
- 你期待它自动写稿、上传图片并完成发布。它不负责这些。
我的判断很简单:它是高频公众号作者的交付工具,不是所有内容创作者的必装工具。
第一篇文章怎么跑
官方仓库提供的推荐安装命令是:
npx skills add https://github.com/isjiamu/gzh-design-skill
装好后,把已经定稿的文章保存为 Markdown,例如 article.md。
第一次不要只说“帮我排版”。把内容边界、交付物和验收条件一起写进提示词:
使用 gzh-design-skill,把 article.md 排成微信公众号 HTML。
题材是教程,请优先推荐适合教程的主题。
保持原稿观点和段落完整,不删减内容。
需要生成:
1. 可直接粘贴的干净 HTML;
2. 带“复制到公众号”按钮的预览页;
3. validate_gzh_html.py 的校验结果。
ERROR 和半角标点 WARNING 都清零后再交付。
这比“用摸鱼绿排一下”更可靠,因为它同时锁定了三件事:文章不能被排版过程误改,最终要有真实文件,校验没有通过就不能假装完成。
它实际接手了哪六步
1. 选主题
它先按文章类型推荐主题,而不是让模型每篇临时发明一套风格。
2. 读组件库
每套主题都有章节、引言、目录、引用、签名等组件,再加上通用的图片、GIF 和代码块组件。
3. 解析结构
Agent 会识别标题、章节、引用、列表、图片、代码和行内强调。Word、PDF 或纯文本会先归一化为 Markdown,再进入排版。
4. 装配 HTML
它会自动编号章节、提炼目录、标记关键词,并把样式写成公众号更容易保留的内联结构。
5. 脚本校验
这是整套流程最值得保留的一步。validate_gzh_html.py 会检查公众号会过滤的标签、容易掉样式的文字结构和半角标点。
只让模型“记住平台规则”,换模型或换文章后容易漂移;把死规则交给脚本,才有稳定的交付下限。
6. 预览与粘贴
最终会得到干净 HTML 和浏览器预览页。先在浏览器看结构,再通过预览页复制富文本,最后到公众号编辑器做真实检查。
六套主题怎么选
不必把六套都试一遍。先按题材缩小范围:
- 教程、工具清单、产品测评:摸鱼绿。 卡片和步骤组件丰富,适合高信息密度内容。
- 深度观点、行业分析:红白色系。 编辑感更强,适合突出判断和金句。
- 科技评论、专业内容:石墨极简风。 灰阶克制,重点不会被装饰抢走。
- 随笔、生活方式:留白禅意风。 留白更多,适合低信息密度长文。
- 工具对比、创意评测:摸鱼票据风。 适合对比、编号和评分结构。
- 案例复盘、内刊手记:橄榄手记。 适合长篇分节和编辑部式摘要。
拿不准时,可以让 Agent 同时输出三套预览,但要保持原稿完全不变:
保持 article.md 的观点和段落不变,分别用摸鱼绿、石墨极简风、橄榄手记生成预览页。
请从手机端可读性、信息密度、代码块表现、图片位置四个维度比较,只推荐一套最终主题。
现成主题不够,怎样生成自己的主题
gzh-design-skill 还有一条容易被忽略的工作流:用一句描述或一张参考图生成新的主题组件库。
可以这样说:
为公众号生成一套“黑白杂志、克莱因蓝点睛、衬线标题”的新主题。
先输出完整区块库预览,确认后再转成标准 theme 文件,登记到 theme-index.md,并运行 component_lint.py 到 0 ERROR。
只转译风格,不复刻参考图里的文字、Logo 或原始构图。
这不是给单篇文章换皮,而是在建立一套以后还能继续复用的排版资产。
发布前仍要人工检查这 8 项
即使校验脚本通过,也不要直接点发布:
- 标题、段落和原稿观点有没有被误改。
- 手机预览里是否存在过长段落和过密卡片。
- 图片是否真的进入正文,而不是只留在素材目录。
- 图片地址在公众号环境里是否可以访问。
- 代码块有没有横向截断、异常空白或被错误全角化。
- 作者名、简介、名片图是否还残留临时信息。
- 签名区和互动文案是否只出现一次。
- 粘贴进公众号编辑器后,样式是否仍与本地预览一致。
脚本能检查结构性错误,不能替你判断文章是否值得发,也不能替公众号编辑器完成最后一次真实渲染。
别忽略许可证和产品化边界
官方仓库声明采用 AGPL-3.0。
如果只是按仓库说明安装并使用,先阅读官方 README 和 LICENSE 即可。如果准备修改后再分发,或者把修改版接进对外提供的网络服务,应单独核对许可证义务;个人直接使用和把修改版产品化,不是同一件事。
这不是法律意见。涉及商业集成时,以仓库当前 LICENSE 和专业意见为准。
最终判断
如果你只是偶尔排一篇文章,它未必比在线编辑器更省事。
但如果你已经把选题、写稿和改稿放进 Codex、Claude Code 或 Cursor,又需要稳定发布公众号,那么它补上的不是“美化”,而是此前缺失的交付环节:
内容定稿 → 选择主题 → 生成 HTML → 脚本校验 → 浏览器预览 → 公众号粘贴检查。
真正能省下来的,不只是某一篇文章的排版时间,而是以后每一篇都不用重新发明排版规则。
获取方式
- 官方仓库:isjiamu/gzh-design-skill
- 推荐安装:
npx skills add https://github.com/isjiamu/gzh-design-skill - 第一次测试:拿一篇包含图片、引用、代码块和多级标题的旧稿,先跑完校验和手机预览,再决定是否接进长期流程。
