@lemoncat7/dsh-partner 2.8.1 → 2.8.2

package/resources/skills/video-recap-production/upstream/skills/video-assemble/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: video-assemble
+user-invocable: false
+description: >
+ 合成视频解说最终成片：把旁白音频铺到源视频上，按旁白窗口压低原声，生成 SRT / ASS 字幕并可烧录，
+ 最后做响度标准化。作为最终合成阶段使用。输入源视频、tts_meta.json 与旁白位置；
+ 输出 recap 成片和字幕。触发词：视频合成、混音、字幕、压字幕、assemble video、mux、ducking、subtitles、成片。
+---
+
+## 1. 定位
+
+本技能负责最终合成：
+
+1. 把各段旁白音频放到视频时间线上。
+2. 在旁白窗口内压低原声，支持 fixed / sidechain / zone 模式。
+3. 根据旁白位置生成 `subtitles.srt`；默认同时生成并烧录 `subtitles.ass`，`--no-burn-subtitles` 可关闭。
+4. 可选把最终响度标准化到目标 LUFS。
+
+## 2. 声音收尾契约
+
+合成阶段只实现创作决定，不凭空制造决定。Agent 在写旁白位置前，已在 `visual_audio_board.json` 为每个 beat 指定 `audio_owner`：
+
+- `original_dialogue`
+- `action_sound`
+- `ambience` / `music`
+- `silence`
+- `narration`
+
+因此，旁白间隙是主动选择，不是必须填满的空白。不要为了“更满”而加入通用 BGM、压住必须听见的台词或消除有意义的沉默。
+
+当前渲染器不解析 `visual_audio_board.json`；Agent 通过旁白时间、`overlaps_speech`、原声留白与现有混音参数落实这些决定。
+
+## 3. 输入契约
+
+- `<video>`：源视频；cut 模式下为 `edited_source.mp4`。
+- `work_dir/tts_meta.json`：默认 `narration` 模式必需；配音阶段写出的 `{segments: [...]}`。每段包含 `audio_path`、时间、`pause_after_ms`、`overlaps_speech` 和用于混音/字幕的位置。显式 `source-mix` / `adopted-packet-copy` 模式不读取它。
+- 已采用的配音使用显式 `--tts-meta` 和 `--narration-adoption`：后者由调用方独立确认文字、请求的引擎/声线和速度策略，不能从待消费元数据自动“批准”出来。完整格式与记录边界见 `references/narration-adoption.md`。
+- 已采用的完整声音底轨与逐段配音可再传 `--audio-mix-adoption`；严格格式、48 kHz 声道矩阵和双 binding 事务见 `references/explicit-audio-mix.md`。
+
+下面的 `scripts/...` 均相对于本技能目录。若执行器从仓库根目录启动，请给脚本路径加上本技能的绝对目录。
+
+## 4. 运行命令
+
+```bash
+python3 scripts/assemble.py <video> --work-dir <work_dir> \
+  [--audio-mode narration|source-mix|adopted-packet-copy] [--audio-stream-index <N>] \
+  [--tts-meta <tts_meta.json> --narration-adoption <narration_adoption.json>] \
+  [--audio-mix-adoption <audio_mix_adoption.json>] \
+  [--recap-stem <name>] [--output-dir <dir>] [--no-burn-subtitles] \
+  [--subtitle-y-top <inclusive-y> --subtitle-y-bot <exclusive-y>] \
+  [--source-video <orig.mp4>] [--export-jianying [--jianying-out <dir>]]
+```
+
+## 5. 输出契约
+
+- `recap_<stem>.mp4`：稳定的最终输出别名；每次运行覆盖更新。
+- `work_dir/output.mp4`：工作目录内成片。
+- `subtitles.srt`：旁白字幕；烧录时另有 `subtitles.ass`。
+- `timeline.json`：后端无关的多轨模型，包含视频、原声、旁白、BGM、字幕和 ducking 自动化。
+- `_placed_*.wav`：实际写入主混音的完整逐段旁白 PCM；时间线与剪映只引用这些文件。
+- `narration_input_binding.json`：旁白输入、转换、实际放置、旁白总轨和最终音轨的消费记录（路径、PCM 参数、packet 计数）。区分未采用与已绑定采用决定两种状态；不等于声线鉴定或听审。
+- `audio_mix_binding.json`：显式完整声音分支消费的画面时钟、底轨、48 kHz 配音放置、premaster、固定 master gain、最终 PCM/AAC 事实与 narration binding 路径的记录。
+- `assembly_manifest.json`：输入来源、cut 来源标识（路径、大小、mtime）、渲染设置与最终输出路径。
+- `assembly_qc.json`：旁白完整性、原声句末交接、时间线素材时长与交付质量的发布门禁。
+- 剪映草稿目录：仅 `--export-jianying` 时生成，包含 `draft_content.json`、`draft_info.json` 与 `draft_meta_info.json`。
+
+## 6. 合成规则
+
+- 音频模式的处理与冻结语义见 `references/audio-modes.md`。默认仍为 `narration`；另外两种模式必须显式选择。
+- `--audio-mix-adoption` 只与显式 `--tts-meta`、`--narration-adoption` 同时使用；它保留 `narration` 模式名，但跳过旧速度/适配、原声 handoff、环境 BGM、duck、loudnorm 和 limiter。
+- 音频按轨道混合：原声、可选 BGM 与旁白各自独立。
+- 旁白不做任何容差裁尾；温和加速后仍放不下即 `no_safe_fit`。每段 `_placed_*.wav`
+  必须与序列化后的时间线区间等长或更短，否则 `timeline_audio_mismatch` 阻断。
+- 已采用配音的 v1 合同只支持原速、禁止段内适速；不能让环境默认 1.15 倍速或旧缓存覆盖它。放不下就修订安排，不裁尾。严格运行使用新工作目录与新输出路径；输入/实际混音来源变动或 QC 失败时，不发布候选成片。没有采用文件的旧入口仍是兼容模式，不自动获得同等证据。
+- 原声在旁白结束后保持压低到下一可靠句末的 `pause_start`，只在实测停顿内渐强，
+  于 `source_restore_at` 回满；无后续锚点时保持压低到时间线末端，而不是放出半句。
+- `--export-jianying` / `EXPORT_JIANYING=1` 可把 `timeline.json` 导出为可编辑草稿。cut 模式应传 `--source-video <orig>`，让草稿引用真实原片区间。
+- 剪映导出默认把视频、音频与图片复制到 `Resources/local/{video,audio,image}`，保持草稿可搬迁；`--jianying-no-bundle-media` 只适合原路径始终可访问的情况。
+- 重叠覆盖物会拆到编号轨道；非空目标目录不会覆盖，而会创建编号兄弟目录。
+- 常速、倒放、变换、富文本、转场、蒙版、LUT、绿幕复合草稿及显式特效轨道通过 timeline v2 扩展表达。需要素材包的功能只接受调用方合法提供的离线资源。
+- 剪映草稿引用未烧录的源视频，因此原片硬字幕仍会保留，必要时在剪映内另行遮罩。
+- 字幕外观可用 `SUBTITLE_FONT_SIZE`、`SUBTITLE_MARGIN_V`、`SUBTITLE_MAX_CHARS` 等控制。
+- `SUBTITLE_Y_TOP/BOT` 把 ASS 基线放到测得的原片字幕区域，坐标为半开 `[top, bot)`；显式遮罩策略下默认 `SUBTITLE_MASK_OPACITY=0.6`，`SOURCE_SUBTITLE_MASK_TIMING=narration`。
+- 原声在旁白间隙回到 `IDLE_ORIG_VOLUME`，旁白下压到 `SPEECH_DUCKING_VOLUME`；`DUCK_FADE_SECONDS` 控制过渡。还可配置 `DUCKING_MODE`、`ZONE_DUCKING_VOLUME`、`FINAL_LOUDNORM` 与 `TARGET_LUFS`。
+- 可通过 `BGM_PATH` 指定 BGM；它会循环到成片长度，并按 `BGM_VOLUME` / `BGM_DUCKING_VOLUME` 混音。不要在没有创作依据时设置通用 BGM。
+- 烧录字幕需要带 `subtitles` / libass 的 ffmpeg；合成阶段会预检并在缺失时明确失败。
+- 原声留白中的对白字幕优先读取 Agent 校对的 `original_subtitles.json`；否则保守映射 ASR。只有遮罩覆盖留白或用户字幕明确要求替换时才烧录原声对白，并用 `「」` 与旁白区分。
+
+### 按原片区间准备声音，而不是整体压低旧成片
+
+已有多段原声取舍和独立 BGM 决定时，先用 `references/source-score.md` 的独立
+`source_score.py` 从原片声音流按精确帧区间重建原声轨、音乐轨及两者之和；它只输出
+声音底轨和来源回执。要与逐段已采用配音合成，再由调用方提供 `references/explicit-audio-mix.md`
+的严格 adoption；不要将底轨塞入旧入口自动 duck，也不要从含旧解说的成片取整条声音冒充干净原声。
+
+## 7. 字幕与可选包装
+
+先锁定画面、剪点、旁白和混音，再投入字幕动画或边框包装；字幕样式不能掩盖叙事、剪点或声音问题。
+普通交付优先使用现有 ASS 路径；只有用户需要逐 cue 排版、动画或透明图层时，才用项目级代码渲染器，
+并按 `references/foreground-compose.md` 把它生成的 RGBA 序列叠到锁定母版。包装顺序与样帧抽检清单见
+`references/packaging.md`。
+
+## 8. 能力边界
+
+- 不生成旁白文字，不合成 TTS，不重新转写视频。
+- 字幕烧录默认开启；关闭时不会重编码绘制字幕区域。
+
+显式输出轴字幕轨的独立合同、完整替换语义和当前边界见 `references/subtitle-track.md`。
+
+画面回原片重建后，若需保留另一文件中的已采用完整混音，先按
+`references/pair-media.md` 显式配对独立画面与音轨。配对只复制流，不补字幕或片名卡；
+后续字幕轨必须重新绑定配对后的容器与 `a:0`，不能继续沿用旧版本身份。

