Skip to content

evcgs/wechat-content-pipeline

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

wechat-content-pipeline

微信公众号内容生产流水线 - 完整的 10 步内容生产流程。

支持两种使用方式:

  1. ✅ 作为 OpenClaw 技能使用
  2. ✅ 作为 独立 Node.js 工具使用

🚀 首次使用:初始化检查清单 ⭐⭐⭐(最重要!)

在开始写文章之前,请先完成以下检查和配置:


1. 依赖安装检查

  • Node.js 是否已安装?

    • 检查:node --version
    • 如果没有:请安装 Node.js
  • npm 是否已安装?

    • 检查:npm --version
    • 通常随 Node.js 一起安装
  • wenyan-cli 是否已安装?

    • 检查:wenyan --help
    • 如果没有:npm install -g @wenyan-md/cli
  • 项目依赖 是否已安装?

    • 检查:cd ~/.openclaw/workspace/skills/wechat-content-pipeline && npm install

2. API Key 配置检查

搜索验证(SerpAPI)

  • SERPAPI_KEY 是否已配置?

图片生成(选择一个模型)

选项 A:火山引擎(Volcengine)- 默认

  • VOLCENGINE_API_KEYARK_API_KEY 是否已配置?
    • 配置位置:~/.openclaw/.envconfig/config.json
    • 获取地址:https://www.volcengine.com/
    • 模型:doubao-seedream-4-5-251128
    • Endpoint:https://ark.cn-beijing.volces.com/api/v3/images/generations

选项 B:Qwen/Qwen-Image

  • QWEN_API_KEY 是否已配置?
    • 配置位置:~/.openclaw/.envconfig/config.json
    • 获取地址:https://dashscope.console.aliyun.com/
    • 模型:qwen-vl-maxqwen-image-plus
    • Endpoint:https://dashscope.aliyuncs.com/api/v1/services/aigc/text2image/image-synthesis

选项 C:其他模型

  • 请配置对应的 API Key
  • 请在 config/config.json 中添加模型配置

微信公众号发布

  • WECHAT_APP_IDWECHAT_APP_SECRET 是否已配置?

3. 模型选择与初始化配置

请选择你要使用的图片生成模型:

  • 火山引擎(Volcengine) - 默认推荐
  • Qwen/Qwen-Image
  • 其他模型(请说明)

请确认你的选择: ________________________


4. 配置文件检查

  • 配置文件 是否已创建?

    • 检查:~/.openclaw/workspace/skills/wechat-content-pipeline/config/config.json
    • 如果没有:从 config.example.json 复制
  • 配置文件内容 是否正确?

    • 检查:API Key 是否填入
    • 检查:模型选择是否正确
    • 检查:微信公众号配置是否正确

5. 快速验证

运行验证命令:

cd ~/.openclaw/workspace/skills/wechat-content-pipeline
node bin/wechat-pipeline.js doctor

确认所有检查都通过!


✅ 初始化检查清单完成后,就可以开始写文章了!


🔧 多模型架构说明(支持火山引擎、Qwen、OpenAI 等)

本项目采用多模型支持架构,图片生成支持多种模型,用户可自由选择:

支持的模型:

  1. 火山引擎(Volcengine) - 默认推荐

  2. Qwen/Qwen-Image

  3. OpenAI DALL-E 3

  4. 可扩展支持其他模型

配置方法:

config/config.json 中配置:

{
  "imageGeneration": {
    "defaultModel": "volcengine",
    "models": {
      "volcengine": { ... },
      "qwen": { ... },
      "openai": { ... }
    }
  }
}

1. 文字生成模型(OpenClaw 配置)

  • 用途: 文章撰写、创意提炼、大纲搭建等文字类任务
  • 配置位置: OpenClaw 全局配置中的默认大模型
  • 使用场景: 步骤 1-6、步骤 8 的文字处理工作

2. 图片生成模型(技能独立配置 - 多模型支持)

  • 用途: 封面图、内文配图的生成
  • 配置位置: 技能独立配置文件 config/config.json
  • 相关技能: 本项目支持多种图片生成模型
  • 使用场景: 步骤 7 的图片生成工作

为什么多模型支持?

  • 用户可根据自己的 API Key 选择最适合的模型
  • 不同模型的特点和成本不同,灵活选择
  • 可以单独更新/切换其中一个模型,不影响另一个的使用

