@lemoncat7/dsh-partner 2.8.1 → 2.8.3

package/resources/skills/video-recap-production/upstream/skills/video-understanding/references/data-schema.md

@@ -0,0 +1,193 @@
+# 数据格式（中间 JSON）
+
+所有中间文件均在 pipeline 工作目录（work_dir/）下。
+
+## vlm_analysis.json
+
+每场景的 VLM 分析结果，数组格式：
+
+```json
+[
+  {
+    "scene_id": 1,
+    "start": 5.0,
+    "end": 15.0,
+    "description": "男子闯入房间",
+    "depth_analysis": "角色情绪分析...",
+    "frame_facts": {
+      "5.0": ["男子闯入房间, 头发蓬乱表情紧张"],
+      "10.0": ["男子俯身盯着床上男孩, 男孩睁眼惊醒"]
+    }
+  }
+]
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `scene_id` | int | 场景编号 |
+| `start` | float | 开始时间（秒） |
+| `end` | float | 结束时间（秒） |
+| `description` | string | 画面简述（≤80字） |
+| `depth_analysis` | string | 深层分析（情绪/关系/潜台词） |
+| `frame_facts` | object | 帧级事实，key 为时间戳字符串 |
+
+## asr_result.json
+
+语音转文字结果：
+
+```json
+[
+  {"start": 0.0, "end": 3.5, "text": "What are you doing here?"}
+]
+```
+
+`start/end` 仅表示送入 MiMo ASR 的固定粗分片窗口。该列表为兼容产物，不能据此声称词级
+时间、准确对白边界或静音证明；空 `text` 的原因未知。
+
+## asr_timing_evidence.json
+
+ASR 的独立证据 sidecar，不改变 `asr_result.json` 的既有数组结构。它记录自己描述的是哪一份源视频、
+`audio.wav`（存在时）和 `asr_result.json`（各自的 `size` + `mtime_ns`），并明确当前精度边界：
+
+```json
+{
+  "schema_version": 2,
+  "status": "AVAILABLE_COARSE",
+  "source_video": {"size": 123456, "mtime_ns": 1700000000000000000},
+  "audio": {"size": 2048, "mtime_ns": 1700000001000000000},
+  "asr_result": {"size": 512, "mtime_ns": 1700000002000000000},
+  "glossary": {
+    "names": ["叶轻眉"],
+    "name_count": 1
+  },
+  "precision": {
+    "window_timing": "COARSE_SEGMENT_WINDOWS",
+    "dialogue_boundaries": "NOT_VERIFIED",
+    "word_alignment": "NOT_PERFORMED",
+    "empty_text_meaning": "UNKNOWN_NOT_PROVEN_SILENCE"
+  },
+  "windows": [{
+    "index": 0,
+    "start": 0.0,
+    "end": 3.5,
+    "text_availability": "AVAILABLE",
+    "observed_text": "她叫叶青眉",
+    "post_glossary_text": "她叫叶轻眉",
+    "glossary_modified": true
+  }]
+}
+```
+
+`status` 可为 `AVAILABLE_COARSE`、`EXPLICITLY_SKIPPED`、`UNAVAILABLE_NO_KEY`、
+`UNAVAILABLE_NO_DURATION`、`FAILED_AUDIO_EXTRACTION`、`FAILED_PROVIDER`、`EMPTY_UNKNOWN`
+或 `LEGACY_UNVERIFIED`。`LEGACY_UNVERIFIED` 标记没有旧 sidecar 的兼容缓存，可离线复用但
+`observed_text`/`glossary_modified` 为 `null`，且始终保持 legacy 身份；非 legacy sidecar 记录
+当时参与修正的人名/别名列表（`glossary.names`），人名表变化或所描述的文件被重写（size/mtime 不再
+一致）都会使 ASR 缓存失效。
+`UNAVAILABLE_NO_DURATION` 与 `EMPTY_UNKNOWN` 是可重试的不可用结果，不作为缓存命中；写作
+brief 会校验 sidecar 并打印当前状态，缺失或与当前文件不一致时显示 `MISSING_OR_STALE`。
+
+## asr_writing_chunks.json
+
+由 CLI 在生成 `agent_narration_brief.md` 时自动写出。它把长 ASR 按句子边界拆成适合 Agent 消化的语义块；中文按字符计数，非 CJK 文本按词数计数，并尽量保留 scene 对齐。
+
+```json
+[
+  {
+    "chunk_id": 0,
+    "start": 0.0,
+    "end": 28.5,
+    "scene_ids": [0, 1],
+    "char_count": 642,
+    "text": "第一段对白……",
+    "segments": [
+      {"start": 0.0, "end": 3.5, "text": "第一句。", "char_count": 4}
+    ]
+  }
+]
+```
+
+## silence_periods.json
+
+静音窗口列表（适合放解说）：
+
+```json
+[
+  {"start": 2.0, "end": 8.5, "duration": 6.5, "has_speech": false}
+]
+```
+
+`has_speech` 标记该窗口是否与检测到的 ASR 语音重叠；下游（pipeline / narration）只把 `has_speech=false` 的窗口当作可放解说的安静窗口。
+
+## timeline_fusion.json
+
+由 CLI 在生成 brief 时自动写出。它把 VLM 场景、ASR 对白和静音窗口按时间轴 overlap 合并，减少写稿时手工推断“这一幕有没有对白/能不能插解说”的成本。
+
+```json
+[
+  {
+    "scene_id": 0,
+    "time_range": [0.0, 10.0],
+    "visual_description": "两人在门口对峙",
+    "depth_analysis": "关系紧张",
+    "frame_facts": {"1.0": ["女子回头"]},
+    "dialogue_segments": [
+      {"start": 2.0, "end": 4.0, "overlap_seconds": 2.0, "text": "你到底是谁"}
+    ],
+    "dialogue_overlap_seconds": 2.0,
+    "narration_slots": [
+      {"start": 5.0, "end": 7.0, "duration": 2.0, "char_budget": 5}
+    ],
+    "recommended_mode": "ducked-bed"
+  }
+]
+```
+
+## deslop_qc_requirements.json（工具/brief 生成的运行契约）
+
+`deslop_qc_requirements.json` 是 tool/brief generated run contract：工具或 brief 生成本次运行的 QC 要求，供 `deslop_qc` 读取，不由 Agent 手写。字段为 `schema_version` 与 `style_card_required`。
+
+`style_card_required` 默认 `false`（advisory）：缺少 `style_card.json` 只是 warning，不阻断出片。将来的 opt-in 运行可把它设为 `true`，让 `style_card.json` 成为硬性要求——`deslop_qc` 只读这个字段判断缺少 `style_card.json` 是否是 blocker，不扫描 `agent_narration_brief.md` 的 prompt wording 来推断。如果 requirements 文件缺失或损坏，按 legacy/migration advisory 处理，不作为 hard failure。
+
+该契约不改变 `--style`：`--style` 仍是 freeform verbatim guidance，不增加固定风格档位。它也不改变 `deslop_qc` 边界：仍然是 report-only，不是 AIGC detector，不自动改写。
+
+最小示例：
+
+```json
+{
+  "schema_version": 1,
+  "style_card_required": false
+}
+```
+
+## background_research.json
+
+可选的背景调研结果（由 Agent 使用任意可用搜索/浏览方式整理）：
+
+```json
+{
+  "synopsis": "剧情概要",
+  "characters": {"角色名": "角色简介"},
+  "worldbuilding": "世界观设定",
+  "episode_context": "集数上下文",
+  "character_details": {
+    "角色名": {
+      "aliases": ["别名/昵称"],
+      "role": "主角|配角|反派|次要角色",
+      "relationships": ["与XX是夫妻", "与YY是师徒"]
+    }
+  },
+  "plot_arcs": [
+    {"name": "线索名称", "description": "简要描述", "status": "进行中|已解决|伏笔"}
+  ],
+  "cultural_notes": [
+    {"item": "文化梗/典故/时代背景", "explanation": "解释"}
+  ]
+}
+```
+
+> `character_details`、`plot_arcs`、`cultural_notes` 为（可选，新增）字段。仅含 `synopsis`、`characters`、`worldbuilding`、`episode_context` 四个原始字段的旧 JSON 仍然有效。
+
+## 其他产物
+
+`narration.json`、`narration_lint.json`、`style_card.json`、`packaging_plan.json`、`deslop_qc.json`、`clip_plan.json`、`clip_plan_validated.json` 由后续的写稿与剪辑阶段读写，本技能既不生成也不校验它们；其格式以本技能生成的 `agent_narration_brief.md` 和编排器的中间产物契约为准。

package/resources/skills/video-recap-production/upstream/skills/video-understanding/references/prompt-templates.md

@@ -0,0 +1,37 @@
+# Prompt 模板
+
+> 本文件被 `load_prompt()` 按 `### NAME` 切片读取。当前 CLI 只读取 VLM 模板；解说词由 Agent 根据 `agent_narration_brief.md` 撰写。
+
+## 目录
+
+| 模板名 | 用途 | 使用阶段 |
+|--------|------|----------|
+| VLM_DEPTH_PROMPT | 场景画面深度分析 | VLM 分析 |
+
+### VLM_DEPTH_PROMPT
+仔细观察这些视频帧，分析这个场景。分三部分输出：
+
+【描述】
+不超过80字，描述画面中正在发生什么（场景、人物、动作、表情、文字、事件）。
+
+【帧标签】
+逐帧列出每帧可见的人物动作和物品关系。每帧一行，格式：
+时间点 | 该帧可见的关键动作（1-2个完整短句，包含谁在做什么、物品如何被使用，如有字幕/文字也一并列出）
+示例：
+5.0s | 男子闯入房间, 头发蓬乱表情紧张
+10.0s | 男子俯身盯着床上男孩, 男孩睁眼惊醒
+15.0s | 男孩从床上坐起双手抱住头上的瓷枕准备防御
+
+【深层分析】
+不超过180字，分析：
+1. 角色的真实情绪或心理状态（通过表情、肢体语言、眼神判断）
+2. 人物之间的关系动态（亲密、紧张、疏离、试探等）
+3. 从场景开头到结尾发生了什么变化（知识、权力、目标、关系或情绪）
+4. 谁的视角最能承载这次变化；说话者、倾听者或旁观者中，谁的反应最值得保留
+5. 对话背后的潜台词（他们没说出口但由可见证据支持的东西）
+
+要求：
+- 必须基于画面可见的证据推断，不做无根据的猜测
+- 不要用"象征""隐喻"等文学词汇
+- 用口语化表达："他明显是在试探她的反应"
+- 如果画面信息不足，直接说"信息不足"

