wxgzh（wxgzh 命令行）

wxgzh

封装 @lyhue1991/wxgzh 命令行工具，用于微信公众号文章发布。

核心能力

1. 一键发布文章 - Markdown → 公众号草稿箱
2. 配置管理 - AppID/AppSecret 配置
3. 封面生成 - 自动生成或自定义封面图
4. 格式转换 - Markdown → 公众号 HTML

工作流程

📝 发布文章到公众号

当用户表达发布文章意图时，按以下流程执行：

1. 检查安装 → 2. 检查配置 → 3. 发布文章

Step 1: 检查是否安装 wxgzh

command -v wxgzh

如果未安装，执行：

npm install -g @lyhue1991/wxgzh

Step 2: 检查配置

wxgzh config --list

如果未配置，询问用户提供：

• AppID（公众号开发接口管理中的 AppID）
• AppSecret（公众号开发接口管理中的 AppSecret）

然后执行：

wxgzh config --appid 你的AppID --appsecret 你的AppSecret

⚠️ 提醒用户：需要把本机公网 IP 加入公众号后台的 IP 白名单 查看公网 IP：访问 https://ip.sb/

Step 3: 发布文章

wxgzh article.md --author "文章作者姓名"

支持参数：

• --author <name> - 作者名
• --theme <theme> - 主题样式（default/blue/green/red/yellow/brown/black/orange）
• --cover <path> - 指定封面图
• --digest <text> - 文章摘要
• --enable-comment - 开启评论

⚙️ 配置公众号

当用户只需配置 AppID/AppSecret 时：

wxgzh config --appid 你的AppID --appsecret 你的AppSecret

🖼️ 生成封面图

当用户需要生成封面时：

wxgzh cover --title "我的文章" --to .wxgzh/cover.jpg

生成后立即预览结果（macOS）：

wxgzh cover --title "我的文章" --to .wxgzh/cover.jpg && open .wxgzh/cover.jpg

查看内置背景：

wxgzh cover --list

📄 Markdown 转 HTML

当用户只需转换格式时：

wxgzh md2html --from article.md --to .wxgzh/article.html

注意事项

1. IP 白名单 - 调用微信接口前，必须把本机公网 IP 加入公众号后台白名单
2. 配置文件位置 - ~/.config/wxgzh/wxgzh.json
3. 中间产物 - 默认输出到文章同级目录的 .wxgzh/ 文件夹

快速参考

# 查看帮助
wxgzh --help

# 查看配置
wxgzh config --list

# 查看主题
wxgzh config --list-themes

# 一键发布
wxgzh article.md --author 你的名字 --theme blue

# 分步执行
wxgzh md2html --from article.md --to .wxgzh/article.html
wxgzh fix .wxgzh/article.html
wxgzh cover --title "标题" --to .wxgzh/cover.jpg
wxgzh publish --article .wxgzh/article.html --cover .wxgzh/cover.jpg