@wji.ai/cli 0.5.0 → 0.5.1

package/skill/social-media/reference/content-craft.md

@@ -0,0 +1,124 @@
+# Content craft — hooks, loops, overlays, captions, covers, carousels
+
+What makes a post perform once the size is right: the first three seconds, the ending that
+re-plays, text that stays inside the safe zone, a caption shaped for each platform's reading
+pattern, a posting slot to start from, a cover that reads at thumbnail size, and a carousel that
+tells one story. Sizes and limits are quoted from platforms-global.md and platforms-china.md,
+not restated here; teaser and poster recipes built on these rules are in repurpose.md.
+
+## The first 3 seconds
+
+Feeds decide in the first swipe-length. The product, the face or the question is on screen by
+second 3, in motion, with no logo card, no fade-in and no "hi guys". Hook types, with a line
+each (drama and product examples side by side):
+
+| Hook type | Drama teaser | Product / brand |
+| --- | --- | --- |
+| Shocking line, mid-scene | 「你以为我不知道孩子是谁的？」 cut in on the reaction | "This is the last one we could get made." |
+| Result first, cause later | the slap, the arrest, the reveal — then 「三天前…」 | the after-state (clean pan, finished room), then the before |
+| Direct question | 「如果你婆婆当众撕了你的结婚证，你会怎么做？」 | "Why does every white sneaker turn yellow in a month?" |
+| Contradiction / mismatch | the bride in a wedding dress signing divorce papers | a luxury unboxing on a bus |
+| Countdown / stakes | 「还有十分钟，她就要嫁给别人了」 | "Three tests. One survives." |
+| Visual anomaly | one impossible detail in an ordinary frame (a wet footprint indoors) | the product doing the one thing rivals cannot |
+| Named audience | 「二婚的姐妹看过来」 | "If you edit on a phone, watch this." |
+
+Rules: one hook per cut, the first frame is already the strongest frame (it is also the cover),
+sound-off comprehension — the hook line is burned in as text. Write 2–3 hooks for the same body
+and let the platform pick (repurpose.md, variants).
+
+## Loop-friendly endings
+
+Reels, TikTok and 抖音 count re-watches. End on a frame that matches the first frame (same
+composition, same subject position) so the loop hides the seam; or end one beat *before* the
+answer the hook promised, so the viewer re-watches to catch it; or end on the CTA card that is
+also the cover. Never end on a logo fade or a black frame. For a drama teaser the ending is the
+cut before the payoff plus the line 「主页看全集 / full episode in bio」 (repurpose.md).
+
+## On-screen text and burned subtitles
+
+- Keep every word inside the safe zone of the 9:16 diagram (platforms-global.md): headline in the
+  upper safe band, subtitles at the lower edge of the safe band (≈y 1100–1240 on 1080×1920), never
+  behind the caption or the right rail.
+- Subtitles are burned in (most feeds autoplay muted): 2 lines maximum, ≤ 14 CJK chars or ≤ 32
+  Latin chars per line, high-contrast box or stroke, one style for the whole account.
+- Headline type ≥ 60 px on 1080×1920, ≤ 6 words / 8 chars; a second overlay only when the first
+  has left. Do not repeat the caption on screen.
+- Text is added after the crop and at the final ratio (ratio-map.md, crop anchoring); text
+  generated inside the picture is only for covers that are never cropped again.
+- 「AI生成」 label where required (platforms-china.md) is the platform's toggle, not an overlay
+  you design — but do not place other text where the platform paints its label (top-left on most
+  Chinese apps).
+
+## Caption structure per platform
+
+| Platform | Structure | Hashtags / tags | Length notes |
+| --- | --- | --- | --- |
+| Instagram | hook line (shown before "more") → 2–4 short lines → CTA (save / share / comment) | **≤5** (Dec 2025 cap) — 3 niche + 2 broad | 2,200 max; the first 125 chars are the post |
+| TikTok / 抖音 | one-line hook + a question that invites comments | 3–5 hashtags / 话题, one is the series tag | 4,000 max on TikTok; 抖音 shows ≈20 chars of title |
+| YouTube | title ≤ 60–70 chars shown; description: 2-line summary, links, chapters, disclosure | 3–5 hashtags at the end of the description | title 100 hard cap |
+| Facebook | short hook, link in the first comment or the post, CTA | 1–3 | shares outweigh hashtags |
+| X | the hook is the whole post; thread for detail | 1–2 or none | 280 |
+| LinkedIn | hook in the first two lines → line-broken story → question → 3 hashtags | 3 | 3,000; "see more" after ≈3 lines |
+| Pinterest | keyword title ≤ 100, description with 2–3 search phrases | none | description 500–800 *(verify)* |
+| Threads | one sentence; the picture carries the rest | none | 500 |
+| 小红书 | 标题 ≤ 20 with the keyword first → 正文 in short lines with emoji markers → 话题 tags | keyword + 3–6 话题 (#…#) | 正文 1,000 (长文 6,000) |
+| 视频号 / 公众号 | one-line 描述 with 话题; the article's first line is the hook | 1–3 话题 | limits not confirmed |
+| B站 | 标题 with the series and episode number; 简介 with timestamps | tags on upload (platform field) | limits not confirmed |
+
+A CTA is one verb: 关注 / follow, 主页看全集 / full episode in bio, save, comment the answer.
+Platform buttons (shop, link, subscribe) are not drawn into the picture.
+
+## Posting-time starting points
+
+Sprout Social 2026 aggregates, to be treated as **starting points** and replaced by the
+account's own insights after two weeks: Instagram Mon–Thu 10:00–15:00; TikTok Wed 14:00–17:00;
+LinkedIn Tue 11:00–17:00. Local time of the audience, not of the account. Other platforms and
+the Chinese apps: not confirmed in the research — plan lunchtime (12–13) and evening (20–22)
+slots in the audience's time zone and measure. Series content posts at the same slot every
+time; the second post of a series goes out within 24 h of the first while the hook is fresh.
+
+## Cover and thumbnail design
+
+- **Face + ≤ 4 words** (≤ 8 CJK chars): the face at 40–60 % of the frame height, looking at the
+  camera or at the text; the words in one colour band, one weight.
+- **High contrast**: light text on a darkened lower third or dark text on a light band; check
+  it at 120 px wide (the 小红书 / 快手 tile is half a phone).
+- **One template per series**: same title position, same colour, same type; the episode number
+  changes, nothing else. Recognition beats novelty in a grid.
+- **Ratio per platform** (ratio-map.md): 16:9 1280×720 YouTube; 3:4 小红书 / IG grid; 9:16 Reels
+  / TikTok / 抖音 with the text in the centre 60 % because the grid crops to a taller tile;
+  1146×717 B站 with the bottom-left clear; 6:7 视频号 composed for its 1:1 share crop.
+- Covers are generated **with** the text only at the final ratio (nano-banana-pro, gpt-image-2.5
+  or seedream-5-pro for reliable multilingual type); every other size gets the text overlaid
+  after the crop.
+
+## Carousel / 图文 storytelling
+
+1. **Cover as hook** — the question, the contrast or the result; it must work alone in the feed.
+2. **One idea per card**, one line of text per card, the same layout grid on every card.
+3. **Escalate**: cards 2–N answer the cover in order of surprise, not of logic; the strongest
+   proof sits two cards before the end.
+4. **Last card = CTA** (follow, save, 主页看全集, 领取), in the same template as the cover so the
+   loop back to card 1 feels designed.
+5. **One ratio for the whole set** (IG ≤ 20 slides, 小红书 ≤ 18 images, TikTok photo mode ≤ 35):
+   generate every card at the same `ratio` and crop to the same box.
+6. Caption repeats the cover's keyword in the first line; on 小红书 the 话题 tags close the body.
+
+## Trending audio
+
+Trending sounds lift reach on TikTok / 抖音 / Reels, but a business account may only use
+tracks from the platform's **commercially licensed library**; personal-account sounds are
+muted or the post is removed when the account is business-typed. AI-generated soundtracks
+(Seed Audio, generated per teaser) avoid the problem and can be reused across the series.
+Never lip-sync a drama clip to a licensed pop song for a paid promotion.
+
+## What to avoid
+
+- A logo intro, a fade-in, a title card before the hook.
+- Letterboxed 16:9 inside a 9:16 post (regenerate — ratio-map.md).
+- Text in the top 270 px or the bottom 670 px of a vertical frame; text under the right rail.
+- More than 5 hashtags on Instagram; hashtag walls anywhere; hashtags that do not exist yet.
+- Sub-1080-px sources, upscaled 1K frames, JPEG re-compression of a re-compression.
+- Cross-platform reposts with the other platform's watermark or overlay language.
+- Engagement bait ("like if…", fake polls), fake countdowns, fake UI buttons drawn into the frame.
+- Claiming AI footage is real footage; skipping the AI label where it is required.

package/skill/social-media/reference/plan-template.md

@@ -0,0 +1,171 @@
+# Plan template — the post spec sheet
+
+One spec sheet per post (one platform × one surface × one asset). It is written before any
+generation, filled from the platform row (platforms-global.md / platforms-china.md), the ratio
+row (ratio-map.md) and the craft rules (content-craft.md); the campaign's sheets together are
+the deliverables checklist of repurpose.md. The block below is the template; after it, one
+filled example — a 3-episode 短剧 launch on 小红书, 抖音 and Instagram Reels with a teaser and a
+poster per platform. Every figure in a sheet is copied from a reference row or marked
+"not confirmed"; nothing is invented in the sheet.
+
+## Fields
+
+| Field | Meaning | Where it comes from |
+| --- | --- | --- |
+| campaign | name of the launch / series / promotion | the user |
+| platform | 小红书, 抖音, Instagram … | the user |
+| surface | the row: 图文, video note, Reels, Stories, thumbnail … | platform file |
+| ratio | delivered ratio | platform row |
+| px | delivered pixel size | platform row |
+| duration cap | the surface's cap and the planned length | platform row; content-craft.md |
+| safe zone | the pixel bands text and faces avoid | platform row / 9:16 diagram |
+| source asset | episode + segment ids, KV id, uploaded file | short-drama storyboard / ads brief / user assets |
+| generation plan | model, `ratio`, `resolution`, `duration`, references (`@imageN`), prompt notes (framing sentence) | ratio-map.md |
+| crop | native ratio → target px, anchor | ratio-map.md, crop anchoring |
+| cover | file or "first frame"; template name | content-craft.md, covers |
+| caption | hook line + body + CTA, within the limit | content-craft.md, captions |
+| hashtags | count and list, within the cap | content-craft.md |
+| CTA | one verb | the brief / series plan |
+| posting slot | day + time in the audience's time zone; "starting point" or "from insights" | content-craft.md, posting times |
+| disclosure | the platform's AI toggle and its state; 「AI生成」 for China | platforms-china.md; repurpose.md §3 |
+| status | planned · quoted · generated · cropped · overlaid · scheduled · posted | the work |
+
+## Template block
+
+```
+campaign:         
+platform:         
+surface:          
+ratio:            
+px:               
+duration cap:      (surface cap) / planned:
+safe zone:        
+source asset:     
+generation plan:
+  model:          
+  ratio:          
+  resolution:     
+  duration:       
+  references:     @image1 = … · @image2 = …
+  prompt notes:   
+crop:              native → target, anchor:
+cover:            
+caption:          
+hashtags:          (n / cap)
+CTA:              
+posting slot:     
+disclosure:       
+status:           
+```
+
+## Filled example — 《穿越战神》 3-episode launch, 小红书 + 抖音 + Instagram Reels
+
+Six sheets: a teaser and a poster per platform. Beats and references are the same across the
+three teasers; only the ratio (all 9:16 here), the copy and the covers differ.
+
+```
+campaign:         穿越战神 E01–E03 launch, week 1
+platform:         抖音
+surface:          video
+ratio:            9:16
+px:               1080×1920
+duration cap:     60 min (verify) / planned: 30 s
+safe zone:        pixel bands not confirmed for 抖音 — using the 9:16 diagram union: x 120–960, y 270–1248
+source asset:     E01 storyboard segments 03 (turn), 05 (爽点), 07 (cliff); character sheets C01, C02; scene sheet S02 (the ancestral hall)
+generation plan:
+  model:          seedance-2.5-ref
+  ratio:          9:16
+  resolution:     1080p
+  duration:       4 segments × 7–8 s (hook 3 s inside segment 1)
+  references:     @image1 = C01 sheet · @image2 = C02 sheet · @image3 = S02 sheet · @audio1 = C01 voice sample
+  prompt notes:   vertical, faces at the upper third, hall built in depth (pillar foreground, altar behind); hook variant A = the line 「跪下的应该是你」 cut in cold; subtitles burned in at y 1100–1240
+crop:             none (video is regenerated at 9:16)
+cover:            first frame of variant A, title template 「穿越战神 · 第1集」 in the centre 60 %
+caption:          「跪下的应该是你。」 穿越战神 第1集 — 他回来了，这次跪的是谁？ 主页看全集
+hashtags:         4 / no fixed cap: #穿越战神 #短剧 #逆袭 #第1集
+CTA:              主页看全集
+posting slot:     Wed 20:00 CST — not confirmed for 抖音, starting point; replace from insights after week 1
+disclosure:       「AI生成」 toggle on (标识办法 2025-09-01)
+status:           quoted
+```
+
+```
+campaign:         穿越战神 E01–E03 launch, week 1
+platform:         小红书
+surface:          图文 (poster + 3 cards)
+ratio:            3:4
+px:               1242×1660
+duration cap:     — / 4 images (≤ 18)
+safe zone:        title inside the middle 70 %; the tile is half a screen
+source asset:     E01 爽点 keyframe (C01 standing over C02 in the hall); scene sheet S02
+generation plan:
+  model:          nano-banana-pro
+  ratio:          3:4
+  resolution:     2K
+  references:     @image1 = C01 sheet · @image2 = C02 sheet · @image3 = S02 sheet
+  prompt notes:   poster: two figures, C01 lit from the altar candles, title band lower third with 「穿越战神」 + 「第1集 · 跪下的应该是你」 rendered in the picture; cards 2–4 without text (overlaid after)
+crop:             3:4 2K frame → cover-fit to 1660 high → trim 1–2 px each side → 1242×1660
+cover:            card 1 (the poster) — template 「剧名 / 第N集 / one-line hook」
+caption:          标题 (18 chars): 穿越战神｜第1集他回来了跪的是谁 · 正文: 3 short lines with emoji markers, the keyword 穿越战神 in line 1, 主页看全集 as the last line
+hashtags:         6 / no fixed cap: #穿越战神 #短剧推荐 #逆袭 #穿越 #第1集 #AI短剧
+CTA:              关注 + 主页看全集
+posting slot:     Thu 12:30 CST — not confirmed for 小红书, starting point
+disclosure:       「AI生成」 toggle on
+status:           planned
+```
+
+```
+campaign:         穿越战神 E01–E03 launch, week 1
+platform:         Instagram
+surface:          Reels
+ratio:            9:16
+px:               1080×1920
+duration cap:     3 min in-app / planned: 30 s
+safe zone:        Meta unified (Mar 2026): 269 px top, 384–672 px bottom, 65 px sides
+source asset:     the 抖音 teaser's segments (same references), English subtitle layer regenerated
+generation plan:
+  model:          same clips as 抖音 (no new generation); overlay layer in English at the final ratio
+  ratio:          9:16
+  resolution:     1080p
+  duration:       30 s
+  references:     —
+  prompt notes:   hook variant B for this market: the result-first cut (the kneel) before the line
+crop:             none
+cover:            first frame of variant B; title in the centre — the grid tile is 3:4
+caption:          "You should be the one kneeling." Ep 1 of 穿越战神 — full episode in bio.
+hashtags:         5 / 5: #shortdrama #aidrama #cdrama #reels #ep1
+CTA:              full episode in bio
+posting slot:     Tue 12:00 local — Sprout 2026 starting point (Mon–Thu 10–15)
+disclosure:       Meta AI label per policy (auto-detected from Jun 2026; state it in the caption as well)
+status:           planned
+```
+
+```
+campaign:         穿越战神 E01–E03 launch, week 1
+platform:         Instagram
+surface:          feed poster (4:5)
+ratio:            4:5
+px:               1080×1350
+duration cap:     —
+safe zone:        avoid the outer 3 % per side (3:4 grid crop since Jan 2025)
+source asset:     the 小红书 poster's references
+generation plan:
+  model:          nano-banana-pro
+  ratio:          4:5
+  resolution:     2K
+  references:     @image1 = C01 sheet · @image2 = C02 sheet · @image3 = S02 sheet
+  prompt notes:   same composition as the 3:4 poster; English title band 「WARLORD RETURNS · EP 1」 rendered in the picture
+crop:             none (4:5 is native to nano-banana-pro)
+cover:            itself
+caption:          hook line + 2 lines + "full episode in bio"
+hashtags:         5 / 5
+CTA:              full episode in bio
+posting slot:     with the Reel, same day
+disclosure:       Meta AI label per policy
+status:           planned
+```
+
+The 抖音 poster sheet mirrors the 小红书 one at 9:16 (a native 9:16 generation, title in the
+centre 60 %), and the 抖音 teaser variant C (the direct question hook) is a fourth video sheet
+with only the hook segment regenerated. Six sheets, one references set, two image generations
+per ratio, four video segments plus two extra hook segments — that is the whole quote.

package/skill/social-media/reference/platforms-china.md

@@ -0,0 +1,94 @@
+# Platform specs — China (抖音, 快手, 小红书, 视频号, B站, 微博, 微信公众号)
+
+The same table shape as platforms-global.md for the mainland platforms: per surface, the ratio
+and pixel size, duration and file caps, the safe zone, the text limits, and the conventions that
+decide whether a post is read at all. Chinese trade terms are kept in Chinese (图文, 封面, 话题,
+标题) because that is how the platform's own upload screens name them. Rows marked *(verify)*
+had conflicting figures in the 2025–2026 research; "not confirmed" means no figure was found —
+say so in the plan rather than guess. Generation ratios and crop boxes per row are in
+ratio-map.md.
+
+## 抖音 (Douyin)
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Video | 9:16 1080×1920 (16:9 accepted, letterboxed); 30 or 60 fps | 60 min *(verify; older figure 15 min)* | web upload ≤4 GB | pixel bands not confirmed — same layout as TikTok (right rail, bottom caption): use the 9:16 diagram in platforms-global.md until verified | 标题 ≈20 chars visible; 话题 tags (#…#) appended | product or hook inside 3 s; 抖音 ranks completion rate and re-watches |
+| 图文 | 3:4 or 9:16 images, one ratio per post | — | not confirmed | as video | 标题 ≈20 chars | image count cap not confirmed; swipes with music like TikTok photo mode |
+| 封面 | 9:16 frame (a chosen frame or an uploaded cover) | — | not confirmed | profile grid crops to a taller tile — keep cover text in the centre 60 % | cover text ≤ ≈8 chars readable at thumbnail size | series use one template: same title position, same colour band |
+
+## 快手 (Kuaishou)
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Video | 9:16 1080×1920 | ≈10 min | 2–3 GB *(verify)* | not confirmed — use the 9:16 diagram | not confirmed | double-column feed on the home tab: the 封面 is a tile, so its text must survive being half-width |
+| 封面 | 9:16 or 3:4 | — | not confirmed | — | not confirmed | one idea, big type, face if there is one |
+
+## 小红书 (Xiaohongshu / RED)
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| 图文 note | 3:4 1242×1660 (or 1080×1440); 1:1 and 9:16 accepted | — | ≤18 images, ≤20 MB each | the feed card shows the first image at 3:4 — a 1:1 or 9:16 first image is cropped; titles inside the image sit in the middle 70 % | 标题 ≤20 chars; 正文 ≤1,000 (长文 6,000); 话题 tags inside the body | **one ratio per note**: the first image sets the frame for all; the cover is the hook (see content-craft.md) |
+| Video note | 9:16 or 3:4 | ≤15 min | not confirmed | not confirmed — use the 9:16 diagram | 标题 ≤20; 正文 ≤1,000 | 3:4 video shows larger in the two-column feed than 9:16 |
+| 封面 | 3:4 or 9:16 | — | ≤5 MB | two-column feed: the tile is half the screen width — cover text must read at that size | cover text ≤ ≈8 chars, ≤2 lines | 3:4 covers dominate the discovery feed; a 9:16 cover is cropped to 3:4 on the card |
+
+## 视频号 (WeChat Channels)
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Feed video | 6:7 1080×1260 (largest in the feed); 9:16 1080×1920; 4:3 1080×810; 1:1 1080×1080; any ratio 0.33–3.0 accepted | web 3 s–8 h; phone ≤60 min | ≤2 GB | 9:16 plays with black bars in the feed until tapped — 6:7 fills the card without bars | 描述 limit not confirmed; 话题 tags supported | 6:7 has no native generation ratio — crop from 3:4 or 1:1 (ratio-map.md) |
+| 封面 | same ratio as the video; **朋友圈 share crops the cover to 1:1** | — | not confirmed | keep the title and face inside the central square of the cover | — | a 6:7 cover loses 90 px top and bottom in the 朋友圈 card |
+| Live / 直播 preview | 9:16 | — | — | — | — | not covered here |
+
+## B站 (Bilibili)
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Video | 16:9 1920×1080 or 3840×2160 | not confirmed | not confirmed | — | 标题 and 简介 limits not confirmed | 横屏 first; vertical is accepted but shown pillar-boxed on desktop |
+| 封面 | 1146×717 (≈16:10) or 1920×1200 | — | ≤2–5 MB | **keep the bottom-left corner clear** (duration badge overlays it); the title of the card sits under the cover, not on it | cover text ≤ ≈10 chars | crop from 3:2 or 16:9 — see ratio-map.md |
+| 动态 (dynamic post) | 1:1 or 4:3 images | — | not confirmed | — | not confirmed | nine-grid like 微博 |
+
+## 微博 (Weibo)
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| 头条文章 cover | 1000×562 (safe area 1000×400) or 900×500 | — | not confirmed | the card crops top and bottom: keep the title inside the middle 400 px | article title limit not confirmed | crop from 16:9 — see ratio-map.md |
+| Post images | not confirmed | — | not confirmed | not confirmed | post text limit not confirmed | nine-grid: the first three images are seen; make the first the hook |
+| Video | *(verify)* | *(verify)* | *(verify)* | — | *(verify)* | the research produced no reliable 2026 figures for 微博 video |
+
+## 微信公众号 (WeChat Official Account)
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| 头图 / cover | 2.35:1 900×383 — **plus the 1:1 share crop** taken from its centre | — | not confirmed | title and face inside the central 383×383 square so the 1:1 share card still reads | article title limit not confirmed | crop from 21:9 — see ratio-map.md |
+| Secondary cover (次条) | 1:1 200×200, export at 2× (400×400) | — | not confirmed | — | — | small: one object or one face, no text |
+| 图文 body | images the width of the article column; 900 px wide matches the cover width (practice, not a platform rule) | — | not confirmed | — | body length not confirmed | see 图文 layout notes below |
+
+图文 layout notes: the article opens on the cover and the first line, so the first image after
+the title is a second hook, not a decoration; one image per point, captions under images in a
+lighter weight; a share card at the end repeats the CTA; the 1:1 share crop is what most
+readers see first in a chat, so the cover's centre square is the real cover.
+
+## China-specific practice
+
+- **「AI生成」 label.** 《人工智能生成合成内容标识办法》 has been in force since 2025-09-01: AI-generated
+  or AI-edited video, images and audio carry a visible 「AI生成」 label (most platforms add a
+  toggle on upload — switch it on) and the file keeps implicit metadata / watermark marking. Do
+  not strip the marking in the crop step; do not describe AI footage as real footage.
+- **Title style.** 小红书 标题 ≤20 chars and the platform hides more; 抖音 shows ≈20. Front-load the
+  keyword the search box will match (product, place, problem), then the twist. Number + result
+  patterns (「3个…」「第2集…」) and bracketed qualifiers (【】) read as native; clickbait without the
+  payoff in the body is down-ranked.
+- **Emoji and keyword conventions.** Emoji as bullet markers at line starts, not inside
+  sentences; the body repeats the title's keyword once in the first line; 话题 tags (#…#) go at
+  the end of the body, 3–6 on 小红书, and they are searchable — use the platform's suggested
+  spellings, not invented ones.
+- **图文 storytelling.** The cover is the hook (question, contrast, result), each following image
+  is one idea with one line of text on it, the last image is the CTA (follow / 主页看全集 / 领取).
+  One ratio for the whole set, one title template for the whole account.
+- **Cover text is the headline.** On 小红书 and 快手 the tile is half the screen: ≤8 chars, one
+  colour band behind the text, face or product filling the rest.
+- **Search first.** 小红书 and 抖音 surface posts by search as much as by feed: the title, the
+  cover text and the first body line should agree on one keyword.
+- **Platform video-style borrowing.** 抖音 audiences reject an obvious repost from TikTok (English
+  overlays, foreign sounds); regenerate the overlay layer in Chinese rather than translating on
+  top of the old one.

package/skill/social-media/reference/platforms-global.md

@@ -0,0 +1,122 @@
+# Platform specs — global (Instagram, TikTok, YouTube, Facebook, X, LinkedIn, Pinterest, Threads, Snapchat)
+
+One table per platform, one row per surface: the ratio and pixel size to deliver, the duration
+and file-size caps, the safe zone where UI covers the picture, the text limits, and what has
+changed recently with the date. Copy the row into the post spec sheet (plan-template.md) before
+generating anything; the generation ratio and crop box for each row is in ratio-map.md, and the
+Chinese platforms are in platforms-china.md. Figures marked *(verify)* were inconsistent between
+sources in the 2025–2026 research; "not confirmed" means the research produced no figure — never
+fill it from memory, say so and let the user check the platform's current help page.
+
+## The 9:16 safe zone (1080×1920) — one diagram for every vertical surface
+
+Vertical surfaces all hide the top band behind the status bar and the bottom band behind the
+caption, the sound tag and the action rail on the right. Measured bands, in pixels of a
+1080×1920 frame:
+
+```
+ y     0 ┌────────────────────────────┐
+         │ ▒ top band: Meta 14 % = 269 px (Stories / Reels, unified Mar 2026)
+         │   TikTok 108 · IG Reels 220 · Snapchat 150
+ y   270 ├────────────────────────────┤ ▒ right rail (likes / comments / share):
+         │                            │   TikTok 120 px · Meta 6 % = 65 px
+         │   SAFE — faces, headline,  │ ▒ left band: TikTok 60 px · Meta 65 px
+         │   subtitles, product,      │
+         │   x 120 → 960              │
+ y  1248 ├────────────────────────────┤
+         │ ▒ bottom band: Meta 20–35 % = 384–672 px (caption + sound + CTA)
+         │   TikTok 320 · IG Reels 420 · Snapchat 330
+ y  1920 └────────────────────────────┘
+```
+
+The conservative union — text and faces inside **x 120–960, y 270–1248** — is safe on every
+platform in this file at once, so a single 9:16 master can be posted everywhere. Per-platform
+bands are looser; use them only when a variant is made for one platform.
+
+## Instagram
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Feed image | 4:5 1080×1350 (standard); 3:4 1080×1440 (shows uncropped in the grid); 1:1 1080×1080; 1.91:1 1080×566 | — | not confirmed | grid tile is 3:4 since Jan 2025: a 4:5 loses ≈3 % per side, 1:1 ≈12 % per side, 1.91:1 keeps only the centre | caption 2,200; **≤5 hashtags since Dec 2025** | 4:5 fills the most feed height; 1080×1440 may fail via API upload |
+| Feed video | 4:5 or 9:16 | 3 s–60 min | not confirmed | as Reels | caption 2,200; ≤5 hashtags | every feed video is shown as a Reel |
+| Reels | 9:16 1080×1920 | 3 min in-app (Jan 2025); up to 15 min upload *(verify)* | not confirmed | 220 px top, 420 px bottom (IG figure); Meta unified 14 % / 20–35 % / 6 % from Mar 2026 | caption 2,200; ≤5 hashtags | cover frame is cropped to 3:4 in the grid — keep the cover's title in the centre |
+| Stories | 9:16 1080×1920 | 60 s per card | not confirmed | 14 % top and bottom clear (269 px) | sticker text, link sticker | tap-through: one idea per card |
+| Carousel | one ratio for every slide (4:5 recommended) | — | not confirmed | first slide sets the crop for all | caption 2,200; ≤5 hashtags | ≤20 slides; last slide carries the CTA |
+| Profile grid | 3:4 tiles since Jan 2025 | — | — | design covers for the 3:4 tile | — | previews of 9:16 Reels and 1:1 posts are centre-cropped |
+
+## TikTok
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Video | 9:16 1080×1920 | ≤60 min upload, 10 min in-app | not confirmed | 108 px top · 320 px bottom · 60 px left · 120 px right | caption 4,000 | product or key message inside 3 s; start in motion |
+| Photo mode | 9:16 (1:1 and 4:5 accepted) | — | not confirmed | as video | caption 4,000 | ≤35 images; swipes like a carousel with music |
+| Cover | first frame or a chosen frame, 9:16 | — | — | profile-grid tile crop not confirmed — keep title text in the centre 60 % of the frame | cover text | face + ≤4 words; the same template across a series |
+
+## YouTube
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Long-form | 16:9 1920×1080 or 3840×2160 | 15 min unverified account, 12 h verified | not confirmed | end-screen area in the last 5–20 s | title 100 (≈60–70 shown), description 5,000 | chapters from timestamps in the description |
+| Shorts | 9:16 or 1:1 | ≤3 min (Oct 2024) | not confirmed | pixel bands not confirmed — keep captions above the bottom UI; use the 9:16 diagram | title 100 | a Short is any vertical video ≤3 min with #Shorts optional |
+| Thumbnail | 16:9 1280×720 | — | ≤2 MB | duration badge sits bottom-right; keep that corner clear | — | face + ≤4 words, high contrast; see content-craft.md |
+| Posts (formerly Community tab) | image ratio not confirmed | — | not confirmed | — | not confirmed | renamed from "Community" to "Posts"; polls, images, text |
+| End screens | inside the 16:9 frame | last 5–20 s of videos ≥25 s | — | elements occupy the frame — no important picture behind them | — | ≤4 elements (video, playlist, subscribe, link) |
+
+## Facebook
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Feed image | 4:5 1080×1350 or 1:1 1080×1080 | — | not confirmed | — | post text not confirmed | 4:5 fills the most feed height |
+| Feed video | 4:5 or 9:16 | 1 s–240 min | not confirmed | Meta 9:16 bands | not confirmed | **all Facebook video is published as Reels since Jun 2025** |
+| Reels | 9:16 1080×1920 | 3–90 s | not confirmed | Meta unified: 14 % top, 20–35 % bottom, 6 % sides (Mar 2026) | caption not confirmed | same master as Instagram Reels |
+| Stories | 9:16 1080×1920 | 1–60 s | not confirmed | Meta unified bands | sticker text | — |
+| Link preview | 1.91:1 1200×630 (OG image) | — | not confirmed | — | title and description from the page's OG tags | crop from 16:9 — see ratio-map.md |
+
+## X
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Image post | 16:9 1600×900 or 1:1 | — | not confirmed | timeline preview crops tall images to 16:9-ish — keep the subject centred | 280 chars (Premium longer) | up to 4 images; the first sets the layout |
+| Video | 16:9 or 1:1, ≤1920×1200 | 2 min 20 s (Premium up to 4 h) | 512 MB | — | 280 chars | autoplays muted — burned subtitles |
+
+## LinkedIn
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Image post | 1080×1080 or 4:5 1080×1350 | — | not confirmed | — | 3,000 chars ("see more" after ≈3 lines) | first two lines carry the hook |
+| Link preview | 1.91:1 1200×627 | — | not confirmed | — | OG title / description | crop from 16:9 — see ratio-map.md |
+| Video | 16:9, 1:1 or 9:16 | ≤10 min organic | 5 GB | — | 3,000 chars | muted autoplay — burned subtitles; 3 hashtags |
+| Document / carousel | PDF pages, 1:1 or 4:5 | — | not confirmed | — | — | one idea per page, last page CTA |
+
+## Pinterest
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Standard Pin | 2:3 1000×1500 | — | not confirmed | — | title 100; description 500–800 *(verify)* | Idea Pins merged into standard Pins in 2023 |
+| Video Pin | 9:16 (2:3 accepted) | 4 s–15 min | not confirmed | bottom band hides behind the title on the feed card | title 100 | first frame is the cover unless a cover is chosen |
+
+## Threads
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Post | 4:5 best; 9:16, 1:1, 16:9 accepted | video ≤5 min | 500 MB | — | 500 chars | text-first feed: the first line is the hook |
+
+## Snapchat
+
+| Surface | Ratio · px | Duration | File size | Safe zone | Text limits | Notes |
+| --- | --- | --- | --- | --- | --- | --- |
+| Story / Spotlight | 9:16 1080×1920 | 3–180 s | not confirmed | 150 px top · 330 px bottom | caption not confirmed | full-screen only; no letterboxing |
+
+## Recent changes to keep in mind (dated)
+
+| When | Platform | Change | Effect on delivery |
+| --- | --- | --- | --- |
+| Oct 2024 | YouTube | Shorts up to 3 min | drama teasers up to 3 min qualify as Shorts |
+| Jan 2025 | Instagram | profile grid tiles 3:4; Reels 3 min in-app | covers designed for 3:4; 4:5 posts lose ≈3 % per side in the grid |
+| 2025 | YouTube | Community tab renamed Posts | say "Posts" in plans |
+| Jun 2025 | Facebook | every video post is a Reel | there is no separate feed-video spec; use the Reels row |
+| Dec 2025 | Instagram | hashtags capped at 5 per post | captions with more are rejected or trimmed; pick 5 |
+| Mar 2026 | Meta | one unified safe zone for Stories and Reels: 14 % top, 20–35 % bottom, 6 % sides | one 9:16 master serves IG and FB Reels and Stories |
+
+Where a row says "not confirmed", the platform may well have a published figure; the research
+did not verify it, so the plan must not state one.

package/skill/social-media/reference/ratio-map.md

@@ -0,0 +1,100 @@
+# Ratio map — placement size → generation ratio, model, crop box
+
+Every image placement in platforms-global.md and platforms-china.md, mapped to the ratio a WJI
+image model actually generates (taken from the model seeds — the model's `ratio` list is the
+law, not the platform's wish) and, where the placement is not a native ratio, to the nearest
+native ratio plus the crop box that reaches the exact pixels. Then the same for video, where
+the rule is different: **video is regenerated at the target ratio from the same references,
+never cropped**. Read this after choosing the surfaces and before writing the generation plan
+in plan-template.md.
+
+## Native image ratios per model (from the seeds)
+
+| Model (`model`) | Ratios | Resolution | Refs |
+| --- | --- | --- | --- |
+| nano-banana, nano-banana-pro, nano-banana-2 | auto 1:1 2:3 3:2 3:4 4:3 **4:5** 5:4 9:16 16:9 21:9 9:21 | pro / 2: 1K–4K | 14 (pro / 2), 4 (nano-banana) |
+| nano-banana-2-lite | same minus 9:21 | | |
+| gpt-image-2 | auto 1:1 4:3 3:4 16:9 9:16 | 1K / 2K / 4K | 16 |
+| gpt-image-2.5 (sunburst / flare) | gpt-image-2 + **21:9** | 1K / 2K / 4K | 16 |
+| bytedance-seedream-4.5 | 1:1 4:3 3:4 16:9 9:16 | 2K / 4K | |
+| bytedance-seedream-5-lite / 5-pro | seedream-4.5 + 3:2 **2:3** 21:9 | size select; 5-pro layered PNG | |
+| flux-2-flex | 1:1 16:9 3:2 2:3 **4:5** 5:4 9:16 3:4 4:3 | | |
+| marketing-studio-image | auto 1:1 3:2 2:3 4:3 3:4 16:9 9:16 21:9 | 1k / 2k / 4k | 8 |
+| runninghub-midjourney v7 / v8.1 / v8.2 | 1:1 4:3 3:2 16:9 3:4 2:3 9:16 | | |
+
+No model generates 1.91:1, 6:7, 16:10, 2.35:1 or any banner size. Those are crops.
+
+**Resolution rule.** Pick the resolution whose generated short side is at least the target's short
+side after cover-fit, then downscale; never upscale a 1K frame to a 1242-px-wide note. 1K frames
+(≈1024 on the long side) are too small for every placement in this file except 200×200 and
+400×400; generate at 2K for everything else and at 4K when the crop keeps less than 60 % of the
+frame.
+
+## Image placements
+
+| Placement (file) | Target px | Ratio | Native models | If not native: generate → crop |
+| --- | --- | --- | --- | --- |
+| IG feed / FB feed / Threads | 1080×1350 | 4:5 | nano-banana, nano-banana-pro, nano-banana-2, flux-2-flex | 3:4 → cover-fit to 1080 wide (1080×1440) → crop 45 px top and 45 px bottom |
+| IG feed grid-native, 小红书 图文, 抖音 图文, 小红书 cover | 1080×1440 / 1242×1660 | 3:4 | all models in the table above | 1242×1660 is 4 px off exact 3:4 — cover-fit to height 1660 (1245 wide) → crop 1–2 px each side |
+| IG Reels / Stories / TikTok / Shorts / 抖音 / 快手 covers, Snapchat, 视频号 9:16 | 1080×1920 | 9:16 | all | — |
+| IG 1:1, FB 1:1, LinkedIn post, 视频号 1:1, 公众号 secondary cover, X square | 1080×1080 / 1200×1200 / 400×400 | 1:1 | all | — |
+| YouTube thumbnail, X, B站 video frame, 微博 1000×562 | 1280×720 / 1600×900 / 1920×1080 / 1000×562 | 16:9 | all | 1000×562 is 16:9 to the pixel — resize only; keep the title inside the middle 400 px |
+| Pinterest Pin | 1000×1500 | 2:3 | nano-banana family, seedream-5-lite / 5-pro, flux-2-flex, marketing-studio-image, midjourney | 3:4 → cover-fit to height 1500 (1125 wide) → crop 62 px left, 63 px right |
+| 视频号 4:3, B站 动态 | 1080×810 | 4:3 | all | — |
+| IG landscape | 1080×566 | 1.91:1 | none | 16:9 → cover-fit to 1080 wide (1080×608) → crop 21 px top and bottom |
+| FB / LinkedIn link preview, Google landscape | 1200×630 / 1200×627 / 1200×628 | 1.91:1 | none | 16:9 → cover-fit to 1200 wide (1200×675) → crop 22–24 px top and bottom (45 / 48 / 47 px in total) |
+| 视频号 feed card | 1080×1260 | 6:7 | none | 3:4 → 1080×1440 → crop 90 px top and 90 px bottom (keeps full width); or 1:1 → cover-fit to height 1260 (1260 wide) → crop 90 px each side (keeps full height) |
+| B站 cover | 1146×717 | ≈16:10 | none | **3:2** (closest) → cover-fit to 1146 wide (1146×764) → crop 23 px top, 24 px bottom; or 16:9 (from the master) → cover-fit to height 717 (1275 wide) → crop 64–65 px each side |
+| B站 cover large | 1920×1200 | 16:10 | none | 3:2 → 1920×1280 → crop 40 px top and bottom; or 16:9 → 2133×1200 → crop 106–107 px each side |
+| 公众号 cover | 900×383 | 2.35:1 | none | 21:9 (gpt-image-2.5, nano-banana family, seedream-5-lite / 5-pro, marketing-studio-image) → cover-fit to 900 wide (900×386) → crop 1 px top, 2 px bottom; the 1:1 share crop is the centre 383×383 (x 258–641) — compose for that square |
+| 微博 头条文章 alt | 900×500 | 1.8:1 | none | 16:9 → cover-fit to 900 wide (900×506) → crop 3 px top and bottom |
+| 公众号 secondary | 200×200 (export 400×400) | 1:1 | all | generate 1:1 at 1K, downscale to 400, deliver 400×400 |
+
+"Cover-fit" means: scale the generated frame uniformly until it covers the target box, then cut
+what falls outside, anchored as described under "Crop anchoring". One generated frame per ratio,
+never one per pixel size: a single 16:9 frame serves the YouTube thumbnail, X, 微博 and every
+1.91:1 preview.
+
+## Video placements
+
+| Placement | Ratio | Models that generate it natively (`ratio`) | Duration range (`duration`) |
+| --- | --- | --- | --- |
+| Reels, Stories, TikTok, Shorts, 抖音, 快手, 小红书 video, 视频号 9:16, Snapchat, Pinterest video | 9:16 | minimax-h3 (+ -ref), seedance-2.5 (+ -ref), seedance-2.0 family, wan-3.0 (+ -ref, prime), veo-3.1, kling-3, happy-horse | h3 5–15 s · seedance-2.5 4–30 s · seedance-2.0 4–15 s · wan-3.0 2–30 s · veo-3.1 4–8 s · kling-3 3–15 s · happy-horse 3–15 s |
+| YouTube long-form, B站, X, LinkedIn, FB in-stream | 16:9 | all of the above | as above |
+| IG / FB / LinkedIn square, 视频号 1:1, Shorts 1:1, X 1:1 | 1:1 | minimax-h3, seedance-2.5, seedance-2.0, wan-3.0, kling-3, happy-horse (not veo-3.1) | as above |
+| 视频号 4:3 | 4:3 | minimax-h3, seedance-2.5, seedance-2.0, wan-3.0, happy-horse | as above |
+| 小红书 3:4 video, 视频号 tall card, 抖音 图文-style video | 3:4 | minimax-h3, seedance-2.5, seedance-2.0, wan-3.0, happy-horse | as above |
+| Cinematic banner, hero loop | 21:9 | minimax-h3, seedance-2.5, seedance-2.0 | as above |
+| 视频号 6:7, Pinterest 2:3, 1.91:1 previews | — | none | deliver the nearest accepted ratio instead: 视频号 takes 3:4 or 1:1 (0.33–3.0 accepted), Pinterest takes 9:16, link previews take a 16:9 still |
+
+Resolutions: minimax-h3 480P / 768P / 2K / 4K; seedance-2.5 480p / 720p / 1080p; wan-3.0 480P /
+720P / 1080P; seedance-2.0 480p / 720p. Publish 1080p or the model's top tier below it; the
+platform re-encodes anyway.
+
+**The video rule.** A 16:9 master cropped to 9:16 loses two thirds of the frame and lands the
+faces under the caption band; a 9:16 master padded to 16:9 is a phone video with bars. So every
+ratio in the placement list is a **new generation**: the same character / scene / product
+references (`@image1` …), the same segment prompt with the framing sentence rewritten for the
+new frame ("vertical, subject centred, head at the upper third, room built in depth"), the same
+`duration`. Cost is one clip per ratio per segment — plan it in repurpose.md, quote it, then
+generate. The only cut permitted on a video is trimming its length.
+
+## Crop anchoring
+
+A crop box has an anchor: the point that must stay inside. Decide it per frame before cutting.
+
+| Frame content | Anchor | Then |
+| --- | --- | --- |
+| A face (poster, teaser cover, testimonial still) | the face box; eyes at ≈1/3 from the top of the target | crop from the bottom first, then the top; never cut the chin or the hairline |
+| Two faces | the midpoint between them, both boxes inside | if both cannot fit, regenerate the frame tighter rather than cut one out |
+| Product / packshot | the product's centre; the whole product plus its shadow inside | crop the sides symmetrically; on 1.91:1 previews keep the label readable at 600 px wide |
+| Headline zone (key visual with text) | the text block plus its margin | text is rendered into the picture only on the final ratio — on crops, generate without text and overlay after |
+| Scene / landscape | the horizon or the main light | side crops are free; top / bottom crops keep the horizon off the edge |
+
+After the crop, re-check the target's safe zone (platforms-global.md / platforms-china.md):
+a 6:7 视频号 cover is shared to 朋友圈 as its centre 1:1, so the face has to sit inside that
+square; a 900×383 公众号 cover is read as its centre 383×383 in chats; a 4:5 IG post loses ≈3 %
+per side in the 3:4 grid; a 16:9 thumbnail keeps the bottom-right corner clear for the duration
+badge and a B站 cover the bottom-left. When the anchor cannot survive the crop, the answer is a
+new generation at the closer native ratio (3:4 instead of 1:1 for 6:7, 3:2 instead of 16:9 for
+1146×717), not a smaller face.