如何用AI技能一键搞定公众号排版：gzh-design-skill完整指南
项目地址: https://gitcode.com/gh_mirrors/gz/gzh-design-skill 厌倦了每次发布公众号文章都要手动调整格式、担心样式粘贴后丢失？gzh-design-skill正是为你解决这些痛点的终极公众号排版工具。这个AI-agent技能能将Markdown文档一键转换为可直接粘贴进微信公众号编辑器的精美HTML，提供6套专业主题、智能主题生成器和双关卡质量校验，让你专注于内容创作而非格式调整。
🌟 项目亮点与独特价值
gzh-design-skill的核心创新在于将复杂的公众号排版工作流程化、自动化。它不仅仅是简单的HTML转换工具，而是一套完整的排版系统。
智能主题适配：内置6套精心设计的主题，每套都有明确的适用场景。摸鱼绿适合教程测评，红白色系适合深度分析，石墨极简风适合科技评论，留白禅意风适合随笔散文，摸鱼票据风适合工具对比，橄榄手记适合内刊复盘。AI会自动根据文章题材推荐最合适的主题。
全内联样式保障：所有样式完全内联，文字使用<span leaf="">包裹，彻底解决了公众号编辑器过滤外部样式的问题。这意味着你粘贴到公众号后，所有格式都会完整保留，不会出现样式丢失的尴尬情况。
双关卡质量校验：项目包含两个关键校验脚本。scripts/component_lint.py检查组件库源头，scripts/validate_gzh_html.py验证最终产物，确保输出完全符合公众号平台的要求，包括禁用标签检查、标点全角转换等。
🚀 5分钟快速入门体验
安装gzh-design-skill非常简单，只需一行命令：
npx skills add https://gitcode.com/gh_mirrors/gz/gzh-design-skill
或者手动克隆到本地：
git clone https://gitcode.com/gh_mirrors/gz/gzh-design-skill.git ~/.claude/skills/gzh-design
安装完成后，对支持Skill的AI Agent（如Claude Code、Codex、Cursor等）说：
用摸鱼绿把这篇文章排成公众号HTML：article.md
AI会自动完成整个排版流程，生成可直接粘贴的HTML文件。整个过程无需任何手动调整，真正实现了一键排版。
🔧 核心功能深度解析
智能内容识别与处理
系统能自动识别Markdown中的各种元素：文章标题、章节结构、加粗强调、引用块、图片、代码块、列表和表格。更智能的是，它会自动为章节编号、标记关键词下划线、提取引言卡片和生成目录导航。
多格式输入支持
除了Markdown文件，gzh-design-skill还支持Word文档（.docx）、PDF文件和纯文本输入。非Markdown格式会自动通过scripts/extract_docx.py等工具转换为标准Markdown，确保后续排版顺利进行。
主题生成器：创造专属风格
如果内置6套主题不能满足你的需求，主题生成器功能让你可以创建完全自定义的主题。只需提供一句话描述或一张参考图片，AI就会生成包含45-75个区块的完整HTML组件库。新主题会自动保存到assets/theme-previews/目录，并登记到references/theme-index.md中，之后就可以像内置主题一样使用。
输出质量保证
最终输出包含两个文件：干净的正文HTML文件和带"复制"按钮的预览页面。打开预览页，点击右上角的"复制到公众号"按钮，然后粘贴到公众号编辑器即可，无需手动全选复制。
🎯 高级技巧与最佳实践
选择合适的主题
根据你的文章类型选择最合适的主题：
- 教程测评类：推荐摸鱼绿主题，信息密度高，卡片丰富
- 深度分析类：红白色系，经典编辑风格，红色点缀恰到好处
- 专业观点类：石墨极简风，克制理性，适合高端品牌
- 随笔散文类：留白禅意风，呼吸感最强，适合深度思考
- 工具对比类：摸鱼票据风，票据视觉隐喻，创意十足
- 内刊复盘类：橄榄手记，编辑部质感，信息密度适中
充分利用校验脚本
每次生成HTML后，务必运行校验脚本：
python3 scripts/validate_gzh_html.py output.html
这会检查HTML是否符合公众号平台的所有限制：无div/class/style标签、文字完全用span leaf包裹、标点全角转换等。确保输出质量是gzh-design-skill区别于其他工具的核心优势。
批量处理技巧
如果你有多篇文章需要排版，可以批量处理。AI Agent支持批量操作，只需提供多个Markdown文件路径，系统会自动为每篇文章选择最合适的主题并生成独立的HTML文件。
❓ 常见问题与解决方案
Q：粘贴到公众号后样式会丢失吗？ A：完全不会。所有样式都是内联的，文字使用<span leaf="">包裹，这是校验脚本强制要求的重点，专门规避公众号编辑器的过滤机制。
Q：只能在Claude Code中使用吗？ A：不限于Claude Code。任何能够读取Skill目录的AI Agent（如Codex、Cursor等）都可以使用，工作流定义在SKILL.md中。
Q：如何更新到最新版本？ A：重新运行安装命令npx skills add https://gitcode.com/gh_mirrors/gz/gzh-design-skill，或者到安装目录执行git pull。
Q：可以一次生成多套主题对比吗？ A：完全可以。只需对AI说"用这几套主题各排一遍这篇"，系统就会批量生成多套主题供你选择。
Q：支持自定义字体吗？ A：公众号平台限制外部字体，因此gzh-design-skill使用平台默认的安全字体组合，确保在所有设备上显示一致。
📚 项目架构与扩展
目录结构解析
gzh-design/
├── SKILL.md # 排版工作流主文档
├── references/
│ ├── theme-index.md # 6套主题索引
│ ├── theme-*.md # 6套主题组件库
│ ├── theme-generator.md # 主题生成器
│ ├── common-components.md # 跨主题通用增量组件
│ └── eval-cases.md # 触发用例与验证循环
├── scripts/
│ ├── validate_gzh_html.py # 产物合规校验
│ └── component_lint.py # 组件库源头检查
├── assets/
│ ├── sample-article.md # 演示输入
│ └── theme-previews/ # 主题生成器产出预览
└── docs/gallery/ # 主题浏览器预览
设计原则
gzh-design-skill遵循几个关键设计原则：
- 约束优于自由：预设主题色板和固定组件保证输出质量下限
- 确定性下沉脚本：平台限制等死规则交给校验脚本处理
- 配方优于自由：按文章类型查主题库的配方表确定组件组合
- 克制用色：主色只在关键锚点出现，大面积使用白底和灰阶
社区与贡献
项目采用开源模式，欢迎贡献新的主题和功能改进。如果你有好的主题设计或发现了bug，可以通过GitHub提交issue或pull request。项目遵循AGPL-3.0许可证，确保开源生态的健康发展。
🎨 主题速查表
| 主题 | 主色 | 适用场景 | 核心特点 |
|---|---|---|---|
| 摸鱼绿 | #059669 | 教程、测评、清单、工具盘点 | 信息密度高，卡片丰富 |
| 红白色系 | #DC2626 | 深度分析、观点、力量感话题 | 经典编辑风，红色点睛 |
| 石墨极简风 | #52525B | 设计、科技评论、专业观点 | 极简克制，全灰阶设计 |
| 留白禅意风 | #4A5D52 | 禅意、极简生活、深度随笔 | 呼吸感最强，适合长文 |
| 摸鱼票据风 | #059669 | 工具对比、创意评测 | 票据视觉隐喻，创意十足 |
| 橄榄手记 | #1e1f23 | 内刊手记、深度评测、案例复盘 | 编辑部质感，信息密度适中 |
🚀 下一步行动指南
- 立即安装：使用
npx skills add命令安装gzh-design-skill - 体验演示：克隆项目后打开
docs/gallery/index.html查看6套主题的完整效果 - 尝试排版：用
assets/sample-article.md作为测试文件，体验一键排版 - 探索主题生成：尝试使用主题生成器创建自己的专属主题
- 加入社区：分享你的使用体验和创作成果
gzh-design-skill将公众号排版从繁琐的手工劳动转变为智能的自动化流程，让你能够专注于内容创作本身。无论是个人博主还是专业内容团队，这个工具都能显著提升你的工作效率和内容质量。
现在就开始你的智能排版之旅吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
