wenyan-cli 发布指南

# 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