微信公众号发布
将 Markdown 文章转换为微信公众号格式并提交到草稿箱。基于 wenyan-cli，支持主题、代码高亮和本地/网络图片上传。
触发场景
- 要求“发到公众号”“推送公众号”“提交公众号草稿”。
- 需要把 Markdown 排版为微信公众号图文。
- 需要选择文章主题、代码高亮或排查图片/API/白名单问题。
安全边界
- 默认只提交草稿箱，不代替公众号后台的审核和正式发布。
- 只有明确要求时才执行联网发布；先运行
--dry-run。 - 从当前 shell、CI Secret 或外部密钥管理器读取
WECHAT_APP_ID、WECHAT_APP_SECRET；禁止把凭证写入仓库、模板、文章或命令历史。 - 发布前运行
scripts/validate_article.py。发现疑似凭证、私钥或本机路径时停止并要求清理，不回显匹配值。 - 不读取宿主环境私有配置、个人配置或固定绝对路径；不自动安装全局依赖。
标准流程
-
准备带 frontmatter 的 Markdown 文件，优先复制
assets/templates/article-template.md。 -
在 frontmatter 中填写
title和cover；正文至少保留一张可访问的图片作为后备封面。 -
使用
python3 scripts/validate_article.py ARTICLE.md检查结构和敏感信息。 -
使用
scripts/publish.sh --dry-run ARTICLE.md预览命令。 -
明确获得“提交草稿”意图后，设置凭证并执行：
export WECHAT_APP_ID='从密钥管理器注入的值' export WECHAT_APP_SECRET='从密钥管理器注入的值' ./scripts/publish.sh ARTICLE.md lapis solarized-light -
到微信公众号后台审核草稿；需要正式发布时由操作者在后台完成。
模板与参考资料
assets/templates/article-template.md：通用文章骨架。assets/templates/technical-tutorial.md：技术教程模板。assets/templates/product-update.md：产品/版本更新模板。assets/templates/weekly-digest.md：周报或资讯汇总模板。assets/templates/cover-prompt.txt：封面图生成提示词模板。references/themes.md：主题与代码高亮选型。references/content-checklist.md：发布前内容检查单。references/troubleshooting.md：常见错误和排查路径。
命令速查
./scripts/publish.sh --help
./scripts/publish.sh --dry-run path/to/article.md
./scripts/publish.sh path/to/article.md
./scripts/setup.sh
publish.sh 默认使用 lapis 主题和 solarized-light 代码高亮，也可通过参数或环境变量 WECHAT_PUBLISH_THEME、WECHAT_PUBLISH_HIGHLIGHT 覆盖。