🔧 双模型架构说明

本项目采用双模型分离架构,文字生成和图片生成使用不同的模型,各自独立配置:

1. 文字生成模型(OpenClaw 配置)

  • 用途: 文章撰写、创意提炼、大纲搭建等文字类任务
  • 配置位置: OpenClaw 全局配置中的默认大模型
  • 使用场景: 步骤 1-6、步骤 8 的文字处理工作

2. 图片生成模型(技能独立配置)

  • 用途: 封面图、内文配图的生成
  • 配置位置: 技能独立配置文件 config/config.json 中的火山引擎(Volcengine)API
  • 相关技能: 本项目依赖 volcengine-image-gen 技能进行图片生成
  • 使用场景: 步骤 7 的图片生成工作

为什么分开配置?

  • 文字和图片对模型的要求不同,分离可以灵活选择最适合的模型
  • 图片生成通常需要更高的 API 配额,独立配置便于成本控制
  • 可以单独更新/切换其中一个模型,不影响另一个的使用

完整内容生产工作流(10步)

1. 选题确认
   ↓
2. 创意点提炼(5个核心创意点+金句)
   ↓
3. 证据链整理(每个创意点2-3个证据+来源)
   ↓
4. 大纲搭建(三级大纲,约2500-3000字)
   ↓
5. 写文章(初稿)
   ↓
6. 搜索验证(SerpAPI搜索修正)
   ↓
7. 生成图片(火山引擎生图)
   ↓
8. 插入图片/更新文章
   ↓
9. 发布前检查环节(新增!)
   ↓
10. 发布(微信公众号)

**详细说明见:WORKFLOW.md

完整模板见:templates/workflow/


功能

  • 搜索验证 - 使用 SerpAPI 搜索和获取网络信息
  • 图片生成 - 使用火山引擎生成封面图和内文图
  • 微信发布 - 使用 wenyan-cli 一键发布到微信公众号草稿箱
  • 统一配置 - 一个配置文件管理所有密钥
  • 统一入口 - 一个命令完成所有操作
  • 安装验证 - 使用 doctor 命令验证安装是否成功

两种使用方式

方式 1: 作为 OpenClaw 技能使用(推荐)

如果你使用 OpenClaw,这是最简单的方式。

安装步骤

  1. 复制技能到 OpenClaw
# 假设你的 OpenClaw workspace 在 ~/.openclaw/workspace
cp -r wechat-content-pipeline ~/.openclaw/workspace/skills/
  1. 安装依赖
cd ~/.openclaw/workspace/skills/wechat-content-pipeline
npm install
  1. 安装 wenyan-cli(必需)
npm install -g @wenyan-md/cli
wenyan --help
  1. 配置
cd ~/.openclaw/workspace/skills/wechat-content-pipeline
cp config/config.example.json config/config.json

编辑 config/config.json,填入你的 API 密钥。

在 OpenClaw 中使用

"帮我运行完整流水线发布这篇文章"
+ 附带文章路径:./content/my-article.md

更多细节见:SKILL.md


方式 2: 作为独立 Node.js 工具使用

如果你不使用 OpenClaw,可以作为独立命令行工具使用。

安装步骤

  1. 克隆仓库
git clone https://github.com/evcgs/wechat-content-pipeline.git
cd wechat-content-pipeline
npm install
npm link  # 可选,全局链接命令
  1. 安装 wenyan-cli(必需)
npm install -g @wenyan-md/cli
wenyan --help
  1. 配置
cp config/config.example.json config/config.json

编辑 config/config.json,填入你的 API 密钥。

使用命令行

# 查看帮助
wechat-pipeline --help

# 完整流水线(一条龙)
wechat-pipeline pipeline --article ./content/my-article.md

# 分步执行
wechat-pipeline search --article ./content/my-article.md
wechat-pipeline image --article ./content/my-article.md
wechat-pipeline publish --file ./content/my-article.md

# 单独使用
wechat-pipeline search --query "搜索关键词"
wechat-pipeline image --prompt "图片描述" --size 2560x1440 --type cover
wechat-pipeline publish --file ./content/my-article.md

# 配置管理
wechat-pipeline config --init
wechat-pipeline config --show

