name: "wechat-blog-write-publish"
description: "基于参考资料创作微信公众号文章并发布到草稿箱。Invoke when user provides reference materials and wants to create and publish a WeChat official account article."

WeChat Blog Write & Publish

本技能基于参考资料自动创作微信公众号文章，并发布到公众号草稿箱，实现从素材到成品的全流程自动化。

工作流程

1. 接收输入

• 接收用户提供的参考资料（网页链接、文档、PDF 等）
• 确认文章主题、核心内容方向和写作风格

2. 内容创作

严格遵循以下标准创作高质量文章：

内容要求

• ✅ 准确性：严格依据参考资料，确保信息准确、来源可靠
• ✅ 专业性：突出专业深度和实用价值，提供丰富的干货内容
• ✅ 可读性：采用通俗易懂的表达，避免过度使用专业术语，必要时提供清晰解释
• ✅ 逻辑性：结构清晰，层次分明，论述连贯

排版设计

• ✅ 布局美观：整体排版大方得体，视觉舒适
• ✅ 标题层级：合理使用 Markdown 标题（# ## ###），层次清晰
• ✅ 段落分隔：段落长短适中，分隔清晰
• ✅ 重点突出：使用 加粗、> 引用 等方式强调关键信息

视觉元素

• ✅ 适度装饰：合理运用表情符号（如：😊、🎉、✨、📌）增强可读性
• ✅ 风格平衡：保持专业性与趣味性的平衡，避免过度娱乐化

图表要求

• ✅ 流程图/架构图：涉及流程、架构等内容时，使用 mermaid 语法创建可视化图表
• ✅ 示例：

graph TD
    A[开始] --> B[输入处理]
    B --> C[内容生成]
    C --> D[发布]

元信息格式

文章开头必须包含 Front Matter 元信息：

---
title: 文章标题
cover: asset/微信公众号头像.png
---

3. 输出格式

• 将完成的文章保存为 Markdown (.md) 格式文件
• 确保 Markdown 语法正确，可直接用于发布

4. 发布文章

使用 wenyan-cli 工具将 Markdown 文章发布到微信公众号草稿箱：

wenyan publish -f 文章名字.md

wenyan-cli 工具说明

安装方式：

npm install -g @wenyan-md/cli

前置配置：

1. 获取公众号 AppID 和 AppSecret

   • 登录微信公众号后台
   • 进入"设置与开发" → "开发接口管理"
   • 复制 AppID 和 AppSecret

2. 配置 IP 白名单 ⚠️

   • 在公众号后台"开发接口管理" → "基本配置" → "IP 白名单"
   • 添加本机公网 IP（可通过访问 ip.sb 查看）
   • 重要：未配置白名单会导致 40164 错误

3. 配置凭证

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

常用命令：

# 一键发布（最常用）
wenyan publish -f article.md

# 指定主题样式
wenyan publish -f article.md --theme blue

# 指定作者
wenyan publish -f article.md --author "作者名"

# 指定封面图
wenyan publish -f article.md --cover ./cover.jpg

# 开启评论
wenyan publish -f article.md --enable-comment

# 查看当前配置
wenyan config --list

# 查看可用主题
wenyan config --list-themes

内置主题： default, blue, green, red, yellow, brown, black, orange

Front Matter 支持：

文章开头可使用 Front Matter 定义元信息，命令行参数优先级高于 Front Matter：

---
title: 文章标题
author: 作者名
digest: 文章摘要
theme: blue
cover: ./cover.jpg
enableComment: true
---

分步执行流程：

如需更精细的控制，可分步执行：

# Step 1: Markdown 转 HTML（可指定主题）
wenyan md2html --from article.md --to article.html --theme blue

# Step 2: 修复 HTML 并上传图片到微信图床
wenyan fix article.html

# Step 3: 生成封面图
wenyan cover --title "文章标题" --author "作者名" --to cover.jpg

# Step 4: 发布到草稿箱
wenyan publish --article article.html --cover cover.jpg

输出目录结构：

执行后会在同级目录生成 .wxgzh/ 中间产物目录：

.wxgzh/
├── article.html          # 转换后的 HTML（已内联样式）
├── article.cover.jpg     # 自动生成的封面图
└── publish-result.json   # 发布结果（含草稿 ID）

常见问题：