Skip to content

ZJU-REAL/Easel / skills/builtin/skill-wechat-publisher

skill-wechat-publisher

Verified

微信公众号文章自动创作与发布工具。给定参考文章、文字或文档,自动搜索整理全网相关信息、生成图文并茂的公众号文章,并发布到微信公众号草稿箱。特别强调反 AI 检测写作。 触发场景(沾边就用):用户提到"公众号 / 微信文章 / 推文 / 公号 / 发文 / mp / 草稿箱 / 群发",或要求把话题/文档/笔记写成公众号文章并发布到微信。

FileKindSize
EASEL-META.mdmarkdown2.6 KB
SKILL.mdskill md11.4 KB
assets/image-styles/README.mdmarkdown29.5 KB
assets/image-styles/blue.jsonconfig3.0 KB
assets/image-styles/data-chart.jsonconfig2.4 KB
assets/image-styles/flat-editorial.jsonconfig4.9 KB
assets/image-styles/hand-drawn-blue.jsonconfig2.3 KB
assets/image-styles/illustrated-warm.jsonconfig3.3 KB
assets/image-styles/infographic-blue.jsonconfig5.2 KB
assets/image-styles/infographic-dark.jsonconfig5.4 KB
assets/image-styles/infographic-mint.jsonconfig5.2 KB
assets/image-styles/infographic-warm.jsonconfig5.4 KB
assets/image-styles/knowledge-card.jsonconfig2.3 KB
assets/image-styles/magazine-editorial.jsonconfig2.3 KB
assets/image-styles/marker-coral.jsonconfig6.4 KB
assets/image-styles/marker-lime.jsonconfig6.6 KB
assets/image-styles/marker-pink.jsonconfig6.4 KB
assets/image-styles/marker-sky.jsonconfig6.4 KB
assets/image-styles/marker-violet.jsonconfig6.4 KB
assets/image-styles/meme-illustration.jsonconfig2.3 KB
assets/image-styles/mint.jsonconfig3.1 KB
assets/image-styles/morandi.jsonconfig3.4 KB
assets/image-styles/previews/blue.webpbinary104.0 KB
assets/image-styles/previews/data-chart.webpbinary16.4 KB
assets/image-styles/previews/flat-editorial.webpbinary109.7 KB
assets/image-styles/previews/hand-drawn-blue.webpbinary17.9 KB
assets/image-styles/previews/illustrated-warm.webpbinary31.2 KB
assets/image-styles/previews/infographic-blue.webpbinary160.4 KB
assets/image-styles/previews/infographic-dark.webpbinary142.1 KB
assets/image-styles/previews/infographic-mint.webpbinary150.2 KB
assets/image-styles/previews/infographic-warm.webpbinary162.5 KB
assets/image-styles/previews/knowledge-card.webpbinary22.4 KB
assets/image-styles/previews/magazine-editorial.webpbinary14.0 KB
assets/image-styles/previews/marker-coral.webpbinary41.2 KB
assets/image-styles/previews/marker-lime-template.webpbinary34.3 KB
assets/image-styles/previews/marker-lime.webpbinary39.3 KB
assets/image-styles/previews/marker-pink.webpbinary37.5 KB
assets/image-styles/previews/marker-sky.webpbinary47.9 KB
assets/image-styles/previews/marker-violet.webpbinary42.8 KB
assets/image-styles/previews/meme-illustration.webpbinary35.5 KB
assets/image-styles/previews/mint.webpbinary95.7 KB
assets/image-styles/previews/morandi.webpbinary82.0 KB
assets/image-styles/previews/slice-of-life.webpbinary46.3 KB
assets/image-styles/previews/warm-handdrawn.webpbinary79.0 KB
assets/image-styles/previews/xiaohongshu-colorful.webpbinary24.3 KB
assets/image-styles/slice-of-life.jsonconfig4.9 KB
assets/image-styles/warm-handdrawn.jsonconfig4.4 KB
assets/image-styles/xiaohongshu-colorful.jsonconfig2.3 KB
assets/theme-previews/README.mdmarkdown1.7 KB
assets/theme-previews/academic-paper.htmlother13.5 KB
assets/theme-previews/business-navy.htmlother13.6 KB
assets/theme-previews/elegant-ink.htmlother13.0 KB
assets/theme-previews/girly-pink.htmlother13.2 KB
assets/theme-previews/index.htmlother26.6 KB
assets/theme-previews/ink-wash.htmlother13.5 KB
assets/theme-previews/magazine-grid.htmlother13.0 KB
assets/theme-previews/minimal-bw.htmlother13.6 KB
assets/theme-previews/minimal-mono.htmlother12.7 KB
assets/theme-previews/mint-fresh.htmlother14.0 KB
assets/theme-previews/news-bold.htmlother13.3 KB
assets/theme-previews/refined-blue.htmlother15.1 KB
assets/theme-previews/sage-premium.htmlother13.6 KB
assets/theme-previews/sample.mdmarkdown2.6 KB
assets/theme-previews/screenshots/ink-wash.webpbinary27.8 KB
assets/theme-previews/screenshots/minimal-mono.webpbinary34.8 KB
assets/theme-previews/screenshots/news-bold.webpbinary32.5 KB
assets/theme-previews/screenshots/refined-blue.webpbinary34.3 KB
assets/theme-previews/screenshots/theme-overview.webpbinary229.8 KB
assets/theme-previews/sunset-coral.htmlother14.8 KB
assets/theme-previews/warm-editorial.htmlother12.8 KB
assets/theme-previews/warm-orange.htmlother12.3 KB
assets/themes/academic-paper.jsonconfig5.2 KB
assets/themes/business-navy.jsonconfig5.2 KB
assets/themes/elegant-ink.jsonconfig5.1 KB
assets/themes/girly-pink.jsonconfig5.3 KB
assets/themes/ink-wash.jsonconfig5.1 KB
assets/themes/magazine-grid.jsonconfig5.1 KB
assets/themes/minimal-bw.jsonconfig5.2 KB
assets/themes/minimal-mono.jsonconfig5.0 KB
assets/themes/mint-fresh.jsonconfig5.3 KB
assets/themes/news-bold.jsonconfig5.1 KB
assets/themes/refined-blue.jsonconfig5.6 KB
assets/themes/sage-premium.jsonconfig5.3 KB
assets/themes/sunset-coral.jsonconfig5.5 KB
assets/themes/warm-editorial.jsonconfig4.9 KB
assets/themes/warm-orange.jsonconfig5.0 KB
assets/typeset-card/template.htmlother3.5 KB
brief.md.exampleother2.3 KB
references/anti-ai-checklist.mdmarkdown3.4 KB
references/api_reference.mdmarkdown3.2 KB
references/article-structures.mdmarkdown3.2 KB
references/errors.mdmarkdown1.1 KB
references/image-styles-guide.mdmarkdown3.5 KB
references/inline-markup.mdmarkdown1.7 KB
references/multi-platform-sync.mdmarkdown2.6 KB
references/newspic-mode.mdmarkdown5.7 KB
references/themes.mdmarkdown1.8 KB
references/typeset-card.mdmarkdown4.3 KB
scripts/ai_score.pyexecutablescript15.2 KB
scripts/api.pyexecutablescript13.3 KB
scripts/baoyu_image_gen.tsexecutablescript5.5 KB
scripts/baoyu_image_gen_core.tsscript11.5 KB
scripts/config.pyexecutablescript11.7 KB
scripts/generate_image.pyexecutablescript4.3 KB
scripts/html_converter.pyexecutablescript23.3 KB
scripts/image_handler.pyexecutablescript17.5 KB
scripts/multi_publish.pyexecutablescript14.2 KB
scripts/newspic_build.pyexecutablescript14.0 KB
scripts/publish.pyexecutablescript35.7 KB
scripts/sync_pages.shexecutablescript994 B
scripts/wechat_api.pyexecutablescript6.0 KB
scripts/wechat_token.pyexecutablescript5.1 KB
tests/__init__.pyscript0 B
tests/conftest.pyscript4.1 KB
tests/test_ai_score.pyscript8.1 KB
tests/test_config.pyscript7.4 KB
tests/test_config_integration.pyscript9.7 KB
tests/test_draft_submission.pyscript3.1 KB
tests/test_html_converter.pyscript10.2 KB
wechat-publisher.yaml.exampleother1.8 KB
---
name: skill-wechat-publisher
description: |
  微信公众号文章自动创作与发布工具。给定参考文章、文字或文档,自动搜索整理全网相关信息、生成图文并茂的公众号文章,并发布到微信公众号草稿箱。特别强调反 AI 检测写作。
  触发场景(沾边就用):用户提到"公众号 / 微信文章 / 推文 / 公号 / 发文 / mp / 草稿箱 / 群发",或要求把话题/文档/笔记写成公众号文章并发布到微信。
