用途
把一篇 Markdown 文章转换为可直接复制粘贴进微信公众号编辑器、且粘贴后样式不丢失的 HTML。核心资产是 references/ 下的主题组件库(每套主题包含设计变量、各组件完整 HTML、模板骨架、映射规则),外加一套通用增量库(代码块、图片/GIF、小标签标题,所有主题共用)。主题清单以 references/theme-index.md 为单一来源。
主要能力
- 输入与格式归一化:支持 Markdown 文本或 .md 路径、.docx(用 scripts/extract_docx.py)、.pdf(分页读取加清噪)、.txt/无标记纯文本(按标题启发式推断结构)、网页富文本。
- 主题选择(自动推荐制):据文章题材主动推荐最契合主题并让用户一步确认,也支持用户指定主题,或走自定义主题生成流程。
- 组件库匹配:读取主题专属组件库与通用增量库,按主题库的「文章类型 → 组件组合配方」表确定组件组合。
- 智能排版处理:章节自动编号、英文标签生成、正文关键词下划线标记、引言关键词高亮、目录提取、开头引言卡署名、尾部作者签名区等。
- 合规校验:运行 validate_gzh_html.py 确定性检查平台禁用项与 span leaf 包裹,ERROR 清零后方可交付。
- 输出:纯 section 正文片段,保存为带主题名的 HTML 文件,并可经 wrap_preview.py 生成带「复制」按钮的预览页。
使用方式
- 输入与格式归一化;用户说「直接排 / 自动排 / 一键 / 不用问」时进入全自动模式,跳过提问并附决策说明。
- 选主题:读 theme-index.md,据题材推荐并确认。
- 读组件库:主题专属组件库与通用增量库。
- 解析 Markdown 结构并判定文章类型(教程/盘点/观点/访谈/数据/随笔/案例)。
- 按配方选组件组合并装配 HTML,依主题库的完整文章模板骨架进行。
- 校验合规:
<SKILL_ROOT>/scripts/validate_gzh_html.py <生成的.html 的实际路径>,ERROR 与标点 WARNING 需修复到 0。 - 输出正文片段,并可用
<SKILL_ROOT>/scripts/wrap_preview.py <干净正文.html>生成预览页。
用户打开预览页后点右上角「复制」,再到公众号编辑器粘贴。
适用场景
- 教程 / 测评 / 清单 / 工具盘点 / 知识整理 / 方法论拆解 → 摸鱼绿
- 深度分析 / 观点 / 力量感话题 → 红白色系
- 设计 / 科技评论 / 专业观点 / 高端品牌 → 石墨极简风
- 禅意 / 极简生活 / 深度随笔 → 留白禅意风
- 工具对比 / 创意评测 → 摸鱼票据风
- 内刊手记 / 深度评测 / 案例复盘 → 橄榄手记
限制
- 平台红线:禁止 style/script/div 标签、class/id 属性、position:fixed/absolute/sticky、float、@media/@keyframes、display:grid、CSS 变量、外部字体/CSS;样式须全部内联,所有文字节点须用 <span leaf=""> 包裹。
- 产物为纯 section 正文片段,不包 <!DOCTYPE>/<html>/<head>/<body>。
- 一篇文章只用所选主题加通用库的组件,不跨主题混用。
- 正文标点须用全角(代码块、行内代码、英文专名/URL/代码标识符内部保持原样)。
- 锚点层最强强调全文不超过 5 处。
- 目录组件展示精选的 3 个核心看点,非完整章节列表。
- 自定义主题生成需读 references/theme-generator.md 并按其流程执行,产物需转换登记并跑 component_lint.py 到 0 ERROR。
新增主题规范
新主题以 references/theme-{英文标识}.md 命名,须包含设计变量速查表、各组件完整 HTML、完整文章模板骨架、文章类型到组件组合配方表、Markdown 到组件映射规则表;并在 theme-index.md 登记一行。
具体价格、平台支持范围、效果数据等资料中暂未提供。