package/resources/skills/video-recap-production/upstream/skills/video-assemble/references/audio-modes.md

@@ -0,0 +1,63 @@
+# Assembly audio modes
+
+`assemble.py` keeps `narration` as its API and CLI default. Non-narration
+behavior is opt-in with `--audio-mode`; `--audio-stream-index N` is the
+zero-based audio ordinal used by FFmpeg's `0:a:N` selector.
+
+## `narration`
+
+- Requires non-empty `tts_meta.json` segments, as before.
+- Builds/places narration WAV, performs source ducking and optional BGM mix,
+  then applies the configured final loudness/limiter stage and AAC encoding.
+- Missing source audio may use the existing synthetic-silence fallback.
+- With the additional strict `--audio-mix-adoption`, narration instead consumes an
+  adopted prepared bed plus complete direct-to-48-kHz narration placements. This is
+  still narration mode, but it bypasses ambient BGM, ducking, speed/fit, loudnorm, and
+  limiter operations. See `explicit-audio-mix.md`.
+
+## `source-mix`
+
+- Does not read or require `tts_meta.json` and never creates narration audio.
+- Uses the selected input audio stream, applies `IDLE_ORIG_VOLUME`, mixes a
+  declared `BGM_PATH` when present, and runs the configured final
+  loudness/limiter stage before AAC encoding.
+- A declared but missing `BGM_PATH` is an error in this new mode (the legacy
+  narration-mode warn-and-skip behavior remains unchanged).
+- This is a processed mix, not frozen audio. `assembly_qc.json` reports the
+  operations that actually ran.
+
+## `adopted-packet-copy`
+
+- First implementation supports a selected AAC stream from `<video>` only.
+- Rejects TTS segments, explicit `--tts-meta`, any configured `BGM_PATH`, a
+  missing/wrong stream, unsupported codec, or audio/picture interval mismatch.
+- Maps that stream with `-c:a copy`. It does not build narration, mix, duck,
+  normalize, limit, resample, change tempo, or add silence.
+- It deliberately omits `-t` and `-shortest`, preserving AAC priming and tail
+  packets. After rendering, the output is probed and compared with the input:
+  decoder parameters, packet count, total payload bytes, the packet-clock span,
+  and every packet's size and PTS/DTS/duration converted to rational time must
+  match. Packet side data also must match, including AAC skip-sample/
+  discard-padding values and their reason fields.
+- QC/manifest evidence records selected stream, absolute stream index, codec,
+  time base, sample rate, channels/layout, packet count, payload bytes, packet
+  details, and actual operation flags.
+
+The adopted-copy settings payload excludes narration/mix/loudness defaults, so
+irrelevant ambient settings do not invalidate a frozen-audio render. Video
+filters and video re-encoding remain allowed; packet verification must still
+pass afterward.
+
+These modes do not create a commercial quality profile, automatic speech
+alignment, listening approval, or release approval. An explicit subtitle track
+is only a version/media-bound timing declaration; its evidence labels and
+`NOT_CHECKED` acoustic/listening status remain authoritative.
+Matching packets and decoder parameters show the encoded audio was copied; they
+do not prove perceptual quality or that a person listened to the result.
+
+`timeline.json` represents either non-narration mode as one complete clip from
+the current input video and records the selected stream. Adopted copy uses gain
+1 with no automation. Source-mix records processed/non-frozen delivery and is
+not claimed to be reconstructable by an editor. The optional JianYing exporter
+currently supports only selected stream 0; requesting export with another
+stream fails instead of silently substituting the default stream.