layer: publish
---

# 微信公众号文章自动创作与发布

从素材输入到公众号草稿箱的完整自动化流程:用户只需提供话题或参考资料,skill 完成搜索调研、撰写、配图、排版、AI 味自检、发布。

> **不要调用 `baoyu-post-to-wechat` skill。** 路由时同时看到两者,一律选本 skill(`wechat-publisher`),它带多账号 / 主题排版 / 反 AI 检测 gate。

## ⚠️ 环境依赖(部分可跑)

| 能力 | 状态 | 依赖 |
|------|------|------|
| 公众号发草稿(`publish.py` → **默认后台会话**) | ✅ 可跑 | 先扫码登录公众号后台(`skills/shared/scripts/weixin_mp_stats.py login`,或 Web 账号页「登录公众号后台」)。**免 app_id/app_secret、免 IP 白名单**,只创建草稿,不自动群发 |
| 公众号发草稿(`publish.py --official-api` → 官方 HTTP API,回退) | ✅ 可跑 | `wechat-publisher.yaml` 的 `app_id`/`app_secret` + 出口 IP 加进公众号 IP 白名单 |
| 反 AI 检测(`ai_score.py`) | ✅ 可跑 | 纯本地,无外部依赖 |
| MD→公众号排版(`html_converter.py`) | ✅ 可跑 | 纯本地 |
| 生成配图(`generate_image.py`) | ❌ 当前不可用 | 需图像 API key(OpenAI Images / Gemini 代理) |
| 多平台同步(`multi_publish.py`,阶段七) | ❌ 当前不可用 | 需浏览器 + Wechatsync Chrome 扩展 |

