01 / 它能帮你做哪些排版工作
它能帮你做哪些排版工作
整条流程一句话说得完：你交出现有稿子，选一套现成主题（或让智能体生成一套新的），智能体按这套主题的组件配方逐块装配，最后给你正文 HTML 和一个带复制按钮的预览页。HTML 可以理解成样式已经写进文章里的文件；所谓 Skill，是智能体会照着读的一套规则和组件库，排版用的代码它从库里取，不凭记忆手写。
六套主题按题材对号入座：
| 主题 | 适合的题材 | 能看出的风格 |
|---|---|---|
| 摸鱼绿 | 教程、测评、清单、工具盘点 | 绿色主色，卡片丰富、信息密度高 |
| 红白色系 | 深度分析、观点、力量感话题 | 白底红点睛，编号章节配引言卡，经典编辑风 |
| 石墨极简风 | 设计、科技评论、专业观点、高端品牌 | 全灰阶，极简克制 |
| 留白禅意风 | 禅意冥想、极简生活、深度随笔 | 墨绿细线，留白多、呼吸感强 |
| 摸鱼票据风 | 工具对比、创意评测 | 票据门票样式，星级评分、硬阴影卡片 |
| 橄榄手记 | 内刊手记、深度评测、案例复盘 | 墨黑配橙，编辑部内刊质感 |
正文要用的零件基本齐：代码块（深浅两色、等宽不折行）、图片和 GIF、行内代码、引用、列表、表格，外加引言卡、章节编号、署名这些公众号常见部件。零件齐全说的是排版这一段；Word、PDF 里本来就提取不出来的图表，仍要你按后面的说明补。
六套不合用，还有第二条路：给智能体一段风格描述或一张参考图，让它生成新主题。流程是先把偏好做成一整套区块库，在浏览器里整页预览；你确认后，它转成标准主题、登记进主题索引、通过组件校验，之后就能像内置主题一样反复用。上游要求参考图只取风格，不复制其中的文字、Logo 或版权主体；没有参考图，一段描述也能起步。
读过本站 Baoyu markdown-to-html 总览的读者会问两者差别：那个工具把 Markdown 交给脚本直接转换，配色和字体靠参数传；gzh-design 让智能体读组件库逐块装配，多了主题选择和自定义主题这条线。按手头的活选就行；快慢和成品质量，本站没做过对比测试。
02 / 看六套官方主题排出的文章
看六套官方主题排出的文章
光看名字想象不出效果，好在作者把样例备齐了：甲木和摸鱼小李用六套主题各排了同一篇长文，放进官方仓库的画廊。同一篇文字，换一套主题，标题、引言、章节编号和强调方式也会变化。本站取回六份原始 HTML，在禁脚本、断外网的环境里做了静态渲染，你可以在站内把整篇读完。身份标注为：官方示例·甲木×摸鱼小李；本站仅静态渲染——它们不是本站用技能排出的新文章，也不代表粘进公众号编辑器后的样子。
挑的办法：按上一节的题材表缩到两三套，点开对比首屏气质；犹豫时选信息密度和你文章接近的那套。每个入口点开都是完整长文，按宽度往下读，读完关闭返回。
选定后记下主题名，在本页目录选择“装到哪里，先准备什么”，完成准备后再到“把文章和排版要求交给智能体”。Markdown 用第一条请求，Word 或 PDF 用第二条；把其中的“摸鱼绿”或“红白色系”换成你选的主题。例如选了石墨极简风，就在请求里写“按石墨极简风主题排版”。
其中摸鱼绿那份有一个原样限制：顶部横向导读栏在窄窗口会截掉后面几项（本站检查到 338 像素宽时出现截字），这是官方原文件目前的表现，本站保留了原件；正文各节内容完整，往下读不受影响。
03 / 装到哪里，先准备什么
装到哪里，先准备什么
第一次可以选 Codex 的本地项目，它是上游明确列出的支持宿主之一；已有 Claude Code、Cursor 的读者也可按各自的技能加载方式使用。还没准备好宿主，先按 Codex 官方入门安装、登录并打开本地文件夹；当前官方桌面入口需从 ChatGPT 下拉菜单选择 Codex。想先弄清 Skill 的作用，可读本站工具与技能入门。
先建一个专门放文章的文件夹，例如 gzh-first-article，在 Codex 中打开它。再在终端（Windows 可用 PowerShell）中运行 cd "文章文件夹的完整路径"，把引号里的内容换成实际路径；运行 pwd 核对路径与 Codex 打开的项目一致。下面的 Project 安装范围就对应这个目录。
安装只有下面这一条命令，来自 skills.sh 上该技能的页面，本站核对过命令本身，没有实际装过：
npx skills add https://github.com/isjiamu/gzh-design-skill --skill gzh-design跑之前核对手头的条件：
- 电脑上有 Node 和 npx，安装命令靠它们下载技能；
- 一个支持在本地加载 Skill、读写文件的智能体；上游举例包括 Claude Code、Codex、Cursor，读稿和写 HTML 都由智能体完成；
- Python3，技能自带的校验和预览包装脚本要用它运行；
- 打算喂 PDF 的话，你的智能体本身要能分页读取 PDF。
安装器询问目标智能体时选 Codex，询问 Installation scope 时选 Project，对应当前文章文件夹。安装摘要应指向本项目的 .agents/skills/gzh-design。回到 Codex 的同一项目，在侧边栏 Skills（技能）中查找它；列表没更新时先重启 Codex。再请它报告 gzh-design 的实际安装路径，读取其中的 SKILL.md，说明接下来怎样按这套规则排版。读到规则后，再发送下一节的文章请求；能找到技能还不代表排版已成功。其它宿主的发现方式按各自说明核对。
本站提供的完整源码包用来读官方示例和许可原文，安装仍走上面的命令。上述当前项目安装与加载路径依据 Skills CLI 和 Codex 官方文档整理，本站没有实际安装验证。
接着看你的原稿属于哪种情况，不同格式的损耗不一样：
- Markdown：直接进排版流程，最省事。
- Word（.docx）：标题、粗体、下划线、列表和内嵌图片能提出来；表格会变成
[表格：…]这样的占位，要你决定转成列表、重新截图还是自己补。旧版 .doc 先在 Word 或 WPS 里另存为 .docx。 - PDF：智能体分页读取后清理页眉页脚和断行；图提不出来，位置留“原 PDF 第 N 页图”的占位；双栏 PDF 的段落顺序可能错乱，需要你整理。
- 纯文本：没有标题标记时按行长、序号这类线索推断章节；实在识别不出，智能体会自拟标题，并明确告诉你哪些是它起的。
- 网页富文本：剥掉原来的样式，按语义转成 Markdown 结构。
使用非 Markdown 材料时，归一化后智能体会把识别结果报给你确认——几个章节、哪些标题是推断的、图缺在哪——你确认或修正后才进入选主题。缺的表格和图片，在这一步一起补。
04 / 把文章和排版要求交给智能体
把文章和排版要求交给智能体
第一次可以先用一篇已有的 Markdown 稿：把它另存为 article.md，放进刚才的文章项目文件夹，标题、列表和图片引用保留原来的写法。Word 或 PDF 则把原文件放进同一文件夹，并在请求里写明实际文件名；宿主支持附件时，也可以附上该文件。不要只把 Word 或 PDF 的扩展名改成 .md。
材料和技能都就位后，怎么开口？下面三条均为起始请求示例，本站未执行；发出去之前把文件名、主题和描述换成你的实际情况。
第一条，Markdown 文章加指定主题：
发送给智能体的请求
请读取当前项目里的 article.md，使用 gzh-design，按摸鱼绿主题把它排成公众号 HTML：按技能流程装配，把干净的正文 HTML 按技能约定保存到当前项目，并用技能脚本生成带复制按钮的预览页。完成后告诉我两个文件的完整文件名和路径，以及怎样在本地浏览器打开预览页。
第二条，Word 或 PDF，先报结构再排：
发送给智能体的请求
请读取当前项目里的原稿.docx（若用 PDF，改成实际 PDF 文件名）。请使用 gzh-design，先别排版：把提取后的结构报给我——识别出哪些章节、哪些标题是你推断的、图片落在原稿什么位置、表格怎么处理。我确认结构没问题后，再用红白色系主题排；正文和带复制按钮的预览页按技能约定保存到当前项目，并告诉我两个完整文件名和路径。
第三条，按描述生成可复用的新主题：
发送给智能体的请求
请使用 gzh-design 为我的公众号生成一套主题，描述如下：浅米底色、深棕标题，整体像纸质笔记本，卡片小圆角、淡阴影。请按这套描述生成新主题，先给我完整区块库预览；我确认风格后，再转成可复用的标准主题登记。
排完会拿到两样东西：一份干净的正文 HTML 片段，这是要粘进公众号编辑器的内容本身；一个带复制按钮的预览页，本地浏览器打开，用来检查效果、点按钮复制。预览页里的按钮和脚本只为你服务，不会被复制进正文。
不指定主题时，技能会按题材推荐一套让你确认；说“直接排”它就跳过提问自动做完，交付时附一段决策说明。这里有个上游文件的出入要知道：SKILL.md 和主题索引把摸鱼绿列在第一行当默认，格式归一化文档末句却写自动选红白色系。两边对不上，第一次开口时最好把主题名直接写进请求，别赌默认值。
上游约定把文件存到当前工作目录：正文名带“原文件名、排版、主题名”，对应预览页再加 _预览.html。例如 article.md 用摸鱼绿排版，正文可命名为 article_排版_摸鱼绿(moyu-green).html，预览页为 article_排版_摸鱼绿(moyu-green)_预览.html；实际打开智能体回复中的完整路径。
拿到两个路径后，在文件管理器中找到带 _预览.html 的文件，用本地浏览器打开；若文件没有按请求生成，先把实际文件清单交给智能体补齐。检查四类地方：智能体自动加的章节编号、英文小标签、每段的关键词下划线；文末署名——你没给署名时它会留 {{作者名}} 这样的占位，要换成你自己的；原文是否每段每图都在；提取损失的表格和图片占位补齐没有。
发现问题就带着位置提修改，例如“第二节第三段漏了一句，请对照 article.md 补回；文末署名改为我的署名，并同步更新正文和预览页”。改完重新打开或刷新预览页，核对刚才的问题和相邻段落，再点预览页里的“复制到公众号”。
随后到公众号编辑器试粘正文，查看预览中的段落、图片、表格和署名；粘贴后的样式还需逐项检查。确认后由你操作保存草稿，并在平台核对保存结果。本站没有实测试粘或保存草稿，不能保证粘贴格式与平台保存成功。
还有一条边界：它管的是排版这一段。写文章本身、上传封面图、保存公众号草稿、发表，都不在它的工作范围里。
05 / 采用前看清边界与费用
采用前看清边界与费用
先把证据边界摆清。到 2026-10-31 为止，本站做过：对照官方仓库原文核对能力、命令和许可，并在禁脚本、断外网的环境里静态渲染了六份官方示例。没做过：实际安装技能、用它排一篇文章、把产物粘进公众号编辑器、发布到平台。作者宣传里“样式全内联、粘贴不掉格式”“换模型结果一致”是作者声明，本站没法替它背书。
费用上，技能文件可以免费取得；跑排版的模型额度是另一笔账，按你自己的智能体账户计。基础排版不要求开通专门的生图或音频账号。具体花多少，取决于你用的智能体怎么收费，本文不报数。
按上游流程，交付前要跑自带的校验脚本，错误清零再给结果。要说清这个检查的范围：它验的是产物符合既定的结构规则，比如文字有没有正确包裹、标点是否全角；粘进公众号编辑器后的最终效果是另一回事，只能你亲自试粘预览。
许可也提一句：技能按 AGPL-3.0 或后续版本开源，版权归甲木和摸鱼小李联名。再分发、改造模板和源码是有条件的，条件以许可原文为准，本文不作法律概括。
06 / 来源、许可与更新
来源、许可与更新
来源集中列在这里，方便你回到上游核对：
- 官方主仓库：github.com/isjiamu/gzh-design-skill（AtomGit 有同步镜像）
- 宿主准备与技能加载：Codex 官方入门、官方技能文档；安装目标和范围见 Skills CLI 说明
- 安装命令出处：skills.sh/isjiamu/gzh-design-skill/gzh-design
- 主题清单与生成器文档：主题索引与主题生成器
- 作者：甲木 × 摸鱼小李 联名共建
许可采用 GNU AGPL-3.0-or-later，LICENSE 文件署名 Copyright (C) 2026 甲木 × 摸鱼小李。README 里的宣传语不替代许可原文，分发和改造的条件请读全文。本站备有许可全文和六份官方示例的完整源码包，页面下方可以直接下载。
本页据上游介绍写成，能力与官方示例核对于 2026-10-31；2026-11-01 补充首次使用指路，安装范围与加载说明复用本站已核对的 Skills CLI、Codex 官方文档，之后的更新以各上游为准；本站只检查过源件和示例的静态渲染，安装、实际排版、公众号试粘和发布都未做。要动手，在本页目录选择“装到哪里，先准备什么”，把你的第一篇文章和写明的主题名一起交给智能体。