package/resources/skills/video-recap-production/upstream/skills/video-assemble/references/explicit-audio-mix.md

@@ -0,0 +1,75 @@
+# Explicit adopted full-sound mix
+
+Use this path only when the picture, a completed `prepared_bed_receipt`, an exact
+narration adoption, narration placements/gains, and one fixed master gain have already
+been independently selected. It is still `audio_mode=narration`, but it bypasses the
+legacy narration timing, ducking, ambient BGM, loudness-normalization, and limiter path.
+
+```bash
+python3 scripts/assemble.py picture.mp4 --work-dir NEW_WORK \
+  --tts-meta /local/tts_meta.json \
+  --narration-adoption /local/narration_adoption.json \
+  --audio-mix-adoption /local/audio_mix_adoption.json
+```
+
+All strict output paths, including the CLI delivery alias, must be new. The CLI copies
+to a hidden delivery stage and creates the alias with an exclusive atomic link, so a
+concurrent or existing file is never overwritten.
+
+## Adoption schema v1
+
+```json
+{
+  "artifact": "audio_mix_adoption",
+  "schema_version": 1,
+  "prepared_receipt": {"path": "/local/prepared_bed_receipt.json"},
+  "format": {"sample_rate": 48000, "channels": 2, "total_samples": 1856000},
+  "segments": [
+    {"index": 0, "output_start_sample": 366000, "gain": 0.4251421093940735}
+  ],
+  "master_gain_db": 0.75
+}
+```
+
+Unknown or missing fields fail; legacy `*_sha256` keys are ignored. The format must
+equal the actual zero-origin picture frame clock at 48 kHz and the prepared receipt.
+The receipt, all three float PCM beds (format, sample count, finite PCM), the picture,
+the narration adoption file and the ordered segment indices are checked before
+narration snapshots are written.
+
+## Exact audio operations
+
+Each narration snapshot is decoded directly and completely to `pcm_f32le`, 48 kHz
+stereo. Version 1 uses one fixed channel matrix, recorded per segment as
+`mono_equal_power` or `stereo_identity`:
+
+- mono is panned to left and right at `1/sqrt(2)` per channel;
+- stereo preserves independent left and right channels at unit gain;
+- inputs with more than two channels are rejected.
+
+There is no intermediate 44.1 kHz mono placement, speed change, fade, trim, tail pad,
+normalization, or automatic fit. Every complete converted WAV must fit its adopted
+integer `output_start_sample`; placements may not overlap. Adopted per-segment gains
+form a float `voice_bus.wav`. The producer's `prepared_bed.wav` and voice bus form a
+float premaster, then the sole adopted `master_gain_db` forms the float master consumed
+by the final AAC encode. The picture's old audio is never a mixer input.
+
+## Records and publication
+
+`narration_input_binding.json` records the actual direct 48 kHz placed files and voice
+bus, marking the bus `CONSUMED_BY_EXPLICIT_MIX`. `audio_mix_binding.json` records the
+mix adoption path, picture path and clock, prepared receipt path and stems, converted
+placements (path, channel matrix, PCM facts), voice bus, premaster, master, the
+narration binding path, the final decoded PCM facts, the final AAC decoder/packet
+count/payload bytes, and the actual output picture decoder/frame clock. The output
+picture must preserve fps, frame count, zero start, and duration. A video-copy path
+reports `packet_identity: EXACT` when decoder parameters and packet sizes/timestamps
+are unchanged; an allowed visual re-encode reports `REENCODED_CLOCK_MATCH`. Timeline,
+settings, QC, and manifest identify the explicit path rather than reporting ambient
+ducking/BGM/loudnorm operations.
+
+The candidate render is written to a hidden file. Both bindings are written, QC must
+pass, the media is published, and a second QC runs against the published path. Any
+render, binding, or QC failure removes the candidate, final-named media and the
+bindings written by this run instead of overwriting an older success.
+Diagnostic/staging audio may remain in the unique work directory.

