@lingjingai/scriptctl 0.74.1 → 0.75.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/scriptctl",
-  "version": "0.74.1",
+  "version": "0.75.0",
   "description": "剧本阶段统一 CLI：素材转 Script v4，并兼容 Script v3 的本地写作、精修、校验和发布。",
   "type": "module",
   "bin": {

package/skills/scriptctl/SKILL.md

@@ -58,7 +58,7 @@ acR8cV4n  → 三天后。
 ```
 
 - 左槽是锚点（v4 是稳定 `action_id`，v3 是序号）。
-- `名字(提示)：` 是对白；提示首段为 `心声` 表示 inner_thought；`→` 开头是转场。
+- `名字(提示)：` 是对白；`名字(心声/提示)：` 是 inner_thought，提示里任一段是 `心声` 都按心声读；`\` 开头强制为 action，用于正文本身以 `名字：`、`→` 或时间戳开头的动作；`→` 开头是转场。
 - **存在的字段一定显示**：speaker 状态写成 `名字·状态`，时间戳紧跟锚点。
 - 人物显示名取全局唯一的最短别名（`雷文娜指挥官` → `雷文娜`），别名回写时可解析。
 - `--plain` 去掉锚点与时间戳，**只读**：它的输出回写会被拒绝。
@@ -214,11 +214,15 @@ scriptctl review -p "$S" -s <视频目录> --converge-only --resume-log <已有
 scriptctl review -p "$S" -s <漫画ingest工作区>  # 对照 PDF 逐话审核并修正
 scriptctl create --title "…" -p "$S"          # 从零建空剧本
 scriptctl view -w <workspace>                 # 渲染或起审阅页
+scriptctl soundtrack -s <视频或目录> --episodes 1,3-5 -w <workspace>  # 听音标 BGM、音效的时间和情绪
+scriptctl soundtrack-view -w <workspace> --host <地址>  # 起网页服务，看各集汇总，点进去细看
 scriptctl checkout / status / publish         # 远端工作副本
 ```
 
 `ingest` 见 [references/ingest-workflow.md](references/ingest-workflow.md)。
 
+`soundtrack` 把结果写到 `<workspace>/soundtrack/ep_NNN.json` 和 `ep_NNN.html`，并更新汇总各集的 `index.html`，不碰 `script.json`。`soundtrack-view` 用这个目录起网页服务并一直运行：默认只有本机能打开，默认端口 8766，要在别的电脑上看就用 `--host` 传这台机器的局域网或 Tailscale 地址，这个地址上没有登录保护。单个文件视为一集，`--episodes` 指定它的集号；目录按 `--episodes` 过滤。同一来源重跑沿用已有结果，`--force` 才重新调模型。每集调用 2 次模型：第一轮只听音频定声音和起止，第二轮带清单看视频，给每段写 `emotion`、`on_screen`、`why`、`improve`，一段音乐跨几场戏时按剧情切开。`audio_emotion` 是纯听音频的情绪，`source: video` 的声音是第二轮才补的，可能按画面猜出来，要重点听。有没有和起止以人耳为准。这个任务不走豆包后备。需要 PATH 里有 ffmpeg 和 ffprobe。
+
 单个 PDF 或分话 PDF 目录自动进入漫画 ingest；`--step` 完成下一话，重跑续接已接受进度。漫画正文通过 `extend.scriptctl.source` 保存原 PDF 页码及画格/气泡/文字区域，`view` 可点击正文定位并高亮原页区域。文档模型通过 `ingest.comic-serial` 配置，内置路由为 NNYYAI `gemini-3.8-flash`，使用 `NNYYAI_API_KEY`、base64 PDF 与 `responseSchema`。
 
 `ingest` 的 Gemini 文本、结构化工具、视频和 PDF 文档请求先用配置的主模型，再按 3.8 Flash →