| name | wechat-publisher |
| description | 将 Markdown 文章规范化处理后发布到微信公众号草稿箱。依赖 wenyan-mcp（MCP 工具）和 gemini-image-gen skill（封面图生成）。触发场景：用户说"发布到微信"、"发到公众号"、"推送文章"、"发布这篇文章"，或提供 markdown 文件要求发布到微信公众号时使用。 |
WeChat Publisher
将 Markdown 文章经过预检、规范化、生成封面图后，通过 wenyan-mcp 发布到微信公众号草稿箱。
工作流
第一步：文章预检与规范化
读取文章内容，依次检查并修复以下问题：
1. Frontmatter 检查
必须包含 title 和 cover。若缺少 frontmatter：
- 从正文第一个 H1（
# 标题）提取 title
- 添加 frontmatter 块
---
title: "从正文提取的标题"
cover: "./cover.png"
---
2. 去除重复标题
若正文 H1 与 frontmatter title 相同，删除正文 H1，避免发布后出现两个标题。微信文章标题来自 frontmatter，正文应从 H2 开始。
3. 图片路径修复
wenyan-mcp 按文件系统路径读取图片，不做 URL 解码。逐一检查：
- 用 Glob 工具验证每个图片引用的文件是否存在
- 文件名含空格：重命名为连字符格式（
Pasted image 123.png → pasted-image-123.png），更新引用
- 路径含
%20 编码：解码后查找实际文件，必要时在子目录（如 attachments/）中搜索
- 修正后再次确认文件存在
4. 链接脚注确认
wenyan-mcp 会将文章中所有链接（裸 URL 和 markdown 链接）自动转为文末脚注引用。发布前询问用户是否需要保留这些脚注：
- 保留 → 不处理
- 不保留 → 删除对应链接（纯文本替代或直接去掉）
第二步：封面图
若 frontmatter 缺少 cover 或指向的文件不存在：
- 调用 gemini-image-gen skill 生成封面图
- 比例 2.35:1（微信公众号封面推荐 900x383）
- 基于文章标题和内容组装 prompt
- 用 Read 工具查看生成结果，检查中文文字和构图
- 保存到文章同目录，更新 frontmatter cover 字段
第三步（可选）：草稿同步 review
当用户在微信后台直接编辑草稿后，可用此流程将改动同步回本地：
source /root/.openclaw/workspace/.secrets/wechat_env.sh && \
node <SKILL_DIR>/scripts/sync-from-draft.js <local-md-path>
node <SKILL_DIR>/scripts/sync-from-draft.js <local-md-path> --apply
意图备注处理规则（重要）：
用户在微信后台用 （；指令内容） 格式标注的内容视为指令意图，不是正文内容（分号开头，正常括号不会这样写）。脚本会自动识别并在报告末尾汇总，同时阻止 --apply 执行。
AI 必须在 apply 前：
- 列出所有意图备注，逐条说明处理方案
- 获得用户确认后，先处理意图（补充内容/修改等）
- 再执行
--apply 同步其余非意图改动
第三步：发布
使用 wenyan CLI 发布：
source /root/.openclaw/workspace/.secrets/wechat_env.sh && \
wenyan publish -f "<文章绝对路径>" -c "<SKILL_DIR>/themes/phycat-custom.css" 2>&1
默认主题：themes/phycat-custom.css（phycat 薄荷绿风格 + 自定义覆盖）
- 隐藏分隔线
<hr>
- 加粗文字添加薄荷绿下划线
- section 字体继承微信默认
注意：-c 参数会完全替换主题，不是追加。该文件已内嵌完整 phycat CSS，直接使用即可。
微信凭据从 .secrets/wechat_env.sh 读取（WECHAT_APP_ID + WECHAT_APP_SECRET）。
发布成功后提醒用户：
- 去公众号后台草稿箱预览排版效果
- 手动设置：摘要、阅读原文链接、作者、原创声明（wenyan 不支持这些字段）
- 清理之前的旧草稿（每次发布新增一篇，不覆盖）
已知限制
详见 references/known-issues.md，遇到发布报错时查阅。
