publish-md-to-wechat 面向把 Markdown 发布到微信公众号草稿箱的场景,附带视觉风格、图片处理与封面生成。
用途与模式严格区分:模式 A 文章发布(Markdown 转公众号草稿,输出草稿 media id,命令为 scripts/wechat_publisher.py);模式 B 视频渲染(生成竖版 MP4,输入含时长、语气、受众、视觉风格与可选 Edge TTS 音色,命令为 scripts/video_publisher.py);模式 C 全文翻译/转载,由智能体自行翻译(不调用 Python 脚本翻译),保存到 /tmp/translated_article.md 后再按模式 A 发布。不要把 A、B 步骤混在同一流程,除非用户明确同时要两种产出。
环境与凭据:可用 ls .venv/bin/python 2>/dev/null || echo "MISSING" 检查依赖,缺失时运行 ./install.sh;凭据自动从当前目录 .env 或 ~/.config/publish-md-to-wechat/.env 读取。发布前可先试运行校验:.venv/bin/python3 scripts/wechat_publisher.py --md [PATH] --style [STYLE] --dry-run --out-html /tmp/preview.html,正式发布去掉 --dry-run。常用参数有 --thumb、--title、--no-verify-ssl、-v。
风格:用 .venv/bin/python3 scripts/styles.py --list 列出,核心为 swiss、editorial、ink,另有 notebook、geometry、botanical、terminal、bold、cyber、voltage 等扩展风格,并支持从公众号文章创建 custom-xxx 自定义风格。
视频号流程需先向用户确认时长、旁白语气、目标受众、视觉风格与可选音色,不可自行假设;生成项目使用 .venv/bin/python3 scripts/video_publisher.py --init-project /tmp/video-project,再编辑 scenes.txt 与 gen_scenes.py,最后渲染 --project-dir … --duration … --voice … --rate … --out …。依赖 ffmpeg、Playwright Chromium 与 edge-tts,并需查看 build/check_start.jpg、check_middle.jpg、check_end.jpg 做视觉校验。
限制:公众号平台的 IP 白名单、凭据、限流等错误需按提示处理;平台渲染限制(图片 data-src、脚注空白节点、锚点链接、脚注回链)由后处理器自动修复。其余未提供的收费、价格、平台支持范围等信息暂未提供。