package/resources/skills/video-recap-production/upstream/skills/video-understanding/references/research-guide.md

@@ -0,0 +1,74 @@
+# 背景调研指南（可选）
+
+Agent 在开始视频理解**之前**先做背景调研，确认作品名、角色关系、剧情背景或科普概念，写入 `work_dir/background_research.json`。理解阶段会把它并入 VLM 的画面分析上下文，让场景描述能直接叫出人物名字、带着剧情读画面，而不是把人都标成「黑衣男子」。**调研不是必需步骤**；没有浏览器工具、网络不可用或用户未提供明确片名时，直接跳过，不阻塞视频生成。
+
+## 工具选择
+
+使用当前环境里可用的任意检索方式即可，例如：
+
+- Codex / Claude 自带的联网搜索或网页浏览工具
+- 用户已经配置好的浏览器自动化或页面读取工具
+- 普通浏览器手动查找后把结果整理进 JSON
+- 已知资料、用户给的剧情背景或项目内已有文档
+
+## 通用流程
+
+1. 从 `--context`、文件名或用户描述里提取可搜索关键词。
+2. 搜索 1-3 个高价值问题，不要过度调研。
+3. 只记录对解说有帮助的事实：人物关系、剧情前提、世界观、当前集上下文、术语解释。
+4. 写入 `work_dir/background_research.json`。
+5. 如果查不到可靠信息，跳过调研并继续视频理解；不要在理解索引生成前提前写 `narration.json`。
+
+## 按视频类型搜索策略
+
+### 短剧 / 电视剧
+
+| 搜索关键词 | 目标字段 |
+|-----------|---------|
+| `{作品名} 剧情 介绍 人物` | synopsis, characters |
+| `{作品名} 人物 关系` | characters |
+| `{作品名} 第{N}集 剧情` | episode_context |
+
+### 电影
+
+| 搜索关键词 | 目标字段 |
+|-----------|---------|
+| `{电影名} 剧情 简介` | synopsis |
+| `{电影名} 影评 解读` | cultural_notes |
+
+### 纪录片 / 科普视频
+
+| 搜索关键词 | 目标字段 |
+|-----------|---------|
+| `{主题} 背景 知识` | worldbuilding |
+| `{核心概念} 解释` | synopsis |
+| `{主题} 最新 进展` | cultural_notes |
+
+## 写入格式
+
+写入 `work_dir/background_research.json`，只填搜到的字段，未搜到的字段省略，不要写 `null` 或空字符串。
+
+```json
+{
+  "synopsis": "...",
+  "characters": {
+    "角色名": "简介或关系"
+  },
+  "worldbuilding": "...",
+  "episode_context": "...",
+  "cultural_notes": [
+    {"item": "...", "explanation": "..."}
+  ]
+}
+```
+
+## 错误处理
+
+| 场景 | 处理 |
+|------|------|
+| 没有浏览器 / 搜索工具 | 跳过调研，继续视频理解 |
+| 搜索无结果 | 换一组关键词重试一次，仍无结果则继续视频理解 |
+| 结果互相矛盾 | 只使用用户提供的上下文或画面/ASR 可验证的信息 |
+| 信息可能剧透后续 | 只用于理解人物关系，不在解说里剧透用户没要求的后续剧情 |
+
+**原则**：背景资料只能补上下文，不能替代 `vlm_analysis.json` / `asr_result.json` 里的画面和对白证据。

