@oh-story/dsh 0.1.13 → 0.1.15

package/lib/oh-story/skills/story-short-write/scripts/author_memory_commit.py

@@ -34,21 +34,22 @@ PENDING_MAX_BYTES = 12288
 JOURNAL_MAX_BYTES = 24576
 QUERY_MAX_BYTES = 2048
 ASSERTION_MAX_BYTES = 120  # 新建条目的断言限一句话；解释进 reason（不进 query 载荷）。
-OMITTED_IDS_MAX = 20  # omitted_ids 封顶，omitted 保留真实总数——漏项列表不许把载荷本身挤炸。
 LEGACY_ASSERTION_MAX_BYTES = 768  # 存量条目的读取上限；强化老条目不受新上限约束。
 
-# query 的输出是要原样贴进执行 agent prompt 的注入载荷，QUERY_MAX_BYTES
-# 是它在 prompt 里的注意力预算，不该放大。防「作者以为载入了、实际被静默
-# 截断挤掉」靠三层：①新建条目的断言限 ASSERTION_MAX_BYTES，从源头短（强化
-# 已有条目不受限，否则存量长断言再也无法被确认，只会派生重复条目）；②写入
-# 端按下列任务组合（与 references/author-memory-maintenance.md 的映射表同包跟版）估算
-# 最坏查询情形——全局条目＋各 scope 维度上最重的单一切片（一次查询只带一
-# 个 book/genre/workflow，不同书的条目不会同现；切片按 casefold 归并，与
-# same_scope_value 同一口径，轻重按 compact 字节＋列表分隔符算，与真实载荷
-# 同一把尺），装不下时在返回的 warnings 里点名将被略过的条目、指向「整理作
-# 者记忆」，写入本身永不因注入预算失败；③查询按 重要度→本书例外→最近更新
-# 排序装填，被略过的恒是重要度较低的条目，漏下的 ID 按同一优先级顺序报进
-# omitted_ids。
+# query 输出里的 lines（每条一行「- 断言（编号）」）是交给执行 agent 的注入
+# 载荷，QUERY_MAX_BYTES 是它在 prompt 里的注意力预算，不该放大；量的是执行者
+# 真正读到的这几行，不是 JSON 外壳（编号、kind、scope 只给主会话和脚本看）。
+# 防「作者以为载入了、实际被静默挤掉」靠三层：①新建条目的断言限
+# ASSERTION_MAX_BYTES，从源头短（强化已有条目不受限，否则存量长断言再也无法
+# 被确认，只会派生重复条目）；②写入端按下列任务组合（与
+# references/author-memory-maintenance.md 的映射表同包跟版）估算最坏查询情形——
+# 全局条目＋各 scope 维度上最重的单一切片（一次查询只带一个 book/genre/workflow，
+# 不同书的条目不会同现；切片按 casefold 归并，与 same_scope_value 同一口径，
+# 轻重按渲染后的行字节算，与真实载荷同一把尺），装不下时在返回的 warnings 里
+# 点名将被略过的条目、指向「整理作者记忆」，写入本身永不因注入预算失败；
+# ③查询按 重要度→本书例外→最近更新 排序装填，被略过的恒是重要度较低的条目，
+# 漏下的 ID 按同一优先级全数报进 omitted_ids，首句报进 omitted_summaries，
+# 供主会话用原话告诉作者哪几条没带上。
 QUERY_COMBOS: dict[str, tuple[str, ...]] = {
     "正文初稿/续写": ("prose_style", "story_design"),
     "去AI味/改写": ("prose_style",),
@@ -1086,12 +1087,19 @@ def summarize_assertion(assertion: str, *, limit: int = 14) -> str:
 
 
 def compact_item(item: dict[str, Any]) -> dict[str, Any]:
-    """query 载荷只带这四个字段——估算与真实输出必须同一把尺。"""
+    """query 的 items 只带这四个字段，给主会话和脚本按 kind/scope 判断用；
+    reason、evidence 等一律不出 store。"""
     return {"id": item["id"], "kind": item["kind"], "scope": item["scope"], "assertion": item["assertion"]}
 
 
-def compact_bytes(item: dict[str, Any]) -> int:
-    return len(json.dumps(compact_item(item), ensure_ascii=False).encode("utf-8"))
+def render_line(item: dict[str, Any]) -> str:
+    """执行者读到的一行：断言原文＋编号。注入预算量的就是这几行。"""
+    return f"- {item['assertion']}（{item['id']}）"
+
+
+def line_bytes(item: dict[str, Any]) -> int:
+    """一行在注入载荷里的占位，含行尾换行——估算与真实装填只用这一把尺。"""
+    return len((render_line(item) + "\n").encode("utf-8"))
 
 
 SCOPE_RANK = {"book": 0, "genre": 1, "workflow": 2, "global": 3}
@@ -1121,48 +1129,38 @@ def fit_items(
     *,
     extra: dict[str, Any] | None = None,
 ) -> tuple[dict[str, Any], list[str]]:
-    """按 query 输出信封把条目装进 QUERY_MAX_BYTES：装不下的跳过而不中断
-    （一条长的不挡后面的短条），漏下的 ID 报进 omitted_ids（封顶
-    OMITTED_IDS_MAX 条，omitted 保留真实总数）。返回 (结果文档, 全部漏下 ID)。
+    """按渲染后的行把条目装进 QUERY_MAX_BYTES：装不下的跳过而不中断（一条长的
+    不挡后面的短条）。返回 (结果文档, 全部漏下 ID)。
 
-    漏项恒按候选优先级排序，不按被丢弃的先后：收尾回吐的条目优先级高于循环
-    里跳过的，若按追加顺序排，omitted_ids 的封顶正好会把最该报的那条切掉。
-    `extra` 是同样计入信封的附加字段（book_revision 等）。
+    只有 lines 计入预算；items、漏项清单和 `extra`（book_revision 等）是给主会话
+    和脚本看的，不进执行者 prompt，所以漏项全数列出、不封顶，并按候选优先级
+    排序——排在前面的就是作者最该知道没带上的那几条。
     """
+    kept: list[dict[str, Any]] = []
+    dropped: list[dict[str, Any]] = []
+    used = 0
+    for item in sorted_items:
+        size = line_bytes(item)
+        if used + size > QUERY_MAX_BYTES:
+            dropped.append(item)
+            continue
+        kept.append(item)
+        used += size
     result: dict[str, Any] = {
         "ok": True,
         "command": "query",
         "initialized": True,
         "revision": revision,
-        "items": [],
-        "omitted": 0,
-        "omitted_ids": [],
+        "items": [compact_item(item) for item in kept],
+        "lines": [render_line(item) for item in kept],
+        "omitted": len(dropped),
+        "omitted_ids": [item["id"] for item in dropped],
+        "omitted_summaries": {item["id"]: summarize_assertion(item["assertion"]) for item in dropped},
+        # 组装脚本按题材×流程查好几次再合并，合并后只能按重要度重排漏项，所以把它带出来。
+        "omitted_importance": {item["id"]: item["importance"] for item in dropped},
     }
     result.update(extra or {})
-    order = {item["id"]: index for index, item in enumerate(sorted_items)}
-    kept: list[dict[str, Any]] = []
-    dropped: set[str] = set()
-
-    def ordered_omitted() -> list[str]:
-        return sorted(dropped, key=order.__getitem__)
-
-    def envelope_bytes() -> int:
-        omitted = ordered_omitted()
-        result["items"] = [compact_item(item) for item in kept]
-        result["omitted"] = len(omitted)
-        result["omitted_ids"] = omitted[:OMITTED_IDS_MAX]
-        return len((json.dumps(result, ensure_ascii=False, sort_keys=True) + "\n").encode("utf-8"))
-
-    for item in sorted_items:
-        kept.append(item)
-        if envelope_bytes() > QUERY_MAX_BYTES:
-            kept.pop()
-            dropped.add(item["id"])
-    # omitted 计数落定后包可能恰好贴边超出一两个字节，回吐条目直到装下。
-    while kept and envelope_bytes() > QUERY_MAX_BYTES:
-        dropped.add(kept.pop()["id"])
-    envelope_bytes()
-    return result, ordered_omitted()
+    return result, result["omitted_ids"]
 
 
 def build_query_result(
@@ -1170,8 +1168,8 @@ def build_query_result(
     project_state: dict[str, Any] | None,
     book_state: dict[str, Any] | None,
 ) -> tuple[dict[str, Any], list[str]]:
-    """真实查询与写入端估算共用的唯一信封构造：候选已按优先级排好，这里补上
-    book_revision 等附加字段再装填。两处信封差一个字段就是一次假阴性——回执
+    """真实查询与写入端估算共用的唯一装填入口：候选已按优先级排好，这里补上
+    book_revision 等附加字段再装填。两处装填口径一旦分叉就是假阴性——回执
     说没事、query 照样丢条。"""
     extra: dict[str, Any] = {}
     if book_state is not None:
@@ -1208,12 +1206,13 @@ def merged_query(
 
 
 def slice_weight(items: list[dict[str, Any]]) -> int:
-    """切片在真实载荷里的占位：compact 字节＋每条在 JSON 数组里的分隔符。
+    """切片在真实载荷里的占位：按渲染后的行（含换行）计。
 
-    只比 compact 字节会挑错切片——条目多、单条短的切片字节和更小，实际占位
-    却更大，于是估算判「装得下」而真实查询溢出（warnings 假阴性）。
+    必须与 fit_items 同一把尺。按 JSON 字节挑会挑错切片——scope 取值长、断言
+    短的切片 JSON 更重，渲染出的行却更轻，于是估算判「装得下」而真实查询溢出
+    （warnings 假阴性）。
     """
-    return sum(compact_bytes(item) + 2 for item in items)
+    return sum(line_bytes(item) for item in items)
 
 
 def active_of_kinds(state: dict[str, Any] | None, kinds: tuple[str, ...]) -> list[dict[str, Any]]:
@@ -1419,16 +1418,20 @@ def command_query(
     project_state = load_state(project_store(workspace))
     book_state = load_state(book_store(workspace, book_root, book)) if book_root is not None else None
     if project_state is None and book_state is None:
-        return {"ok": True, "command": "query", "initialized": False, "revision": 0, "items": [], "omitted": 0, "omitted_ids": []}
+        return {"ok": True, "command": "query", "initialized": False, "revision": 0, "items": [], "lines": [],
+                "omitted": 0, "omitted_ids": [], "omitted_summaries": {}, "omitted_importance": {}}
     requested_scopes = {
         "genre": optional_text(genre, "query.genre", max_bytes=180),
         "workflow": optional_text(workflow, "query.workflow", max_bytes=180),
     }
     # 装不下的**跳过而不中断**（一条长的不挡后面的短条），漏下的 ID 报进
     # omitted_ids：非空＝记忆超编该整理了，不是「没有更多了」。写入端的
-    # warnings 与这里共用 build_query_result 同一个信封，估算即实况。
+    # warnings 与这里共用 build_query_result 同一把尺，估算即实况。
     result, _ = merged_query(project_state, book_state, set(kinds), requested_scopes)
-    require(len((json.dumps(result, ensure_ascii=False, sort_keys=True) + "\n").encode("utf-8")) <= QUERY_MAX_BYTES, "query result exceeds its fixed byte budget")
+    require(
+        sum(len((line + "\n").encode("utf-8")) for line in result["lines"]) <= QUERY_MAX_BYTES,
+        "query lines exceed their fixed byte budget",
+    )
     return result
 
 

package/lib/types/client/canvas-viewport.d.ts

@@ -0,0 +1,31 @@
+import type { CanvasPoint } from "./production-runtime.js";
+/**
+ * Screen = world * zoom + pan. The canvas has no edges: nodes and the pan offset take any
+ * finite coordinate, so nothing can be pushed out of reach.
+ */
+export interface CanvasViewport {
+    readonly x: number;
+    readonly y: number;
+    readonly zoom: number;
+}
+export interface CanvasSize {
+    readonly width: number;
+    readonly height: number;
+}
+export declare const CANVAS_NODE_WIDTH = 180;
+export declare const CANVAS_NODE_HEIGHT = 76;
+export declare const MIN_CANVAS_ZOOM = 0.1;
+export declare const MAX_CANVAS_ZOOM = 3;
+export declare const DEFAULT_CANVAS_VIEWPORT: CanvasViewport;
+export declare function clampZoom(zoom: number): number;
+/** Scales by `factor` while the world point under `anchor` (viewport pixels) stays put. */
+export declare function zoomAt(viewport: CanvasViewport, factor: number, anchor: CanvasPoint): CanvasViewport;
+/** Wheel deltas arrive in pixels, lines or pages depending on device; one notch is ~10%. */
+export declare function wheelZoomFactor(deltaY: number, deltaMode: number): number;
+export declare function screenToWorld(viewport: CanvasViewport, point: CanvasPoint): CanvasPoint;
+/** Pans so the node's centre sits in the middle of the viewport, keeping the zoom. */
+export declare function centerOn(viewport: CanvasViewport, node: CanvasPoint, size: CanvasSize): CanvasViewport;
+export declare function nodeVisible(viewport: CanvasViewport, node: CanvasPoint, size: CanvasSize): boolean;
+/** Frames every node; a single tall column fits its width rather than shrinking to dots. */
+export declare function fitNodes(nodes: readonly CanvasPoint[], size: CanvasSize, fallback?: CanvasViewport): CanvasViewport;
+//# sourceMappingURL=canvas-viewport.d.ts.map

package/lib/types/client/canvas-viewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-viewport.d.ts","sourceRoot":"","sources":["../../../src/client/canvas-viewport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,eAAe,MAAK,CAAC;AAClC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,uBAAuB,EAAE,cAA0C,CAAC;AAGjF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,2FAA2F;AAC3F,wBAAgB,MAAM,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,cAAc,CAIpG;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,GAAG,WAAW,CAEvF;AAED,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,cAAc,CAMtG;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAIlG;AAED,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,GAAE,cAAwC,GAAG,cAAc,CAe5I"}

package/lib/types/client/drama-production-view.d.ts

@@ -1,4 +1,5 @@
 import { type DramaDocumentTarget, type DramaEpisodeProduction, type DramaProductionSection } from "./drama-production.js";
+import type { CanvasViewport } from "./canvas-viewport.js";
 import { type CanvasPoint, type ProductionJob, type ProductionMediaVersion, type ProductionQueueEntry, type ProductionSequenceItem } from "./production-runtime.js";
 interface Props {
     readonly sessionId: string;
@@ -14,7 +15,7 @@ interface Props {
     readonly manualReferences: Readonly<Record<string, readonly string[]>>;
     readonly sequence: readonly ProductionSequenceItem[];
     readonly canvas: Readonly<Record<string, CanvasPoint>>;
-    readonly zoom: number;
+    readonly viewport: CanvasViewport | undefined;
     readonly onSectionChange: (section: DramaProductionSection) => void;
     readonly onSelect: (id: string | undefined) => void;
     readonly onNavigate: (target: DramaDocumentTarget) => void;
@@ -24,7 +25,7 @@ interface Props {
     readonly onOpenMedia: (path: string) => void;
     readonly onSequenceChange: (sequence: ProductionSequenceItem[]) => void;
     readonly onCanvasChange: (canvas: Record<string, CanvasPoint>) => void;
-    readonly onZoomChange: (zoom: number) => void;
+    readonly onViewportChange: (viewport: CanvasViewport) => void;
     readonly onDispatchPrompt: (prompt: string) => Promise<void>;
     readonly onCancelTurn: () => Promise<void>;
     readonly onRemoveQueued: (itemId: string) => Promise<void>;

package/lib/types/client/drama-production-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drama-production-view.d.ts","sourceRoot":"","sources":["../../../src/client/drama-production-view.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"drama-production-view.d.ts","sourceRoot":"","sources":["../../../src/client/drama-production-view.tsx"],"names":[],"mappings":"AAIA,OAAO,EAA0B,KAAK,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEnJ,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAA6P,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,sBAAsB,EAAE,KAAK,oBAAoB,EAAE,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAE/Z,UAAU,KAAK;IACb,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACrD,QAAQ,CAAC,eAAe,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC5D,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACpE,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;IACvD,QAAQ,CAAC,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IAC1E,QAAQ,CAAC,wBAAwB,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAClF,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,sBAAsB,EAAE,KAAK,IAAI,CAAC;IACxE,QAAQ,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,IAAI,CAAC;IACvE,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;CAChC;AAiBD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,sBAAsB,EAClC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAC3C,QAAQ,EAAE,SAAS,sBAAsB,EAAE;;;;;;IAc5C;AAyFD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,2CAwF/C;AAoDD,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,kBAAkB,CAAC,GAAG;IAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAA;CAAE,2CAU/K"}

package/lib/types/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAgEpE,eAAO,MAAM,IAAI,aAAa,CAAC;AAC/B,eAAO,MAAM,MAAM,UAAwC,CAAC;AAE5D,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,OAAO;QACf,oBAAoB,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAC;YAAC,KAAK,EAAE,SAAS,CAAA;SAAE,CAAC;KAC5D;CACF;AAuzDD,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAsClD;;;;;;AAED,wBAAuC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAiEpE,eAAO,MAAM,IAAI,aAAa,CAAC;AAC/B,eAAO,MAAM,MAAM,UAAwC,CAAC;AAE5D,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,OAAO;QACf,oBAAoB,EAAE;YAAE,IAAI,EAAE,QAAQ,CAAC;YAAC,KAAK,EAAE,SAAS,CAAA;SAAE,CAAC;KAC5D;CACF;AAuzDD,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAsClD;;;;;;AAED,wBAAuC"}

package/lib/types/client/production-canvas.d.ts

@@ -0,0 +1,24 @@
+import type { DramaDocumentTarget, DramaEpisodeProduction } from "./drama-production.js";
+import type { CanvasPoint } from "./production-runtime.js";
+import { type CanvasViewport } from "./canvas-viewport.js";
+interface Props {
+    readonly production: DramaEpisodeProduction;
+    readonly selectedId: string | undefined;
+    readonly canvas: Readonly<Record<string, CanvasPoint>>;
+    /** Undefined until the creator pans or zooms this episode; the first view then frames the nodes. */
+    readonly viewport: CanvasViewport | undefined;
+    readonly onSelect: (id: string | undefined) => void;
+    readonly onNavigate: (target: DramaDocumentTarget) => void;
+    readonly onCanvasChange: (canvas: Record<string, CanvasPoint>) => void;
+    readonly onViewportChange: (viewport: CanvasViewport) => void;
+}
+interface CanvasNode {
+    readonly id: string;
+    readonly label: string;
+    readonly type: "asset" | "shot";
+    readonly initial: CanvasPoint;
+}
+export declare function canvasNodes(production: DramaEpisodeProduction): CanvasNode[];
+export declare function ProductionCanvas(props: Props): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=production-canvas.d.ts.map

package/lib/types/client/production-canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-canvas.d.ts","sourceRoot":"","sources":["../../../src/client/production-canvas.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAUL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,UAAU,KAAK;IACb,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IACvD,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,IAAI,CAAC;IACvE,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CAC/D;AAED,UAAU,UAAU;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAQD,wBAAgB,WAAW,CAAC,UAAU,EAAE,sBAAsB,GAAG,UAAU,EAAE,CAI5E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,2CA8Q5C"}

package/lib/types/skill-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-provider.d.ts","sourceRoot":"","sources":["../../src/skill-provider.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAwNhC,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAuBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAa7D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIrE;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAK9C;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAKpD;AAuDD,wBAAgB,0BAA0B,CAAC,SAAS,SAA4B,GAAG,aAAa,CAE/F;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,SAA0B,GAAG,MAAM,CAM/G;AAED,wBAAgB,wBAAwB,CAAC,SAAS,SAA0B,GAAG,aAAa,CAE3F;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,8BAA8B,CAAC,SAAS,SAAgC,GAAG,aAAa,CAEvG;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAKnD;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,wBAAgB,6BAA6B,CAAC,SAAS,SAA+B,GAAG,aAAa,CAErG"}
+{"version":3,"file":"skill-provider.d.ts","sourceRoot":"","sources":["../../src/skill-provider.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAyNhC,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAuBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAa7D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIrE;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAKhD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAK9C;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAKpD;AAuDD,wBAAgB,0BAA0B,CAAC,SAAS,SAA4B,GAAG,aAAa,CAE/F;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,SAA0B,GAAG,MAAM,CAM/G;AAED,wBAAgB,wBAAwB,CAAC,SAAS,SAA0B,GAAG,aAAa,CAE3F;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,8BAA8B,CAAC,SAAS,SAAgC,GAAG,aAAa,CAEvG;AAED,wBAAgB,0BAA0B,IAAI,MAAM,CAKnD;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,wBAAgB,6BAA6B,CAAC,SAAS,SAA+B,GAAG,aAAa,CAErG"}

package/lib/video-recap/CHANGELOG.md

@@ -10,6 +10,20 @@ All notable changes to this project are documented here.
 
 ## [Unreleased]
 
+## [0.6.2] - 2026-10-03
+
+用 dub 模式的命令（包括旧 `work_dir` 打印的续跑命令）都要补上 `--confirm-voice-rights`，否则在外发任何音频之前报错退出；只在有权使用这段视频、且说话人同意被克隆声音时确认。
+补丁号不代表可以直接升级：本版收紧了 dub 的运行条件；video-script 与 video-voiceover 写明每条远程调用发什么、发给谁、怎样关闭；没有 key 时评审不再把稿件发出去。
+
+### Changed
+
+- **dub 模式必须显式确认声音权利：`--edit-mode dub` 需要 `--confirm-voice-rights`。** dub 会把源视频音轨分窗发给 MiMo ASR，并把原说话人约 10 秒的声音当参考发给 MiMo voiceclone 克隆音色，以前只要选了 dub 就会运行，`dub.py` 被直接执行时也没有任何确认。现在 recap 在 dub 模式下缺少该参数时于建 `work_dir` 和探测视频之前报错，其他模式传入同样报错；`dub.py` 的 `--stage prepare|render` 也都必须带它，缺少时在抽取音频与任何请求之前退出并说明会外发什么。只在用户有权使用这段视频与音频、且说话人同意被克隆声音时确认。升级后在所有 dub 命令（包括旧 `work_dir` 打印的续跑命令）上补这个参数；没有环境变量形式。
+- **video-script 与 video-voiceover 的 SKILL.md 写明每条远程调用发什么、发给谁、怎样关闭。** video-script 新增 §2：`review.py` 是唯一联网的脚本，只把旁白全文、选定时间段内的画面描述与对白转写文字、背景资料和策划文件摘录发到 MiMo chat 接口（不发视频、帧图片或音频），单独使用时只在显式执行时运行，编排时用 `--no-review-narration` / `REVIEW_NARRATION=0` 关闭；`validate.py` 与 lint 只在本地运行。video-voiceover 新增 §2 逐路径列出 MiMo TTS、`--voice-ref` 克隆、Fish Audio、自托管 IndexTTS 与 dub 各自收到的内容，新增 §8 说明 dub 是实验功能、如何触发与权利要求。两份文档其后的章节号各顺延一号。
+
+### Fixed
+
+- **没有 `MIMO_API_KEY` 时 `review.py` 不再把稿件发出去。** 以前缺 key 也会把旁白与证据 POST 到 MiMo，再因 401 失败；现在在构造请求前退出，不写评审产物。编排入口的建议型评审照旧失败不阻断。
+
 ## [0.6.1] - 2026-10-03
 
 升级前先从脚本与环境里删掉本版移除的参数和环境变量（见 Removed，如 `--mimo-qc`、`validate.py --preserve-approved-text`、`cut.py --clip-padding`、`dashboard_server.py --host` 和 19 个调参变量），读 `golden_eval.json`、`mimo_qc.json`、`preflight_qc.json` 的脚本按 Removed 改读 `final_qc.json` 或对应产物。
@@ -463,7 +477,8 @@ recap feels like a recap, not captions over a clip.
   MiMo API key. Five independent skills (understanding, script, cut, voiceover, assemble)
   plus a thin orchestrator; optional 剪映 draft export.
 
-[Unreleased]: https://github.com/zenstory-ai/video-recap-skills/compare/v0.6.1...HEAD
+[Unreleased]: https://github.com/zenstory-ai/video-recap-skills/compare/v0.6.2...HEAD
+[0.6.2]: https://github.com/zenstory-ai/video-recap-skills/compare/v0.6.1...v0.6.2
 [0.6.1]: https://github.com/zenstory-ai/video-recap-skills/compare/v0.6.0...v0.6.1
 [0.6.0]: https://github.com/zenstory-ai/video-recap-skills/compare/v0.5.0...v0.6.0
 [0.5.0]: https://github.com/zenstory-ai/video-recap-skills/compare/v0.4.0...v0.5.0

package/lib/video-recap/README.en.md

@@ -396,10 +396,10 @@ The reference audio is sent to MiMo for synthesis; use it only with the voice ow
 **Dub an English video into Chinese while keeping the speaker's voice:**
 
 ```text
-Dub /path/to/english.mp4 into Chinese, keeping the original speaker's voice.
+Dub /path/to/english.mp4 into Chinese, keeping the original speaker's voice. I have the rights to this video and the speaker consents to having their voice cloned.
 ```
 
-This replaces the original speech rather than overlaying commentary; the current version supports one speaker and full-track replacement without background-music separation.
+This is experimental and replaces the original speech rather than overlaying commentary; the current version supports one speaker and full-track replacement without background-music separation. The source audio is sent to MiMo ASR for transcription and about 10 seconds of the original speaker's voice are sent to MiMo as the voice-clone reference, so the run requires `--confirm-voice-rights`: confirm only when you have the rights to the video and the speaker's consent to clone their voice.
 
 **Reuse subtitle style, voice, BGM and frame across a series:**
 

package/lib/video-recap/README.md

@@ -385,10 +385,10 @@ flowchart LR
 **英语视频译成中文并保留原说话人的声音：**
 
 ```text
-把 /path/to/english.mp4 翻译成中文配音，保留原说话人的声音。
+把 /path/to/english.mp4 翻译成中文配音，保留原说话人的声音。我有权使用这段视频，说话人同意克隆其声音。
 ```
 
-这是替换原始台词而不是叠加解说；当前支持单说话人整轨替换，不分离背景音乐。
+这是实验功能，替换原始台词而不是叠加解说；当前支持单说话人整轨替换，不分离背景音乐。源视频音频会发给 MiMo ASR 转写，原说话人约 10 秒的声音会作为参考发给 MiMo 克隆音色，所以运行需要 `--confirm-voice-rights`：只在你有权使用该视频、且说话人同意被克隆声音时确认。
 
 **同一个系列复用字幕样式、音色、BGM 与包框：**
 

package/lib/video-recap/manifest.json

@@ -2,10 +2,10 @@
   "schemaVersion": 1,
   "upstream": {
     "repository": "https://github.com/zenstory-ai/video-recap-skills.git",
-    "commit": "88af4d4f37b09510a1169e945d43d0532770a8e4",
-    "releaseVersion": "0.6.1"
+    "commit": "539168622918e058bd250c793b82f043eced31e0",
+    "releaseVersion": "0.6.2"
   },
-  "generatedAt": "2026-10-03T14:32:42.171Z",
+  "generatedAt": "2026-10-08T11:36:39.521Z",
   "skills": [
     "video-assemble",
     "video-cut",
@@ -18,8 +18,8 @@
   "files": [
     {
       "path": "CHANGELOG.md",
-      "sha256": "8b6c971f123fe170a97e7c517131fab120a2fcb5cb9bd06ebd2a795a7d26dfc3",
-      "bytes": 104618
+      "sha256": "043143b851ca8357b371bb782c838a5e6593b6018b911edacab58fa862213786",
+      "bytes": 107052
     },
     {
       "path": "LICENSE",
@@ -28,13 +28,13 @@
     },
     {
       "path": "README.en.md",
-      "sha256": "7557cd1dee6734697a26517d40a6337c2de5bcc470c17fd739c2a496fb018a24",
-      "bytes": 30570
+      "sha256": "61ca8e1d4d2ff312fb15444a6dfe1044de77ce83f47063b16db3a245a2a41d02",
+      "bytes": 30977
     },
     {
       "path": "README.md",
-      "sha256": "d70a2957ee9f1dcaa685fba9420ccd12506dc7509b2d96a647937ce535c465a4",
-      "bytes": 26510
+      "sha256": "e431bb4c4fb45c21e8d9a9e4523bcaceb14cb5be545c55fbc7af3f379252f253",
+      "bytes": 26828
     },
     {
       "path": "skills/video-assemble/SKILL.md",
@@ -398,8 +398,8 @@
     },
     {
       "path": "skills/video-recap/SKILL.md",
-      "sha256": "940ba0b6621d59f1fe30f7e598a80f96acfb700628bbdd86d852f98b32c5c38b",
-      "bytes": 16498
+      "sha256": "dcee225f8a0e2f797ef03640bf5462c91b28efb34f4e9378ed7fcad373d5df2c",
+      "bytes": 17027
     },
     {
       "path": "skills/video-recap/references/audio-routing.md",
@@ -408,8 +408,8 @@
     },
     {
       "path": "skills/video-recap/references/config-playbook.md",
-      "sha256": "45a1cbdff2c66fb0a083341355f3e051f8bb2a50a9943b1a29ba329421b1a68e",
-      "bytes": 12839
+      "sha256": "0cfc3cf66d39a9faa56d1b61e1b1fba3fefb81a825a3352174a2d0f286cbd821",
+      "bytes": 13265
     },
     {
       "path": "skills/video-recap/references/data-schema.md",
@@ -453,8 +453,8 @@
     },
     {
       "path": "skills/video-recap/scripts/recap_cli.py",
-      "sha256": "45058a6ea3cb147b79e3765d2314e184c0732acf9e08760d0bbac1aaa36c21d9",
-      "bytes": 8819
+      "sha256": "02af53cc5a70229b8b4cafac470a650c996e6c6dc8403c96bb3c77f8a57bab4a",
+      "bytes": 9088
     },
     {
       "path": "skills/video-recap/scripts/recap_inspect.py",
@@ -468,8 +468,8 @@
     },
     {
       "path": "skills/video-recap/scripts/recap_runner.py",
-      "sha256": "4643ddc62689940cf5ffff76f8f862bab10cb79a52ad392364d33172685f2ebc",
-      "bytes": 28261
+      "sha256": "63eb03a6f383785cdbd1e1af736d97bc8f763045b63903a3cf1c5513485e07cf",
+      "bytes": 28906
     },
     {
       "path": "skills/video-recap/scripts/recap_runtime.py",
@@ -548,8 +548,8 @@
     },
     {
       "path": "skills/video-script/SKILL.md",
-      "sha256": "387b8e7f57c11938c934d736ed5df564871b8f654a7d421dc2aeef73537dc3c9",
-      "bytes": 15352
+      "sha256": "7ae12d12f77e300829650789452caf867f1cab6bd4f8e002fcb3fc4394b54369",
+      "bytes": 18296
     },
     {
       "path": "skills/video-script/references/creative-editing-playbook.md",
@@ -618,8 +618,8 @@
     },
     {
       "path": "skills/video-script/scripts/review_runner.py",
-      "sha256": "da3c0b402bd11df72fad80a8a4f266e329a5b2c807f97ff53d92b67a7df4712b",
-      "bytes": 6667
+      "sha256": "653c4b17ae6c6fc283934a82cd71801b00897bc9e0b7b862c64fdfe13985cecb",
+      "bytes": 7307
     },
     {
       "path": "skills/video-script/scripts/speech_ownership.py",
@@ -758,8 +758,8 @@
     },
     {
       "path": "skills/video-voiceover/SKILL.md",
-      "sha256": "c6b407aec1310c2db4d7704bc522700461fae681cdfcafd99a533676db4192a1",
-      "bytes": 7583
+      "sha256": "2ba0c0c0ded5d561f89ed80d42b7075edc469fb820224a547e97d122ff50fdf9",
+      "bytes": 11407
     },
     {
       "path": "skills/video-voiceover/references/index-tts.md",
@@ -773,8 +773,8 @@
     },
     {
       "path": "skills/video-voiceover/scripts/dub.py",
-      "sha256": "78d494206648c6adb1637ec81a288dccc71a02beda53e646269b51a01a3ac7d3",
-      "bytes": 25292
+      "sha256": "fd6eb27baf2c16f542e177d5ab99c55761c54da16efba71f1a4760f338851dd1",
+      "bytes": 26601
     },
     {
       "path": "skills/video-voiceover/scripts/lib.py",

package/lib/video-recap/skills/video-recap/SKILL.md

@@ -210,10 +210,12 @@ python3 scripts/recap.py adopted.mp4 --work-dir packaging_work --audio-mode adop
 
 ## 5. 英译中原声复刻模式
 
-`--edit-mode dub` 把英文视频翻译为中文，并用原说话者的克隆音色替换人声；它不是在压低原声上叠加解说。
+`--edit-mode dub` 是实验功能：把英文视频翻译为中文，并用原说话者的克隆音色替换人声；它不是在压低原声上叠加解说。只在用户明确要求英译中配音时使用。
+
+dub 会把源视频音轨分窗发给 MiMo ASR 转写，并把截取的约 10 秒原说话人声音作为参考，连同每句译文发给 MiMo voiceclone。因此必须带 `--confirm-voice-rights`：先向用户确认他有权使用这段视频与音频、且说话人同意被克隆声音，确认后才加这个参数；缺少时启动即报错，不抽音频、不发请求。该参数只用于 dub，其他模式传入会报错。
 
 ```bash
-python3 scripts/recap.py <video> --edit-mode dub --work-dir <work_dir>
+python3 scripts/recap.py <video> --edit-mode dub --confirm-voice-rights --work-dir <work_dir>
 ```
 
 准备阶段会转写英文、提取一段参考音频，并写出 `dub_brief.md` 与 `dub_transcript.json`。Agent 按 `dub_brief.md` 里的翻译要求（逐句忠实、时间窗、语速）写 `dub_script.json`：

package/lib/video-recap/skills/video-recap/references/config-playbook.md

@@ -41,7 +41,7 @@ Defaults below are bundle-level defaults unless a note scopes them to a specific
 | Final loudness | `FINAL_LOUDNORM` / `TARGET_LUFS` / `LOUDNESS_LIMITER_MAX_DB` | `true` / `-14` / `6` | end-of-pipeline two-pass normalize with one constant gain, never dynamically compressed; when the mix's true peak has no room for that gain an oversampled true-peak limiter takes up to `LOUDNESS_LIMITER_MAX_DB` of peak first, and only the gain beyond that lowers the target (`0` disables the limiter). The -1 dBTP ceiling holds for the delivered AAC file: the first render aims 0.5 dB under it, the encoded file is decoded and measured, and an overshoot re-encodes only the audio lower (at most twice; still over blocks with `delivered_true_peak_over_target`). `assembly_qc.json` records the mode ffmpeg actually ran (`loudness_mode`, `loudnorm_final_pass` incl. `peak_limiter` and the measured `delivered` file) |
 | Output compression | `OUTPUT_CRF` / `OUTPUT_PRESET` / `OUTPUT_MAX_HEIGHT` | `18` / `veryfast` / `0` | x264 re-encode controls, applied whenever the final mux re-encodes (burning subtitles / masking / scaling / `FORCE_VIDEO_REENCODE`, or a source picture that is not H.264 8-bit 4:2:0 with even dimensions; the delivery is always H.264 8-bit 4:2:0 with `+faststart`: `yuv420p`, or a full-range `yuvj420p` H.264 source copied unchanged; tagged BT.709 when the source is untagged or BT.709, keeping any other declared colour tags, and an RGB source (colour space `gbr` or an RGB/paletted pixel format) is converted to BT.709 limited range; multi-source cuts whose sources disagree convert every clip's matrix and range to BT.709 limited. Dub mode (`--edit-mode dub`) copies the source picture as is). Higher `OUTPUT_CRF` = smaller file/lower quality (18≈visually lossless, 23–26 much smaller); `slow`/`slower` preset shrinks more at the same CRF; `OUTPUT_MAX_HEIGHT>0` downscales the final height (keeps aspect, even width), e.g. `720` to halve 1080p pixels. Subtitles/mask render at native res then downscale, so they stay crisp |
 | Style | `--style` | `纪录片` | freeform verbatim guidance passed into the agent brief. The agent synthesizes voice/pacing from this exact text plus evidence; it is not a fixed option list, preset, switch, or finite style taxonomy |
-| Edit mode | `EDIT_MODE` / `--edit-mode` | `full` | `full`, `cut`, or `dub`; multi-source input supports `cut` only |
+| Edit mode | `EDIT_MODE` / `--edit-mode` | `full` | `full`, `cut`, or `dub`; multi-source input supports `cut` only. Experimental `dub` also requires `--confirm-voice-rights` (the user may use the source audio and the speaker consents to voice cloning) and is rejected without it |
 | Cut target | `TARGET_DURATION` / `--target-duration` | — | e.g. `10m` (cut mode) |
 | Scene threshold | `--scene-threshold` | `0.1` | scene-cut sensitivity |
 | Shot-change-aware cut | `SCENE_CUT_SNAP` / `SCENE_CUT_SNAP_MARGIN` / `SCENE_CUT_DETECT_THRESHOLD` | on / `0.5` / `0.4` | cut mode: nudge each clip boundary off the original footage's hard cuts so the edit point doesn't flash a sliver of the adjacent shot (闪烁). source_start moves forward onto / source_end back onto any shot-change within the margin; boundaries already on a cut, or that would shrink a clip below ~0.5s, are left as-is. Set `SCENE_CUT_SNAP=0` to disable |
@@ -49,7 +49,7 @@ Defaults below are bundle-level defaults unless a note scopes them to a specific
 | Subtitle size | `SUBTITLE_FONT_SIZE` / `SUBTITLE_MARGIN_V` | `42` / `48` | look & placement |
 | Subtitle font | `SUBTITLE_FONT_NAME` / `SUBTITLE_FONT_FILE` | `Arial` / — | with a font file, burned ASS subtitles load fonts from its directory (`fontsdir`) and on-screen text overlays use it (`fontfile`); `SUBTITLE_FONT_NAME` must be that file's family name. A bound `subtitle_style` template sets both |
 | 整理 / index | `--no-consolidate` / `--consolidate-asr` | on | build the understanding index (and optionally clean ASR); use `--no-consolidate` to skip |
-| Advisory / strict narration review | `REVIEW_NARRATION` / `--review-narration` / `--no-review-narration`; strict: `REQUIRE_NARRATION_REVIEW` / `--require-narration-review` | advisory on, strict off | runs the narration review stage after validation and before TTS. Default advisory mode is fail-open; strict mode blocks TTS on review failure, parse error, or error-severity findings. In cut mode the reviewer uses `clip_plan_validated.json` to remap VLM/ASR grounding onto the output timeline |
+| Advisory / strict narration review | `REVIEW_NARRATION` / `--review-narration` / `--no-review-narration`; strict: `REQUIRE_NARRATION_REVIEW` / `--require-narration-review` | advisory on, strict off | runs the narration review stage after validation and before TTS; it sends the narration text plus text excerpts of the understanding evidence and planning files (no video, frames or audio) to the MiMo chat endpoint, so `--no-review-narration` / `REVIEW_NARRATION=0` keeps the script on this machine unless strict review is on. Default advisory mode is fail-open; strict mode blocks TTS on review failure, parse error, or error-severity findings. In cut mode the reviewer uses `clip_plan_validated.json` to remap VLM/ASR grounding onto the output timeline |
 | 剪映 export (optional) | `--export-jianying` / `EXPORT_JIANYING` | off | after rendering, also write a 剪映/JianYing draft from `timeline.json`. Decoupled — the core render never needs it |
 | 剪映 draft dir | `JIANYING_DRAFT_DIR` | work_dir | parent folder for the exported draft (point it at 剪映's drafts root to open in-app) |
 | 剪映 bundle media | `JIANYING_BUNDLE_MEDIA` / `--jianying-no-bundle-media` | **on** | copies video/audio/photo into `Resources/local/*`, uses draft-placeholder paths, and writes the type-0 material index in `draft_meta_info.json`. This makes a cloned/moved draft self-contained and is required on sandboxed macOS. Use `--jianying-no-bundle-media` only if 剪映 can reach the original paths |

package/lib/video-recap/skills/video-recap/scripts/recap_cli.py

@@ -92,6 +92,12 @@ def parse_args(argv=None):
         default=os.environ.get("EDIT_MODE", "full"),
         choices=["full", "cut", "dub"],
     )
+    core.add_argument(
+        "--confirm-voice-rights",
+        action="store_true",
+        help="dub mode only, required there: the user confirms they may use this video's audio "
+        "and clone its speaker's voice (sent to MiMo ASR and MiMo voiceclone)",
+    )
     core.add_argument(
         "--target-duration", default=os.environ.get("TARGET_DURATION") or None
     )

package/lib/video-recap/skills/video-recap/scripts/recap_runner.py

@@ -434,6 +434,8 @@ def main():
     if (args.doctor or needs_voiceover(args)) and args.tts_provider not in TTS_PROVIDERS:
         ap.error("TTS_PROVIDER/--tts-provider must be one of: " + ", ".join(TTS_PROVIDERS))
 
+    if args.edit_mode != "dub" and args.confirm_voice_rights:
+        ap.error("--confirm-voice-rights only applies to --edit-mode dub")
     if args.doctor:
         if any(
             getattr(args, field) is not None
@@ -501,6 +503,12 @@ def main():
         )
     if args.edit_mode == "dub" and args.burn_subtitles:
         ap.error("--burn-subtitles is only supported in full/cut modes; dub never burns subtitles")
+    if args.edit_mode == "dub" and not args.confirm_voice_rights:
+        ap.error(
+            "--edit-mode dub requires --confirm-voice-rights: dub sends the source audio to "
+            "MiMo ASR and clones the original speaker's voice with MiMo voiceclone; confirm only "
+            "when the user has the rights to this video and the speaker's consent to clone the voice"
+        )
     if (args.subtitle_y_top is None) != (args.subtitle_y_bot is None):
         ap.error("--subtitle-y-top and --subtitle-y-bot must be provided together")
     if args.subtitle_y_top is not None:
@@ -572,7 +580,8 @@ def _run_dub(video, work_dir, args):
     One pause: prepare (ASR + sentence-seg + reference) -> agent writes the Chinese
     translation (dub_script.json) -> render (clone TTS + full-replace mux)."""
     dub_script = work_dir / "dub_script.json"
-    dub_args = ["--video", str(video), "--work-dir", str(work_dir)]
+    # main() has already required --confirm-voice-rights for dub; forward it to both stages.
+    dub_args = ["--video", str(video), "--work-dir", str(work_dir), "--confirm-voice-rights"]
     if not dub_script.exists():
         _run("video-voiceover", "dub.py", "--stage", "prepare", *dub_args)
         _write_run_manifest(work_dir, video, args)