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
前置配置：
-
获取公众号 AppID 和 AppSecret
- 登录微信公众号后台
- 进入"设置与开发" → "开发接口管理"
- 复制 AppID 和 AppSecret
-
配置 IP 白名单 ⚠️
- 在公众号后台"开发接口管理" → "基本配置" → "IP 白名单"
- 添加本机公网 IP（可通过访问 ip.sb 查看）
- 重要：未配置白名单会导致
40164错误
-
配置凭证
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）
常见问题：
40164错误：IP 不在白名单，需在公众号后台添加本机公网 IP- 封面图比例错误：微信封面图要求 2.35:1，工具会自动裁剪
- 图片上传失败：确保图片为本地路径，或已上传至微信图床
使用示例
示例 1：基于网页链接创作
用户输入：
请根据这个链接写一篇关于 LangChain 的公众号文章：
https://python.langchain.com/docs/get_started/introduction
技能执行：
- 抓取并分析网页内容
- 创作文章（包含 Front Matter 元信息、mermaid 图表、适当的表情符号）
- 保存为
langchain-intro.md - 执行
wenyan publish -f langchain-intro.md发布到草稿箱
示例 2：基于多个参考资料
用户输入：
请根据以下资料写一篇 AI 产品经理的文章：
- 文档：/path/to/product-methods.pdf
- 链接：https://example.com/ai-pm-guide
技能执行：
- 读取 PDF 文档和网页内容
- 整合信息，创作结构化的文章
- 保存为
ai-product-manager.md - 执行
wenyan publish -f ai-product-manager.md发布到草稿箱
注意事项
- 内容准确性：必须严格基于参考资料，不臆造信息，确保内容可靠
- 格式规范：确保 Markdown 语法正确，标题层级清晰，无语法错误
- 发布前检查：执行
publish命令前确认 wenyan-cli 已正确配置，文件路径正确 - 封面图片：默认使用
asset/微信公众号头像.png，请确保该路径存在或使用自定义封面 - IP 白名单：发布前务必在公众号后台配置本机 IP 白名单，避免
40164错误