验证安装(重要!)

安装完成后,运行验证命令:

wechat-pipeline doctor

成功输出示例:

╔══════════════════════════════════════════════════════════╗
║           wechat-content-pipeline 安装验证                ║
╚══════════════════════════════════════════════════════════╝

✅ Node.js: v18.0.0
✅ npm: 9.0.0
✅ wenyan-cli: 1.0.0
✅ 项目依赖: 已安装
✅ 配置文件: config/config.json 已存在

✅ 所有检查通过!安装成功!

快速开始:
  wechat-pipeline --help

📢 重要更新记录

2026-02-28:深度优化完成 - 全面提升用户体验!⭐⭐⭐(非常重要)

本次更新是全面的深度优化,包含 P0、P1、P2 所有优化!


🎯 P0 优化(必须立即做 - 防止再次踩坑)

  1. 优化检查清单:分成 P0 和 P1 两类
    • P0 检查(必须确认):最重要的3项(红色大号字体)
      • 确认使用了文章/大纲中已有的详细配图描述
      • 确认没有自己随意创建提示词
      • 确认没有添加颜色代码、像素高度等技术约束
    • P1 检查(建议确认):其他项(普通字体)

🚀 P1 优化(应该尽快做 - 提升效率和质量)

  1. 优化图片确认流程:提供两种模式

    • 安全模式(默认):一张一张确认
    • 快速模式:批量生成3张后一起确认
    • 让用户选择模式
  2. 建立按图片类型分类的提示词模板库

    • 封面图模板
    • 对比表/信息图表示模板
    • 流程图/时间线模板
    • 概念对比图模板
    • 资源要素对比图模板
  3. 建立工作流迭代记录机制

    • 明确的迭代流程:发现问题 → 分析原因 → 评估调整 → 实施调整 → 记录效果 → 定期回顾
    • 迭代内容和效果记录
    • 定期回顾机制

🌟 P2 优化(可以稍后做 - 锦上添花)

  1. 建立示例库

    • 提示词示例库
    • 配图示例库(待补充)
    • 工作流示例库(待补充)
  2. 建立定期回顾机制

    • 每次完成文章后的回顾(小回顾)
    • 每周总结(中回顾)
    • 每月大回顾(大回顾)

2026-02-27:发布前检查 + 图片生成规范 + 文字修改联动 ⭐⭐⭐(重要)

本次更新是非常重要的质量和效率优化,避免了今天遇到的问题!

🔧 新增:步骤9:发布前检查环节

工作流从9步改成10步:

  1. 选题确认
  2. 创意点提炼
  3. 证据链整理
  4. 大纲搭建
  5. 写文章初稿
  6. 搜索验证
  7. 生成图片
  8. 插入图片/更新文章
  9. 发布前检查环节(新增!)
  10. 发布(微信公众号)

📋 新增:发布前检查清单(6大检查项)

1. 目标公众号确认(首先检查!)

  • 确认发布到哪个公众号
  • 检查公众号配置

2. 文章内容检查

  • 检查文章开头:是否有不应该发布的内容
  • 检查文章结尾:是否有不应该发布的内容
  • 检查文章中间:是否有内部注释、草稿标记等
  • 检查整体:文章逻辑是否完整

3. 图片检查

  • 检查所有图片引用:是否都正确指向最新生成的图片
  • 检查图片文件:是否都存在于指定目录
  • 检查图片质量:是否清晰,内容是否符合要求
  • 检查图片风格:是否统一,是否符合文章主题
  • 检查图片留白:是否在下方预留空白(如果需要)
  • 检查图片内容:是否有人物头像、不相关元素等

4. 配图描述检查

  • 检查配图描述:是否基于文章内容重新编写
  • 检查提示词:是否简洁明了,没有过度技术约束
  • 检查提示词:是否强调了"不要有人物头像"等关键要求

5. 格式检查

  • 检查Markdown格式:是否正确,标题层级是否清晰
  • 检查图片语法:是否正确使用 ![alt](path) 格式
  • 检查链接:是否都有效,是否有死链
  • 检查特殊字符:是否有乱码、格式错误

6. 元数据检查

  • 检查文章标题:是否清晰,符合主题
  • 检查封面图:是否正确设置
  • 检查摘要:是否有(如果需要)
  • 检查标签:是否设置(如果需要)

