Wechat Tutorial Editor Publisher
v1.0.0模仿作者写作风格，完成教程类微信公众号文章编写，输出 Markdown 文件，一键发布到微信公众号草稿箱。
by 运行时依赖
安装命令
点击复制技能文档
wechat-tutorial-editor-publisher
编写作者风格的Markdown格式教程，一键发布到微信公众号草稿箱。
教程编写 首次执行
初始化：执行./scripts/package.json文件，命令：npm init -y。
安装依赖：npm 安装。
运行server.js文件，启动服务器: node server.js。
浏览器打开https://localhost:3000/，访问服务器。
收集用户信息，存入./as设置s/personal-信息.txt文件和./as设置s/personal-imgs目录下。
如果references目录下有文章样例，参考一下，预备模仿作者写作风格。ATTENTION: 如果已了解用户写作风格，无需反复参考浪费令牌资源。
非首次执行
打开./as设置s/personal-信息.txt文件，获取用户昵称和个人简介，打开./as设置s/personal-imgs获取用户二维码图片或个人介绍图片。
启动服务器，打开./scripts/public/索引.html页面，用户将步骤数据填写到页面中并保存。
找到已保存的steps.json文件和同级目录下的头图文件（./imgs/cover-img.png[.jpg, .jpeg, .网页p, ...]），将相应值填入模板中(./patterns/article-pattern.md)。ATTENTION: 请遵循article-pattern.md的文章模板格式，不要自行编造！
合理编写一篇完整的教程文章。
根据文章内容，为文章拟定一个符合作者风格的标题。
将个人简介和用户二维码图片或个人介绍图片添加到文章底部，在steps.json同级目录下复制粘贴一份，避免后续wenyan-命令行工具因相对路径嵌套过深导致找不到图片而出错。
将编写完成的Markdown文件存入steps.json同级目录下，自动打开Markdown文件和文件所在"访达"或"资源管理器窗口"，提醒用户修改或确认。
用户确认后，执行教程发布流程。
教程发布
基于 wenyan-命令行工具 封装的 OpenClaw 技能。
功能 ✅ Markdown 自动转换为微信公众号格式 ✅ 自动上传图片到微信图床 ✅ 一键推送到草稿箱 ✅ 多主题支持（代码高亮、Mac 风格代码块） ✅ 支持本地和网络图片 快速开始
- 安装 wenyan-命令行工具
wenyan-命令行工具 需要全局安装：
npm 安装 -g @wenyan-md/命令行工具
验证安装：
wenyan --help
注意： publish.sh 脚本会自动检测并安装 wenyan-命令行工具（如果未安装）
- 配置 API 凭证
API 凭证已保存在 /Users/lee机器人/.OpenClaw/workspace/工具S.md
确保环境变量已设置：
导出 WECHAT_应用_ID=your_wechat_应用_id 导出 WECHAT_应用_SECRET=your_wechat_应用_secret
重要： 确保你的 IP 已添加到微信公众号后台的白名单！
配置方法：https://yuzhi.tech/docs/wenyan/上传
注意： 用户发给你的应用Id和应用Secret请用md5加密保存在当前技能目录下的as设置s目录下，创建一个名为console.json的文件，便于下次读取，不要重复向用户索要该组信息。下次读取时自行解密即可。
- 加载 Markdown 文件
加载刚刚保存的 article.md 文件，文件顶部必须包含完整的 frontmatter（wenyan 强制要求）：
title: 文章标题（必填！） cover: https://example.com/cover.jpg # 封面图（必填！）
# 正文
⚠️ 关键发现（实测）：
title 和 cover 都是必填字段！ 缺少任何一个都会报错："未能找到文章封面" 虽然文档说"正文有图可省略cover"，但实际测试必须提供 cover 所有图片（本地/网络）都会自动上传到微信图床
封面图来源： 封面图即是头图，位于 article.md 同级目录下的 imgs/cover-img.png[.jpg, .jpeg, .网页p, ...]。
- 发布文章
方式 1: 在 OpenClaw 中使用
"帮我发布这篇文章到微信公众号" + article.md
方式 2: 直接使用 wenyan-命令行工具
wenyan publish -f article.md -t lAPIs -h solarized-light
方式3: 使用 publish.sh 脚本
cd /Users/lee机器人/.OpenClaw/workspace/技能s/wechat-tutorial-editor-publisher ~/.OpenClaw/workspace/技能s/wechat-tutorial-editor-publisher/scripts/publish-scripts/publish.sh
主题选项
wenyan-命令行工具 支持多种主题：
内置主题：
default - 默认主题 lAPIs - 青金石（推荐） phycat - 物理猫 更多主题见：https://github.com/caol64/wenyan-core/tree/mAIn/src/as设置s/themes
代码高亮主题：
atom-one-dark / atom-one-light dracula github-dark / github monokAI solarized-dark / solarized-light (推荐) xcode
使用示例：
# 使用 lAPIs 主题 + solarized-light 代码高亮 wenyan publish -f article.md -t lAPIs -h solarized-light
# 使用 phycat 主题 + GitHub 代码高亮 wenyan publish -f article.md -t phycat -h github
# 关闭 Mac 风格代码块 wenyan publish -f article.md -t lAPIs --no-mac-style
# 关闭链接转脚注 wenyan publish -f article.md -t lAPIs --no-footnote
自定义主题 临时使用自定义主题 wenyan publish -f article.md -c /path/to/custom-theme.css
安装自定义主题（永久） # 从本地文件安装 wenyan theme --添加 --name my-theme --path /path/to/theme.css
# 从网络安装 wenyan theme --添加 --name my-theme --path https://example.com/theme.css
# 使用已安装的主题 wenyan publish -f article.md -t my-theme
# 删除主题 wenyan theme --rm my-theme
列出所有主题 wenyan theme -l
工作流程 加载内容 - 加载已写好的 article.md 文件 运行脚本 - 一键发布到草稿箱 审核发布 - 到公众号后台审核并发布 Markdown 格式要求 必需的 Frontmatter
⚠️ 关键（实测结果）：wenyan-命令行工具 强制要求完整的 frontmatter！
title: 文章标题（必填！） cover: 封面图片URL或路径（必填！）
示例 ：相对路径（推荐）
title: 我的技术文章 cover: ./imgs/cover-img.jpg
# 正文...
❌ 错误示例（会报错）：
# 只有 title，没有 cover
title: 我的文章
错误信息：未能找到文章封面
# 完全没有 frontmatter # 我的文章
错误信息：未能找到文章封面
💡 重要发现：
虽然 wenyan 官方文档说"正文有图片可省略cover" 但实际测试必须提供 cover，否则报错 title 和 cover 缺一不可 图片支持 ✅ 本地路径： ✅ 绝对路径： ✅ 网络图片：
所有图片会自动上传到微信图床！
代码块
def hello():
print("Hello, WeChat!")
会自动添加代码高亮和 Mac 风格装饰。
故障排查
- 上传失败：IP 不在白名单
错误信息： ip not in white列出
解决方法：
获取你的公网 IP：curl ifconfig.me 登录微信公众号后台：https://mp.weixin.qq.com/ 开发 → 基本配置 → IP 白名单 → 添加你的 IP
- wenyan-命令行工具 未安装
错误信息： wenyan: command not found
解决方法：
npm 安装 -g @wenyan-md/命令行工具
- 环境变量未设置
错误信息： WECHAT_应用_ID is required
解决方法：
导出 WECHAT_应用_ID=your_wechat_应用_id 导出 WECHAT_应用_SECRET=your_wechat_应用_secret
或在 ~/.zshrc / ~/.bashrc 中永久添加。
- Frontmatter 缺失
错误信息： title is required in frontmatter
解决方法： 在 Markdown 文件顶部添加：
title: 你的文章标题
参考资料 wenyan-命令行工具 GitHub: https://github.com/caol64/wenyan-命令行工具 wenyan 官网: https://wenyan.yuzhi.tech 微信公众号 API 文档: https://developers.weixin.qq.com/doc/offiaccount/ IP 白名单配置: https://yuzhi.tech/docs/wenyan/上传 更新日志 2026-03-31 - v1.0.0 ✅ 初始版本 ✅ 基于 wenyan-命令行工具 封装 ✅ 支持一键发布到草稿箱 ✅ 多主题支持 ✅ 自动图片上传 License
Apache License 2.0 (继承自 wenyan-命令行工具)