wenyan-cli 发布指南

准备工作

你需要准备一篇 Markdown 格式的文章，包含必要的 frontmatter（标题、封面等元数据）。如果文章内包含图片，确保图片路径正确且可访问，CLI 会自动上传图片到微信公众号素材库。

安装 wenyan-cli

npm install -g @wenyan-md/cli

确认安装成功：

wenyan --version

发布文章

发布文章的基本命令如下：

wenyan publish [options]

命令参数说明

参数	简写	说明	必填	默认值
--file	-f	Markdown 文件路径	否¹	-
--theme	-t	排版主题	否	default
--highlight	-h	代码高亮主题	否	solarized-light
--custom-theme	-c	自定义主题 CSS（本地或 URL）	否	-
--no-mac-style	-	禁用代码块 Mac 风格	否	启用
--no-footnote	-	禁用脚注转换	否	启用
--server	-	Wenyan Server 地址	否	-
--api-key	-	Server API Key	否²	-
--help	-	查看帮助	否	-

从本地文件读取并发布

wenyan publish -f article.md

指定排版主题

wenyan publish -f article.md -t orangeheart

指定代码高亮主题

wenyan publish -f article.md -h solarized-light

主题管理

主题管理的基本命令如下：

wenyan theme [options]

命令参数说明

参数	简写	说明	必填	默认值
--list	-l	列出所有可用主题（内置 + 自定义）	否	-
--add	-	触发添加自定义主题操作	否（添加主题时必填）	-
--name	-	自定义主题名称（唯一标识）	是（仅 --add 生效时）	-
--path	-	主题 CSS 文件路径（本地绝对 / 相对路径、网络 URL）	是（仅 --add 生效时）	-
--rm	-	删除指定名称的自定义主题	否（删除主题时必填）	-

列出可使用的主题

wenyan theme -l

Frontmatter 要求

必须在 Markdown 顶部包含一段 frontmatter：

---
title: 文章标题
cover: ./cover.jpg
author: 作者名称
source_url: https://example.com
---

字段说明：

字段	必填	说明
title	是	文章标题
cover	否	封面图片（本地路径或网络 URL）
author	否	作者
source_url	否	原文链接

说明：

• 如果未指定 cover，将自动使用正文第一张图片作为封面
• cover 支持本地路径和网络 URL

常见问题

图片上传失败

请检查：

• 图片路径是否正确
• 图片文件是否存在
• 图片格式是否支持（jpg、png、gif）

发布失败：invalid ip

说明当前机器 IP 未加入微信公众号白名单。

解决方法：

登录微信公众号后台，将当前 IP 加入微信公众号白名单。

发布失败：invalid appid or secret

请在环境变量中设置以下变量：

WECHAT_APP_ID
WECHAT_APP_SECRET