@starreel/mcp 0.1.34 → 0.1.36

package/SKILL.md

@@ -59,6 +59,14 @@ Don't ask the user at every step. Sort work into three tiers:
    `video_style_prompt`) are all free and the foundation that steers every later
    generation. Set them up front via `create_drama` / `update_project_settings`
    — don't build an empty shell, or all downstream generation drifts.
+   **Never pin a specific character's wardrobe / hair / look inside
+   `visual_lock` or `art_bible`** — those hold scene-level and world-level locks
+   only. The **single source of truth** for a character's appearance is the
+   character profile that `extract_assets` produces (edit it via
+   `update_character`). Writing appearance in both places guarantees they
+   contradict: portraits follow the profile, sheets follow the lock, and the
+   consistency gate then rejects the sheet against the portrait **every single
+   retry** — a structural dead loop that only burns money.
 2. **Pipeline backbone — metered; in order; quote-then-confirm.** portraits →
    frames → videos → TTS → compose. Spending stages follow the normal
    quote → show the user → confirm flow (discipline 2).
@@ -110,7 +118,18 @@ content that will be rejected.
    somewhere else.
 
 6. **Follow the pipeline order — do not skip.** `set_script` → `rewrite_script`
-   → `extract_assets` → portraits **+ sheets** → storyboards → frames → videos. Always
+   → `extract_assets` → portraits **+ sheets** → storyboards → frames → videos.
+   **The rewrite step is mandatory and server-enforced**: put your raw material
+   (outline, synopsis, or even a finished script you wrote) into `set_script`,
+   then run `rewrite_script` — the platform rewrite produces a shootable draft
+   that stays self-consistent with the character profiles and storyboards built
+   from it. Pasting your own script straight into `edit_rewritten_script` to
+   skip the rewrite gets a 400 (no rewritten draft exists to edit), and
+   `extract_assets` likewise requires the rewritten draft. After the rewrite,
+   make every change in the AI output's structured format: polish the draft with
+   `edit_rewritten_script`, edit character profiles with `update_character`,
+   edit shots with `update_shot` / `replace_shot_dialogue` — never rewrite the
+   whole script out-of-band or duplicate its facts into settings fields. Always
    generate frames **before** videos; skipping frames degrades video into
    anchorless t2v — wasted money. Lock character portraits **and sheets** before
    video: a portrait is one image, but **character sheets (multi-view turnarounds)

package/dist/tools/produce.js

@@ -26,7 +26,14 @@ const WORKFLOW_HINT = '★三档执行策略(别把三档混着问客户):' +
     '①【基础项目设定·免费·必做地基·建剧即设好,别建空壳】project_type/setting_brief(世界观·ERA LOCK)/' +
     'ethnicity(族裔)/画幅分辨率,以及一致性锚 cinematography_prompt(摄影DNA)·art_bible(美术圣经)·visual_lock(视觉锁定)——' +
     '全免费,是驱动全链一致性的地基;不设好,后续所有生成都跑偏、返工重花钱。用 create_drama/update_project_settings 直接设。' +
+    '★visual_lock/art_bible 只写画面级/世界级锁(镜头语言·环境·美术基调·禁入元素),**绝不为具体角色钉服装/发型/外观细节**——' +
+    '角色外观的唯一真相源是 extract_assets 产出的人物档案(要改走 update_character);两处都写必然互相矛盾,' +
+    '定妆图跟档案、设定图跟视觉锁,一致性闸按定妆图拒收 → 设定图/镜头帧**结构性连拒**,重掷多少次都过不了、纯白花钱。' +
     '②【产线主干·按序不跳步·★先分镜再建资产】set_script→rewrite_script→extract_assets→storyboards(先分镜·纯文本拆镜)→' +
+    '★剧本纪律(端点强制,绕不过):原始素材(梗概/大纲/成品稿都算)一律放 set_script,**必须经 rewrite_script 产出 AI 改写稿**——' +
+    '把自己写好的剧本直接贴进 edit_rewritten_script 绕过改写会被 400 拒(没有改写稿就没有可改的对象),extract_assets 同样要求基于改写稿。' +
+    '改写后的所有修改按 AI 产物的结构化格式做:改稿 edit_rewritten_script(润色/纠正)、人物档案 update_character、分镜 update_shot/replace_shot_dialogue——' +
+    '别回头整篇替换剧本或在设定字段里另写一套,两套真相源打架是一致性事故的头号根源。' +
     'generate_portraits_and_sheets(定妆图+设定图·分镜后建只给出场角色出图更省)→assign_voices(分配音色)→frames→videos→generate_tts→compose;' +
     '★别先建角色形象/道具设定图/动作模板再分镜——分镜是纯文本步、不依赖任何图;资产在分镜后建更省更准(动作模板本就必须分镜后)。收费步照现有 quote 报价确认流程。' +
     '广告另需 add_product+generate_product_sheet;MV 走 set_mv_lyrics→generate_mv_story→generate_mv_script。' +
