@wji.ai/cli 0.9.0 → 0.9.2

package/README.md

@@ -215,6 +215,7 @@ wji backreel create "Harbour" -d @synopsis.txt --cover <assetId>
 wji backreel credit add <postId> --npc @mika --role "飾 阿明" --job appearance
 wji backreel image poster.png --slot portrait --post <postId>   # size check + upload + set
 wji backreel episode add <postId> E01.mp4 -t "第一集"            # VOD upload
+wji backreel episode subs add <postId> 1 E01.zh-Hant.srt        # subtitles, one per language
 wji backreel check <postId>
 wji backreel publish <postId>
 wji backreel enquiry list --unread
@@ -310,10 +311,15 @@ generations, banner sizes, AI-disclosure compliance); `social-media` holds
 every platform's image / video specs (Instagram, TikTok, YouTube, Facebook, X,
 LinkedIn, Pinterest, Threads, Snapchat, 小红书, 抖音, 快手, 视频号, B站, 微博,
 公众号) and the repurposing recipes — an episode into 9:16 teasers and posters,
-an ad master into every placement. Install them the same way:
+an ad master into every placement. `skill/w-film-dialogue-editor/` is the
+dialogue skill short-drama reviews every script with: a guide per 语体 (粤语,
+大陆普通话, 台湾国语, 港式普通话, 古装／年代, English, 韩文, 日文) and a corpus of
+real usage queried with its `scripts/ref.mjs`; short-drama finds it when it is
+installed beside it. Install them the same way:
 
 ```bash
 cp -r "$(npm root -g)/@wji.ai/cli/skill/short-drama" ~/.claude/skills/short-drama
+cp -r "$(npm root -g)/@wji.ai/cli/skill/w-film-dialogue-editor" ~/.claude/skills/w-film-dialogue-editor
 cp -r "$(npm root -g)/@wji.ai/cli/skill/ads" ~/.claude/skills/ads
 cp -r "$(npm root -g)/@wji.ai/cli/skill/social-media" ~/.claude/skills/social-media
 ```

package/dist/index.js

