元子公众号图文系列 · 整合版 v2

🦞 yuanzi-wechat-series · v2.1.2 1 装即用 — 4 站流水线 + 知识库 + 全套脚本

一句话

5 个独立 yuanzi-* 技能 → 1 个整合技能。装 1 个 = 装 5 个的功能。

包含（原 5 技能 = 现 1 技能）

注：5 个独立 yuanzi-* 技能已在 clawhub 隐藏。用户升级装本整合版即可。

装后目录结构

yuanzi-wechat-suite/                              <- 装到这里
├── SKILL.md                                      # 本文件（主入口）
├──                                              # 一键调用脚本
│   ├── yuanzi-extract                            # → node scripts/extractor/...
│   ├── yuanzi-image                              # → python scripts/image-gen/...
│   └── yuanzi-publish                            # → python scripts/publisher/...
├── references/                                   # 11 段 + 写作舵
│   ├── 00-quick-reference.md
│   ├── 01-v7-master-4-laws.md
│   ├── 02-v8-prose-8-laws.md
│   ├── 03-tail-structure.md
│   ├── 04-image-publish-iron-laws.md
│   ├── 05-ip-whitelist-pitfalls.md
│   ├── 06-end-to-end-workflow.md
│   ├── 07-prose-word-count.md
│   ├── 08-publish-pitfalls.md
│   ├── 09-case-hugou-xiebian.md
│   ├── 10-clawhub-publish-pitfalls.md
│   └── 写作舵-master v7 散文体铁律.md
├── scripts/
│   ├── extractor/                                # 读稿锚 (Node.js)
│   │   ├── extract.js                            # 主解析器
│   │   ├── errors.js                             # 错误码
│   │   ├── package.json                          # npm 依赖
│   │   └── README.md
│   ├── image-gen/                                # 配图帆 (Python)
│   │   ├── generate.py                           # 主生成器
│   │   ├── serve.py                              # 本地预览服务
│   │   ├── auto_screenshot.py                    # 自动截图
│   │   ├── assets/                               # 3 模板
│   │   ├── output/                               # 3 样例
│   │   └── README.md
│   └── publisher/                                # 发布桨 (Python)
│       ├── publish_wechat.py                     # 主脚本
│       ├── config.json                           # app_id + USE_KEYRING
│       ├── requirements.txt                      # pip 依赖
│       └── assets/                               # 默认封面兜底
├── install-requirements.sh                        # macOS/Linux 一键装依赖
├── install-requirements.ps1                       # Windows 一键装依赖
└── agents/
    └── openai.yaml                                # OpenAI agent 接口

一键安装

# CLI 装（推荐）
clawhub install yuanzi-wechat-suite
# → 自动到 ~/.openclaw/workspace/skills/yuanzi-wechat-suite/

一键装依赖

# macOS / Linux
bash install-requirements.sh

# Windows
powershell -ExecutionPolicy Bypass -File install-requirements.ps1

# 或手动
pip install markdown requests Pillow beautifulsoup4 pyyaml keyring
cd scripts/extractor && npm install

4 站流水线

[读稿锚]  →  [写作舵]  →  [配图帆]  →  [发布桨]
extractor    master       image-gen    publisher
   ↓          ↓            ↓            ↓
解析 URL   散文体 v7     封面/对比     草稿箱
提炼选题   800-3500 字   数据图        老板群发

入口命令（总调度）

# 4 站自检
python scripts/yuanzi.py --check

# 读稿
python scripts/yuanzi.py extract --url "<mp.weixin.qq.com URL>"

# 散文体自动校验
python scripts/yuanzi.py check article.md

# 配图（封面 / 对比 / 数据图）
python scripts/yuanzi.py image cover --title "标题" --output cover.png

# 发布
python scripts/yuanzi.py publish article.html --dry-run

5 yuanzi-* 替代关系

凭据配置（发布前 1 次）

# 推荐用 keyring (Windows Credential Manager)
python -c "import keyring; keyring.set_password('wechat-article-publisher', '<your-app-id>', '<your-app-secret>')"

# 或临时环境变量
export WECHAT_APP_ID=<your-app-id>
export WECHAT_APP_SECRET=<your-app-secret>

快速参考

• 快速参考卡: references/00-quick-reference.md
• v7 铁律: references/01-v7-master-4-laws.md + 02-v8-prose-8-laws.md
• 端到端工作流: references/06-end-to-end-workflow.md

更新日志

v2.1.2 (2026-07-05)

• 🐛 修两个 path bug：(1) scripts/image-gen/generate.py ASSETS_DIR 缺 image-gen/ 层级；(2) scripts/publisher/publish_wechat.py skill_dir 多取一层
• 🔧 修 utf-8 编码（之前双重编码显示乱码）

v2.1.1 (2026-07-05)

• 🔒 隐私修复：掩码 references/ 中的 AppID 与 IP（5 处 114.x.x.x、2 处占位符），config.json 中 AppID 改占位符
• 功能无变化

v2.1.0 (2026-07-05)

• 🆕 scripts/yuanzi.py 总调度（extract/image/publish/check/all/--check/--help）
• 🆕 scripts/master/v7_check.py 散文体自动校验（句长/短句/字数/4 禁句/谁在说话）
• 🔧 修 install-requirements.sh/.ps1 路径

v2.0.0 (2026-07-04)

• 🆕 整合版本（草创）

v1.0.0 (2026-07-04)

• 🆕 元子公众号图文系列首发

🦞 元子公众号图文系列 · 整合版 · MIT-0 协议 · 一键装即用