@lingjingai/scriptctl 0.63.15 → 0.63.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/scriptctl",
-  "version": "0.63.15",
+  "version": "0.63.16",
   "description": "剧本阶段统一 CLI：素材转 Script v4，并兼容 Script v3 的本地写作、精修、校验和发布。",
   "type": "module",
   "bin": {
@@ -20,7 +20,7 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22.22.0"
   },
   "scripts": {
     "build": "pnpm run clean && pnpm --filter @lingjingai/screenplay build && pnpm --filter @lingjingai/review-agent build && tsc && node scripts/bundle.mjs",
@@ -42,6 +42,7 @@
     "commander": "^12.1.0",
     "fast-json-patch": "^3.1.1",
     "fast-xml-parser": "^5.9.0",
+    "google-auth-library": "^10.9.0",
     "https-proxy-agent": "^9.1.0",
     "jszip": "^3.10.1",
     "nanoid": "^5.1.16",
@@ -73,10 +74,10 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "@ai-sdk/provider": "^4.0.4",
     "@ai-sdk/google": "^4.0.63",
+    "@ai-sdk/openai-compatible": "^3.0.48",
+    "@ai-sdk/provider": "^4.0.4",
     "@mastra/core": "^1.64.0",
-    "zod": "^4.5.4",
-    "@ai-sdk/openai-compatible": "^3.0.48"
+    "zod": "^4.5.4"
   }
 }

package/skills/scriptctl/SKILL.md

@@ -14,6 +14,8 @@ metadata:
 
 Agent 直接运行命令并阅读结果就是正常用法，默认文本输出即为给人和给 agent 看的形态。
 
+原创建稿、外部剧本导入和视频拉片均遵循 [人物身份与剧情外貌阶段](references/production-writing-standard.md#人物身份与剧情外貌阶段)：角色身份与当前外貌阶段分开表达，阶段变化及回忆按剧情绑定。
+
 ## 地址
 
 **一个字符串，读写通用**：

package/skills/scriptctl/references/ingest-workflow.md

@@ -201,3 +201,7 @@ scriptctl publish -p workspace/script.json --project-group-no 123
 - `states <actor>` 看造型弧线；`actors --counts` 看出场频次决定 `importance`。
 - 归属/造型修正：`dialogue <at> -a/-k`、`scene-ref <ep/scn> <kind:id> --state`。
 - 梗概/世界观：`synopsis` / `synopsis generate`（LLM 批量）/ `worldview`。
+
+## 外貌阶段提取与复核
+
+视频与外部剧本/小说导入共用 [人物身份与剧情外貌阶段规范](production-writing-standard.md#人物身份与剧情外貌阶段)。正文标准化保留源材料的阶段特征、时序和触发事件，资产登记分别建立当前阶段，后期描述不覆盖早期造型。文本 serial 的 `lookChanges` 在同一 scene/entity 下按正文顺序列出本场全部阶段，最后一项用于后续延续；回忆/预演和返回现实均显式选状态。编译保持本场的前后人物状态集合，不因换造型强行拆场。已缓存的已完成提取不会因新规范自动重跑或自动修好，应先核对现有产物再决定修订范围。

package/skills/scriptctl/references/production-writing-standard.md

@@ -11,6 +11,15 @@
 5. V4 同一资产在一场只引用一次，通常只引用实际造型；本场确有持久外观变化时，`state_ids` 包含变化前后的状态，正文 Action 写清变化过程。
 6. actor speaker 必须属于当前 scene；显式 speaker state 必须在该 actor 的场景状态集合中。
 
+## 人物身份与剧情外貌阶段
+
+- 人物总描述与识别锚点只记录跨阶段不变的身份特征。祛痘、胖瘦、年龄、伤病恢复、伪装和变身等承担剧情因果的可见差异写入对应 state；同一套衣服可以对应多个阶段。
+- 写作时先根据创作要求明确初始状态、触发变化的事件、变化后的状态和各自可见差异，再写场与 Action。分别使用“校服·祛痘前”“校服·祛痘后”等可辨认名称和独立完整描述。资产建模不依赖另增阶段字段，沿用现有 state / variant 与场景引用。
+- 原创作品可按明确创作要求设计外貌特征；提取或导入只能保留原片/原文提供的事实。只给出“丑”而没有具体特征时，保留该设定和信息边界，不擅自补出痤疮、体重数值或残障。面孔好看与否不能替代剧情功能，不能用肤色或族裔替代丑美设定。
+- 同一连续场有变身时，场引用包含前后状态，Action 明确触发时点和实际变化；显式 speaker state 对应发声时的阶段。回忆、照片、幻想或系统预演使用被呈现的阶段，返回现实恢复现实状态。状态集合无序，不用集合顺序表达时间。
+- `authoring compose` 的人物 `variants` 按阶段声明，`scene.actors` 可按不同 variant 列出同一人物；编译后合为一个人物引用的多个 state。使用实际 variant 名区分阶段，同一阶段新增视角或细节才沿用同名，不能让终态覆盖初始状态。
+- 审核同时检查“误拆”和“误合”：服装与持续外貌均一致才合并；只出现一次、衣服相同或同为受伤不能证明阶段相同。先检查首次亮相、变化前后及回忆/预演，再评价画面或文字呈现质量。
+
 ## Action 与对白
 
 - Action 写可见、可拍摄的行为链：明确行动者、动作、对象、空间关系和结果。
@@ -57,5 +66,5 @@
 2. 检查 Action 的真名、动作链、空间结果和可拍摄性，以及对白说话人与表演提示。
 3. 对照源素材复核对白原文、事实、因果、顺序、动作结果和状态。
 4. 运行 `validate`，确认结构与引用合法。
-5. 结合剧情身份、外观、对白归属、出现位置和跨集连续性，确认资产与状态归并准确。
+5. 结合剧情身份、外观、对白归属、出现位置和跨集连续性，确认资产与状态归并准确，并逐项核对剧情外貌阶段与变化因果。
 6. 修复后重新运行 `validate`，并报告结构、内容标准和源素材一致性。

package/skills/scriptctl/references/state-reference-repair.md

@@ -40,3 +40,11 @@ scriptctl validate -p "$S"
 ```
 
 `del` 本身会报出它新引入的校验问题；`introduced 0 issue(s)`（无此行）才算收口。
+
+## 剧情外貌阶段
+
+同一套衣服在祛痘、减重、衰老、伤病恢复或变身前后可以需要独立 state。先用原片核验变化前后与回忆/预演，记录集、场/action、时间和实际可见差异，再用 `state` 建立可复现状态、`ref --state` 回写完整集合。连续场内同时出现前后阶段时保留两个状态，在对应动作中明确变化时点和阶段；按真实时空决定场界。
+
+人物总描述与识别锚点只承载跨阶段不变的事实，肤况、面颊软组织和胖瘦写入适用状态；同名状态的补充限于同一阶段。回忆按被回忆的阶段绑定，系统预演保留预演外貌。判断重复状态需同时核对服装与外貌阶段。
+
+自动 `review` 的逐集阶段以 finding 记录已看原片的时间、地址与观察；需要全局描述/状态修改的项目交给末尾收敛阶段处理。本次运行的 wardrobe、actor-identity、asset findings 会随证据传入收敛；收敛先读回当前地址，只按达到证据准入的事实修改。`--converge-only` 没有本次逐集证据时只做结构核验，不能据此声称核实外貌阶段。