Yuanzi Wechat Suite

Orchestrates the full WeChat article workflow: extracting, writing, generating images, and publishing for Official Account posts from start to finish.

鍏冨瓙鍏紬鍙峰浘鏂囩郴鍒?路 鏁村悎鐗?v2

馃 yuanzi-wechat-series 路 v2.0.0 *1 瑁呭嵆鐢? 鈥?4 绔欐祦姘寸嚎 + 鐭ヨ瘑搴?+ 鍏ㄨ剼鏈?

涓€鍙ヨ瘽

6 涓嫭绔?yuanzi-* 鎶€鑳?鈫?**1 涓暣鍚堟妧鑳?*銆傝 1 涓?= 瑁?6 涓殑鍔熻兘銆?

鍖呭惈锛堝師 6 鎶€鑳?= 鐜?1 鎶€鑳斤級

绔?	鍘熺嫭绔嬫妧鑳?	鐜版暣鍚堣矾寰?	鑱岃兘
1/4 鍐欎綔鑸?	yuanzi-article-master	references/鍐欎綔鑸?maste v7 鏁ｆ枃浣撻搧寰?md	鏁ｆ枃浣撻搧寰?v7 + 涓夐棶瀹氳皟
2/4 璇荤閿?	yuanzi-article-extractor	scripts/extractor/	mp.weixin.qq.com 瑙ｆ瀽
3/4 閰嶅浘甯?	yuanzi-image-generator	scripts/image-gen/	闆?token 灏侀潰/瀵规瘮/鏁版嵁鍥?
4/4 鍙戝竷妗?	yuanzi-wechat-publisher	scripts/publisher/	Markdown/HTML 鈫?鑽夌绠?
鐭ヨ瘑	yuanzi-wechat-kb	references/00鈥?0*.md	11 娈?Markdown 鐭ヨ瘑搴?

鏃?5 涓嫭绔?yuanzi-* 鎶€鑳藉凡鍦?clawhub 闅愯棌銆傜敤鎴峰崌绾ц鏈暣鍚堢増鍗冲彲銆?

瑁呭悗鐩綍缁撴瀯

text

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 鎺ュ彛

涓€閿畨瑁?

bash

# CLI 瑁咃紙鎺ㄨ崘锛?clawhub install yuanzi-wechat-suite
# 鈫?鑷姩鍒?~/.openclaw/workspace/skills/yuanzi-wechat-suite/

涓€閿渚濊禆

bash

# 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 绔欐祦姘寸嚎

text