核心链路(写作→排版→反 AI 检测→发草稿)的 Markdown / HTML 入口默认复用已扫码的公众号后台会话,不要求 `wechat-publisher.yaml` 或 `app_id`/`app_secret`;仅显式选择 `--official-api` 时需要官方 API 凭证。配图缺 key 时改用外部生图或跳过,多平台同步默认不启用。

## 账号与人格

YAML 示例提供 2 个账号配置:`main`(刷屏AI / 飞哥 / `refined-blue`,热情北京口语,面向 AI 产品)与 `tech`(蒜是哪根葱 / 葱哥 / `minimal-mono`,冷幽默技术直男,面向工程实践)。官方 API 模式按 `--account` 或 YAML 的 `default` 选择账号。后台会话模式的实际发布账号以当前扫码登录的公众号为准,`--account` 不会切换浏览器登录态;没有 YAML 时,可用 `--author` / `--theme` 指定署名和主题,并优先使用当前 Easel Profile 的语气。

**必须按当前账号的 voice 改写语气** —— 两个号写出明显风格差异,这本身就是反 AI 检测的关键(平台对每个号建历史文风基线)。

## 前置条件

以下命令均从 Easel 项目根目录运行。

### 默认:公众号后台会话(Markdown / HTML)

先检查已有登录态,不要因缺少 YAML 或官方 API 凭证而停止发布:

```bash
python3 skills/shared/scripts/weixin_mp_stats.py whoami
# 仅在确认未登录或会话过期时执行,也可在 Web 账号页扫码登录
python3 skills/shared/scripts/weixin_mp_stats.py login
```

`loggedIn: true` 时继续使用默认的 `publish.py --input` / `--html` 流程;检查报错时先排查具体异常,不把网络或浏览器错误当成缺少 API 凭证。会话模式无需创建 `wechat-publisher.yaml`、调用 `wechat_api.py` 验证 token 或配置 IP 白名单。

### 可选回退:官方 API(`--official-api`)

