@starreel/mcp 0.1.148 → 0.1.150

package/SKILL.md

@@ -42,13 +42,17 @@ create_drama → set_script(raw) → rewrite_script(AI draft, user may edit)
   → scene-images(empty-set plates = the background anchor — every shot in a scene
     anchors on its plate; skip it and each scene's FIRST shot has no background
     anchor at all, and the backdrop drifts from shot to shot)
+  → prop sheets(generate_prop_sheet per referenced prop = the prop anchor)
+  → [review_assets]
   → frames(first frames → tail_frame_plan → tail frames)
   → seams(chain_frames dry_run → confirm → run; per-shot fixes via chain_shot_from*)
-  → [review_frames] → videos → generate_tts(voiceover) → compose_episode → final cut (.mp4 link)
+  → [review_frames] → videos → generate_tts(voiceover) → [review_videos]
+  → compose_episode → final cut (.mp4 link) → review_final_cut
 ```
 
-The three `[review_*]` steps are free and **enforced** — see discipline 11.
-Nothing downstream of them runs until you have reviewed that layer.
+The five `[review_*]` steps are free and **enforced** — see discipline 11.
+Nothing downstream of them runs until you have reviewed that layer **and done
+your own QC of it** (look at the materials yourself, then `submit_qc_report`).
 
 `project_type` picks the flavor at `create_drama`: `drama` / `ad` / `mv` /
 `brand_film`. MV replaces `rewrite_script` with
@@ -525,20 +529,62 @@ content that will be rejected.
     key in an environment variable or secrets manager, never in code or logs.
     The 15-min token auto-re-exchanges; a leaked key is revoked in Settings.
 
-11. **Review every layer before you spend on the next one — free, and three of
+11. **Review every layer before you spend on the next one — free, and five of
     them are enforced.** Never run the pipeline straight through from
     `rewrite_script` to `compose_episode`. A flaw in the rewritten draft gets
     copied into character profiles, then storyboards, then frames, then video —
     by the time you see it in the final cut, the whole episode has to be redone,
     and every redo is another real charge. Reviewing costs nothing.
 
-    **Three hard gates** (the server returns `400` if you skip them):
+    **Five hard gates** (the server returns `400` if you skip them; the assets
+    and videos gates are rolled out per drama):
 
     | After you produce | Run | Before you call |
     |---|---|---|
     | the rewritten draft | `review_script` | `extract_assets`, `generate_storyboards` |
     | storyboards | `review_storyboards` | `generate_frames`, `generate_shot_frame` |
+    | portraits, sheets, scene plates, prop sheets | `review_assets` | `generate_frames`, `generate_shot_frame` (pass its token as `asset_review_token`, alongside the storyboard `review_token`) |
     | shot frames | `review_frames` | `generate_videos`, `regenerate_shot_video` |
+    | videos, voiceover, BGM | `review_videos` | `compose_episode` |
+
+    **Your own QC, on top of the platform's.** The platform can tell whether an
+    asset exists, is still generating, or was rejected; it cannot tell whether
+    it *looks right*. Every `review_*` response carries `agent_qc`: a checklist
+    for that layer and the materials to inspect (one `ref` each — script, every
+    shot, every on-screen character's portrait and sheet, every scene plate and
+    prop sheet, every frame, every video — with links). Open each one yourself
+    (download and view images, sample at least the start, middle and end of each
+    video, read text with the named tool), answer every checklist item
+    (`ok` / `issue` / `na`, with a note for each issue), list every `ref` you
+    inspected, and call `submit_qc_report`. The server only checks that the
+    report is complete — every item answered, every material listed, no "pass"
+    with issues in it — it does not judge your verdict. When
+    `agent_qc.required` is true the `review_token` is unusable until the report
+    is in, and a report with `verdict: "issues"` holds the gate exactly like a
+    platform error (only the user's explicit OK + `acknowledge_review: true`
+    lets it through). Relay your QC findings to the user verbatim. Listing a
+    `ref` you never opened is signing off on the user's money.
+
+    **Script QC is an assessment with suggestions the user decides on.** At the
+    script layer the materials include the user's own draft (`script:original`)
+    as well as the rewrite (`script`). Assess the user's draft itself first —
+    clarity of the main line, character motivation, conflict and reversals,
+    pacing, plot holes, whether it can actually be shot — then check the
+    rewrite. Every problem goes into `submit_qc_report.suggestions` with a
+    `problem` and a concrete `proposal` (plus `before` / `after` when the fix is
+    a text change); this is required at the script layer whenever you report
+    issues (`agent_qc.suggestions_required`). The response numbers them
+    (`s1`, `s2`, …). Present the assessment and each suggestion to the user and
+    let them choose: adopt some, apply all directly, or change nothing and move
+    on (`acknowledge_review: true` if the verdict was `issues`). Never choose
+    for them and never edit without asking. Edits change the script, so run
+    `review_script` and QC again afterwards.
+
+    At the asset layer, besides "is it the same person", check the character
+    sheet itself (all angles present, consistent proportions and outfit, sound
+    anatomy, single figure, no text) and whether each prop and scene plate makes
+    sense in the story — the materials carry `used_in_shots`; read those shots
+    (`get_storyboards`) and the era contract (`get_era_contract`).
 
     The per-shot tools are gated too (since 2026-10-14). A whole episode driven
     shot by shot through `generate_shot_frame` / `regenerate_shot_video` used to

package/dist/i18n/instructions.en.md

@@ -17,8 +17,9 @@ StarReel = a prepaid AI short-drama production line (script → AI rewrite → a
 · They want to edit themselves and need a per-shot handoff pack (clean footage / dialogue track / SFX / music / subtitles) → export_handoff_pack → get_handoff_toolchain → save_handoff_toolchain
 · Multilingual release → translate_subtitles → update_project_settings
 
-Pipeline order (no skipping): create_drama (set setting_brief / aspect ratio / video_engine / image_model / consistency anchors at creation — all free) → set_script → rewrite_script → ★review_script → extract_assets → quote/generate_storyboards → ★review_storyboards → character sheets + design sheets / world concept / motion templates / color script → run_precheck → quote/generate_frames (first frames only by default) → tail_frame_plan (free · which shots need a separate last frame) → quote/generate_frames (frame_type=last_frame) → ★review_frames → quote/generate_videos → audio → compose_episode → get_final_cut. Track progress with get_pipeline_status.
-Three free hard gates (skipping → 400): review_script (before extract_assets / storyboards) · review_storyboards (before frames) · review_frames (before videos); pass the review_token to downstream paid tools and relay every finding to the customer verbatim.
+Pipeline order (no skipping): create_drama (set setting_brief / aspect ratio / video_engine / image_model / consistency anchors at creation — all free) → set_script → rewrite_script → ★review_script → extract_assets → quote/generate_storyboards → ★review_storyboards → character sheets + design sheets / scene plates / prop sheets / color script → ★review_assets → run_precheck → quote/generate_frames (first frames only by default) → tail_frame_plan (free · which shots need a separate last frame) → quote/generate_frames (frame_type=last_frame) → ★review_frames → quote/generate_videos → audio → ★review_videos → compose_episode → get_final_cut → review_final_cut. Track progress with get_pipeline_status.
+Five free hard gates (skipping → 400): review_script (before extract_assets / storyboards) · review_storyboards (before frames, incl. per-shot generate_shot_frame) · review_assets (before frames; pass its token as asset_review_token) · review_frames (before videos, incl. per-shot regenerate_shot_video) · review_videos (before compose_episode); pass the review_token to downstream paid tools (batch and per-shot alike) and relay every finding to the customer verbatim.
+★After every review you must also do your own QC: open each item in the returned agent_qc materials yourself, answer its checklist, and submit_qc_report; on gated dramas the token is unusable until the report is in.
 Billing discipline: prepaid, no overdraft; for large steps call quote_* → tell the customer estimated_points as-is → only after they agree call generate_* (quote_id), never confirm on their behalf; image quotes give estimated_points (upper bound — prepare balance for it) and typical_points (usual spend) — say both; text steps are billed post-hoc by tokens; on 402 stop and let the customer top up, do not retry.
 Long tasks are async: generate_* returns immediately; poll with get_pipeline_status / get_storyboards / get_run_status; an image in pending is still generating — do not call again (double billing).
 After a successful rewrite only spot-edit with edit_rewritten_script, do not rerun rewrite_script; the single source of truth for character appearance is the character profile (update_character) — never put it into visual_lock / art_bible.

package/dist/i18n/instructions.zh-CN.md

@@ -17,8 +17,9 @@ StarReel = 预付费 AI 短剧产线(剧本 → AI 改写 → 资产 → 分镜
 · 想自己剪:要逐镜素材包(裸片 / 对白轨 / 音效 / 配乐 / 字幕) → export_handoff_pack → get_handoff_toolchain → save_handoff_toolchain
 · 多语言发行 → translate_subtitles → update_project_settings
 
-产线顺序(不跳步):create_drama(建剧即设好 setting_brief/画幅/video_engine/image_model/一致性锚,全免费) → set_script → rewrite_script → ★review_script → extract_assets → quote/generate_storyboards → ★review_storyboards → 定妆图+设定图 / 世界观图 / 动作模板 / 色彩脚本 → run_precheck → quote/generate_frames(默认只出首帧) → tail_frame_plan(免费·哪几镜要独立尾帧) → quote/generate_frames(frame_type=last_frame) → ★review_frames → quote/generate_videos → 音频 → compose_episode → get_final_cut。用 get_pipeline_status 查进度。
-三道免费硬闸(跳过 → 400):review_script(extract_assets/分镜前)· review_storyboards(出图前)· review_frames(出视频前);review_token 随下游收费工具传,findings 逐条原样告诉客户。
+产线顺序(不跳步):create_drama(建剧即设好 setting_brief/画幅/video_engine/image_model/一致性锚,全免费) → set_script → rewrite_script → ★review_script → extract_assets → quote/generate_storyboards → ★review_storyboards → 定妆图+设定图 / 场景图 / 道具图 / 色彩脚本 → ★review_assets → run_precheck → quote/generate_frames(默认只出首帧) → tail_frame_plan(免费·哪几镜要独立尾帧) → quote/generate_frames(frame_type=last_frame) → ★review_frames → quote/generate_videos → 音频 → ★review_videos → compose_episode → get_final_cut → review_final_cut。用 get_pipeline_status 查进度。
+五道免费硬闸(跳过 → 400):review_script(extract_assets/分镜前)· review_storyboards(出图前,含单镜 generate_shot_frame)· review_assets(出图前,token 作 asset_review_token)· review_frames(出视频前,含单镜 regenerate_shot_video)· review_videos(compose_episode 前);review_token 随下游收费工具传(批量与单镜工具都要),findings 逐条原样告诉客户。
+★每层审查之后你还要亲自质检:按返回的 agent_qc 逐件看素材,submit_qc_report 提交报告;灰度剧没交报告进不了下一步。
 计费纪律:预付费不透支;大额步 quote_* → 把 estimated_points 原样告诉客户 → 客户同意后 generate_*(quote_id),绝不擅自确认;出图类报价给 estimated_points(上界,按它准备余额)与 typical_points(通常花费),两个都说;文本步按 token 后付;402 就停下让客户充值,别重试。
 长任务异步:generate_* 立即返回,用 get_pipeline_status / get_storyboards / get_run_status 轮询;图片 pending = 还在生成,别重复调(重复扣费)。
 改写成功后只 edit_rewritten_script 点改,别重跑 rewrite_script;角色外观唯一真相源是人物档案(update_character),别写进 visual_lock/art_bible。