wechat-draft-uploader

name	wechat-draft-uploader
description	Use wx-upload to upload Markdown to WeChat Official Account drafts with minimal setup.

Wechat Draft Uploader (AI Skill Doc)

Purpose

将 Markdown 文件上传为微信公众号草稿，包含图片上传、封面处理、样式注入与远程 Token 获取。

When To Use

• 用户要求把 Markdown 文章上传到公众号草稿箱。
• 用户在本地不具备 IP 白名单，需要通过白名单服务器获取 Token。
• 用户希望自动处理图片素材与封面图。

Preconditions

• 存在 .env：/root/git_repo/mk2wxhtml4api/standalone/.env
• 必填环境变量：appid、secret、SSH_REMOTE
• 本地可免密 SSH 登录到 SSH_REMOTE
• 已安装依赖（bun install）

Inputs

• 必需：Markdown 文件路径，例如 path/to/article.md
• 可选参数：--env /path/to/.env
• 可选参数：--title "My Title"
• 可选参数：--author "Alice"

Primary Command

wx-upload path/to/article.md

Options Examples

wx-upload --env /path/to/.env path/to/article.md
wx-upload --title "My Title" --author "Alice" path/to/article.md

Output

• 微信公众号草稿箱新增一条草稿。

Operational Steps (AI Checklist)

1. 确认 .env 存在且包含 appid、secret、SSH_REMOTE。
2. 确认 SSH 免密登录可用（如果用户反馈失败，提示检查 SSH Key 与白名单）。
3. 调用 wx-upload 执行上传。
4. 返回结果：成功则说明草稿已创建；失败则回传错误提示并给出排查方向。

Notes

• 未设置 WX_THUMB_MEDIA_ID 时，正文第一张图将作为封面图。
• 使用 Obsidian 图片语法 ![[image.png]] 会被正确处理。

Troubleshooting

• Token 获取失败：检查 SSH_REMOTE 是否可登录，服务器 IP 是否在白名单。
• 图片上传失败：检查网络、图片路径、WX_UPLOAD_LOCAL_IMAGES/WX_UPLOAD_REMOTE_IMAGES。
• 草稿未显示：等待数秒后刷新公众号后台。