7. 最终确认

  • 通读全文:确认没有遗漏
  • 预览效果:在发布前预览一下(如果有预览功能)
  • 人工审核:有人工审核环节(重要!)

🚫 新增:规范12:图片生成必须调用已有的详细文字内容,禁止自己随意发挥!⭐⭐⭐(最重要!)

问题(今天遇到的):

  • ❌ 生成图片时,没有调用文章中已有的图片详细文字内容
  • ❌ 自己随意创建了提示词,导致图片效果差
  • ❌ 浪费了大量时间和资源(图片生成失败、返工)

解决方案:

  • 禁止: 自己随意创建提示词文字
  • 禁止: 不调用已有的详细配图描述
  • 必须: 使用已有的、经过审查的详细配图描述
  • 必须: 如果文章中有配图建议部分,直接用那个作为提示词
  • 必须: 如果是大纲阶段,就用大纲中的配图描述

🔄 新增:规范13:文字修改后必须联动检查并同步修改!⭐⭐⭐(重要!)

问题(今天遇到的):

  • ❌ 文字修改后,没有联动检查哪些环节需要同步修改
  • ❌ 文字修改后,没有同步修改针对图片的位置和详细描述
  • ❌ 导致内容不一致,浪费时间

解决方案:

  • 必须: 从步骤2到步骤9中间,任何一个步骤的文字内容有修改,都要往回去检查哪些环节的内容需要联动修改
  • 必须: 文字修改后,同步修改针对图片的位置
  • 必须: 文字修改后,同步修改针对图片的详细文字描述
  • 必须: 确保所有相关内容保持一致

📋 更新:输出物规范从10个改成13个

新增:

  • 规范11:发布前必须完成检查清单
  • 规范12:图片生成必须调用已有的详细文字内容,禁止自己随意发挥!
  • 规范13:文字修改后必须联动检查并同步修改!

2026-02-26:输出物规范 + 11 个调整 ⭐⭐⭐(重要)

本次更新是非常重要的输出物规范更新,明确了所有输出物的要求!

📋 新增:输出物规范(10个规范)

规范 1:选题推荐过程必须保存

  • 不仅要保存「选题确认」,还要保存「选题推荐过程」
  • 包含:初始推荐、第一轮推荐、用户反馈、第二轮推荐、用户确认、第三轮推荐、最终确认
  • 作为资产沉淀,以便后续复用

规范 2:历史选题推荐过程必须补充保存

  • 所有历史选题的推荐过程都必须补充保存
  • 对应到对应日期及主题
  • 确保不丢失

规范 3:配图建议必须区分封面图和文内图

  • 封面图放在最前面
  • 封面图需要有:风格、画面、尺寸、详细生图提示词
  • 文内图按顺序排列

规范 4:选题建议的结构

  • 我的建议(推荐)放在最前面
  • 然后是支持理由
  • 然后是三个选题(含侧重点、钩子、亮点)

规范 5:每个选题必须有侧重点和钩子

  • 每个选题都有「侧重点」
  • 每个选题都有「钩子」(开头场景)
  • 侧重点和钩子每个选题都不一样

规范 6:不要只发文件路径,要把生成后的内容直接发到聊天界面

  • 文字内容直接发
  • 图片文件直接发(用 message 工具)
  • 每一步完成后,都把结果发到聊天界面

规范 7:发布前先确认发布到哪个公众号

  • 发布前先询问用户
  • 提供清晰的选项
  • 等待用户确认后,再执行发布操作

规范 8:重要更新要记录在 README.md 中

  • 在 README.md 开头添加「重要更新记录」部分
  • 记录每次的重要更新
  • 让用户可以看到本次做了什么重要更新

规范 9:推送完成后必须带上远程项目地址

  • 推送完成后,在推送完成的结论中,必须带上远程项目的 GitHub 地址
  • 格式:**GitHub 仓库:** https://github.com/evcgs/wechat-content-pipeline
  • 放在推送完成结论的最前面,方便用户打开
  • 让用户可以直接点击链接查看线上项目

