@starreel/mcp 0.1.19 → 0.1.21

package/SKILL.md

@@ -49,6 +49,26 @@ big-ticket image/video stages (portraits, storyboards, frames, videos,
 scene-images) carry a `quote_*`; the other metered steps have no quote and bill
 by usage — 402 mid-run if the balance can't cover them (never overdraft).
 
+## Execution tiers — when to just do it vs. when to ask
+
+Don't ask the user at every step. Sort work into three tiers:
+
+1. **Project settings — free; do them first; don't ask.** `project_type`,
+   `setting_brief` (worldview / ERA LOCK), `ethnicity`, aspect & resolution, and
+   the consistency anchors (`cinematography_prompt`, `art_bible`, `visual_lock`,
+   `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.
+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).
+3. **Optional boosts — metered; proactively offer them.** world concept,
+   art-bible generation, scene images, scene groups, lipsync, posters/covers,
+   SFX, BGM, subtitle translation. These lift consistency/quality but aren't
+   required to finish an episode. **Proactively tell the user they're available
+   and show a quote, then run on their OK** — neither silently skip them nor
+   auto-charge.
+
 ## The ten disciplines (hard rules)
 
 These are not suggestions. Violating them wastes the user's money or produces

package/dist/tools/produce.js

@@ -22,12 +22,16 @@ const CONFIRM_HINT = '⚠️ 批量报价确认流程:先调对应的 quote_*
 //   → quote/generate_storyboards → quote/generate_frames → quote/generate_videos
 //   → compose_episode → get_final_cut / get_export
 // 项目设定随时可 update_project_settings;剧目级资产(色彩脚本/动作模板/世界观图/美术圣经)可选增强。
-const WORKFLOW_HINT = '照完整工作流按序推进,别跳步:set_script(原始)→ rewrite_script(AI改写)→ extract_assets →' +
-    ' generate_portraits_and_sheets(定妆图+设定图·镜头一致性根锚)→ assign_voices(分配音色,否则 generate_tts 无声)→' +
-    ' storyboards → frames → videos → generate_tts → compose。' +
-    '★广告(ad)另需 add_product 建产品库 + generate_product_sheet(广告主体,不建镜头产品会漂);' +
-    'MV 走 set_mv_lyrics→generate_mv_story→generate_mv_script。' +
-    '用 get_pipeline_status 查进度——它按项目类型返回专属步骤(广告有 build_product_library,MV 有歌词/故事)。';
+const WORKFLOW_HINT = '★三档执行策略(别把三档混着问客户):' +
+    '①【基础项目设定·免费·必做地基·建剧即设好,别建空壳】project_type/setting_brief(世界观·ERA LOCK)/' +
+    'ethnicity(族裔)/画幅分辨率,以及一致性锚 cinematography_prompt(摄影DNA)·art_bible(美术圣经)·visual_lock(视觉锁定)——' +
+    '全免费,是驱动全链一致性的地基;不设好,后续所有生成都跑偏、返工重花钱。用 create_drama/update_project_settings 直接设。' +
+    '②【产线主干·按序不跳步】set_script→rewrite_script→extract_assets→generate_portraits_and_sheets(定妆图+设定图)→' +
+    'assign_voices(分配音色)→storyboards→frames→videos→generate_tts→compose;收费步照现有 quote 报价确认流程。' +
+    '广告另需 add_product+generate_product_sheet;MV 走 set_mv_lyrics→generate_mv_story→generate_mv_script。' +
+    '③【可选增强·AI 主动提示客户·报价确认才做】世界观图/美术圣经生成/视觉锁抽取/色彩脚本/动作模板/场景图/场景组/口型/海报/音效/配乐/字幕翻译——' +
+    '这些提升一致性/质量、大多收费。★AI 应主动告知客户这些可做并给报价,客户确认才跑;既不默默跳过、也不擅自扣费。' +
+    '用 get_pipeline_status 查进度(按项目类型返回专属步骤)。';
 const ETHNICITY_CODES = [
     'east_asian', 'southeast_asian', 'south_asian', 'central_asian',
     'caucasian', 'middle_eastern', 'african', 'latin_american',
@@ -87,7 +91,10 @@ export function registerProduceTools(server, client) {
     // 参数=「项目设定 / 新建项目」页对外能设的全部通用字段(不含内部产线开关)。
     // 尤其 setting_brief(世界观 Brief)与 ethnicity:它们是全链 ERA LOCK / 族裔单一真相源,
     // 建剧时设好,下游剧本改写·分镜·所有出图都据它约束——不设则按剧本语言自动推断(旧行为)。
-    server.tool('create_drama', '新建一部短剧(剧壳)。按 total_episodes 自动建对应数量的空集,返回 drama_id 与各集 episode_id。免费。', {
+    server.tool('create_drama', '新建一部短剧(剧壳)。★强烈建议建剧时一并设好基础项目设定——project_type/setting_brief(世界观·ERA LOCK)/' +
+        'ethnicity(族裔)/画幅分辨率,以及一致性锚(cinematography_prompt/art_bible/visual_lock)。这些全免费、' +
+        '是驱动全链一致性的地基;只传 title 建空壳会让后续所有生成跑偏、返工重花钱。' +
+        '按 total_episodes 自动建 N 空集,返回 drama_id 与各集 episode_id。免费。', {
         title: z.string().describe('剧名'),
         total_episodes: z.number().int().min(1).max(200).optional().describe('集数(默认 1),自动建 N 个空集'),
         genre: z.string().optional().describe('题材,如 都市/悬疑/古装'),
@@ -239,7 +246,8 @@ export function registerProduceTools(server, client) {
         return jsonResult(await client.producePut(`/dramas/${drama_id}`, body));
     });
     // ========== 项目设定页子资源(可选增强,提升一致性/风格锁)==========
-    server.tool('generate_world_concept', '生成世界观概念图(固定4格:全景/时代/主场景/色彩)。需 setting_brief ≥30字。图片步,按固定成本后付、不欠费。', { drama_id: z.number().int().positive() }, async ({ drama_id }) => jsonResult(await client.producePost(`/dramas/${drama_id}/world-concept`)));
+    server.tool('generate_world_concept', '(★可选增强·主动提示客户·报价确认才做)生成世界观概念图(固定4格:全景/时代/主场景/色彩),提升整剧视觉一致性。' +
+        'AI 应告知客户这项可做并给报价,客户确认才跑(不默默跳过、不擅自扣费)。需 setting_brief ≥30字。图片步,按固定成本后付、不欠费。', { drama_id: z.number().int().positive() }, async ({ drama_id }) => jsonResult(await client.producePost(`/dramas/${drama_id}/world-concept`)));
     server.tool('generate_art_bible', '生成美术圣经(色调/材质/气质,读角色+元数据)。文本步后付不欠费。', { drama_id: z.number().int().positive() }, async ({ drama_id }) => jsonResult(await client.producePost(`/dramas/${drama_id}/art-bible`)));
     server.tool('extract_visual_lock', '从世界观 Brief + 角色抽取「视觉锁定」规则(写 visual_lock,统一出图风格/族裔)。文本步后付不欠费。', {
         drama_id: z.number().int().positive(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starreel/mcp",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "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",