wechat-html-publisher

直接上传HTML富文本到微信公众号草稿箱

与 wechat-publisher 不同,本skill直接上传HTML格式,无需Markdown转换。适合已经有完整HTML排版的文章。

功能

• - ✅ 直接上传HTML富文本
• ✅ 自动上传HTML中的图片到微信图床
• ✅ 支持本地和网络图片
• ✅ 一键推送到草稿箱
• ✅ 无需Markdown转换

快速开始

1. 配置API凭证

确保环境变量已设置:
CODEBLOCK0

重要: 确保你的IP已添加到微信公众号后台的白名单!

2. 准备HTML文件

HTML文件需要包含完整的样式(内联样式):

CODEBLOCK1

注意:

• - 必须使用内联样式(style属性)
• 不支持<style>标签或外部CSS
• 图片会自动上传到微信图床

3. 发布文章

使用脚本:
CODEBLOCK2

参数说明:

• - --file: HTML文件路径(必填)
• INLINECODE2: 文章标题(必填)
• INLINECODE3: 封面图路径(必填)
• INLINECODE4: 作者名称(可选)
• INLINECODE5: 文章摘要(可选)
• INLINECODE6: 原文链接(可选)

使用示例

示例1: 基本用法

CODEBLOCK3

示例2: 完整参数

CODEBLOCK4

示例3: 网络封面图

CODEBLOCK5

HTML格式要求

1. 必须使用内联样式

CODEBLOCK6

2. 图片支持

• - ✅ 本地路径: INLINECODE7
• ✅ 绝对路径: INLINECODE8
• ✅ 网络图片: INLINECODE9

所有图片会自动上传到微信图床并替换URL!

3. 推荐的HTML结构

CODEBLOCK7

工作流程

1. 1. 读取HTML - 读取HTML文件内容
2. 上传封面 - 上传封面图到微信图床
3. 处理图片 - 解析HTML中的图片,上传并替换URL
4. 调用API - 调用微信draft/add接口
5. 返回结果 - 返回草稿media_id

与wechat-publisher的区别

特性	wechat-publisher	wechat-html-publisher
输入格式	Markdown	HTML
样式转换

自动应用主题 | 使用原有样式 | | 适用场景 | 写作发布 | 已有HTML排版 | | 依赖 | wenyan-cli | 仅Python |

故障排查

1. IP不在白名单

错误: INLINECODE10

解决:

1. 1. 获取公网IP: INLINECODE11
2. 添加到微信公众号后台白名单

2. 图片上传失败

错误: INLINECODE12

解决:

• - 检查图片格式(支持jpg, png, gif)
• 检查图片大小(不超过2MB)
• 确保图片路径正确

3. HTML格式错误

错误: INLINECODE13

解决:

• - 确保使用内联样式
• 移除<style>标签
• 检查HTML是否闭合

参考资料

• - 微信公众号API文档: https://developers.weixin.qq.com/doc/offiaccount/
• 草稿箱接口: https://developers.weixin.qq.com/doc/offiaccount/DraftBox/Adddraft.html
• 素材管理接口: https://developers.weixin.qq.com/doc/offiaccount/AssetManagement/Newtemporary_materials.html

更新日志

2026-03-09 - v1.0.0

• - ✅ 初始版本
• ✅ 支持HTML直接上传
• ✅ 自动图片上传
• ✅ 命令行工具

License

MIT License