1# Image-Text Posting (贴图发表, formerly 图文)
2 
3Post image-text messages with multiple images to WeChat Official Account.
4 
5> **Note**: WeChat has renamed "图文" to "贴图" in the Official Account menu (as of 2026).
6 
7## Usage
8 
9```bash
10# Post with images and markdown file (title/content extracted automatically)
11${BUN_X} ./scripts/wechat-browser.ts --markdown source.md --images ./images/
12 
13# Post with explicit title and content
14${BUN_X} ./scripts/wechat-browser.ts --title "标题" --content "内容" --image img1.png --image img2.png
15 
16# Save as draft
17${BUN_X} ./scripts/wechat-browser.ts --markdown source.md --images ./images/ --submit
18```
19 
20## Parameters
21 
22| Parameter | Description |
23|-----------|-------------|
24| `--markdown <path>` | Markdown file for title/content extraction |
25| `--images <dir>` | Directory containing images (sorted by name) |
26| `--title <text>` | Article title (max 20 chars, auto-compressed if too long) |
27| `--content <text>` | Article content (max 1000 chars, auto-compressed if too long) |
28| `--image <path>` | Single image file (can be repeated) |
29| `--submit` | Save as draft (default: preview only) |
30| `--profile <dir>` | Chrome profile directory |
31 
32## Auto Title/Content from Markdown
33 
34When using `--markdown`, the script:
35 
361. **Parses frontmatter** for title and author:
37   ```yaml
38   ---
39   title: 文章标题
40   author: 作者名
41   ---
42   ```
43 
442. **Falls back to H1** if no frontmatter title:
45   ```markdown
46   # 这将成为标题
47   ```
48 
493. **Compresses title** to 20 characters if too long:
50   - Original: "如何在一天内彻底重塑你的人生"
51   - Compressed: "一天彻底重塑你的人生"
52 
534. **Extracts first paragraphs** as content (max 1000 chars)
54 
55## Image Directory Mode
56 
57When using `--images <dir>`:
58 
59- All PNG/JPG files in directory are uploaded
60- Files are sorted alphabetically by name
61- Naming convention: `01-cover.png`, `02-content.png`, etc.
62 
63## Constraints
64 
65| Field | Max Length | Notes |
66|-------|------------|-------|
67| Title | 20 chars | Auto-compressed if longer |
68| Content | 1000 chars | Auto-compressed if longer |
69| Images | 9 max | WeChat limit |
70 
71## Example Session
72 
73```
74User: /post-to-wechat --markdown ./article.md --images ./xhs-images/
75 
76Claude:
771. Parses markdown meta:
78   - Title: "如何在一天内彻底重塑你的人生" → "一天内重塑你的人生"
79   - Author: from frontmatter or default
802. Extracts content from first paragraphs
813. Finds 7 images in xhs-images/
824. Opens Chrome, navigates to WeChat "图文" editor
835. Uploads all images
846. Fills title and content
857. Reports: "Image-text posted with 7 images."
86```
87 
88## Scripts
89 
90| Script | Purpose |
91|--------|---------|
92| `wechat-browser.ts` | Main image-text posting script |
93| `cdp.ts` | Chrome DevTools Protocol utilities |
94| `copy-to-clipboard.ts` | Clipboard operations |
95