package/resources/skills/video-recap-production/upstream/skills/video-understanding/scripts/agent_text.py

@@ -0,0 +1,301 @@
+"""Normalize, split, budget, and de-duplicate narration text."""
+
+import copy
+import re
+
+from lib import CONFIG, log
+from deslop_qc import _sentence_pieces, _text_units
+
+
+def _format_frame_facts(scene):
+    """将帧动作描述格式化为可注入 agent brief 的文本。"""
+    facts = scene.get("frame_facts", {})
+    if not facts:
+        return ""
+    lines = [f"    {ts}s: {'; '.join(facts[ts])}" for ts in sorted(facts, key=float)]
+    return "\n  帧动作:\n" + "\n".join(lines)
+
+
+def _text_char_count(text):
+    """计算文本的有效字数（去除标点和空白，这些不占 TTS 朗读时间）。"""
+    return len(
+        re.sub(
+            r'[，。！？、；：…“”‘’《》〈〉\s"\'「」『』（）()【】\[\]—～·,.!?;:\\-]',
+            "",
+            text,
+        )
+    )
+
+
+def _split_text_by_sentence_windows(text, min_chars=500, max_chars=800):
+    """Clipto-style three-tier sentence boundary splitting for long ASR text."""
+    text = re.sub(r"\s+", " ", text).strip()
+    if not text:
+        return []
+    if _text_units(text) <= max_chars:
+        return _sentence_pieces(text)
+
+    result = []
+    rest = text
+    sentence_marks = "。！？!?；;."
+    while _text_units(rest) > max_chars:
+        # The min/max thresholds are unit-based but punctuation is char-indexed.
+        # For Chinese (the dominant recap target) these are nearly identical; for
+        # non-CJK this remains a safe sentence-boundary heuristic around words.
+        char_min = min(len(rest), max(1, min_chars))
+        char_max = min(len(rest), max(1, max_chars))
+        window = rest[:char_max]
+        cut = max(window.rfind(mark) for mark in sentence_marks)
+        if cut + 1 < char_min:
+            outside = -1
+            for i, ch in enumerate(rest[char_max:], start=char_max):
+                if ch in sentence_marks:
+                    outside = i
+                    break
+            cut = outside if outside >= 0 and outside + 1 <= len(rest) else char_max - 1
+        piece = rest[: cut + 1].strip()
+        if not piece:
+            piece = rest[:char_max].strip()
+            cut = char_max - 1
+        result.append(piece)
+        rest = rest[cut + 1 :].strip()
+    if rest:
+        result.append(rest)
+    return result
+
+
+def _timed_sentence_pieces(seg, min_chars, max_chars):
+    """Split one ASR segment into timed sentence pieces with approximate spans."""
+    text = seg["text"].strip()
+    if not text:
+        return []
+    start, end = seg["start"], seg["end"]
+    pieces = []
+    for sentence in _sentence_pieces(text):
+        if _text_units(sentence) > max_chars:
+            pieces.extend(
+                _split_text_by_sentence_windows(
+                    sentence, min_chars=min_chars, max_chars=max_chars
+                )
+            )
+        else:
+            pieces.append(sentence)
+    total_units = sum(max(1, _text_units(piece)) for piece in pieces)
+    duration = end - start
+    cursor = start
+    timed = []
+    for idx, piece in enumerate(pieces):
+        units = max(1, _text_units(piece))
+        piece_end = end if idx == len(pieces) - 1 else cursor + duration * units / total_units
+        timed.append(
+            {
+                "start": round(cursor, 2),
+                "end": round(piece_end, 2),
+                "text": piece,
+                "char_count": _text_units(piece),
+            }
+        )
+        cursor = piece_end
+    return timed
+
+
+def _scene_ids_for_range(scenes, start, end):
+    duration = max(0.001, end - start)
+    scene_ids = []
+    for scene in scenes:
+        overlap = _overlap_seconds(start, end, scene["start"], scene["end"])
+        # Ignore tiny boundary tails from approximate ASR sentence timing. A
+        # scene id should mean the chunk materially belongs to that scene.
+        if overlap and (overlap >= duration * 0.2 or overlap >= 3.0):
+            scene_ids.append(scene["scene_id"])
+    return scene_ids
+
+
+def _chunk_asr_for_writing(segments, scenes_analysis, min_chars=None, max_chars=None):
+    """Chunk ASR into semantic windows before an agent writes long-dialogue recaps.
+
+    The strategy mirrors Clipto's segment splitter: accumulate a window, prefer
+    the last sentence boundary inside max length, allow a slightly longer first
+    boundary outside the window, and fall back to the remaining text. CJK text is
+    measured by characters; non-CJK text is measured by words.
+    """
+    min_chars = CONFIG["asr_chunk_min_chars"] if min_chars is None else min_chars
+    max_chars = CONFIG["asr_chunk_max_chars"] if max_chars is None else max_chars
+    pieces = [
+        piece
+        for seg in segments
+        for piece in _timed_sentence_pieces(seg, min_chars, max_chars)
+    ]
+
+    chunks = []
+    current = []
+    current_units = 0
+    current_scene_ids = set()
+
+    def flush():
+        nonlocal current, current_units, current_scene_ids
+        if not current:
+            return
+        chunks.append(
+            {
+                "chunk_id": len(chunks),
+                "start": current[0]["start"],
+                "end": current[-1]["end"],
+                "scene_ids": sorted(
+                    current_scene_ids, key=lambda sid: (isinstance(sid, str), sid)
+                ),
+                "char_count": current_units,
+                "text": " ".join(piece["text"] for piece in current).strip(),
+                "segments": current,
+            }
+        )
+        current = []
+        current_units = 0
+        current_scene_ids = set()
+
+    for piece in pieces:
+        units = max(1, piece["char_count"])
+        piece_scene_ids = set(
+            _scene_ids_for_range(scenes_analysis, piece["start"], piece["end"])
+        )
+        crosses_scene = (
+            current
+            and current_scene_ids
+            and piece_scene_ids
+            and not (current_scene_ids & piece_scene_ids)
+        )
+        if crosses_scene and current_units >= min_chars:
+            flush()
+        if current and current_units >= min_chars and current_units + units > max_chars:
+            flush()
+        current.append(piece)
+        current_scene_ids.update(piece_scene_ids)
+        current_units += units
+        if current_units >= max_chars:
+            flush()
+    flush()
+    return chunks
+
+
+def _truncate_at_sentence(text, max_chars):
+    """在句子边界截断，不产生残句。max_chars 按有效字符计（不含标点空白）。"""
+    if _text_char_count(text) <= max_chars:
+        return text
+    eff = 0
+    cutoff = len(text)
+    for i, ch in enumerate(text):
+        eff += 1 if _text_char_count(ch) else 0
+        if eff > max_chars:
+            cutoff = i + 1
+            break
+    idx = max(text[:cutoff].rfind(sep) for sep in ["。", "！", "？", "!", "?"])
+    if idx > 0:
+        return text[: idx + 1]
+    idx = max(text[:cutoff].rfind(sep) for sep in ["，", "、", "；", ","])
+    if idx > 3:
+        return text[:idx] + "。"
+    return ""
+
+
+def _char_bigrams(text):
+    return {text[i : i + 2] for i in range(len(text) - 1) if text[i : i + 2].strip()}
+
+
+def _post_dedup_narration(narration):
+    """去除相邻相似解说段（bigram 重叠 >60% 则合并）。"""
+    if len(narration) < 2:
+        return narration
+    result = [narration[0]]
+    for seg in narration[1:]:
+        prev = result[-1]
+        set_a, set_b = _char_bigrams(prev["narration"]), _char_bigrams(seg["narration"])
+        if not set_a or not set_b:
+            result.append(seg)
+            continue
+        overlap = len(set_a & set_b) / min(len(set_a), len(set_b))
+        # Only merge near-identical adjacent beats. Short Chinese beats share many
+        # bigrams by chance, so a low threshold collapses intentional parallel beats
+        # ("他不再试探" / "他直接赌上全力") and silently drops density below target.
+        if overlap > 0.6:
+            # Validation is also the handoff boundary for renderer metadata: keep the
+            # overlays authored on either merged beat.
+            merged_overlays = copy.deepcopy(
+                prev.get("visual_overlays", []) + seg.get("visual_overlays", [])
+            )
+            if len(seg["narration"]) > len(prev["narration"]):
+                prev["narration"] = seg["narration"]
+            prev["end"] = seg["end"]
+            prev["pause_after_ms"] = seg["pause_after_ms"]
+            if merged_overlays:
+                prev["visual_overlays"] = merged_overlays
+            log(f"  去重合并: {prev['start']:.0f}-{prev['end']:.0f}s")
+        else:
+            result.append(seg)
+    removed = len(narration) - len(result)
+    if removed:
+        log(f"  去重: {len(narration)} → {len(result)} 段 (合并 {removed} 段)")
+    return result
+
+
+def _scene_available_seconds(start, end):
+    return max(0.0, end - start - CONFIG["narration_tail_pad_seconds"])
+
+
+def _recommended_char_budget(start, end):
+    # account for the global narration atempo (CONFIG['narration_speed']) so a beat's text
+    # is budgeted against the FINAL sped-up audio, not the raw TTS rate — otherwise windows
+    # are over-sized and the bed shows long silent gaps between sentences.
+    effective_rate = (
+        CONFIG["speech_rate"] * CONFIG["speech_safety_margin"] * CONFIG["narration_speed"]
+    )
+    return int(_scene_available_seconds(start, end) * effective_rate)
+
+
+def _find_scene_for_midpoint(scenes_analysis, start, end):
+    mid = (start + end) / 2
+    for scene in scenes_analysis:
+        if scene["start"] <= mid <= scene["end"]:
+            return scene
+    return None
+
+
+def _normalise_narration_segment(seg):
+    """Normalize one lint-validated narration segment for the full-mode rewrite.
+
+    Authored timing is a delivery contract: scene boundaries are approximate
+    visual-analysis buckets, so start/end are never clamped here.
+    """
+    item = {
+        "start": round(seg["start"], 2),
+        "end": round(seg["end"], 2),
+        "narration": str(seg["narration"]).strip(),
+        "pause_after_ms": int(seg.get("pause_after_ms", CONFIG["breath_ms"])),
+        "overlaps_speech": bool(seg.get("overlaps_speech", True)),
+    }
+    for optional_key in (
+        "source_start",
+        "source_end",
+        "source_clip_id",
+        "source_entry_policy",
+        "source_entry_reason",
+    ):
+        if optional_key in seg:
+            item[optional_key] = seg[optional_key]
+    # carry the per-beat emotion/tone tag (MiMo TTS instruct) through lint untouched
+    if seg.get("emotion"):
+        item["emotion"] = seg["emotion"].strip()
+    # Renderer-owned metadata survives the validation rewrite; the recap orchestrator
+    # filters supported overlay kinds later.
+    if "visual_overlays" in seg:
+        item["visual_overlays"] = copy.deepcopy(seg["visual_overlays"])
+    return item
+
+
+def _clean_narration_punctuation(text):
+    text = re.sub(r"\s+", " ", text).strip()
+    text = re.sub(r'[，：、；,]["\']?[。！？]', "。", text)
+    return re.sub(r'["\']。$', "。", text)
+
+
+def _overlap_seconds(start, end, other_start, other_end):
+    return max(0.0, min(end, other_end) - max(start, other_start))