WeChat Publisher With WeMD Render

---

name: wechat-publisher description: 微信公众号发文自动化 skill。覆盖 Markdown 排版渲染（12 种内置主题 + 自定义主题）、正文图片上传、封面上传、草稿创建/更新/预览、人工确认发布、发布状态查询、素材/草稿/已发布文章查询。Use when agent needs to help write or publish 公众号文章, or for requests like "发公众号", "创建草稿", "更新草稿", "确认发布", "查询发布结果", "查素材", "查草稿列表", "查已发布文章", "添加主题", "切换主题", or "主题列表".

---

WeChat Publisher

能力概览

覆盖公众号发文全链路：

发文工作流（主路径）： 1. 收集输入 → 询问用户选择排版主题 2. WeMD 渲染：Markdown / 纯文本 → 带主题样式的微信 HTML 3. 正文内本地图片自动上传并替换为微信 CDN URL 4. 封面素材自动上传 5. 创建或更新草稿 → 返回预览链接 6. 等待人工确认（不可跳过） 7. 提交发布 → 查询发布状态

资产查询（只读）：素材 / 草稿 / 已发布文章的列表与详情

主题管理：12 个内置主题 + 用户自定义主题（发送 CSS 即可添加）

仅 client 封装（高风险）：删除素材 / 草稿 / 已发布文章

首次使用：自动安装 Node.js 依赖（需要 Node.js v18+），后续跳过

---

核心规则

发布前必须有明确人工确认，拒绝任何隐含或沉默批准

不暴露凭据到用户侧输出

删除类操作默认不触发，需用户明确要求

只做发文相关链路，不扩展到菜单、群发、客服、统计等域

用户未指定主题时必须询问，不擅自选择

---

工作流

1. 收集输入

必填：

title

author

digest（摘要）

正文：content_markdown / content_markdown_path / content_text / content

封面：thumb_image_path（本地图片）或 thumb_media_id（已上传素材）

theme：排版主题（用户未指定时必须询问）

可选：

content_base_dir：正文中相对路径图片的基准目录

draft_media_id / media_id：更新已有草稿时必填

content_source_url / need_open_comment / only_fans_can_comment

主题选择规则：

用户未指定主题时，向用户展示主题列表请用户选择

中文名或英文名都可以，脚本自动识别

用户说"默认"或不想选 → 使用默认主题

内置主题（12 个）：

| 中文名 | 英文 ID | 适合场景 | |--------|---------|----------| | 默认 | Default | 通用，微信绿现代风 | | 学术论文 | Academic-Paper | 技术论文、研究报告 | | 极光玻璃 | Aurora-Glass | 产品介绍、创意内容 | | 包豪斯 | Bauhaus | 设计、艺术、创意 | | 赛博朋克 | Cyberpunk-Neon | 科技、数码、AI | | 知识库 | Knowledge-Base | 教程、说明文档 | | 黑金奢华 | Luxury-Gold | 品牌文、深度文章 | | 莫兰迪森林 | Morandi-Forest | 生活方式、慢阅读 | | 新粗野主义 | Neo-Brutalism | 潮流、先锋、态度文 | | 购物小票 | Receipt | 趣味内容、清单、复古 | | 落日胶片 | Sunset-Film | 故事、散文、影评 | | 主题模板 | Template | 基础排版参考 |

2. 归一化正文

由 upsert_draft.py 自动调用，无需手动执行。首次使用时自动安装 Node.js 依赖。

渲染引擎：WeMD

处理流程： 1. Markdown / 纯文本 → 经 WeMD 渲染为带内联样式的微信兼容 HTML 2. 本地图片自动上传到微信图文图片接口，替换为 CDN URL 3. 锚点链接自动转为脚注引用

3. 创建或更新草稿

python scripts/upsert_draft.py --input article.json
python scripts/upsert_draft.py --input article.json --update

草稿创建完成后向用户呈现：标题、摘要、主题、预览链接。

4. 等待人工确认

接受：确认发布 / 可以发布 / 批准发布

5. 提交发布

python scripts/submit_publish.py --draft-id  --confirmed

6. 查询发布状态

python scripts/query_publish_status.py --publish-id 

7. 查询资产

python scripts/query_assets.py materials-count
python scripts/query_assets.py drafts-list [--no-content]
python scripts/query_assets.py published-list [--no-content]

8. 管理自定义主题

python scripts/manage_themes.py add --cn "清新蓝" --en "Fresh-Blue" --css-file /path/to/theme.css
python scripts/manage_themes.py list
python scripts/manage_themes.py delete --name "清新蓝"

Agent 交互规则： 1. 用户指定了中英文名 → 直接使用 2. 用户只给了中文名 → agent 生成英文 ID 3. 用户什么名字都没指定 → agent 根据 CSS 风格取名，先问用户同意再保存 4. CSS 必须以 #wemd 为根选择器

---

输入 JSON 样例

{
  "title": "2026 AI 工具盘点",
  "author": "Bingo",
  "digest": "深度盘点。",
  "content_markdown_path": "/root/articles/ai-tools.md",
  "thumb_image_path": "/root/articles/cover.jpg",
  "theme": "黑金奢华"
}

---

输出格式规范

- 动作：创建草稿
主题：黑金奢华
media_id：TnhkZ9HGMxOYETms_33Ct...
预览：http://mp.weixin.qq.com/s?...
下一步：请点击预览确认内容，确认后说"确认发布"

---

脚本索引

| 脚本 | 用途 | |------|------| | setup.py | 首次使用时自动安装 Node.js 依赖 | | normalize_article.py | 正文归一化（WeMD 渲染 + 图片上传替换） | | upload_material.py | 上传封面等永久素材 | | upsert_draft.py | 创建/更新草稿 | | submit_publish.py | 提交发布（需 --confirmed） | | query_publish_status.py | 查询发布进度与结果 | | query_assets.py | 只读查询：素材 / 草稿 / 已发布文章 | | manage_themes.py | 主题管理：添加 / 列出 / 删除 | | wechat_client.py | 底层接口封装 |

---

参考文档

references/api-mapping.md：接口映射、渲染引擎详情

references/safety-rules.md：确认门槛、凭据规范、能力边界