@starreel/mcp 0.1.38 → 0.1.40

package/SKILL.md

@@ -180,6 +180,33 @@ 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.
 
+## Script fidelity — auto two-pass rewriting
+
+`rewrite_script` routes automatically based on what the user put into
+`set_script`:
+
+- **Source is already a screenplay** (scene headers / dialogue-line structure):
+  the platform runs a two-pass fidelity rewrite. The user's dialogue is
+  byte-locked by machine gates (a missing line is rejected and redone
+  internally — you never need to babysit this), and the AI adds **no** hooks,
+  twists, or emotional beats of its own. Dramaturgy gaps it detects come back
+  in `get_script` → `dramaturgy_suggestions`; relay them to the user and let
+  the user decide. Ignoring them blocks nothing.
+- **Source is a novel or outline**: the creative single-pass rewrite runs as
+  before (the AI builds hooks and emotional beats).
+
+Overrides via `update_project_settings`: `rewrite_pipeline`
+(`auto` default / `two_pass` force fidelity / `single_forced` force creative)
+and `fidelity_enforce: 1` (hard-reject any rewrite that drops a dialogue line,
+a cast member, or an action beat).
+
+When the user complains "the AI rewrote my script off course": ① confirm the
+full original went into `set_script`; ② set `rewrite_pipeline: "two_pass"` and
+rerun `rewrite_script`; ③ once the user approves a character's look, lock it
+with `update_character` `profile_locked: 1` so later extractions can't
+overwrite appearance (appearance anchors the portrait and face lock — an
+overwrite means face drift across the whole drama).
+
 ## Failure playbook
 
 Failures surface as a human-readable `message` (MCP throws `Error(message)`;

package/dist/tools/produce.js

@@ -56,6 +56,12 @@ const WORKFLOW_HINT = '★三档执行策略(别把三档混着问客户):' +
     '★两条锁定纪律:①**画幅比例**在 create_drama 即定、drama 级锁定,之后所有出图/出视频/成片都用它、**别中途改**' +
     '(改了已生成内容画幅会不一致、漂移);不设默认 9:16。②**拆镜每镜 5-7 秒是对 AI 出视频优化的正常时长**,' +
     '别因「镜偏长」误判就重拆——generate_storyboards 会**替换整集所有分镜**、已出图白费,已有分镜后端会拦、需 confirm_replace。' +
+    '★改写保真(默认 auto 智能路由):set_script 的原稿**本身已是剧本形态**(场景头/对白行结构)时,rewrite_script 自动走两步保真——' +
+    '客户台词逐句由机器闸锁定(丢一句即内部拒收重做)、AI 绝不加戏;剧作缺口(钩子/情感锚点)不自动补,写进 get_script 返回的 dramaturgy_suggestions 由客户决定采纳。' +
+    '原稿是小说/大纲则自动走创作型改写(AI 铺钩子造情感点),两种客户各得其所、无需手动切换。' +
+    '要覆盖默认用 update_project_settings 的 rewrite_pipeline(auto/two_pass/single_forced)与 fidelity_enforce(1=保真硬闸)。' +
+    '客户说「AI 把我的剧本改偏了」时的处置:①确认完整原稿已进 set_script;②rewrite_pipeline 设 two_pass 强制保真后重跑 rewrite_script;' +
+    '③客户确认角色外观后用 update_character 的 profile_locked=1 锁定档案,防后续提取覆盖外貌导致定妆图换脸。' +
     '用 get_pipeline_status 查进度(按项目类型返回专属步骤)。';
 const ETHNICITY_CODES = [
     'east_asian', 'southeast_asian', 'south_asian', 'central_asian',
@@ -142,6 +148,8 @@ export function registerProduceTools(server, client) {
         project_type: z.enum(['drama', 'ad', 'mv', 'brand_film']).optional()
             .describe('项目类型(默认 drama)。ad=广告(改写走 ad_script_rewriter);mv=音乐(走歌词→故事→剧本子流程);brand_film=品牌微电影(默认16:9)'),
         rewrite_mode: z.enum(['standard', 'director']).optional().describe('AI改写深度:standard 或 director(导演级)'),
+        rewrite_pipeline: z.enum(['auto', 'two_pass', 'single_forced']).optional().describe('改写流水线:auto(默认,按原稿形态智能路由——剧本形态走两步保真,小说/大纲走创作改写)/two_pass(强制两步保真,客户自带成熟剧本必选)/single_forced(强制单步创作)'),
+        fidelity_enforce: z.number().int().min(0).max(1).optional().describe('1=改写保真硬闸:丢台词/丢人物/丢动作节拍直接拒收重做(客户要求逐句保留时开)'),
         director_style: z.string().optional().describe('导演风格包 key'),
         ...PROJECT_SETTINGS_FIELDS,
     }, async (args) => {
@@ -161,11 +169,12 @@ export function registerProduceTools(server, client) {
     }, async ({ episode_id, script }) => jsonResult(await client.producePut(`/episodes/${episode_id}/script`, { content: script })));
     // ---------- AI 改写 / 审阅 / 改稿 ----------
     server.tool('rewrite_script', 'AI 改写:把原始剧本改写成可拍稿(读 content → 写 script_content)。按项目类型自动选改写 agent' +
+        '★保真自动路由:原稿已是剧本形态时自动走两步保真(台词逐句机器锁定、AI 不加戏,剧作缺口进 dramaturgy_suggestions 由客户决定);原稿是小说/大纲则走创作型改写。' +
         '(广告走 ad 改写;MV 不走标准改写会被拦)。后台异步(分钟级),文本步按 token 后付、不欠费,无需报价。' +
         '完成后用 get_script 审阅、edit_rewritten_script 改稿。' +
         '★典型耗时 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('get_script', '读某一集的原始内容 + AI 改写后的可拍稿 + 改写状态 + dramaturgy_suggestions(两步保真模式下 AI 识别到但未自动补的剧作缺口——钩子/情感锚点;把它转述给客户决定采纳与否,忽略不影响产线)。免费。', { 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 改写产出的稿(人工润色/纠正);' +
         '本集还没跑过 rewrite_script 时会被 400 拒——这不是绕过改写的通道,别把自己写好的剧本直接贴进来。免费。', {
         episode_id: z.number().int().positive(),
@@ -214,6 +223,9 @@ export function registerProduceTools(server, client) {
         'fail_reason(sensitive/text_sensitive/copyright/face_mismatch/account_overdue/quota_full/authorizing/' +
         'insufficient_credits/transient)、retryable(true=可重试;false=改内容换图,重试无效)、fail_hint(人读文案)。' +
         '照 retryable 判该重试还是该改内容,别解析中文。' +
+        '★first_frame_source/last_frame_source=\'upload\' 表示该帧是**外部上传图**(绕开了身份锚/画风锚/' +
+        'best-of-N/帧审计整条质量链路)——人物·服装·画风漂移排查先看这些镜;外部图导致的漂移不是平台生成质量问题,' +
+        '修复正路是删掉外部图改走 generate_shot_frame 平台重生。' +
         '★若某镜带 reopen_pair_id:该镜首尾帧同时生成时只有一侧真的有问题、另一侧是无辜陪拒,' +
         '原样传给 generate_shot_frame 的 reopen_pair_id 参数可以只重掷有问题的那一侧(省一半算力/费用,' +
         '不会拿去生成一张这次根本没打算重做的图)。没有这个字段就按 fail_reason/retryable 走常规重试。免费。', { episode_id: z.number().int().positive() }, async ({ episode_id }) => jsonResult(await client.produceGet(`/episodes/${episode_id}/storyboards`)));
@@ -321,11 +333,16 @@ export function registerProduceTools(server, client) {
         description: z.string().optional(),
         tags: z.array(z.string()).optional(),
         aspect_ratio: z.enum(ASPECT_RATIOS).optional(),
+        // v0.1.39 — 画幅锁定闸:本剧已有分镜/生成资产后改画幅会被 400 拦(已生成内容会漂移),
+        // 确认要改必须显式带 true。通常正解是建剧时定好画幅、之后不改。
+        confirm_aspect_change: z.boolean().optional(),
         video_resolution: z.enum(VIDEO_RESOLUTIONS).optional(),
         setting_brief: z.string().optional().describe('世界观 Brief(ERA LOCK)'),
         ethnicity: z.enum(ETHNICITY_CODES).optional().describe('角色族裔锁'),
         ethnicity_note: z.string().optional(),
         rewrite_mode: z.enum(['standard', 'director']).optional(),
+        rewrite_pipeline: z.enum(['auto', 'two_pass', 'single_forced']).optional().describe('改写流水线:auto 默认智能路由/two_pass 强制两步保真/single_forced 强制单步创作'),
+        fidelity_enforce: z.number().int().min(0).max(1).optional().describe('1=改写保真硬闸(丢台词即拒)'),
         director_style: z.string().optional(),
         theme_statement: z.string().optional().describe('一句话主题'),
         subtitle_preset: z.string().optional(),
@@ -514,7 +531,8 @@ export function registerProduceTools(server, client) {
     server.tool('generate_mv_script', 'MV 项目:据歌词+故事写首集可拍剧本(写 scriptContent)。之后走标准 extract_assets → 分镜 → …。按用量后付。', { drama_id: z.number().int().positive() }, async ({ drama_id }) => jsonResult(await client.producePost(`/dramas/${drama_id}/mv/script`)));
     server.tool('get_mv', 'MV 项目:读歌词/故事/剧本当前状态。免费。', { drama_id: z.number().int().positive() }, async ({ drama_id }) => jsonResult(await client.produceGet(`/dramas/${drama_id}/mv`)));
     // ========== P1 · 资产精修(提取后改设定再出图)==========
-    server.tool('update_character', '改角色设定(名字/外貌/年龄段/族裔/性别/性格/戏份)。改后需重出定妆图/相关图。免费。', {
+    server.tool('update_character', '改角色设定(名字/外貌/年龄段/族裔/性别/性格/戏份/档案锁定)。改后需重出定妆图/相关图。免费。' +
+        '★profile_locked=1:客户确认外观后锁定档案,后续 AI 提取不再覆盖外貌/性格/描述——外貌锚着定妆图与人脸锁定,被覆盖=全片换脸;确认满意即锁,要再改先传 0 解锁。', {
         character_id: z.number().int().positive(),
         name: z.string().optional(),
         description: z.string().optional(),
@@ -524,6 +542,7 @@ export function registerProduceTools(server, client) {
         gender: z.string().optional(),
         personality: z.string().optional(),
         role: z.string().optional(),
+        profile_locked: z.number().int().min(0).max(1).optional().describe('1=锁定档案(AI 提取不再覆盖外貌/性格/描述,防定妆图换脸);0=解锁'),
     }, async ({ character_id, ...fields }) => jsonResult(await client.producePut(`/characters/${character_id}`, fields)));
     server.tool('delete_character', '删除一个角色(提取误建/合并时用)。免费。', { character_id: z.number().int().positive() }, async ({ character_id }) => jsonResult(await client.produceDelete(`/characters/${character_id}`)));
     server.tool('update_scene', '改场景设定(名字/描述/地点/时段/氛围)。免费。', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starreel/mcp",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "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",
@@ -18,7 +18,7 @@
     "build": "tsc",
     "dev": "tsx src/index.ts",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build && node scripts/release-check.mjs"
   },
   "engines": {
     "node": ">=18"

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.38",
+  "version": "0.1.40",
   "websiteUrl": "https://starreel.ai",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@starreel/mcp",
-      "version": "0.1.38",
+      "version": "0.1.40",
       "transport": { "type": "stdio" },
       "environmentVariables": [
         {