规范 10:步骤5(写文章初稿)必须发送完整的详细文章内容,不能只发大纲总结 ⭐⭐⭐(最重要!)

  • 步骤5(写文章初稿)完成后,必须把完整的详细文章内容直接发到聊天界面
  • 禁止: 只发送大纲级别的总结(每部分只有1-3句话)
  • 禁止: 把文章拆分成多个部分发送
  • 必须: 发送完整的、详细的文章内容,包含所有段落、所有细节
  • 必须: 文章内容要和文件中的内容完全一致

2026-02-26:启动引导流程 + 5 大优化 ⭐⭐⭐(重要)

本次更新是非常重要的使用说明更新,极大提升了用户体验!

🚀 新增:启动引导流程

当用户说「帮我写一篇公众号文章」时,技能会自动给出引导提示,询问 4 个关键问题:

  1. 📝 文章主题/选题是什么?
  2. 🎯 目标读者是谁?
  3. 📋 文章类型是?(A.深度分析类 / B.行业观察类 / C.产品发布类 / D.案例分享类)
  4. 💡 有什么特别想强调的点吗?(可选)

用户提供信息后,技能会确认并告知完整流程,然后自动开始执行。

还提供了 3 个内置场景模板:

  • 深度分析类
  • 产品发布类
  • 案例分享类

🔧 同时修复了 4 个重要问题:

  1. 图片没有保存在对应目录 - 生成图片后,自动复制到文章所在目录的 images 子文件夹
  2. 每一步都把生成内容发到聊天界面 - 选题、创意点、证据链、大纲、文章、图片...每一步完成后都发送结果
  3. 发送消息时始终包含 target 参数 - 确保消息发送到正确的聊天
  4. 发布前先询问发布到哪个公众号 - 支持多个公众号配置,发布前让用户选择

完整的优化后的工作流:

用户说「帮我写文章」
    ↓
[引导] 给出引导提示,询问 4 个问题
    ↓
用户提供信息
    ↓
[确认] 确认信息,告知流程
    ↓
[执行步骤 1-10,每一步都发送结果]
    ↓
[发布前询问] 发布到哪个公众号?
    ↓
用户确认
    ↓
[发布] 执行发布操作

更多细节见:SKILL.md


📢 重要更新记录(结束)


交流与反馈

使用群

扫码加入使用群,交流问题、分享经验:

使用群二维码

个人微信

有问题也可以直接加我微信:

个人微信二维码


配置

详细配置指南请见:CONFIG.md

包含:

  • wenyan-cli 详细配置
  • 如何获取微信公众号 AppID 和 AppSecret
  • 如何设置 IP 白名单
  • 完整配置示例

文章格式要求

文章必须包含 frontmatter:

---
title: 文章标题(必填)
cover: ./images/cover.png(必填,本地路径或网络URL)
---

# 正文开始

你的内容...

![图片说明](./images/image1.png)

项目结构

wechat-content-pipeline/
├── SKILL.md                # OpenClaw 技能说明
├── README.md               # 本文档
├── CONFIG.md               # 详细配置指南
├── QUICKSTART.md           # MVP 快速开始
├── package.json            # Node.js 配置
│
├── assets/                 # 图片资源
│   ├── group-qrcode.png   # 使用群二维码
│   └── personal-qrcode.png # 个人微信二维码
│
├── bin/                    # 可执行文件
├── src/                    # 源代码
│   ├── config/            # 配置管理
│   ├── search/            # 搜索模块
│   ├── image/             # 图片生成模块
│   ├── publish/           # 发布模块
│   └── pipeline/          # 流水线
├── config/                 # 配置文件
├── content/                # 文章目录(默认)
├── images/                 # 图片目录(默认)
└── examples/               # 示例

致谢与声明

本项目整合了以下优秀的开源工具和服务:

核心依赖

  • wenyan-cli - 微信公众号 Markdown 发布工具

    • 作者:caol64
    • License:Apache License 2.0
    • 用途:核心的微信公众号发布功能
  • SerpAPI - 网络搜索 API

    • 用途:搜索和获取网络信息
  • 火山引擎 Ark Images API - 图片生成 API

    • 用途:生成文章配图

开发框架

说明

  • 本项目是一个流程整合工具,旨在把多个独立工具串联起来,提供统一的使用体验
  • 所有核心功能都依赖上述开源项目和服务
  • 如果你觉得这个项目有用,请也给上述项目点个 Star ⭐

更多文档


License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors