| name | wechat-publisher |
| description | 【公众号发布助手】将 WPS 笔记排版并导出为微信公众号 HTML。
当用户说"发公众号""排版公众号""导出到公众号""我要发布了""文章排版""发一下""排版这篇文章"时使用。
这是创作流程的最后一步：内容已完成，需要排版发布到公众号。
核心能力：1)自动套用排版模板 2)占位符标签转样式 3)生成可直接粘贴的 HTML。
输入：WPS 笔记 ID（内容已完成的笔记）。输出：带内联样式的 HTML 文件。
不要用于创作内容，只用于已完成的排版发布。
|
| metadata | {"version":"1.1.0","category":"publishing","tags":["wechat","publishing","html-export","content-formatting"],"dependencies":["wps-note"]} |
WeChat Publisher - 公众号发布助手
将已完成的 WPS 笔记内容，一键排版并导出为微信公众号 HTML 格式。这是创作流程的最后一步：内容已完成，只需排版发布。
使用场景
典型工作流：
- 用
content-creator 创作文章内容
- 保存到 WPS 笔记
- 用本 skill 导出排版好的 HTML ← 你在这里
- 粘贴到公众号后台直接发布
Contract（契约）
Input Contract
触发条件：
- "发公众号"
- "排版公众号"
- "导出到公众号"
- "我要发布了"
- "文章排版"
- "生成公众号 HTML"
- "这篇可以发了"
- "帮我排版一下"
输入类型：
- WPS 笔记 ID（必填）：内容已完成的笔记
- 模板名称（可选）：
default/minimal/elegant，默认 blue-theme
- 输出路径（可选）：默认生成
{标题}_formatted.html
前置条件：
- 笔记内容已完成（不是空笔记）
- 笔记已保存并同步到云端
- 内容建议 < 20000 字符
Output Contract
| 文件 | 说明 |
|---|
{标题}_formatted.html | 带内联样式的公众号排版文件，可直接粘贴到公众号编辑器 |
排版特性：
- WPS 笔记 XML 直接转 HTML（无 Markdown 中间层，样式精度更高）
- WPS 预设颜色（fontColor / fontHighlightColor）完整映射到内联样式
- 代码块语法高亮
- 图片自适应处理
- 移动端阅读优化
Error Contract
| 错误场景 | 错误码 | 处理方式 |
|---|
| 笔记不存在 | NOTE_NOT_FOUND | 检查 note_id 是否正确 |
| 笔记为空 | EMPTY_CONTENT | 提示先完成内容创作 |
| 内容过长 | CONTENT_TOO_LONG | 建议拆分为多篇发布 |
| 图片处理失败 | IMAGE_ERROR | 检查图片链接有效性 |
工具优先级策略
优先使用 CLI，降级到 MCP：
检查 wpsnote-cli 是否可用
↓ 可用（推荐路径）
wpsnote-cli current / find → 获取笔记 ID
wpsnote-cli read --note_id <id> --json → 获取笔记内容（XML）
↓ CLI 不可用（命令不存在 / 认证失败）
[降级] MCP: get_current_note / search_notes
[降级] MCP: read_note
AI 操作决策树：
用户触发「排版发布」
│
├─ 检测 wpsnote-cli
│ ↓ 可用
│ ① 无 note_id → wpsnote-cli current --json
│ 有 note_id → 直接跳到 ③
│ ↓ 不可用
│ ① 无 note_id → MCP: get_current_note()
│
├─ ② 搜索确认（用户给了关键词）
│ CLI: wpsnote-cli find --keyword "xxx" --json
│ MCP: search_notes({ keyword: "xxx" })
│
├─ ③ 读取笔记内容
│ CLI: wpsnote-cli read --note_id <id> --json
│ MCP: read_note({ note_id: <id> })
│
└─ ④ 执行导出脚本
python scripts/export-to-html.py --note-id <id>
→ 生成 "{标题}_formatted.html"
快速开始
方式一：CLI 读取 + 脚本转换（推荐）
python scripts/export-to-html.py --current
python scripts/export-to-html.py --note-id "abc123"
python scripts/export-to-html.py --note-id "abc123" --template "elegant"
python scripts/export-to-html.py --search "文章标题"
Python API
from scripts.export_to_html import WPSNoteExporter
exporter = WPSNoteExporter()
exporter.export(
note_id="abc123",
template_name="default",
output_path="./article.html"
)
方式二：MCP 工具方式（CLI 不可用时降级）
通过 wps-note SKILL 的 MCP 工具读取笔记内容，再转换为 HTML：
# 1. 搜索并获取笔记
search_notes({ keyword: "文章标题" }) → note_id
# 2. 读取笔记内容
read_note({ note_id }) → xml_content
# 3. 转换为 HTML（本地脚本处理）
python scripts/export-to-html.py --note-id <id>
完整 MCP 工作流示例
# 步骤 1：获取当前笔记（或搜索）
get_current_note()
→ { note_id: "abc123", title: "AI 工具介绍", word_count: 3500 }
# 步骤 2：读取笔记内容（根据大小选择方式）
get_note_outline({ note_id: "abc123" })
→ blocks: [...]
read_note({ note_id: "abc123" })
→ xml_content: "<h1>AI 工具介绍</h1><p>...</p>"
# 步骤 3：导出为 HTML（本地脚本转换）
python scripts/export-to-html.py --note-id "abc123" --template blue-theme
→ 生成 "AI 工具介绍_formatted.html"
占位符标签（快速排版）
在 WPS 笔记中使用这些标签，导出时自动转换为对应样式：
| 标签 | 用法 | 效果 |
|---|
<b/> | <b/>文字</b> | 橙色加粗（整段或行内） |
<h2/> | <h2/>大标题</h2> | 蓝色大标题（一级章节） |
<h3/> | <h3/>小标题</h3> | 蓝色小标题（二级分节） |
<bq/> | <bq/>引用文字</bq> | 灰底蓝边引用块 |
<note/> | <note/>注释文字</note> | 灰色小字注释 |
使用示例：
<h2/>01｜核心观点
<b/>整段橙色加粗，适合核心金句。</b>
<b/>行内加粗</b> 用于强调重点词汇。
<h3/>深入分析
正文段落正常书写...
<bq/>引用块适合摘录观点或补充说明。</bq>
<note/>注：本文仅代表个人观点。</note>
WPS 笔记颜色 → HTML 颜色映射
WPS 笔记的 XML 中颜色受预设色板约束，导出时按下表映射为公众号内联样式 RGB 值：
fontColor（字体颜色）
| WPS XML 值 | 含义 | HTML 输出 |
|---|
#080F17 | 黑色 | color: rgb(8,15,23) |
#C21C13 | 红色 | color: rgb(194,28,19) |
#DB7800 | 橙色 | color: rgb(219,120,0) |
#078654 | 绿色 | color: rgb(7,134,84) |
#0E52D4 | 蓝色 | color: rgb(14,82,212) |
#0080A0 | 浅蓝 | color: rgb(0,128,160) |
#757575 | 灰色 | color: rgb(117,117,117) |
#DA326B | 粉色 | color: rgb(218,50,107) |
#D1A300 | 金色 | color: rgb(209,163,0) |
#58A401 | 浅绿 | color: rgb(88,164,1) |
#116AF0 | 亮蓝 | color: rgb(17,106,240) |
#A639D7 | 紫色 | color: rgb(166,57,215) |
fontHighlightColor（文字背景高亮）
| WPS XML 值 | 含义 | HTML 输出 |
|---|
#FBF5B3 | 黄色 | background-color: rgb(251,245,179); padding:0 2px; border-radius:2px |
#F8D7B7 | 橙色 | background-color: rgb(248,215,183); ... |
#F7C7D3 | 粉色 | background-color: rgb(247,199,211); ... |
#DFF0C4 | 绿色 | background-color: rgb(223,240,196); ... |
#C6EADD | 深绿 | background-color: rgb(198,234,221); ... |
#D9EEFB | 蓝色 | background-color: rgb(217,238,251); ... |
#D5DCF7 | 浅蓝 | background-color: rgb(213,220,247); ... |
#E6D6F0 | 紫色 | background-color: rgb(230,214,240); ... |
#E6E6E6 | 灰色 | background-color: rgb(230,230,230); ... |
注意：任意 hex 色值在 WPS 编辑器中会被静默丢弃，导出脚本只处理上述预设色板中的颜色，其他值忽略不渲染。
模板风格
| 模板 | 特点 | 适用场景 |
|---|
blue-theme ⭐默认 | 蓝色强调色，现代简洁 | 科技、企业、正式文档 |
default | 橙色风格，专业美观 | 通用场景 |
minimal | 极简风格，干净利落 | 技术文档、教程 |
elegant | 优雅精致，细节丰富 | 深度长文、品牌内容 |
blue-theme 蓝色主题
基于样本 HTML 的蓝色主题，特点：
- 主色:
rgb(36, 91, 219) 深蓝色
- 正文字号: 15px（比默认更小更紧凑）
- 行距: 2.0（更舒适的可读性）
- 引用块: 左边框 3px + 浅灰背景
- 分栏: Flex 布局，居中对齐
使用方法：
python scripts/export-to-html.py --note-id "abc123" --template blue-theme
与 content-creator 的组合
创作流程：
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ content- │ │ WPS 笔记 │ │ wechat- │
│ creator │ --> │ （内容完成） │ --> │ publisher │
│ （创作内容） │ │ │ │ （排版发布） │
└─────────────────┘ └─────────────────┘ └─────────────────┘
你在这里 ↑
完整示例：
python scripts/create-content.py --topic "AI 工具介绍"
python scripts/wps-write.py --input draft.md --title "AI 工具介绍"
python scripts/export-to-html.py --search "AI 工具介绍"
转换流程
WPS 笔记 XML
│
├─ 占位符处理（<b/> <h2/> <bq/> <note/>）
│
├─ xml_to_html()：逐块渲染
│ ├─ <h1>/<h2> → <h2 style="...蓝色...">
│ ├─ <h3>-<h6> → <p><span style="...蓝色...">
│ ├─ <p> → <p><span style="...灰色正文...">
│ ├─ <p listType> → 橙色圆点 / 橙色数字列表
│ ├─ <blockquote> → 灰底蓝边引用块
│ ├─ <codeblock> → 语法高亮代码框
│ ├─ <table> → 蓝色表头表格
│ ├─ <highlightBlock>→ 高亮提示块（保留 WPS 配色）
│ ├─ <columns> → Flex 分栏
│ ├─ <span fontColor>→ WPS 预设颜色 → RGB 内联样式
│ └─ <strong>/<em> → 加粗 / 斜体
│
└─ 套入 template.html 壳 → {标题}_formatted.html
│
└─ 浏览器打开 → 点「复制内容」→ 粘贴到公众号
文件结构
wechat-publisher/
├── SKILL.md # 本文件
├── scripts/
│ ├── export-to-html.py # 核心导出脚本（WPS XML → HTML 直接转换）
│ └── md_to_html.py # 独立 MD 转 HTML 脚本（本地 .md 文件用）
├── templates/
│ ├── template.html # HTML 输出壳（含复制按钮）
│ ├── preview.html # 排版样例（各元素效果预览）
│ ├── default.yaml # 默认模板（橙色风格）
│ ├── blue-theme.yaml # 蓝色主题模板
│ ├── minimal.yaml # 极简模板
│ └── elegant.yaml # 优雅模板
└── references/
└── format-guide.md # 格式规范
常用编排模式
模式 1：直接导出当前笔记
用户已有内容，直接排版导出：
python scripts/export-to-html.py --current --template blue-theme
get_current_note() → note_id
python scripts/export-to-html.py --note-id <id> --template blue-theme
模式 2：搜索后导出
用户不记得笔记 ID，先搜索再导出：
python scripts/export-to-html.py --search "文章标题"
search_notes({ keyword: "文章标题" }) → note_id
python scripts/export-to-html.py --note-id <id>
Troubleshooting
CLI 不可用
现象：wpsnote-cli 命令未找到或认证失败
解决：自动降级使用 MCP 工具，流程不变
笔记读取失败 (NOTE_NOT_FOUND)
现象：search_notes 或 get_current_note 返回笔记不存在
原因：笔记 ID 错误、笔记被删除、编辑器未就绪
解决：
- 重新搜索确认正确的
note_id
- 检查 WPS 笔记应用是否正常打开
- 如使用
get_current_note，确保笔记窗口是激活状态
内容为空或格式错乱
现象：导出的 HTML 内容为空或格式异常
原因：笔记 XML 解析失败、包含不支持的 block 类型
解决：
- 检查笔记是否确实包含内容（不是空笔记）
- 查看笔记是否包含 embed、note_audio_card 等只读内容
- 手动检查 XML 结构是否有异常标签
图片无法显示
现象：公众号后台图片显示为空白或红叉
原因：图片 URL 失效、本地图片未正确转 base64、图片格式不支持
解决：
- 网络图片：检查 URL 是否直接指向图片资源（不是 HTML 页面）
- 本地图片：确认已转为 base64 data URI
- 图片格式：优先使用 PNG、JPG，避免 WebP
占位符标签不生效
现象：<b/>、<h2/> 等标签在 HTML 中显示为纯文本
原因：标签格式错误、嵌套不当
解决：
- 确保标签正确闭合：
<b/>文字</b> ✓ <b/>文字 ✗
- 检查标签是否嵌套在其他标签内导致解析失败
- 参考占位符标签章节的正确用法
模板加载失败
现象：指定模板后样式未生效，使用默认样式
原因：模板名称拼写错误、模板文件缺失、YAML 解析错误
解决：
- 检查模板名称拼写（
blue-theme、default、minimal、elegant）
- 确认
templates/ 目录存在对应 .yaml 文件
- 检查模板 YAML 格式是否正确
HTML 粘贴到公众号后样式丢失
现象：本地预览正常，但粘贴到公众号后台样式错乱
原因：公众号编辑器过滤部分 CSS、微信内置浏览器兼容性问题
解决：
- 使用内联样式（
style="..."），避免 class 选择器
- 避免使用复杂 CSS 特性（grid、flex 谨慎使用）
- 在公众号后台预览后，用手机扫码查看实际效果
MCP 工具调用失败
现象：mcp__wpsnote__read_note 等工具报错
原因：EDITOR_NOT_READY、BLOCK_NOT_FOUND、网络问题
解决：
- 检查 WPS 笔记应用是否正常运行
- 重新获取
note_id 或 block_id
- 参考
wps-note SKILL 的 Troubleshooting
注意事项
- 这是最后一步：只用于内容已完成的笔记，不要在这里创作
- CLI 优先：
wpsnote-cli 可用时总是首选，速度快且更稳定
- 行内代码：WPS XML 不支持行内代码，会被转为纯文本
- 内容长度：超过 20000 字符建议拆分多篇
- 图片处理：WPS 笔记里的图片
src 是 WPS CDN 地址，导出时直接引用，微信公众号可正常加载；不做 base64 转换（本地路径上传公众号容易失败）
- 图片说明：带
caption 属性的图片，导出后会在图片下方生成灰色居中小字说明
- 颜色约束：WPS 笔记只支持预设色板，任意 hex 会被编辑器静默丢弃；导出脚本按预设色板映射到 RGB，非预设色值直接忽略
Resources
- 格式规范：
references/format-guide.md
- 模板配置：
templates/
- 核心脚本：
scripts/export-to-html.py
- MD 转换脚本：
scripts/md_to_html.py
