Xiaohu WeChat Format — 小胡微信格式

小胡微信格式化工具，将Markdown转换为微信公众号可用的HTML。支持33种内联样式主题，浏览器画廊，局部/外部图像上传到微信CDN，草稿箱发布，呼叫，对话块，画廊和可选的封面生成。

安全规则 格式化和本地预览是安全的。推送到微信草稿箱，上传永久媒体，评论自动回复或任何外部写入需要显式用户确认。永远不要打印app_secret，访问令牌或AI API密钥。当导入第三方文章时，除非用户确认拥有发布权，否则将输出视为草稿/预览。

快速命令 使用技能目录作为{skill}。 # 格式化一篇文章本地 uv run --with markdown python {skill}/scripts/format.py --input article.md --theme newspaper --no-open # 打开视觉画廊以选择主题 uv run --with markdown python {skill}/scripts/format.py --input article.md --gallery # 从Markdown发布到微信草稿箱 uv run --with markdown --with requests --with pillow python {skill}/scripts/publish.py --input article.md --theme newspaper --cover cover.jpg # 发布已经格式化的输出目录 uv run --with markdown --with requests --with pillow python {skill}/scripts/publish.py --dir /tmp/wechat-format/article --cover cover.jpg

配置 将config.example.json复制到config.json。填写wechat.app_id，wechat.app_secret和可选的wechat.author。将机器的公网IP添加到微信公众号管理后台→基本配置→IP白名单。错误40164表示IP未被列入白名单。保持config.json私密，它被git忽略且不得发布。

推荐工作流程 阅读或创建Markdown文章。如果文章是纯文本，只添加结构化Markdown：标题，列表，引用，强调。除非被要求，否则不要重写含义。使用一个主题或画廊进行格式化。对于草稿发布，请确保有一个封面图像。微信需要一个。对于批量主题比较，先发布一个小的精选集（例如minimal-gray，newspaper，focus-blue，ink，bauhaus，warm-card，ocean-card，minimal-red），然后再推送每个主题。使用主题ID为草稿预览标题，例如“文章标题 - 预览 - newspaper”。

重要：微信文章图像导入 从mp.weixin.qq.com获取的图像可能被错误标记：URL或wx_fmt可能表示PNG/JPG，而实际字节是WebP。微信的上传API会以errcode 40137无效图像格式拒绝此类图像。在发布导入的文章之前：从字节中检测真实文件类型，而不是文件名。将WebP或不支持的图像转换为真实JPEG。更新Markdown/HTML图像路径后转换。验证一个主题成功上传所有图像，然后再批量发布。publish.py包括自动魔术字节检测和WebP到JPEG转换，当Pillow可用时；使用uv运行时带有--with pillow。

Markdown扩展 :::dialogue[Interview] Alice: Hello Bob: Hi ::: ::: gallery[Screenshots]    :::

[!important] 关键见解
突出显示的文本。
[!tip] 提示
有用的注意事项。

可用脚本 scripts/format.py — Markdown → 微信兼容的内联HTML + 预览/画廊。 scripts/publish.py — 上传文章图像，上传封面，推送到草稿箱。 scripts/generate.py — 可选的封面图像生成，使用兼容的图像API。 scripts/comment_reply.py — 可选的评论自动回复；仅在显式确认时使用。

主题库存 运行：find {skill}/themes -maxdepth 1 -name '*.json' -printf '%f\n' | sed 's/\.json$//' | sort 常见的起始主题：newspaper，minimal-gray，focus-blue，ink，bauhaus，warm-card，ocean-card，wechat-native。