只有显式选择官方 API 发布时,才执行以下凭证配置与连接检查:

```bash
cp skills/builtin/skill-wechat-publisher/wechat-publisher.yaml.example skills/builtin/skill-wechat-publisher/wechat-publisher.yaml
# 编辑该文件,填写 app_id / app_secret / author / theme,并在公众号后台配置出口 IP 白名单
python3 skills/builtin/skill-wechat-publisher/scripts/wechat_api.py list-accounts
# 验证 API 连接,仅输出状态,不输出 token
(cd skills/builtin/skill-wechat-publisher/scripts && python3 -c "from wechat_api import get_access_token; get_access_token(); print('OK')")
```

官方 API 配置文件固定放 skill 根目录(`config.py::_find_unified_yaml()` 只查此处),所选账号必须有 `app_id` 和 `app_secret`。API 参数细节见 [references/api_reference.md](references/api_reference.md),错误码见 [references/errors.md](references/errors.md)。这些要求不适用于默认的后台会话发布。

## 完整工作流程(7 阶段,第 7 为可选 opt-in)

### 阶段一:理解需求与收集素材
搞清用户要什么,同时采集**真人味原料**(具体人名/时间/金额/产品版本/踩过的坑 —— 反 AI 检测最重要原料)。识别目标账号(AI 产品→main,工程→tech),选定 `article_structure` + `opening_hook`。产出 `outputs/主题名/brief.md`。

### 阶段二:全网信息搜索与整理
既搜**权威层**(WebSearch:资讯/数据/案例/官方报告),也搜**真人层**(Reddit/HN/V2EX/即刻/X/小红书的原话作语料)。关键数据多源交叉。产出 `research.md`,每条标来源、分层。

### 阶段三:撰写骨架稿(第一轮)
按结构写初稿,**允许有 AI 味**(下一阶段专门人味化)。`article_structure` 8 种、`opening_hook` 7 种的完整选择规则与写法见 [references/article-structures.md](references/article-structures.md)。骨架稿阶段就主动**混用行内标色**(见 [references/inline-markup.md](references/inline-markup.md))。避免"首先/其次""值得一提的是""随着…的发展"等 AI 套话。

### 阶段 3.5:人味化改写 pass(反 AI 检测核心)
独立 pass,不与阶段三混。对骨架稿逐段过 **9 条强制清单**(Burstiness / 句式多样性 / AI 高频词黑名单 / 开头破冰 / 人称立场 / 事实密度 / 标点多样性 / 结构不完美 / 按账号 voice 过滤)。每条阈值、完整禁用词表、改写示例**必须逐条对照** [references/anti-ai-checklist.md](references/anti-ai-checklist.md)。

### 阶段四:生成配图(当前环境需外部 key)
默认风格 `hand-drawn-blue`;有具体数字/对比→用 `infographic-*`,金句大字→用 `marker-*`;图内需一字不差的文字→改走**排版卡 typeset-card**(HTML/CSS → 无头 Chrome 2× 截图)。风格选择、共享视觉原则见 [references/image-styles-guide.md](references/image-styles-guide.md);排版卡设计系统见 [references/typeset-card.md](references/typeset-card.md)。一篇 6-10 张,统一一种风格。生图入口 `scripts/generate_image.py`(需图像 API key),上传用 `scripts/image_handler.py upload`。

### 阶段五:格式转换与排版
```bash
python3 skills/builtin/skill-wechat-publisher/scripts/html_converter.py article.md --theme refined-blue -o article.html
python3 skills/builtin/skill-wechat-publisher/scripts/html_converter.py article.md --list-themes
```
主题一般由 `publish.py --account` 自动从 yaml 读。15 套主题的推荐表与视觉简介见 [references/themes.md](references/themes.md),行内标色系统见 [references/inline-markup.md](references/inline-markup.md)。主题预览:`assets/theme-previews/index.html`。

### 阶段 5.5:AI 味自检 gate(publish.py 内置强制拦截)
`publish.py` 发草稿前自动调 `ai_score.check_ai_score()`,分数 ≥ 阈值(默认 45)直接拦住。阈值:<35 🟢PASS / 35-45 🟡WARN / ≥45 🔴FAIL。手动看细节报告:
```bash
python3 skills/builtin/skill-wechat-publisher/scripts/ai_score.py outputs/主题名/article.md --threshold 45
```
命中时按脚本列出的 AI 套话/高频词逐句**重写整个句式**(不只换词),重跑到通过。可选双保险:朱雀 / GPTZero 第三方检测。