package/resources/skills/video-recap-production/upstream/skills/video-assemble/references/foreground-compose.md

@@ -0,0 +1,118 @@
+# Caller-rendered foreground composition
+
+`compose_foreground.py` performs one narrow operation: it overlays a caller-rendered,
+full-canvas RGBA PNG sequence on an already locked H264/CFR/AAC base, optionally
+replaces a declared tail with an explicit endcard asset, and copies `a:0` without
+decoding or rewriting it. The PNG pixels are the source schema. This is not a CSS,
+font, text, subtitle, logo, animation, or plugin renderer.
+
+## Command
+
+```bash
+python3 scripts/compose_foreground.py foreground_plan.json \
+  --output-dir a-new-directory [--plan-only]
+```
+
+The output directory must not exist. A normal run publishes `foreground.mp4` only
+after the staged media's frame clock, canvas/color metadata, AAC decoder/packets/PTS/
+side data, and a full audio/video decode pass verification.
+A failure retains `foreground_run.json` and available logs but removes staged/final
+media. `--plan-only` validates the complete plan and inputs and writes only
+`foreground_run.json`; it does not render media or update any current pointer.
+
+## Strict plan schema v1
+
+```json
+{
+  "artifact": "foreground_compose_plan",
+  "schema_version": 1,
+  "base": {"path": "/local/base.mp4"},
+  "video": {"fps": "30/1", "width": 1280, "height": 720, "total_frames": 300},
+  "foreground": {
+    "directory": "/local/foreground_sequence",
+    "pattern": "frame_%06d.png",
+    "start_frame": 0,
+    "end_frame": 270
+  },
+  "endcard": {
+    "kind": "sequence",
+    "directory": "/local/endcard_sequence",
+    "pattern": "frame_%06d.png",
+    "start_frame": 270,
+    "end_frame": 300
+  },
+  "producer_receipt": {"path": "/local/producer_receipt.json"}
+}
+```
+
+`endcard` is an exact tagged union. The alternative static form is:
+
+```json
+{
+  "kind": "still",
+  "path": "/local/endcard.png",
+  "start_frame": 270,
+  "end_frame": 300
+}
+```
+
+When the foreground itself covers the entire declared frame clock, the only accepted
+no-tail form is exactly:
+
+```json
+{"kind": "none"}
+```
+
+It accepts no additional fields. It is invalid when the foreground reserves any tail;
+there is no implicit filler, repeated last frame, or generated endcard.
+
+Use `still` only when a genuinely static full-canvas endcard is intended. A static
+PNG does not reconstruct a delivered fade or other animated endcard; supply the
+caller-rendered `sequence` form for that case.
+
+Both sequences use **local zero-based filenames** regardless of their output range.
+Thus the endcard example contains `frame_000000.png` through `frame_000029.png`,
+mapped to output frames `[270,300)`. The foreground must start at output frame zero.
+Its end must equal the endcard start, and the endcard end must equal the independently
+probed base frame count. With `kind: "none"`, the foreground end must instead equal
+that full base frame count. Bounds are half-open.
+
+The only accepted filename pattern is the literal `frame_%06d.png`. The directory
+must contain exactly the expected contiguous entries—no missing or extra files. Every
+actual image must probe as PNG, `rgba`, and the exact declared full canvas. Repeated
+files and symlinks are allowed so transparent holds need not duplicate storage. The
+run report records each sequence's directory and validated `frame_count`. Legacy
+`sha256` / `ordered_sha256` keys in a plan are ignored.
+
+## Base and output invariants
+
+The first version accepts one selected `v:0` H264, zero-origin CFR, YUV420P,
+BT.709/TV-range base and adopted AAC `a:0`. Declared fps, canvas, and frame count are
+checked independently against actual decoded frame PTS. Picture and audio intervals
+must satisfy the narrow `pair_media` timing contract.
+
+Composition explicitly overlays in RGB, converts to BT.709 limited-range YUV420P,
+limits the final video filter to the declared half-open frame clock, and re-encodes
+only video with fixed `libx264 -preset fast -crf 18` settings. A no-tail run uses only
+the base and foreground inputs; it does not synthesize or pad a tail. The filter EOF
+prevents still-image input loops without imposing an output-level video frame cap that
+could stop accepted trailing AAC packets from being copied. The run
+report records that encoder, preset, CRF, pixel format, color contract, and audio-copy
+mode explicitly. H.264 CRF encoding is lossy: preserved transparent regions are
+visually checked against tolerances, not claimed pixel-identical to decoded base
+pixels. The compositor does not use `-r`, `-shortest`, or `-t`. Audio is mapped from
+base `a:0` with `-c:a copy`; output verification requires matching decoder
+parameters, packet count, payload bytes, PTS/DTS/duration/size, and side data.
+
+## Provenance and review boundary
+
+The producer receipt is a caller artifact that must exist when the plan is read.
+Its declarations may
+describe roles or content decisions such as title/note/brand, `dialogues=[]`, or
+hidden markers. Core records those declarations as `DECLARED_NOT_CHECKED`; it does
+not infer semantic truth from pixels or claim that dialogue/subtitle duplication is
+absent. A separate producer/reviewer must establish that evidence.
+
+Every run reports `direct_listening` and `normal_speed_review` as `NOT_CHECKED` and
+`release_approved` as false. Pixel validation and deterministic rendering are not
+commercial-quality or release approval.