@@ -281,6 +281,8 @@ var MIME_TYPES = {
   mp3: "audio/mpeg",
   wav: "audio/wav",
   m4a: "audio/mp4",
+  srt: "application/x-subrip",
+  vtt: "text/vtt",
   pdf: "application/pdf",
   csv: "text/csv",
   txt: "text/plain",
@@ -6347,9 +6349,10 @@ async function uploadToVod(token, file, onProgress) {
 // src/commands/backreel-episode.ts
 var MAX_EPISODES = 30;
 var VIDEO_EXTS = [".mp4", ".mov", ".m4v", ".webm"];
-var ASSET_VIDEO_MAX_BYTES = 200 * 1024 * 1024;
+var VIDEO_MAX_BYTES = 500 * 1024 * 1024;
+var subtitlesOf = (e) => (e.subtitles || []).map((s) => ({ id: s.id, lang: s.lang, ...s.label ? { label: s.label } : {} }));
 function toDto(e, order) {
-  const base = { title: e.title, order, tier: e.tier || "public" };
+  const base = { title: e.title, order, tier: e.tier || "public", subtitles: subtitlesOf(e) };
   return e.vodVid ? { ...base, vodVid: e.vodVid } : { ...base, video: idOf2(e.video) };
 }
 async function loadEpisodes(client, postId) {
@@ -6373,8 +6376,8 @@ async function resolveSource(client, opts, postId, file) {
   const ext = extname2(file).toLowerCase();
   if (!VIDEO_EXTS.includes(ext)) throw new Error(`${basename6(file)}: episodes must be ${VIDEO_EXTS.join(" / ")}`);
   const size = (await stat5(file)).size;
+  if (size > VIDEO_MAX_BYTES) throw new Error(`${basename6(file)} is over 500 MB`);
   if (opts.legacy) {
-    if (size > ASSET_VIDEO_MAX_BYTES) throw new Error(`${basename6(file)} is over 200 MB \u2014 drop --legacy to upload it to VOD`);
     info(color.dim(`Uploading ${basename6(file)} as a WJI asset\u2026`));
     const asset = await client.upload("/assets/v2/upload", file, {});
     return { video: asset.id };
@@ -6393,10 +6396,63 @@ function printEpisodes(post) {
     { header: "tier", value: (e) => e.tier },
     { header: "source", value: (e) => e.vodVid ? `vod ${e.vodVid}` : e.video ? `asset ${idOf2(e.video)}` : "-" },
     { header: "status", value: (e) => e.vodVid ? e.vodStatus || "?" : e.video ? "ready" : "" },
-    { header: "duration", value: (e) => e.durationSec ? `${Math.round(e.durationSec)}s` : "" }
+    { header: "duration", value: (e) => e.durationSec ? `${Math.round(e.durationSec)}s` : "" },
+    { header: "subs", value: (e) => (e.subtitles || []).map((s) => s.lang).join(" ") }
   ]);
 }
-var sourceOptions = (cmd) => cmd.option("--vid <vid>", "a Vid already in the Backreel VOD space").option("--asset <assetId>", "an uploaded WJI video asset (legacy path, public URL)").option("--legacy", "upload the file as a WJI asset (\u2264200 MB) instead of VOD");
+var MAX_SUBTITLES = 8;
+var SUBTITLE_EXTS = [".srt", ".vtt"];
+var LANG_RE = /^[a-z]{2,3}(-[A-Za-z0-9]{2,8}){0,3}$/;
+function guessSubtitleLang(fileName) {
+  const padded = `.${basename6(fileName).toLowerCase().replace(/\.(srt|vtt)$/, "")}.`;
+  const hints = [
+    [/(zh[-_]?(hant|tw|hk)|繁|cht)/, "zh-Hant"],
+    [/(zh[-_]?(hans|cn)|简|chs)/, "zh-Hans"],
+    [/(yue|粵|粤)/, "yue"],
+    [/[._ -](en|eng|english)[._ -]/, "en"],
+    [/[._ -](ja|jp|jpn)[._ -]/, "ja"],
+    [/[._ -](ko|kr|kor)[._ -]/, "ko"],
+    [/[._ -](th|tha)[._ -]/, "th"],
+    [/[._ -](vi|vie)[._ -]/, "vi"]
+  ];
+  return hints.find(([re]) => re.test(padded))?.[1];
+}
+function printSubtitles(episode) {
+  const subs = episode.subtitles || [];
+  if (!subs.length) return info(`Episode ${(episode.order ?? 0) + 1} has no subtitles`);
+  table(subs, [
+    { header: "lang", value: (s) => s.lang },
+    { header: "label", value: (s) => s.label || "" },
+    { header: "default", value: (s) => s === subs[0] ? color.green("\u2605") : "" },
+    { header: "id", value: (s) => color.dim(s.id) }
+  ]);
+}
+async function saveSubtitles(client, postId, episodes, i, message) {
+  const updated = await saveEpisodes(client, postId, episodes);
+  const episode = [...updated.episodes || []].sort((a, b) => (a.order ?? 0) - (b.order ?? 0))[i];
+  render(episode?.subtitles || [], () => {
+    success(message);
+    printSubtitles(episode);
+  });
+}
+function findTrack(subs, lang, i) {
+  const at = subs.findIndex((s) => s.lang.toLowerCase() === lang.toLowerCase());
+  if (at < 0) {
+    const have = subs.map((s) => s.lang).join(", ") || "none";
+    throw new Error(`Episode ${i + 1} has no ${lang} subtitles (has: ${have})`);
+  }
+  return at;
+}
+function pickRendition(renditions, want) {
+  const w = want.toLowerCase();
+  const hit = renditions.find((r) => String(r.definition || "").toLowerCase() === w) || renditions.find((r) => r.height && String(r.height) === w.replace(/p$/, ""));
+  if (!hit) {
+    const have = renditions.map((r) => r.definition || `${r.height}p`).join(", ") || "only the default";
+    throw new Error(`No ${want} rendition (available: ${have})`);
+  }
+  return hit;
+}
+var sourceOptions = (cmd) => cmd.option("--vid <vid>", "a Vid already in the Backreel VOD space").option("--asset <assetId>", "an uploaded WJI video asset (legacy path, public URL)").option("--legacy", "upload the file as a WJI asset (\u2264500 MB) instead of VOD");
 function episodeCommand(globals2) {
   const ep = new Command19("episode").aliases(["episodes", "ep"]).description("Episodes of a showcase post: upload, reorder, gate by tier, check transcoding");
   ep.command("list <postId>", { isDefault: true }).description("List the episodes with their tier, source and VOD status").action(async (postId) => {
@@ -6417,7 +6473,7 @@ function episodeCommand(globals2) {
     const at = opts.at === void 0 ? episodes.length : episodeIndex(opts.at, episodes.length + 1);
     const source = await resolveSource(client, opts, postId, file);
     if (!source) throw new Error("Give the video: a file, --vid <vid> or --asset <assetId>");
-    episodes.splice(at, 0, { title: opts.title, order: at, tier, ...source });
+    episodes.splice(at, 0, { title: opts.title, order: at, tier, subtitles: [], ...source });
     const updated = await saveEpisodes(client, postId, episodes);
     render(updated.episodes, () => {
       success(`Added episode ${at + 1} "${opts.title}" to "${updated.title}"`);
@@ -6433,12 +6489,21 @@ function episodeCommand(globals2) {
     const i = episodeIndex(n, episodes.length);
     const source = await resolveSource(client, { ...opts, title: opts.title || episodes[i].title }, postId, file);
     if (!opts.title && !opts.tier && !source) throw new Error("Nothing to change \u2014 pass --title, --tier or a new video");
-    const next = { title: opts.title || episodes[i].title, order: i, tier: opts.tier ? oneOf2(opts.tier, TIERS, "--tier") : episodes[i].tier };
+    const next = {
+      title: opts.title || episodes[i].title,
+      order: i,
+      tier: opts.tier ? oneOf2(opts.tier, TIERS, "--tier") : episodes[i].tier,
+      // a new cut of the same episode usually keeps its timing, so the tracks stay
+      subtitles: episodes[i].subtitles
+    };
     episodes[i] = source ? { ...next, ...source } : { ...episodes[i], ...next };
     const updated = await saveEpisodes(client, postId, episodes);
     render(updated.episodes, () => {
       success(`Updated episode ${i + 1}`);
       printEpisodes(updated);
+      if (source && next.subtitles.length) {
+        info(color.dim(`Kept ${next.subtitles.length} subtitle track(s) \u2014 \`wji br episode subs rm\` any that no longer line up`));
+      }
     });
   });
   ep.command("rm <postId> <n...>").description("Remove episodes (later ones move up)").option("-y, --yes", "skip confirmation").action(async (postId, ns, opts) => {
@@ -6513,18 +6578,99 @@ function episodeCommand(globals2) {
       if (rows.some((r) => r.status === "failed")) warn("A failed transcode needs a new upload: `episode set <post> <n> <file>`");
     });
   });
-  ep.command("play <postId> <n>").description("Print a short-lived play URL for episode n (as the owner)").action(async (postId, n) => {
+  ep.command("play <postId> <n>").description("Print a short-lived play URL for episode n (as the owner) \u2014 the best quality unless --quality").option("-q, --quality <q>", "a rendition such as 720p or 480p").option("--qualities", "list every rendition instead of printing one URL").action(async (postId, n, opts) => {
     const client = backreelClient(globals2);
     const post = await loadPost(client, postId);
     const i = episodeIndex(n, (post.episodes || []).length);
     const order = [...post.episodes].sort((a, b) => (a.order ?? 0) - (b.order ?? 0))[i].order ?? i;
     const play = await client.get(`${POSTS}/list/${postId}/episodes/${order}/play`);
-    render(play, (p) => {
+    const renditions = play.renditions || [];
+    if (opts.qualities) {
+      return render(renditions, (rows) => {
+        if (!rows.length) return info("Only one version (legacy asset, or VOD returned no renditions)");
+        table(rows, [
+          { header: "quality", value: (r) => r.definition || "" },
+          { header: "size", value: (r) => r.width && r.height ? `${r.width}\xD7${r.height}` : "" },
+          { header: "bitrate", value: (r) => r.bitrate ? `${Math.round(r.bitrate / 1e3)} kbps` : "" }
+        ]);
+        if (play.expiresAt) info(color.dim(`URLs expire ${play.expiresAt} \u2014 --json to get them`));
+      });
+    }
+    const url = opts.quality ? pickRendition(renditions, opts.quality).url : play.url;
+    render({ ...play, url }, (p) => {
       process.stdout.write(`${p.url}
 `);
       if (p.expiresAt) info(color.dim(`expires ${p.expiresAt}`));
     });
   });
+  const subs = ep.command("subs").aliases(["subtitles", "sub"]).description("Subtitle tracks of an episode: .srt / .vtt, one per language, \u22648, the first is the default");
+  subs.command("list <postId> <n>", { isDefault: true }).description("List episode n's subtitle tracks").action(async (postId, n) => {
+    const client = backreelClient(globals2);
+    const post = await loadPost(client, postId);
+    const i = episodeIndex(n, (post.episodes || []).length);
+    const episode = [...post.episodes].sort((a, b) => (a.order ?? 0) - (b.order ?? 0))[i];
+    render(episode.subtitles || [], () => printSubtitles(episode));
+  });
+  subs.command("add <postId> <n> <file>").description("Upload a .srt / .vtt and attach it to episode n").option("-l, --lang <lang>", "BCP 47 language: en, ja, ko, zh-Hant, zh-Hans, yue\u2026 (guessed from the file name if omitted)").option("--label <label>", "name shown in the player (default: the language's own name)").option("--default", "make it the default track (first in the list)").option("--replace", "replace the episode's existing track in that language").action(async (postId, n, file, opts) => {
+    const client = backreelClient(globals2);
+    const ext = extname2(file).toLowerCase();
+    if (!SUBTITLE_EXTS.includes(ext)) throw new Error(`${basename6(file)}: subtitles must be .srt or .vtt`);
+    if ((await stat5(file)).size > 1024 * 1024) throw new Error(`${basename6(file)} is over 1 MB`);
+    const lang = opts.lang || guessSubtitleLang(file);
+    if (!lang) throw new Error(`Can't tell the language from "${basename6(file)}" \u2014 pass --lang (e.g. en, zh-Hant)`);
+    if (!LANG_RE.test(lang)) throw new Error(`--lang ${lang} isn't a language code like en, ja or zh-Hant`);
+    const label = opts.label ? String(opts.label).trim() : void 0;
+    if (label && label.length > 40) throw new Error("--label is at most 40 characters");
+    const { post, episodes } = await loadEpisodes(client, postId);
+    const i = episodeIndex(n, episodes.length);
+    const duration = [...post.episodes].sort((x, y) => (x.order ?? 0) - (y.order ?? 0))[i]?.durationSec;
+    const list = [...episodes[i].subtitles];
+    const existing = list.findIndex((s) => s.lang.toLowerCase() === lang.toLowerCase());
+    if (existing >= 0 && !opts.replace) {
+      throw new Error(`Episode ${i + 1} already has ${lang} subtitles \u2014 add --replace to swap them`);
+    }
+    if (existing < 0 && list.length >= MAX_SUBTITLES) {
+      throw new Error(`Episode ${i + 1} already has ${MAX_SUBTITLES} subtitle tracks`);
+    }
+    const uploaded = await client.upload("/backreel/subtitle/upload", file, {});
+    const keptLabel = label ?? (existing >= 0 ? list[existing].label : void 0);
+    const track = { id: uploaded.id, lang, ...keptLabel ? { label: keptLabel } : {} };
+    if (existing >= 0) list.splice(existing, 1, track);
+    else list.push(track);
+    if (opts.default) list.unshift(...list.splice(list.indexOf(track), 1));
+    episodes[i].subtitles = list;
+    await saveSubtitles(client, postId, episodes, i, `${existing >= 0 ? "Replaced" : "Added"} ${lang} subtitles on episode ${i + 1} (${uploaded.cueCount} lines)`);
+    if (duration && uploaded.lastCueSec > duration + 2) {
+      warn(`The last line is at ${Math.round(uploaded.lastCueSec)}s but the episode is ${Math.round(duration)}s \u2014 is this the right file?`);
+    }
+  });
+  subs.command("rm <postId> <n> <lang...>").description("Remove episode n's tracks in these languages").action(async (postId, n, langs) => {
+    const client = backreelClient(globals2);
+    const { episodes } = await loadEpisodes(client, postId);
+    const i = episodeIndex(n, episodes.length);
+    const drop = new Set(langs.map((l) => findTrack(episodes[i].subtitles, l, i)));
+    episodes[i].subtitles = episodes[i].subtitles.filter((_, at) => !drop.has(at));
+    await saveSubtitles(client, postId, episodes, i, `Removed ${langs.join(", ")} from episode ${i + 1}`);
+  });
+  subs.command("default <postId> <n> <lang>").description("Make a track the default (moves it first)").action(async (postId, n, lang) => {
+    const client = backreelClient(globals2);
+    const { episodes } = await loadEpisodes(client, postId);
+    const i = episodeIndex(n, episodes.length);
+    const list = [...episodes[i].subtitles];
+    list.unshift(...list.splice(findTrack(list, lang, i), 1));
+    episodes[i].subtitles = list;
+    await saveSubtitles(client, postId, episodes, i, `${list[0].lang} is now episode ${i + 1}'s default`);
+  });
+  subs.command("label <postId> <n> <lang> [label]").description("Set the name the player shows for a track (omit it to go back to the language name)").action(async (postId, n, lang, label) => {
+    const client = backreelClient(globals2);
+    if (label && label.trim().length > 40) throw new Error("A label is at most 40 characters");
+    const { episodes } = await loadEpisodes(client, postId);
+    const i = episodeIndex(n, episodes.length);
+    const at = findTrack(episodes[i].subtitles, lang, i);
+    const { label: _old, ...rest } = episodes[i].subtitles[at];
+    episodes[i].subtitles[at] = label?.trim() ? { ...rest, label: label.trim() } : rest;
+    await saveSubtitles(client, postId, episodes, i, `Updated the ${rest.lang} label on episode ${i + 1}`);
+  });
   return ep;
 }
 
@@ -7846,7 +7992,6 @@ function backreelCommand(globals2) {
     if (!(p.credits || []).length) advice.push("no credits");
     const pending = episodes.filter((e) => e.vodVid && e.vodStatus !== "ready");
     if (pending.length) advice.push(`${pending.length} episode(s) not ready on VOD (${pending.map((e) => `#${(e.order ?? 0) + 1} ${e.vodStatus || "?"}`).join(", ")}) \u2014 \`backreel episode status\``);
-    if (p.trailerDurationSec && p.trailerDurationSec > 31) advice.push(`trailer is ${p.trailerDurationSec}s; the limit is 30s`);
     if (p.donation?.enabled && p.kind === "crowdfunding" && p.campaign?.deadline && new Date(p.campaign.deadline) < /* @__PURE__ */ new Date()) {
       advice.push("the campaign deadline has passed \u2014 donations are closed");
     }
@@ -7924,7 +8069,7 @@ function backreelCommand(globals2) {
   return br;
 }
 function postOptions(cmd) {
-  return cmd.option("--kind <kind>", KINDS.join(" | ")).option("--logline <text>", `one-line hook, max ${LOGLINE_MAX} chars; public even when the description is locked ("" clears it)`).option("--category <category>", "category").option("--project-status <status>", PROJECT_STATUSES.join(" | ")).option("--tags <tags>", "comma-separated tags (replaces the list)").option("-d, --description <text>", "description, plain text or HTML (@file / - supported)").option("--cover <assetId>", "landscape cover asset").option("--cover-portrait <assetId>", "portrait cover asset").option("--trailer <assetId>", "trailer video asset (\u226430 s)").option("--media <assetId...>", `LookBook gallery, images or videos in order (replaces it; \u2264${MEDIA_MAX}; "none" clears)`).option("--org <orgId|none>", "publish as one of your organizations; none = yourself (only the author can change it later)").option("--body <json>", "any other post fields as JSON (@file / - supported); flags win");
+  return cmd.option("--kind <kind>", KINDS.join(" | ")).option("--logline <text>", `one-line hook, max ${LOGLINE_MAX} chars; public even when the description is locked ("" clears it)`).option("--category <category>", "category").option("--project-status <status>", PROJECT_STATUSES.join(" | ")).option("--tags <tags>", "comma-separated tags (replaces the list)").option("-d, --description <text>", "description, plain text or HTML (@file / - supported)").option("--cover <assetId>", "landscape cover asset").option("--cover-portrait <assetId>", "portrait cover asset").option("--trailer <assetId>", "trailer video asset (\u2264500 MB, any length)").option("--media <assetId...>", `LookBook gallery, images or videos in order (replaces it; \u2264${MEDIA_MAX}; "none" clears)`).option("--org <orgId|none>", "publish as one of your organizations; none = yourself (only the author can change it later)").option("--body <json>", "any other post fields as JSON (@file / - supported); flags win");
 }
 async function postBody(opts) {
   const body = { ...await readJson(opts.body) || {} };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wji.ai/cli",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Command line interface for the WJI AI platform",
   "license": "UNLICENSED",
   "author": "WJI AI",

package/skill/backreel/SKILL.md

@@ -26,7 +26,7 @@ wji br list                     # your posts, drafts included
 | kind | `showcase` (episodes, trailer) or `crowdfunding` (goal, supporters) — switching wipes the other side's data | `br create --kind`, `br set --kind` |
 | title / logline / description | logline = one public line ≤200 chars; description = HTML or plain text | `br set --logline`, `-d @file.md` |
 | images | 16:9 cover, 9:16 portrait, LookBook gallery (≤9), credit photos | `br image <file> --slot … --post` |
-| trailer | a video asset ≤30 s | `wji asset upload` → `br set --trailer` |
+| trailer | a video asset, ≤500 MB, any length | `wji asset upload` → `br set --trailer` |
 | episodes | ≤30, each with its own viewer tier, hosted on VOD | `br episode …` |
 | credits | cast / crew / creative, ≤30, may link a WJI user or an NPC | `br credit …` |
 | campaign + donations | goal, offline total, deadline, donation tiers, offline supporters | `br fund …` |
@@ -97,6 +97,10 @@ wji br episode set <postId> 3 E03_v2.mp4               # replace the video
 wji br episode move <postId> 4 2
 wji br episode rm <postId> 6 -y
 wji br episode play <postId> 1        # short-lived URL to watch it yourself
+wji br episode play <postId> 1 --qualities   # renditions VOD made (1080p / 720p / …)
+wji br episode subs add <postId> 1 E01.zh-Hant.srt      # language guessed from the name
+wji br episode subs add <postId> 1 E01_en.vtt --lang en --default
+wji br episode subs <postId> 1        # list tracks; the first is the default
 ```
 
 Episodes exist on **showcase** posts only (≤30). A local file goes straight
@@ -105,7 +109,7 @@ nothing on the page can be copied and shared. Transcoding takes a few minutes;
 an episode stays `processing` until then and viewers get "still
 transcoding". Numbers on the command line are 1-based positions. Read
 [reference/episodes.md](reference/episodes.md) for the trailer, the legacy
-asset path, tier strategy and failure handling.
+asset path, tier strategy, subtitles and failure handling.
 
 ## 4. Crowdfunding and donations
 

package/skill/backreel/reference/episodes.md

@@ -6,19 +6,20 @@
 | --- | --- | --- |
 | posts | any | **showcase only** (switching to crowdfunding drops them) |
 | count | one | ≤30 |
-| length | ≤30 s (server allows +1 s) | no limit |
+| length | no limit | no limit |
+| size | ≤500 MB | ≤500 MB |
 | storage | WJI asset (public URL) | BytePlus VOD (signed URL per play, ~5 min) |
 | gated | no — always public | per episode: public / member / supporter / partner |
 
 ### Trailer
 
 ```bash
-wji asset upload trailer.mp4 --json           # ≤200 MB; duration is probed
+wji asset upload trailer.mp4 --json           # ≤500 MB, any length
 wji br set <postId> --trailer <assetId>
 ```
 
-The server rejects a trailer over 31 s when it knows the duration. Cut it to
-≤30 s first.
+There is no duration cap. The upload is rejected only when the file is over
+500 MB.
 
 ## Uploading episodes
 
@@ -33,8 +34,7 @@ transcoding), then saves the episode list with the new `vodVid`.
 
 - Formats: `.mp4`, `.mov`, `.m4v`, `.webm`. Upload the finished master;
   VOD transcodes to MP4 for playback.
-- The whole file goes up in one request — fine for episodes (hundreds of MB).
-  Multi-GB masters are better uploaded from the web, which chunks them.
+- The whole file goes up in one request. The cap is 500 MB, with no duration limit.
 - A credential lasts 15 minutes and the server allows 30 per 10 minutes —
   upload a season one episode at a time, not in parallel.
 - `--vid <vid>` attaches a video already in the space (e.g. uploaded on the
@@ -43,7 +43,7 @@ transcoding), then saves the episode list with the new `vodVid`.
 ### Legacy path
 
 `--legacy` (or `--asset <assetId>`) stores the episode as a plain WJI asset
-(≤200 MB) with a permanent public URL. It plays immediately with no
+(≤500 MB) with a permanent public URL. It plays immediately with no
 transcoding, but anyone who sees the URL can share it, and tier locks only hide
 it on the page. Use VOD for anything gated; legacy only for short public
 extras.
@@ -78,6 +78,44 @@ wji br episode rm <postId> 7 8 -y
 Removing an episode does not delete the video from VOD; re-adding it later
 with `--vid` works.
 
+## Subtitles
+
+Each episode takes up to 8 subtitle tracks, one per language, from `.srt` or
+`.vtt` files (≤1 MB). The server cleans them into plain WebVTT — italics,
+colours and `{\an8}` positioning are dropped. The **first** track is the
+default; viewers who never chose one get the track matching the site's
+language, else the default.
+
+```bash
+wji br episode subs add <postId> 2 E02.zh-Hant.srt       # zh-Hant guessed from the name
+wji br episode subs add <postId> 2 E02.srt --lang en --label "English (CC)"
+wji br episode subs add <postId> 2 E02_en_v2.srt --lang en --replace
+wji br episode subs default <postId> 2 en
+wji br episode subs label <postId> 2 en                  # back to the language name
+wji br episode subs rm <postId> 2 ja ko
+wji br episode subs <postId> 2
+```
+
+Languages are BCP 47 tags: `zh-Hant`, `zh-Hans`, `yue`, `en`, `ja`, `ko`,
+`th`, `vi`, `id`, `ms`, `es`, `pt`, `fr`, `de` (others are accepted, but the
+player shows the raw code). A file the server can't read fails at upload,
+before the episode changes. `add` warns when the last line runs past the
+episode's length — usually the wrong episode's file.
+
+Subtitles follow the episode's tier: a locked episode never serves its text.
+Replacing the video (`episode set <post> <n> new.mp4`) keeps the tracks; remove
+them if the new cut changed the timing.
+
+## Quality
+
+VOD transcodes each upload into the renditions its template defines. The
+player offers Auto plus each one; with a single rendition the menu hides.
+
+```bash
+wji br episode play <postId> 1 --qualities   # what VOD made
+wji br episode play <postId> 1 -q 720p       # URL of one rendition
+```
+
 ## Who can watch: tiers
 
 `public` anyone · `member` signed in · `supporter` has donated to this post ·

package/skill/short-drama/SKILL.md

@@ -36,8 +36,11 @@ Either way, this skill only says **what to build**; the operations doc says how
 
 **How the drama is written** comes from `{baseDir}/reference/craft-story.md` (the 短剧 method:
 brief, three phases, 分集目录, 爽点 / 钩子 libraries, the episode formula, the character bible) and
-`{baseDir}/reference/dialogue-craft.md` (lines as action, 语体 rules, the polish pass). Read the
+`{baseDir}/reference/dialogue-craft.md` (lines as action, 语体 rules, the dialogue review). Read the
 first before stage 1 and the second before stage 4. The gates encode what those two can check.
+The full dialogue method is the user's **`w-film-dialogue-editor`** skill, installed beside this
+one: its language guides and corpus are read while the lines are written and again in the required
+dialogue review after the script.
 
 **Re-read the guideline.** The 创作指引 (`render guideline`) is the drama's top rule document.
 Print it before writing any character, any episode and any storyboard, and print the speakers'
@@ -277,6 +280,7 @@ Read `{baseDir}/reference/stage-script.md`.
    writes `episodes/E0N.json` with target seconds, hook/cliff, claimed beats, the episode design
    (`function` / `task` / `change` / `hookType`, `satisfactionBeat` to set) and a `seedNote`
    (synopsis, the 爽点 to realise, register, guideline priorities, every speaker's `bible.speech`,
+   the dialogue skill's guides and per-speaker corpus queries in `dialogue`,
    ids, previous cliff, budget). Fill `scenes[].flow` — action beats and line beats alternating,
    **common actions only**, hook image inside the first 3 beats and by 15 s, a `turn: true` beat
    at least every 30 s, the 爽点 on an action (`satisfactionBeat`), cliff as the last beat; lines
@@ -286,9 +290,13 @@ Read `{baseDir}/reference/stage-script.md`.
    Delete `seedNote` when done.
 2. `validate --stage script --ep N` — duration math, line length, speakers, hook window, the
    rhythm, the design, filmability, upstream ids; the register gate only advises. Over budget: cut
-   actions first; under: add conflict, not small talk. When dialogue is the weakness, run the
-   polish pass: `render dialogue --ep N` → fill the 逐句校对表 → apply → re-validate.
-3. Sync: `render script --ep N` (the 短剧 episode format with the 创作自检 table) → `story/` dataset
+   actions first; under: add conflict, not small talk.
+3. **Dialogue review** (required, gate `dialogue-review`): `seed dialogue --ep N` → read the
+   `w-film-dialogue-editor` framework and the guide of each 语体 it prints, query the corpus per
+   speaker → fill the diagnosis, level, one row per line (issue / revised / reason / playable
+   note) and the guide's 自检 → `apply dialogue --ep N` → re-validate. A line edited later is
+   reviewed again. Details in `stage-script.md`.
+4. Sync: `render script --ep N` (the 短剧 episode format with the 创作自检 table) → `story/` dataset
    `E0N 剧本` (type `screenplay`, `viewMode=content`); bind `wji.screenplayDatasetId` with `--ep N`.
 
 ## Stage 5 — Storyboard (per episode)
@@ -307,6 +315,21 @@ prompt, alongside the camera package and each speaker's delivery.
 
 **Two people talking** (gate `two-person-framing`, sheets mode): a two-shot once, then over-the-shoulder (`ots`) for the exchange, a clean single for the punchline. A single names only its person; every look states a screen direction (`eyeline`); the sides stay locked. See `reference/craft-shots.md`.
 
+**Every picture says what it is, and what NOT to copy from it** (gate `ref-binding`, sheets mode).
+The model reads one string: a legend line that only says "a character sheet" for two different
+people is how faces get swapped, and a shot that never names its `@imageK` is a shot where the
+model invents the face or the prop. So — one legend line per picture, naming a person by age /
+hair / clothes from the character bible, the room by its name, a prop by its name; every picture
+that is **not** a person also says what may not be copied from it (*take only its light ratios,
+contrast and colour temperature — never its composition or its people*); the room is named once
+for the whole segment (`Every shot stays inside @image1 …`); every person and every prop is bound
+by its label again **inside its own shot**; no connected picture may go unused; and a segment may
+not carry more pictures than the model takes (`refs` cap). Wording patterns and the six roles:
+`reference/reference-binding.md`. A prompt that was written or edited by hand (or copied from a
+production run) can be proofread before any image is spent:
+`node {baseDir}/reference/prompt-audit.mjs --project <project> --ep 1 --segment E0N-k --prompt <file>`
+— it reports per-shot unbound people and props, indistinguishable legend lines and unused pictures.
+
 **Every cut is lit and composed in the preset's look.** Read the preset's guide
 (`{baseDir}/reference/cinematography-<preset>.md`) before the first storyboard. Name the source
 in `light.source`, stage the person against it, and choose the camera side that gives the

package/skill/short-drama/examples/night-shift/episodes/E01.json

@@ -1879,5 +1879,177 @@
     "canvasId": "",
     "shotFolderId": "",
     "displayNodes": {}
+  },
+  "dialogueReview": {
+    "level": "轻修",
+    "guides": [
+      "lang-zh-cn.md"
+    ],
+    "diagnosis": {
+      "goal": "小夏想守住别人托付的袋子；老陈想弄清袋子从哪来",
+      "conflict": "老陈步步试探，小夏用「别人的东西」挡住",
+      "subtext": "老陈认得穿雨衣的人，却不说破；小夏开始怀疑他",
+      "voice": "小夏短句、收得急；老陈慢、一字一顿，遮住名字也分得出",
+      "rhythm": "问答都短，每两三句就被动作打断，节奏成立"
+    },
+    "rows": [
+      {
+        "scene": 1,
+        "beat": 2,
+        "speaker": "C03",
+        "original": "帮我收着。明天有人来拿。",
+        "issue": "无：两个短句，交代托付又不解释",
+        "revised": "帮我收着。明天有人来拿。",
+        "reason": "",
+        "note": "压着嗓子，你不是请求，是把麻烦塞给她"
+      },
+      {
+        "scene": 1,
+        "beat": 3,
+        "speaker": "C01",
+        "original": "你是谁？我们不代收——",
+        "issue": "无：被打断的半句，正好是人已走远",
+        "revised": "你是谁？我们不代收——",
+        "reason": "",
+        "note": "追问，话到一半发现对方根本不听"
+      },
+      {
+        "scene": 2,
+        "beat": 3,
+        "speaker": "C02",
+        "original": "又是你值夜班。",
+        "issue": "无：熟人寒暄，带着她天天值夜的信息",
+        "revised": "又是你值夜班。",
+        "reason": "",
+        "note": "先吃一口再说，你在装作若无其事"
+      },
+      {
+        "scene": 2,
+        "beat": 4,
+        "speaker": "C01",
+        "original": "陈叔，你怎么天天半夜来。",
+        "issue": "无：顺口一问，眼睛在袋子上，潜台词在动作里",
+        "revised": "陈叔，你怎么天天半夜来。",
+        "reason": "",
+        "note": "嘴上问他，心思全在袋子上，别看他"
+      },
+      {
+        "scene": 2,
+        "beat": 5,
+        "speaker": "C02",
+        "original": "老了，睡不着。",
+        "issue": "无：一句带过，把真正的原因藏住",
+        "revised": "老了，睡不着。",
+        "reason": "",
+        "note": "笑着挡回去，不让她再问"
+      },
+      {
+        "scene": 2,
+        "beat": 7,
+        "speaker": "C02",
+        "original": "这是什么？",
+        "issue": "无：最短的问题，压力在筷子停住",
+        "revised": "这是什么？",
+        "reason": "",
+        "note": "声音不变，你在试探，不是好奇"
+      },
+      {
+        "scene": 2,
+        "beat": 8,
+        "speaker": "C01",
+        "original": "刚才一个人放这儿的，说明天有人来拿。",
+        "issue": "无：耸肩一句，转述托付人的话，不加解释",
+        "revised": "刚才一个人放这儿的，说明天有人来拿。",
+        "reason": "",
+        "note": "耸肩，你在敷衍，想把话题带过"
+      },
+      {
+        "scene": 2,
+        "beat": 10,
+        "speaker": "C01",
+        "original": "别人的东西。",
+        "issue": "无：三个字划界线",
+        "revised": "别人的东西。",
+        "reason": "",
+        "note": "手按住抽屉，你在拒绝，不用抬高声音"
+      },
+      {
+        "scene": 2,
+        "beat": 11,
+        "speaker": "C02",
+        "original": "小夏，那个人穿雨衣？",
+        "issue": "无：叫名字一次，用在试探的关键处",
+        "revised": "小夏，那个人穿雨衣？",
+        "reason": "",
+        "note": "很轻，你在确认一件你早就知道的事"
+      },
+      {
+        "scene": 2,
+        "beat": 13,
+        "speaker": "C02",
+        "original": "三年前，这店里丢过一样东西。",
+        "issue": "无：只给半句往事，留钩子",
+        "revised": "三年前，这店里丢过一样东西。",
+        "reason": "",
+        "note": "背对她说，你在决定要说多少"
+      },
+      {
+        "scene": 2,
+        "beat": 15,
+        "speaker": "C02",
+        "original": "别把它交给任何人。",
+        "issue": "无：命令句，第一次正眼看她",
+        "revised": "别把它交给任何人。",
+        "reason": "",
+        "note": "一字一顿，你在把责任压到她身上"
+      },
+      {
+        "scene": 2,
+        "beat": 17,
+        "speaker": "VO",
+        "original": "他怎么知道那人穿雨衣。",
+        "issue": "无：心声一句，把怀疑交给观众",
+        "revised": "他怎么知道那人穿雨衣。",
+        "reason": "",
+        "note": "压得很低，像自己不敢承认这个念头"
+      },
+      {
+        "scene": 2,
+        "beat": 19,
+        "speaker": "C02",
+        "original": "锁上门。",
+        "issue": "无：三个字收尾，命令里有恐惧",
+        "revised": "锁上门。",
+        "reason": "",
+        "note": "不回头，你在逼她立刻照做"
+      }
+    ],
+    "selfCheck": [
+      {
+        "item": "读出声：有没有播音腔的句子？",
+        "ok": true,
+        "note": "全部短句口语，无书面长句"
+      },
+      {
+        "item": "语气词密度：一句最多一个，没有粤语残留（啦／喇／啫）",
+        "ok": true,
+        "note": "几乎不用语气词"
+      },
+      {
+        "item": "网络用语符合年龄：长辈角色不用",
+        "ok": true,
+        "note": "老陈六十多岁，无网络用语"
+      },
+      {
+        "item": "地域口音只给少数角色",
+        "ok": true,
+        "note": "全员标准普通话"
+      },
+      {
+        "item": "英语夹杂符合行业身份",
+        "ok": true,
+        "note": "无英语夹杂，便利店夜班不需要"
+      }
+    ]
   }
-}
+}