wechat-typeset-pro

微信公众号专业排版技能。把 Markdown 文章转为微信公众号兼容的精美内联样式 HTML，30 套主题 + 可视化画廊选择 + AI 内容增强 + 一键复制到公众号。可选推送到草稿箱。

Skill Description

微信公众号专业排版引擎：Markdown → 精美微信兼容 HTML。当用户说"排版""微信排版""公众号排版""format""美化文章"时使用。支持 30 套精美主题、可视化画廊预览、AI 内容结构增强、深色模式、代码高亮。

When to Use

• 用户需要将 Markdown 文章排版为微信公众号格式
• 用户说"排版""微信排版""美化""格式化为公众号格式""公众号排版"
• wechat-content-studio 技能的排版流程调用本技能
• 需要预览多种主题风格并选择最佳方案

脚本目录

{baseDir} = 本 SKILL.md 所在目录。

配置

配置文件：{baseDir}/config.json

微信凭证优先从环境变量读取（~/.openclaw/.env），无需在 config.json 中配置敏感信息。

环境变量（自动从 ~/.openclaw/.env 加载）

Instructions

完整工作流

第 1 步：确认文章

1. 如果用户给了文件路径，直接读取
2. 如果没给路径，问用户要文章路径
3. 读取文章内容，确认标题和字数

第 1.5 步：结构化预处理（仅在需要时）

读取文章后，检测 Markdown 结构完整度。

判断规则：

• 有 ## 标题且格式标记分布合理 → 跳过，直接进入第 2 步
• 缺少 ## 标题或几乎没有格式标记 → 执行结构化

结构化规则（只加标记，不改内容）：

1. 识别逻辑段落插入 ## 标题（从内容提炼，不编造）
2. 确保段落之间有空行分隔
3. 识别并列内容加列表标记
4. 识别关键词加 加粗
5. 清理格式（多余空行、缩进、标点）
6. 不改措辞：不调语序、不增删内容

保存为 ~/WorkBuddy/wechat-typeset-pro/xxx-structured.md（与 config.json 的 output_dir，即 path.join(HOME, 'WorkBuddy', 'wechat-typeset-pro') 一致），告知用户。

第 2 步：AI 内容分析 + 自动套格式

分析内容结构，在 Markdown 层面自动套用排版容器：

1. 对话/访谈 → :::dialogue[标题]
2. 连续多图（3+） → :::gallery[标题]
3. 核心观点/金句 → > [!important] 标题（一篇 1-3 处）
4. 小技巧 → > [!tip] 标题
5. 注意事项 → > [!warning] 标题
6. 分隔符 → 章节转换处确保有 ---
7. 图说 → 图片后斜体：图片说明

保存增强后 Markdown 为 ~/WorkBuddy/wechat-typeset-pro/xxx-enhanced.md。

第 2.5 步：推荐主题

根据内容分析推荐 3 个最适合的主题：

第 3 步：打开主题画廊（默认）

python3 {baseDir}/scripts/format.py \
  --input "文章路径.md" \
  --gallery \
  --recommend newspaper magazine ink

用真实文章渲染 20 个主题，浏览器中选择。

第 3 步（备选）：直接指定主题

python3 {baseDir}/scripts/format.py \
  --input "文章路径.md" \
  --theme terracotta

第 4 步：确认结果

• Gallery 模式：浏览器中切换主题，选中后点按钮复制，粘贴到公众号后台
• 直接模式：浏览器中检查预览，点「复制到微信」

推送到草稿箱（可选）

用户说"推送""发公众号"时执行：

python3 {baseDir}/scripts/publish.py \
  --dir "排版输出目录" \
  --cover "封面图路径（可选）"

从 Markdown 直接推送：

python3 {baseDir}/scripts/publish.py \
  --input "文章.md" \
  --theme terracotta

参数说明

format.py：

• --input / -i：Markdown 文件路径（必须）
• --gallery：打开主题画廊（推荐）
• --theme / -t：直接指定主题名
• --output / -o：输出目录（默认 ~/WorkBuddy/wechat-typeset-pro，即 path.join(HOME, 'WorkBuddy', 'wechat-typeset-pro')）
• --recommend：推荐主题 ID 列表
• --no-open：不自动打开浏览器
• --format：输出格式 wechat/html/plain

publish.py：

• --dir：排版输出目录
• --input：Markdown 文件路径（自动排版再推送）
• --cover / -c：封面图路径
• --title / -t：文章标题
• --theme：排版主题（仅 --input 模式有效）
• --author / -a：作者名
• --dry-run：只做排版，不推送

可用主题（30 个）

独立风格（9 个）

精选风格（7 个）

模板系列（14 个）

4 种布局（Minimal / Focus / Elegant / Bold）× 多种配色（Gold / Blue / Red / Green / Navy / Gray）

内置排版增强

• CJK 间距修复：中英文/中数字之间自动加空格
• 加粗标点修复：文字， → 文字，
• 纯内联样式：所有 CSS 写在 style="..." 上
• 列表模拟：
  /
  →
  + flexbox
  外链转脚注：自动变为正文标注 + 文末脚注
  语法高亮：代码块自动着色 + Mac 风格工具栏
  深色模式：自动生成微信深色模式 data-darkmode-* 属性
  多类型 callout：tip/note/important/warning/caution 各有独立配色
  图说识别：图片后斜体自动变居中灰色图说
  对话气泡：:::dialogue 左右交替聊天气泡
  图片画廊：:::gallery 横向滚动多图容器
  时间线：:::timeline 时间线展示
  步骤流程：:::steps 编号步骤
  对比卡片：:::compare[A vs B] 两列对比
  人物引言：:::quote[人名] 引言卡片
  表格斑马纹：自动奇偶行背景色

  容器语法

  :::dialogue[采访实录]
  Alice: 你好
  Bob: 你好，很高兴认识你
  :::
  
  :::gallery[产品截图]
  ![](img1.jpg)
  ![](img2.jpg)
  ![](img3.jpg)
  :::
  
  :::timeline[发展历程]
  2020: 项目启动
  2022: 用户破百万
  2024: 全球化
  :::
  
  :::steps[操作步骤]
  打开设置页面
  点击高级选项
  开启开发者模式
  :::
  
  :::compare[方案 A vs 方案 B]
  速度快 | 稳定性高
  成本低 | 安全性强
  :::
  
  :::quote[乔布斯]
  Stay hungry, stay foolish.
  :::
  
  > [!tip] 小技巧
  > 选择适合文章风格的主题效果更佳
  
  > [!important] 核心观点
  > 这是文章的关键洞察