@@ -147,7 +154,8 @@ export function registerProduceTools(server, client) {
     });
     // ---------- 灌本(原始内容) ----------
     server.tool('set_script', '给某一集设置**原始剧本**(content)。这是 AI 改写的输入,不是最终可拍稿。免费。' +
-        '设完调 rewrite_script 做 AI 改写。' + WORKFLOW_HINT, {
+        '梗概/大纲/自己写好的成品稿都放这里,设完**必须调 rewrite_script 做 AI 改写**——' +
+        '不能跳过改写直接把稿子贴进 edit_rewritten_script(会被拒)。' + WORKFLOW_HINT, {
         episode_id: z.number().int().positive(),
         script: z.string().min(1).describe('该集的原始剧本文本(原稿)'),
     }, async ({ episode_id, script }) => jsonResult(await client.producePut(`/episodes/${episode_id}/script`, { content: script })));
@@ -158,13 +166,14 @@ export function registerProduceTools(server, client) {
         '★典型耗时 2~4 分钟(生产实测 ≈169 秒)。**60 秒内查不到结果是正常的,不是失败**——' +
         '用 get_run_status 判断还在不在跑,别急着重发。' + WORKFLOW_HINT, { episode_id: z.number().int().positive() }, async ({ episode_id }) => jsonResult(await client.producePost(`/episodes/${episode_id}/rewrite`)));
     server.tool('get_script', '读某一集的原始内容 + AI 改写后的可拍稿 + 改写状态(供审阅、决定是否 edit_rewritten_script)。免费。', { episode_id: z.number().int().positive() }, async ({ episode_id }) => jsonResult(await client.produceGet(`/episodes/${episode_id}/script`)));
-    server.tool('edit_rewritten_script', '客户改 AI 改写后的可拍稿(写 script_content)。用于人工润色/纠正 AI 改写结果。免费。', {
+    server.tool('edit_rewritten_script', '客户改 AI 改写后的可拍稿(写 script_content)。只用于修改 AI 改写产出的稿(人工润色/纠正);' +
+        '本集还没跑过 rewrite_script 时会被 400 拒——这不是绕过改写的通道,别把自己写好的剧本直接贴进来。免费。', {
         episode_id: z.number().int().positive(),
         script: z.string().min(1).describe('改好的可拍剧本(覆盖 AI 改写稿)'),
     }, async ({ episode_id, script }) => jsonResult(await client.producePut(`/episodes/${episode_id}/rewritten-script`, { script_content: script })));
     // ---------- 提取(角色/场景/道具) ----------
     server.tool('extract_assets', '从可拍稿提取角色/场景/道具(一次写三表,是下游一致性的地基)。后台异步,文本步后付不欠费。' +
-        '前置:已 rewrite_script(或至少 set_script)。' +
+        '前置:已 rewrite_script 产出改写稿(新项目强制;人物档案从改写稿提取才与剧本、分镜自洽)。' +
         '★分钟级后台任务;用 get_run_status 判断是否还在跑,别拿 60 秒当失败判据。' + WORKFLOW_HINT, { episode_id: z.number().int().positive() }, async ({ episode_id }) => jsonResult(await client.producePost(`/episodes/${episode_id}/extract`)));
     // ---------- 完整工作流进度 ----------
     server.tool('get_pipeline_status', '查某一集完整工作流的进度(script_rewrite/提取/分镜/语音/出图/出视频/合成/配乐/终拼…各步 ' +
@@ -431,6 +440,9 @@ export function registerProduceTools(server, client) {
         in_ms: z.number().int().min(0).optional(),
         out_ms: z.number().int().min(0).optional(),
     }, async ({ storyboard_id, in_ms, out_ms }) => jsonResult(await client.producePut(`/storyboards/${storyboard_id}/trim`, { in_ms, out_ms })));
+    server.tool('recommend_trim_window', '裁剪窗口动作QC:对「声明时长<真实视频时长」的独立生成镜,按片内活动检测推荐 in/out 裁剪窗口——'
+        + '供应商产片动作常在后半段,默认从 0 秒裁会截在半动作态(如抬手没打下去)。免费零扣费。'
+        + '组模式镜不适用(组切分已内容感知,返回 applicable=false)。拿到推荐后用 trim_shot 应用。', { storyboard_id: z.number().int().positive() }, async ({ storyboard_id }) => jsonResult(await client.produceGet(`/storyboards/${storyboard_id}/trim/recommend`)));
     server.tool('update_shot', '逐镜编辑:改单个分镜的文本内容(景别/动作/台词/画面描述/运镜等)与角色绑定(character_ids)。只传要改的字段、其余不动。' +
         '**免费**(纯文本写库)。★改 dialogue 会自动失效本镜已生成的 TTS 配音与字幕(需重出 tts);' +
         '改文本不会自动重出图/视频,如需让画面跟上文本改动,改完再 regen 对应镜。用 get_storyboards 查改后结果。', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starreel/mcp",
-  "version": "0.1.34",
+  "version": "0.1.36",
   "mcpName": "ai.starreel/starreel",
   "description": "StarReel MCP server — drive the AI short-drama production pipeline (script → storyboards → frames → video → final cut) from Claude, Cursor, or any MCP client",
   "license": "MIT",

package/server.json

@@ -2,13 +2,13 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "ai.starreel/starreel",
   "description": "Turn a script into a finished, downloadable short-drama episode — via MCP or REST.",
-  "version": "0.1.34",
+  "version": "0.1.36",
   "websiteUrl": "https://starreel.ai",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@starreel/mcp",
-      "version": "0.1.34",
+      "version": "0.1.36",
       "transport": { "type": "stdio" },
       "environmentVariables": [
         {