package/resources/skills/video-recap-production/upstream/skills/video-assemble/references/jianying/LICENSE.duo-video

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 duoec
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/resources/skills/video-recap-production/upstream/skills/video-assemble/references/jianying/SOURCE.md

@@ -0,0 +1,15 @@
+# JianYing protocol templates
+
+These JSON protocol templates are pinned to
+[`duoec/duo-video`](https://github.com/duoec/duo-video) commit
+`ef4eb46c823910553f901649f2f13fd7575e748f`, under its MIT license. They are
+data/schema baselines, not executable upstream code. Runtime builders deep-copy
+the templates and replace authored values such as IDs, paths, timings, canvas
+dimensions, and resource configuration.
+
+The required copyright and permission notice is preserved in
+`LICENSE.duo-video` in this directory.
+
+The exporter never uses duo-video's embedded example credentials. Resource-ID
+features accept an offline `material` or `resource_config` payload so official
+resource packages can be supplied legally by the caller.

package/resources/skills/video-recap-production/upstream/skills/video-assemble/references/jianying/empty_draft_meta_info.json

@@ -0,0 +1,69 @@
+{
+    "cloud_package_completed_time": "",
+    "draft_cloud_capcut_purchase_info": "",
+    "draft_cloud_last_action_download": false,
+    "draft_cloud_materials": [],
+    "draft_cloud_purchase_info": "",
+    "draft_cloud_template_id": "",
+    "draft_cloud_tutorial_info": "",
+    "draft_cloud_videocut_purchase_info": "",
+    "draft_cover": "",
+    "draft_deeplink_url": "",
+    "draft_enterprise_info": {
+        "draft_enterprise_extra": "",
+        "draft_enterprise_id": "",
+        "draft_enterprise_name": "",
+        "enterprise_material": []
+    },
+    "draft_fold_path": "",
+    "draft_id": "",
+    "draft_is_ai_packaging_used": false,
+    "draft_is_ai_shorts": false,
+    "draft_is_article_video_draft": false,
+    "draft_is_from_deeplink": "false",
+    "draft_is_invisible": false,
+    "draft_materials": [
+        {
+            "type": 0,
+            "value": []
+        },
+        {
+            "type": 1,
+            "value": []
+        },
+        {
+            "type": 2,
+            "value": []
+        },
+        {
+            "type": 3,
+            "value": []
+        },
+        {
+            "type": 6,
+            "value": []
+        },
+        {
+            "type": 7,
+            "value": []
+        },
+        {
+            "type": 8,
+            "value": []
+        }
+    ],
+    "draft_materials_copied_info": [],
+    "draft_name": "",
+    "draft_new_version": "",
+    "draft_removable_storage_device": "",
+    "draft_root_path": "",
+    "draft_segment_extra_info": [],
+    "draft_timeline_materials_size_": 9734196,
+    "draft_type": "",
+    "tm_draft_cloud_completed": "",
+    "tm_draft_cloud_modified": 0,
+    "tm_draft_create": 1765203775977,
+    "tm_draft_modified": 1765203775977,
+    "tm_draft_removed": 0,
+    "tm_duration": 249100000
+}

package/resources/skills/video-recap-production/upstream/skills/video-assemble/references/jianying/empty_jy_combination_segment.json

@@ -0,0 +1,84 @@
+{
+  "is_tone_modify": false,
+  "enable_adjust_mask": false,
+  "keyframe_refs": [],
+  "enable_adjust": true,
+  "enable_video_mask": true,
+  "enable_hsl": false,
+  "speed": 1,
+  "clip": {
+    "rotation": 0,
+    "transform": {
+      "y": 0,
+      "x": 0
+    },
+    "flip": {
+      "vertical": false,
+      "horizontal": false
+    },
+    "scale": {
+      "y": 1,
+      "x": 1
+    },
+    "alpha": 1
+  },
+  "intensifies_audio": false,
+  "uniform_scale": {
+    "on": true,
+    "value": 1
+  },
+  "responsive_layout": {
+    "vertical_pos_layout": 0,
+    "target_follow": "",
+    "enable": false,
+    "horizontal_pos_layout": 0,
+    "size_layout": 0
+  },
+  "enable_hsl_curves": true,
+  "desc": "",
+  "state": 0,
+  "enable_lut": true,
+  "reverse": false,
+  "target_timerange": {
+    "start": 0,
+    "duration": 0
+  },
+  "cartoon": false,
+  "enable_color_correct_adjust": false,
+  "last_nonzero_volume": 1,
+  "enable_smart_color_adjust": false,
+  "source": "segmentsourcenormal",
+  "render_timerange": {
+    "start": 0,
+    "duration": 0
+  },
+  "render_index": 0,
+  "group_id": "",
+  "enable_color_match_adjust": false,
+  "enable_color_curves": true,
+  "raw_segment_id": "",
+  "volume": 1,
+  "visible": true,
+  "track_render_index": 0,
+  "track_attribute": 0,
+  "is_loop": false,
+  "id": "",
+  "enable_color_wheels": true,
+  "extra_material_refs": [],
+  "template_id": "",
+  "template_scene": "default",
+  "material_id": "",
+  "common_keyframes": [],
+  "digital_human_template_group_id": "",
+  "color_correct_alg_result": "",
+  "hdr_settings": {
+    "mode": 1,
+    "intensity": 1,
+    "nits": 1000
+  },
+  "is_placeholder": false,
+  "source_timerange": {
+    "start": 0,
+    "duration": 0
+  }
+}

package/resources/skills/video-recap-production/upstream/skills/video-assemble/references/jianying/empty_jy_combination_video_material.json

@@ -0,0 +1,98 @@
+{
+  "category_name": "",
+  "aigc_type": "none",
+  "duration": 0,
+  "category_id": "",
+  "beauty_face_auto_preset_infos": [],
+  "beauty_body_preset_id": "",
+  "picture_from": "none",
+  "cartoon_path": "",
+  "intensifies_audio_path": "",
+  "crop_ratio": "free",
+  "source_platform": 0,
+  "local_material_from": "",
+  "media_path": "",
+  "is_unified_beauty_mode": false,
+  "width": 0,
+  "video_algorithm": {
+    "algorithms": [],
+    "path": "",
+    "story_video_modify_video_config": {
+      "is_overwrite_last_video": false,
+      "tracker_task_id": "",
+      "task_id": ""
+    },
+    "ai_background_configs": [],
+    "ai_in_painting_config": [],
+    "gameplay_configs": []
+  },
+  "type": "video",
+  "height": 0,
+  "material_id": "",
+  "has_audio": true,
+  "is_copyright": true,
+  "source": 0,
+  "intensifies_path": "",
+  "crop_scale": 1,
+  "live_photo_cover_path": "",
+  "reverse_path": "",
+  "reverse_intensifies_path": "",
+  "picture_set_category_id": "",
+  "crop": {
+    "upper_right_x": 1,
+    "lower_right_y": 1,
+    "upper_right_y": 0,
+    "upper_left_y": 0,
+    "lower_left_y": 1,
+    "lower_right_x": 1,
+    "lower_left_x": 0,
+    "upper_left_x": 0
+  },
+  "request_id": "",
+  "local_material_id": "",
+  "picture_set_category_name": "",
+  "path": "",
+  "is_text_edit_overdub": false,
+  "check_flag": 62978047,
+  "origin_material_id": "",
+  "material_url": "",
+  "beauty_face_auto_preset": {
+    "preset_id": "",
+    "scene": "",
+    "name": "",
+    "rate_map": ""
+  },
+  "is_ai_generate_content": false,
+  "extra_type_option": 2,
+  "id": "",
+  "aigc_item_id": "",
+  "material_name": "复合片段1",
+  "beauty_face_preset_infos": [],
+  "team_id": "",
+  "local_id": "",
+  "matting": {
+    "expansion": 0,
+    "feather": 0,
+    "flag": 0,
+    "reverse": false,
+    "strokes": [],
+    "custom_matting_id": "",
+    "has_use_quick_eraser": false,
+    "has_use_quick_brush": false,
+    "path": "",
+    "interactiveTime": [],
+    "enable_matting_stroke": false
+  },
+  "formula_id": "",
+  "has_sound_separated": false,
+  "live_photo_timestamp": -1,
+  "stable": {
+    "stable_level": 0,
+    "time_range": {
+      "start": 0,
+      "duration": 0
+    },
+    "matrix_path": ""
+  },
+  "aigc_history_id": ""
+}