微信公众号虾发布工作流

微信公众号运营完整工作台。从选题到发布的全流程自动化工具包。

核心能力

整合 khazix-writer

khazix-writer（卡兹克风格写作skill）是内容创作的核心引擎，wechat-workflow 负责发布和分发。

完整工作流：

用户给选题/素材
    ↓
khazix-writer 生成文章（四层自检通过）
    ↓
添加 frontmatter（title + cover）
    ↓
wechat-workflow 发布到草稿箱
    ↓
搜狗验证收录
    ↓
monitor.py 追踪数据

khazix-writer 安装： git clone https://github.com/KKKKhazix/khazix-skills 到 skills 目录

触发词： 写文章、写稿子、帮我写、续写、扩写、公众号文章、长文、出稿、按我的风格写

依赖声明

• Node.js / npm：必须。用于运行 @wenyan-md/cli
• wenyan：必须。若未安装，脚本会自动执行 npm install -g @wenyan-md/cli
• Python 3：必须。运行所有管理脚本
• image_generate 工具：推荐。用于生成封面图（由 OpenClaw 内置提供，无需安装）

> ⚠️ 自动安装说明：首次运行发布脚本时，若检测到 wenyan 命令不存在，会自动从 npm registry 下载并全局安装 @wenyan-md/cli。这需要网络连接和写入系统 npm 目录的权限。

运行时文件写入

外部网络调用

快速开始

一句话完成全流程：

> 「帮我写一篇关于 XX 的公众号文章并发布」

→ AI 自动完成：生成封面 + 写稿（去AI味） + 发布草稿箱 + 搜狗验证 + 加入追踪

手动分步操作：

1. 生成封面图（用 image_generate 工具）
2. 写文章（参考下方写作规范）
3. 发布：python -X utf8 scripts/publish_and_verify.py <文章.md>
4. 追踪：python -X utf8 scripts/monitor.py add "标题"
5. 查看状态：python -X utf8 scripts/monitor.py status

凭证配置

方式 1：secrets.json（推荐）

python scripts/add.py wechat "微信公众号" appid=YOUR_APPID appsecret=YOUR_APPSECRET

方式 2：TOOLS.md

## WeChat Official Account

export WECHAT_APP_ID=your_app_id
export WECHAT_APP_SECRET=your_app_secret

> 优先从 secrets.json 读取，若不存在则 fallback 到 TOOLS.md。

IP 白名单：运行前需将本机公网 IP（curl ifconfig.me 查询）添加到微信公众号后台 → 开发 → 基本配置 → IP 白名单。

写作规范

参考 references/ 目录：

• 爆款方法论.md — 标题创作五种类型 + 结构原则
• 写作技巧.md — 四大内容结构 + 开头结尾写法
• 去AI味指南.md — 卡兹克风格核心规则 + 四层自检体系（推荐优先使用 khazix-writer skill）

脚本说明

publish_and_verify.py — 发布 + 验证

python -X utf8 scripts/publish_and_verify.py <文章.md> [主题] [高亮]

frontmatter 格式（必填）：

---
title: 文章标题
cover: ./assets/cover.jpg
---

search_article.py — 独立搜索

python -X utf8 scripts/search_article.py "文章标题"

monitor.py — 追踪 + 建议

python -X utf8 scripts/monitor.py add "标题"         # 添加追踪
python -X utf8 scripts/monitor.py check "标题"         # 检查收录
python -X utf8 scripts/monitor.py status               # 列表
python -X utf8 scripts/monitor.py recommend           # 选题建议

add.py / get.py / remove.py / list.py — 凭证管理

# 添加凭证
python -X utf8 scripts/add.py wechat "微信公众号" appid=YOUR_APPID appsecret=YOUR_APPSECRET

# 获取凭证（完整值，仅本地）
python -X utf8 scripts/get.py wechat appid

# 列举所有凭证（脱敏）
python -X utf8 scripts/list.py

# 删除凭证
python -X utf8 scripts/remove.py wechat

故障排查

文件结构

wechat-workflow/
├── _meta.json
├── SKILL.md
├── scripts/
│   ├── publish_and_verify.py   # 发布 + 搜狗验证
│   ├── search_article.py      # 独立搜索
│   ├── monitor.py             # 数据追踪 + 选题建议
│   ├── add.py                 # 添加凭证
│   ├── get.py                  # 获取凭证（完整值）
│   ├── remove.py               # 删除凭证
│   └── list.py                 # 列举凭证（脱敏）
└── references/
    ├── 爆款方法论.md
    ├── 写作技巧.md
    └── 去AI味指南.md

技能整合说明

已废弃

~~wechat-publisher~~ — 功能已合并到 wechat-workflow，安装了请卸载。

公众号内容全家桶

khazix-writer（写作风格 + 四层自检）
    ↓
wechat-workflow（封面 + 发布 + 验证 + 追踪）

其他公众号技能定位

• xiawei：飞书文档 → 公众号，可与 wechat-workflow 共存
• gongzhonghaoxieshou：传播学驱动多平台（公众号/小红书/知乎）
• khazix-writer：卡兹克风格深度长文

两个公众号写作技能定位不同，可按需选用。