### 阶段六:发布到草稿箱(默认走后台会话,不自动群发)
```bash
python3 skills/builtin/skill-wechat-publisher/scripts/publish.py --account main \
  --input outputs/主题名/article.md \
  --cover .../cover.jpg --title "标题" --digest "120 字以内摘要" --exec
```
**默认走公众号后台会话发布**(免 app_secret、免 IP 白名单)——前提是已扫码登录后台
(`skills/shared/scripts/weixin_mp_stats.py login`,或 Web 账号页「登录公众号后台」);封面与正文内嵌图会自动传 mp CDN。
若后台未登录会报错提示先登录。加 `--official-api` 可回退到官方 HTTP API(需 app_secret + IP 白名单)。
先省略 `--exec` 预览账号、模式和输入;dry-run 只打印参数,不验证登录态、上传或建草稿,不能据此宣称发布成功。向用户展示标题/摘要并取得确认后再执行。成功后调用 `skill-publish-log` 记录草稿;再告知用户登录 mp.weixin.qq.com 查看/群发。

### 阶段七:多平台同步(可选,默认不启用,当前环境不可用)
一键同步到知乎/掘金/CSDN/头条(均存草稿)。基于 Wechatsync Chrome 扩展 + `@wechatsync/cli`,需浏览器。触发方式与失败处理见 [references/multi-platform-sync.md](references/multi-platform-sync.md)。

## 贴图模式(newspic,与文章模式并列)
对标公众号"图片消息":5-10 张卡片墙 + 100-300 字短描述。4 步:`brief.md → newspic_build.py 拆卡 → generate_image.py 批量生图 → publish.py --type newspic`。短文本过精简版 AI 味 gate(`ai_score.py --mode newspic`)。字段说明、判据、限制见 [references/newspic-mode.md](references/newspic-mode.md)。

## 文件组织约定
所有产物放项目内 `outputs/主题名/`:最终稿和封面在目录顶层,研究稿、调试 HTML、配图等中间文件放 `assets/`。不要把临时产物写到 Skill 根目录。

## 脚本说明

| 脚本 | 用途 |
|---|---|
| `publish.py` | 完整发布(一键,含 AI 味 gate),支持 `--type news\|newspic` |
| `generate_image.py` | 统一生图入口(需图像 API key) |
| `newspic_build.py` | 贴图拆卡器(brief.md → card_plan.json) |
| `wechat_api.py` | facade —— 重导出下述模块 + CLI |
| `config.py` | (内部)yaml + 配图风格加载 / `set_account` / `get_config` |
| `wechat_token.py` | (内部)`get_access_token`,本地缓存 |
| `api.py` | (内部)图片上传 / 草稿 / 发布 |
| `html_converter.py` | Markdown → 微信 HTML(多主题 + 行内标色) |
| `image_handler.py` | 图片下载 / 上传 / 替换 |
| `ai_score.py` | 反 AI 检测自检(`--mode news\|newspic`) |
| `multi_publish.py` | 多平台同步(阶段七,默认不启用,需浏览器) |

## Profile 感知
有 Easel Profile 时,用 Profile 的账号定位/受众/语气凝练覆盖账号 voice;无 Profile 时退到 yaml 内置 `main`/`tech` 双账号 voice。

## 注意事项
- 文章始终发**草稿箱**,不自动群发;后台会话发布到当前扫码账号,官方 API 模式才用 `--account` 选择发布账号。
- 默认 dry-run;没有用户对当前标题、摘要、账号和素材的明确确认,不得添加 `--exec`。
- Markdown、HTML 与贴图三条入口都会在上传前扫描密钥、内部地址和路径,命中时必须改稿,不得绕过。
- 两账号 voice/theme 差异是反 AI 检测策略的一部分,不要趋同。
- 错误码(40164 IP 白名单 / 40001 token / 48001 未授权等)见 [references/errors.md](references/errors.md)。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall