@lingjingai/scriptctl 0.51.4 → 0.53.0

package/skills/scriptctl/SKILL.md

@@ -2,8 +2,8 @@
 name: scriptctl
 description: "剧本 script.json 的本地查询、文件化批量写作、原子精修、素材 ingest 与 revision publish CLI。处理 Script v3/v4、两个 script.json、剧本资产/state、Action、场景引用或 authoring 时使用。"
 metadata:
-  version: "0.27.2"
-  scriptctl_version: "0.51.4"
+  version: "0.27.4"
+  scriptctl_version: "0.53.0"
   author: "official"
 ---
 
@@ -68,6 +68,7 @@ scriptctl summary -p "$SCRIPT"
 scriptctl episodes -p "$SCRIPT"
 scriptctl scenes -i '@ep:3' -p "$SCRIPT"
 scriptctl actions -g "台下掌声" -p "$SCRIPT"
+scriptctl actions -i '@ep:1' --time '00:30..00:45' -p "$SCRIPT"
 scriptctl actors --counts -p "$SCRIPT"
 scriptctl states actA3kP9x -p "$SCRIPT"
 scriptctl refs actA3kP9x/stB4xR8p -p "$SCRIPT"
@@ -94,6 +95,7 @@ scriptctl validate -p "$SCRIPT"
 | **按正文搜某句话定位 action**（最常用） | `scriptctl actions -g "<片段>"` |
 | 列某集所有 action（含 timestamp / speaker / 正文 /表演提示） | `scriptctl actions -i '@ep:1'` |
 | 看单条 action 正文 | `scriptctl actions -i '@ep:1/scn:1/ac:3'` |
+| 按集内时间点或闭区间看正文 | `scriptctl actions -i '@ep:1' --time '00:30..00:45'` |
 | action 多维过滤 | `scriptctl actions -i '@ep:1' -t dialogue -a <actor-id> --has speaker` |
 | 某角色出现的所有场 | `scriptctl scenes --has-actor <actor-id>`（另有 `--has-location`/`--has-prop`） |
 | **列某资产的所有 state + 状态弧线**（改造型前必查） | `scriptctl states <asset-id>` |
@@ -124,6 +126,8 @@ scriptctl replace acR8cV4n --from "旧句" --to "新句" -p "$SCRIPT"
 scriptctl parenthetical acT2fG6z --set "低声" -p "$SCRIPT"
 scriptctl parenthetical acT2fG6z --set "" -p "$SCRIPT"
 scriptctl parenthetical acT2fG6z --remove -p "$SCRIPT"
+scriptctl timestamp acT2fG6z --set 00:42.533 -p "$SCRIPT"
+scriptctl timestamp acT2fG6z --remove -p "$SCRIPT"
 scriptctl dialogue acT2fG6z -a actA3kP9x --state stB4xR8p -p "$SCRIPT"
 ```
 
@@ -171,6 +175,7 @@ V3 继续使用现有复合地址，例如：
 ```bash
 scriptctl replace ep_001/scn_003#5 --from "旧句" --to "新句"
 scriptctl emotion ep_001/scn_003#5 "低声"
+scriptctl timestamp ep_001/scn_003#5 --set 00:42
 scriptctl scene-ref ep_001/scn_003 actor:act_001 --state st_002
 ```
 

package/skills/scriptctl/references/atomic-edit-workflow.md

@@ -11,6 +11,7 @@
 scriptctl actions -g "台下掌声雷动" -p "$SCRIPT"
 scriptctl replace acR8cV4n --from "台下掌声雷动" --to "掌声骤停" \
   -p "$SCRIPT"
+scriptctl timestamp acR8cV4n --set 00:42.533 -p "$SCRIPT"
 ```
 
 V4 查询可以使用 1-based `@` 序号，但修改必须使用正式 ID。V3 查询返回原有的
@@ -33,6 +34,7 @@ scriptctl replace -i 'acR8cV4n..acT2fG6z' --from "。" --to "！" \
 ```text
 replace acR8cV4n --from "旧句" --to "新句"
 parenthetical acT2fG6z --set "低声"
+timestamp acT2fG6z --set 00:42.533
 scene-ref scnK6wT3c actA3kP9x --state default --state stB4xR8p
 ```
 

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

@@ -29,6 +29,7 @@ scriptctl ingest -s uploads/正片/
 管线（了解即可，产物都在 `workspace/`）：
 - **文本**：正文起点定位 → 切块 → 生产化归一 → 合并组装 `body.json` → 串行资产/身份/state 治理 → V3 中间校验 → 稳定 V4 身份分配 → V4 校验与生产规范 warning → `script.json`。
 - **视频**：逐集串行观看原视频并维护跨集人物、剧情和造型上下文 → 确定性治理 → V3 中间校验 → 稳定 V4 身份分配 → V4 校验与生产规范 warning → `script.json`。时间戳写入 `extend.timestamp`，逐集 `ep/*.json`、`context.json` 和身份映射支持断点续跑。
+- **用量账本**：`usage.json` 在每集/处理单元成功或失败后立即原子更新。`records` 保存实际 task/provider/model 的逐次调用、失败、重试、token 与耗时；`episodes`、`byTask[].byModel`、全局 `byModel`、`totals` 和 `timing` 都从明细聚合，可用于按模型价格精确核算成本。
 
 ### 提取与解析原则
 

package/skills/scriptctl/references/video-transcript-repair.md

@@ -26,14 +26,14 @@ V3 保持其现有地址与字段；V4 使用其正式 ID 与计划写入语义
 
 ## 2. 定位 Action 与时间点
 
-时间戳是集内固定起点，存储在 `action.extend.timestamp`，格式使用
-`M:SS` 或 `MM:SS.mmm`。它不是持续区间；一条 Action 的结束时间由下一条 Action 的
-起点或视频画面复核推断。
+时间戳是集内固定起点，存储在 `action.extend.timestamp`。输入接受 `M:SS`、`MM:SS`、
+`H:MM:SS` 及可选的 1–3 位小数，写入时规范化宽度并保留有效小数精度。它不是持续区间；
+一条 Action 的结束时间由下一条 Action 的起点或视频画面复核推断。
 
 ```bash
 scriptctl actions -i '@ep:4' -p "$SCRIPT"
 scriptctl actions -g "台词片段" -p "$SCRIPT"
-scriptctl extend <action-id> timestamp 00:42.533 -p "$SCRIPT"
+scriptctl timestamp <action-id> --set 00:42.533 -p "$SCRIPT"
 ```
 
 校时使用视频中该动作或对白真正开始的画面。保留亚秒级精度。没有视频证据时保留待复核，
@@ -51,14 +51,14 @@ scriptctl ids -k action --count 1 -p "$SCRIPT"
 
 ```text
 insert <scene-id> --action-id <new-action-id> -t action --content "她推门进屋。" --after <previous-action-id>
-extend <new-action-id> timestamp 00:42.533
+timestamp <new-action-id> --set 00:42.533
 ```
 
 对白示例：
 
 ```text
 insert <scene-id> --action-id <new-action-id> -t dialogue --content "我回来了。" -a <actor-id> --after <previous-action-id>
-extend <new-action-id> timestamp 00:42.533
+timestamp <new-action-id> --set 00:42.533
 ```
 
 人物必须已经出现在本场 scene ref 中；需要指定造型时同时传 `--speaker-state <state-id>`。
@@ -79,7 +79,7 @@ Action。使用一个 `do` 事务：
 
 ```text
 replace <first-action-id> --from "第一段" --to "第一段第二段"
-extend <first-action-id> timestamp 00:42.533
+timestamp <first-action-id> --set 00:42.533
 delete <second-action-id>
 ```