[璇荤閿歖  鈫? [鍐欎綔鑸礭  鈫? [閰嶅浘甯哴  鈫? [鍙戝竷妗╙
extractor    master       image-gen    publisher
   鈫?          鈫?           鈫?           鈫?瑙ｆ瀽 URL   鏁ｆ枃浣?v7     灏侀潰/瀵规瘮     鑽夌绠?鎻愮偧閫夐   800-3500 瀛? 鏁版嵁鍥?      鑰佹澘缇ゅ彂

涓€閿皟鐢?

bash

# 璇荤锛氳В鏋?mp.weixin.qq.com 鏂囩珷
./yuanzi-extract --url "https://mp.weixin.qq.com/s/xxx"

# 閰嶅浘锛氬皝闈?瀵规瘮/鏁版嵁鍥?./yuanzi-image cover --title "鎴戠殑鏍囬" --output cover.png
./yuanzi-image compare --left "鍓? --right "鍚? --output cmp.png
./yuanzi-image chart --data "X:80,50|Y:30,20" --labels "鍓?鍚? --output chart.png

# 鍙戝竷锛歁arkdown/HTML 鍏ヨ崏绋跨
./yuanzi-publish article.html \
  --cover-image imgs/cover.png \
  --author "鑰佹澘" \
  --title "鎴戠殑鏂囩珷"

# 楠岃瘉渚濊禆
./yuanzi-extract --check
./yuanzi-image --check
./yuanzi-publish --check

绔埌绔ず渚?

bash

# 鍋囪鑰佹澘浠わ細鍐欎竴绡囥€婁簰鏋勮皭鍙樸€嬮鏍兼枃绔?
# Step 1: 璇荤锛堣В鏋?3 绡囧弬鑰冿級
./yuanzi-extract --url "https://mp.weixin.qq.com/s/abc" > ref1.json
./yuanzi-extract --url "https://mp.weixin.qq.com/s/def" > ref2.json

# Step 2: 鍐欎綔锛堣鏁ｆ枃浣撻搧寰?鈫?鍐欒崏绋匡級
cat references/鍐欎綔鑸?master\ v7\ 鏁ｆ枃浣撻搧寰?md
cat references/01-v7-master-4-laws.md
cat references/02-v8-prose-8-laws.md
# 鈫?杈撳嚭 draft.md锛?00-3500 瀛?+ 4 娈靛熬缁撴瀯锛?
# Step 3: 閰嶅浘
./yuanzi-image cover --title "浜掓瀯璋愬彉涔?X" --output imgs/cover.png
./yuanzi-image compare --left "鍛樺伐鍊熷钩鍙? --right "浼佷笟鍊熷憳宸? --output imgs/cmp.png
./yuanzi-image chart --data "2021:100,0|2024:60,40" --labels "鍛樺伐鍗犳瘮,浼佷笟鍗犳瘮" --output imgs/chart.png
# ... 鍏?5 寮犲浘 + 1 寮犲皝闈紙灏侀潰鐢?PIL resize 鍒?900脳383锛?
# Step 4: 鍙戝竷
./yuanzi-publish draft.html \
  --cover-image imgs/cover.png \
  --author "鑰佹澘" \
  --title "浜掓瀯璋愬彉涔?X"
# 鈫?鑽夌 ID
# 鈫?鑰佹澘鍘诲井淇″叕浼楀钩鍙板悗鍙版墜鍔ㄧ兢鍙戯紙璁㈤槄鍙锋棤 freepublish API 鏉冮檺锛?```

## 鍏抽敭閾佸緥锛堥€熸煡锛?
璇﹁ `references/00-quick-reference.md`锛堜竴椤甸€熸煡鍗★級

| # | 閾佸緥 | 鍑哄 |
|---|---|---|
| 1 | 浜嬪疄鍙€冩嵁 | `01-v7-master-4-laws.md` |
| 2 | 璋佸湪璇磋瘽锛堣€佹澘缃插悕锛?| `01-v7-master-4-laws.md` |
| 3 | 鍏ユ垙涓嶅璇?| `01-v7-master-4-laws.md` |
| 4 | 琛屾枃鑺傚锛堝満鏅啋鏍瑰洜鈫掔悊璁衡啋鎬濊€冣啋娲炶锛?| `01-v7-master-4-laws.md` |
| 5 | 鍙ラ暱 35-50 瀛?/ 鐭彞<20% | `02-v8-prose-8-laws.md` |
| 6 | 瀛楁暟 800-3,500锛堣€佹澘鍙疯皟鎬э級 | `07-prose-word-count.md` |
| 7 | 鍏抽敭璇嶅瘑搴?> 50/涓囧瓧 | `02-v8-prose-8-laws.md` |
| 8 | 閰嶅浘鐢?*鐩稿璺緞**锛堥潪 base64锛?| `04-image-publish-iron-laws.md` |
| 9 | 灏侀潰 21:9 (900脳383) 鈥?鍚﹀垯 53401 | `04-image-publish-iron-laws.md` |

## 4 绫荤鍙ュ紑澶?鉂?
- 銆屼袱涓暟瀛楁憜鍦ㄤ竴璧凤紝鍙嶅樊寰堝ぇ鈥斺€斻€?- 銆屽緢澶氫汉 X锛屼絾 Y銆?- 銆屽厛鐪嬪嚑涓暟瀛?/ 鍏堣鍑犱釜鏁版嵁銆?- 銆岃皥鍒?X锛屼笉寰椾笉鎻?Y銆?
## 閿欒鐮侀€熸煡

璇﹁ `references/08-publish-pitfalls.md` + `references/05-ip-whitelist-pitfalls.md`

| 閿欒鐮?| 鍚箟 | 瑙ｅ喅 |
|---|---|---|
| 40001 | access_token 鏃犳晥 | 寮哄埗鍒锋柊 |
| 40002 | 棰戠巼瓒呴檺 | 3 娆￠噸璇?+ 5s 寤惰繜 |
| 40007 | thumb_media_id 鏃犳晥 | 姘镐箙绱犳潗鎺ュ彛 |
| 40164 | IP 涓嶅湪鐧藉悕鍗?| 鑰佹澘鎵嬪姩鍔犵櫧 |
| 48001 | 鏃犲彂甯冩潈闄?| 寰俊鍚庡彴鎵嬪姩缇ゅ彂 |
| 53401 | 灏侀潰灏哄涓嶅悎瑙?| 鑷姩 resize 鍒?900脳383 |

## IP 鐧藉悕鍗曟祦绋嬶紙鍙戝竷鍓嶅繀鍋氾級

璇﹁ `references/05-ip-whitelist-pitfalls.md`

```bash
# 1. 鏌ュ綋鍓?IP
curl ifconfig.me

# 2. 璁╄€佹澘鍔犵櫧锛堝井淇″叕浼楀钩鍙?鈫?璁剧疆 鈫?鍩烘湰閰嶇疆 鈫?IP 鐧藉悕鍗曪級

# 3. 閲嶈窇鍙戝竷锛堝厛 --dry-run 楠岃瘉锛?./yuanzi-publish article.html --dry-run
./yuanzi-publish article.html --cover-image imgs/cover.png --author "鑰佹澘" --title "..."

4 娈靛熬缁撴瀯锛堟瘡绡囧浘鏂囨湯灏惧浐瀹氾級

璇﹁ references/03-tail-structure.md

1. 鍐欑粰鑷繁璇寸殑璇?2. 3 鏉″缓璁?3. 鍗囧崕娲炶
2. 鑰佹澘鎺ㄨ崘
3. 缂栬€呮寜
4. 鍏抽敭璇嶆爣绛?7. 鍙傝€冨嚭澶?8. 搴曢儴灏忓瓧

宸ヤ綔娴佽缁嗘楠?

璇﹁ references/06-end-to-end-workflow.md

鑷磋阿

鏁村悎鑷厓瀛愮郴鍒楀師 6 涓嫭绔?yuanzi-* 鎶€鑳斤紱3 涓?fork 鑷笂娓稿師浣滆€咃細

• wechat-article-publisher v1.0.0 鈥?Owner zhenglong2015
• wechat-image-generator v1.0.2 鈥?Owner jingyu525
• wechat-article-extractor v1.0.0 鈥?Owner chunhualiao / freestylefly

鐗堟湰

鏁村悎鐗?	鐗堟湰	鍙戝竷鏃?	slug
yuanzi-wechat-suite	2.0.0	2026-07-04	yuanzi-wechat-suite

鏃?5 涓嫭绔?yuanzi-* 鎶€鑳藉凡鍦?clawhub 闅愯棌锛坴1.x锛夛細

• yuanzi-article-master@1.0.0
• yuanzi-article-extractor@1.0.1
• yuanzi-image-generator@1.0.3
• yuanzi-wechat-publisher@2.1.0
• yuanzi-wechat-kb@1.0.0

---

*馃 鍏冨瓙鍏紬鍙峰浘鏂囩郴鍒?路 鏁村悎鐗?v2.0.0 路 2026-07-04 路 1 瑁呭嵆鐢?