gemini: 双声旁白、波形对齐字幕、时间轴（step 2）

.gitattributes

@@ -62,3 +62,13 @@ taurus/covers/cover-channels-3x4.jpg filter=lfs diff=lfs merge=lfs -text
 taurus/covers/cover-bili-4x3.jpg filter=lfs diff=lfs merge=lfs -text
 taurus/covers/cover-douyin-4x3.jpg filter=lfs diff=lfs merge=lfs -text
 taurus/covers/cover-douyin-3x4.jpg filter=lfs diff=lfs merge=lfs -text
+gemini/audio/n04.mp3 filter=lfs diff=lfs merge=lfs -text
+gemini/audio/n08.mp3 filter=lfs diff=lfs merge=lfs -text
+gemini/audio/n06.mp3 filter=lfs diff=lfs merge=lfs -text
+gemini/audio/n02.mp3 filter=lfs diff=lfs merge=lfs -text
+gemini/audio/n05.mp3 filter=lfs diff=lfs merge=lfs -text
+gemini/audio/n09.mp3 filter=lfs diff=lfs merge=lfs -text
+gemini/audio/n01.mp3 filter=lfs diff=lfs merge=lfs -text
+gemini/audio/n10.mp3 filter=lfs diff=lfs merge=lfs -text
+gemini/audio/n07.mp3 filter=lfs diff=lfs merge=lfs -text
+gemini/audio/n03.mp3 filter=lfs diff=lfs merge=lfs -text

gemini/README.md

@@ -9,7 +9,7 @@
 | # | 阶段 | 状态 |
 |---|---|---|
 | 1 | 计划 / 大纲 / 步骤（本文件） | ✅ 完成 |
-| 2 | 旁白定稿（10 幕）+ **男女双声交替 TTS**（晓晓 × 云希，象征双生）+ 波形对齐字幕 + 时间轴 | ⏳ |
+| 2 | 旁白定稿（10 幕）+ **男女双声交替 TTS**（晓晓 × 云希，象征双生）+ 波形对齐字幕 + 时间轴 | ✅ 完成（89 句，总长 4:41；字幕起点统一提前 60 ms，有声帧 100% 覆盖） |
 | 3 | 画面引擎：极光虹彩天幕 + 镜像万花筒粒子 + 星图投影；10 个场景（横/竖屏） | ⏳ |
 | 4 | 双星荣誉徽章：两半镜像飞入合璧、3D 旋转、镭射刻名、双色绶带、单独导出 PNG | ⏳ |
 | 5 | 灵动配乐（A 大调 · 竖琴 / 钢片琴 / 拨弦 / 长笛对答卡农）+ 音效，预渲染并混音 | ⏳ |

gemini/audio/n01.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a0e8ac33ec3853cfc82e49d1b3b140f761c1af2f138f6801dcd49c0d0082d48e
+size 265868

gemini/audio/n02.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a63004f10efcf1a15b85485a72463552bf7d0583a15ece47e77cd924e69c0dd6
+size 331244

gemini/audio/n03.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7b71a51e34b066736f29106b22764d7a59724b73ef5d6affba2383ddda573e8a
+size 355724

gemini/audio/n04.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8667b3ad88104e67b2f85ab5e09ba172b37019f93467ba12e88d828a943758f1
+size 466316

gemini/audio/n05.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:09cbc0f42e4ba6e0bddd65b353b49a875aea45100445169e68b1082cdda89bd1
+size 279116

gemini/audio/n06.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f5ac1073b5786b5975307b0bc137bc74e0a9223bd2af6ef775c260c3dce14c25
+size 351404

gemini/audio/n07.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:de3fcd97543f18cbec5ef9a4633a8e1a74fa713f649adf603f92a58647b29846
+size 250028

gemini/audio/n08.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:fc3a3e1e5aaebff38d3dba5319783d0b051dd8317a98ca2b6d83f2d95b939eea
+size 343340

gemini/audio/n09.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:155b2ec66b31faf6fd8c8894a4c11aaa3b638ba30f711a006f1f4005caa33869
+size 248588

gemini/audio/n10.mp3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:30f7457402b53a6ebc35cdadde85ffe6f531015ffd7d9d6d2e17f9f9f7cea61e
+size 162764

gemini/engine/timeline.js

@@ -0,0 +1,684 @@
+// 由 tools/narrate.py 生成、tools/align.mjs 校准：双声旁白时间轴与字幕
+export const TIMELINE = {
+ "duration": 280.852,
+ "voices": {
+  "f": "zh-CN-XiaoxiaoNeural",
+  "m": "zh-CN-YunxiNeural"
+ },
+ "acts": [
+  {
+   "id": "twin",
+   "title": "序章 · 镜中的双星",
+   "tone": "dawn",
+   "start": 0,
+   "end": 25.453,
+   "voice": {
+    "file": "audio/n01.mp3",
+    "at": 2.4,
+    "dur": 21.753
+   },
+   "subs": [
+    {
+     "t0": 2.38,
+     "t1": 5.52,
+     "text": "五月的尾巴，夏天刚刚推开门",
+     "who": "f"
+    },
+    {
+     "t0": 5.54,
+     "t1": 9.04,
+     "text": "夜空里，有两颗星总是肩并着肩",
+     "who": "m"
+    },
+    {
+     "t0": 9.06,
+     "t1": 10.68,
+     "text": "一颗明亮温暖",
+     "who": "f"
+    },
+    {
+     "t0": 10.7,
+     "t1": 12.28,
+     "text": "一颗清澈闪烁",
+     "who": "m"
+    },
+    {
+     "t0": 12.3,
+     "t1": 14.44,
+     "text": "它们像一面镜子的两边",
+     "who": "f"
+    },
+    {
+     "t0": 14.46,
+     "t1": 16.71,
+     "text": "又像同一个灵魂的两种声音",
+     "who": "m"
+    },
+    {
+     "t0": 16.73,
+     "t1": 19.62,
+     "text": "这就是黄道第三宫，双子座",
+     "who": "f"
+    },
+    {
+     "t0": 19.64,
+     "t1": 22.35,
+     "text": "5 月 21 日到 6 月 21 日出生的你",
+     "who": "m"
+    },
+    {
+     "t0": 22.37,
+     "t1": 24.23,
+     "text": "欢迎回到自己的星空",
+     "who": "f"
+    }
+   ]
+  },
+  {
+   "id": "locate",
+   "title": "找到他们",
+   "tone": "night",
+   "start": 25.453,
+   "end": 54.949,
+   "voice": {
+    "file": "audio/n02.mp3",
+    "at": 26.453,
+    "dur": 27.196
+   },
+   "subs": [
+    {
+     "t0": 26.433,
+     "t1": 29.773,
+     "text": "冬天和早春的夜晚，先找到猎户座",
+     "who": "m"
+    },
+    {
+     "t0": 29.793,
+     "t1": 32.473,
+     "text": "从猎户脚下的参宿七出发",
+     "who": "f"
+    },
+    {
+     "t0": 32.493,
+     "t1": 34.843,
+     "text": "穿过肩头那颗橙红的参宿四",
+     "who": "m"
+    },
+    {
+     "t0": 34.863,
+     "t1": 36.923,
+     "text": "一直向东北方延伸",
+     "who": "f"
+    },
+    {
+     "t0": 36.943,
+     "t1": 39.193,
+     "text": "你会看到两颗相距不远的亮星",
+     "who": "m"
+    },
+    {
+     "t0": 39.523,
+     "t1": 42.553,
+     "text": "西边那颗是北河二，卡斯托尔",
+     "who": "f"
+    },
+    {
+     "t0": 42.573,
+     "t1": 46.483,
+     "text": "东边更亮的那颗，是北河三，波吕克斯",
+     "who": "m"
+    },
+    {
+     "t0": 46.503,
+     "t1": 50.273,
+     "text": "从两颗星向下，两串星星并排伸展",
+     "who": "f"
+    },
+    {
+     "t0": 50.293,
+     "t1": 53.623,
+     "text": "就像一对兄弟，手牵着手，站在银河边上",
+     "who": "m"
+    }
+   ]
+  },
+  {
+   "id": "pair",
+   "title": "两颗星的秘密",
+   "tone": "violet",
+   "start": 54.949,
+   "end": 86.486,
+   "voice": {
+    "file": "audio/n03.mp3",
+    "at": 55.949,
+    "dur": 29.237
+   },
+   "subs": [
+    {
+     "t0": 55.949,
+     "t1": 58.679,
+     "text": "有意思的是，排名第一的北河二",
+     "who": "f"
+    },
+    {
+     "t0": 58.999,
+     "t1": 61.029,
+     "text": "其实没有北河三亮",
+     "who": "m"
+    },
+    {
+     "t0": 61.049,
+     "t1": 63.759,
+     "text": "北河三是一颗橙色的巨星",
+     "who": "f"
+    },
+    {
+     "t0": 63.779,
+     "t1": 65.299,
+     "text": "离我们大约34 光年",
+     "who": "m"
+    },
+    {
+     "t0": 65.629,
+     "t1": 71.019,
+     "text": "2006 年，天文学家确认，它身边有一颗行星在转动",
+     "who": "f"
+    },
+    {
+     "t0": 71.039,
+     "t1": 72.319,
+     "text": "而北河二更神奇",
+     "who": "m"
+    },
+    {
+     "t0": 72.749,
+     "t1": 74.349,
+     "text": "它看起来是一颗星",
+     "who": "f"
+    },
+    {
+     "t0": 74.659,
+     "t1": 76.859,
+     "text": "其实是六颗恒星组成的大家庭",
+     "who": "m"
+    },
+    {
+     "t0": 77.269,
+     "t1": 79.339,
+     "text": "三对双星彼此环绕",
+     "who": "f"
+    },
+    {
+     "t0": 79.359,
+     "t1": 81.469,
+     "text": "一起跳着一支很慢很慢的舞",
+     "who": "m"
+    },
+    {
+     "t0": 81.489,
+     "t1": 85.259,
+     "text": "你看，双子座连星星本身，都喜欢热闹",
+     "who": "f"
+    }
+   ]
+  },
+  {
+   "id": "myth",
+   "title": "卡斯托尔与波吕克斯",
+   "tone": "amber",
+   "start": 86.486,
+   "end": 127.24,
+   "voice": {
+    "file": "audio/n04.mp3",
+    "at": 87.486,
+    "dur": 38.453
+   },
+   "subs": [
+    {
+     "t0": 87.486,
+     "t1": 91.906,
+     "text": "古希腊传说里，卡斯托尔和波吕克斯是一对孪生兄弟",
+     "who": "m"
+    },
+    {
+     "t0": 91.926,
+     "t1": 94.996,
+     "text": "一个擅长驯马，一个擅长拳击",
+     "who": "f"
+    },
+    {
+     "t0": 95.016,
+     "t1": 98.636,
+     "text": "他们一起航海，一起冒险，从不分开",
+     "who": "m"
+    },
+    {
+     "t0": 98.656,
+     "t1": 100.826,
+     "text": "可是卡斯托尔是凡人",
+     "who": "f"
+    },
+    {
+     "t0": 100.846,
+     "t1": 103.316,
+     "text": "波吕克斯却拥有不死之身",
+     "who": "m"
+    },
+    {
+     "t0": 103.336,
+     "t1": 106.126,
+     "text": "当卡斯托尔在战斗中倒下",
+     "who": "f"
+    },
+    {
+     "t0": 106.146,
+     "t1": 108.156,
+     "text": "波吕克斯请求宙斯",
+     "who": "m"
+    },
+    {
+     "t0": 108.176,
+     "t1": 111.086,
+     "text": "把自己的永生，分一半给兄弟",
+     "who": "f"
+    },
+    {
+     "t0": 111.106,
+     "t1": 115.736,
+     "text": "从此，他们一天在天上，一天在冥界，永远在一起",
+     "who": "m"
+    },
+    {
+     "t0": 116.266,
+     "t1": 120.046,
+     "text": "宙斯被这份情谊打动，把他们升上星空",
+     "who": "f"
+    },
+    {
+     "t0": 120.066,
+     "t1": 123.606,
+     "text": "后来的水手们相信，看见桅杆上的蓝色火光",
+     "who": "m"
+    },
+    {
+     "t0": 123.916,
+     "t1": 126.006,
+     "text": "就是双子在为他们护航",
+     "who": "f"
+    }
+   ]
+  },
+  {
+   "id": "china",
+   "title": "北河与井宿",
+   "tone": "ink",
+   "start": 127.24,
+   "end": 152.385,
+   "voice": {
+    "file": "audio/n05.mp3",
+    "at": 128.24,
+    "dur": 22.846
+   },
+   "subs": [
+    {
+     "t0": 128.26,
+     "t1": 132.3,
+     "text": "在中国古代的星空里，他们有一个好听的名字",
+     "who": "f"
+    },
+    {
+     "t0": 132.32,
+     "t1": 133.16,
+     "text": "北河",
+     "who": "m"
+    },
+    {
+     "t0": 133.18,
+     "t1": 136.82,
+     "text": "北河二，北河三，守在银河的北岸",
+     "who": "f"
+    },
+    {
+     "t0": 136.84,
+     "t1": 138.66,
+     "text": "它们属于二十八宿中的井宿",
+     "who": "m"
+    },
+    {
+     "t0": 138.96,
+     "t1": 142.24,
+     "text": "井宿，是南方朱雀七宿的第一宿",
+     "who": "f"
+    },
+    {
+     "t0": 142.26,
+     "t1": 145.51,
+     "text": "古人看着它，观测天象，校准历法",
+     "who": "m"
+    },
+    {
+     "t0": 145.89,
+     "t1": 149.67,
+     "text": "东方和西方，看见的是同一片星空",
+     "who": "f"
+    },
+    {
+     "t0": 149.69,
+     "t1": 151.1,
+     "text": "却讲出了不同的故事",
+     "who": "m"
+    }
+   ]
+  },
+  {
+   "id": "discover",
+   "title": "两颗行星的发现",
+   "tone": "deep",
+   "start": 152.385,
+   "end": 183.553,
+   "voice": {
+    "file": "audio/n06.mp3",
+    "at": 153.385,
+    "dur": 28.868
+   },
+   "subs": [
+    {
+     "t0": 153.465,
+     "t1": 155.635,
+     "text": "双子座还有一个了不起的身份",
+     "who": "m"
+    },
+    {
+     "t0": 155.655,
+     "t1": 156.865,
+     "text": "发现之地",
+     "who": "f"
+    },
+    {
+     "t0": 156.885,
+     "t1": 161.115,
+     "text": "1781 年，英国天文学家威廉·赫歇尔",
+     "who": "m"
+    },
+    {
+     "t0": 161.525,
+     "t1": 165.075,
+     "text": "在双子座里，看见一个缓缓移动的光点",
+     "who": "f"
+    },
+    {
+     "t0": 165.095,
+     "t1": 168.935,
+     "text": "那是天王星，人类用望远镜发现的第一颗行星",
+     "who": "m"
+    },
+    {
+     "t0": 168.955,
+     "t1": 172.955,
+     "text": "1930 年，美国青年克莱德·汤博",
+     "who": "f"
+    },
+    {
+     "t0": 172.975,
+     "t1": 175.155,
+     "text": "一张一张地比对星空底片",
+     "who": "m"
+    },
+    {
+     "t0": 175.175,
+     "t1": 178.925,
+     "text": "他在双子座的星星之间，找到了冥王星",
+     "who": "f"
+    },
+    {
+     "t0": 178.945,
+     "t1": 182.315,
+     "text": "好奇心，在这里两次改写了太阳系的地图",
+     "who": "m"
+    }
+   ]
+  },
+  {
+   "id": "meteor",
+   "title": "双子座流星雨",
+   "tone": "snow",
+   "start": 183.553,
+   "end": 206.286,
+   "voice": {
+    "file": "audio/n07.mp3",
+    "at": 184.553,
+    "dur": 20.432
+   },
+   "subs": [
+    {
+     "t0": 184.533,
+     "t1": 188.893,
+     "text": "每年十二月中旬，双子座还会送出一份礼物",
+     "who": "f"
+    },
+    {
+     "t0": 188.913,
+     "t1": 190.433,
+     "text": "双子座流星雨",
+     "who": "m"
+    },
+    {
+     "t0": 190.453,
+     "t1": 193.593,
+     "text": "它是一年中最壮观的流星雨之一",
+     "who": "f"
+    },
+    {
+     "t0": 193.613,
+     "t1": 196.963,
+     "text": "高峰时，每小时可以看到100 多颗",
+     "who": "m"
+    },
+    {
+     "t0": 196.983,
+     "t1": 198.873,
+     "text": "它的源头不是彗星",
+     "who": "f"
+    },
+    {
+     "t0": 198.893,
+     "t1": 201.053,
+     "text": "而是一颗叫法厄同的小行星",
+     "who": "m"
+    },
+    {
+     "t0": 201.073,
+     "t1": 202.883,
+     "text": "冬夜里抬头许愿吧",
+     "who": "f"
+    },
+    {
+     "t0": 203.193,
+     "t1": 205.003,
+     "text": "星星会从双子的方向飞来",
+     "who": "m"
+    }
+   ]
+  },
+  {
+   "id": "sign",
+   "title": "风象 · 水星 · ♊",
+   "tone": "aurora",
+   "start": 206.286,
+   "end": 236.789,
+   "voice": {
+    "file": "audio/n08.mp3",
+    "at": 207.286,
+    "dur": 28.204
+   },
+   "subs": [
+    {
+     "t0": 207.276,
+     "t1": 210.396,
+     "text": "双子座的符号，像罗马数字二",
+     "who": "f"
+    },
+    {
+     "t0": 210.416,
+     "t1": 213.446,
+     "text": "两根柱子，被上下两道横梁连在一起",
+     "who": "m"
+    },
+    {
+     "t0": 213.896,
+     "t1": 215.736,
+     "text": "它属于风象星座",
+     "who": "f"
+    },
+    {
+     "t0": 215.756,
+     "t1": 217.346,
+     "text": "守护星是水星",
+     "who": "m"
+    },
+    {
+     "t0": 217.366,
+     "t1": 221.786,
+     "text": "水星是众神的信使，跑得最快，消息最灵",
+     "who": "f"
+    },
+    {
+     "t0": 221.806,
+     "t1": 226.006,
+     "text": "所以人们说，双子座好奇，聪明，反应快",
+     "who": "m"
+    },
+    {
+     "t0": 226.026,
+     "t1": 228.056,
+     "text": "会表达，爱学习",
+     "who": "f"
+    },
+    {
+     "t0": 228.076,
+     "t1": 229.866,
+     "text": "总能把陌生人变成朋友",
+     "who": "m"
+    },
+    {
+     "t0": 229.886,
+     "t1": 232.166,
+     "text": "有人说双子座善变",
+     "who": "f"
+    },
+    {
+     "t0": 232.186,
+     "t1": 235.436,
+     "text": "其实，那是一颗心里，装着两倍的世界",
+     "who": "m"
+    }
+   ]
+  },
+  {
+   "id": "medal",
+   "title": "双星荣誉徽章",
+   "tone": "royal",
+   "start": 236.789,
+   "end": 259.402,
+   "voice": {
+    "file": "audio/n09.mp3",
+    "at": 237.789,
+    "dur": 20.313
+   },
+   "subs": [
+    {
+     "t0": 237.819,
+     "t1": 240.119,
+     "text": "所以，如果你是双子座",
+     "who": "m"
+    },
+    {
+     "t0": 240.139,
+     "t1": 243.039,
+     "text": "这枚双星荣誉徽章，属于你",
+     "who": "f"
+    },
+    {
+     "t0": 243.059,
+     "t1": 244.339,
+     "text": "一半是北河二的银",
+     "who": "m"
+    },
+    {
+     "t0": 244.679,
+     "t1": 246.709,
+     "text": "一半是北河三的金",
+     "who": "f"
+    },
+    {
+     "t0": 246.729,
+     "t1": 248.749,
+     "text": "上面刻着你的名字",
+     "who": "m"
+    },
+    {
+     "t0": 248.769,
+     "t1": 252.729,
+     "text": "和你最闪亮的天赋，好奇，灵动，真诚",
+     "who": "f"
+    },
+    {
+     "t0": 253.049,
+     "t1": 254.979,
+     "text": "双子座，星空的信使",
+     "who": "m"
+    },
+    {
+     "t0": 255.289,
+     "t1": 258.179,
+     "text": "世界因为你的好奇，变得更有趣",
+     "who": "f"
+    }
+   ]
+  },
+  {
+   "id": "coda",
+   "title": "尾声 · 两束光",
+   "tone": "dusk",
+   "start": 259.402,
+   "end": 280.852,
+   "voice": {
+    "file": "audio/n10.mp3",
+    "at": 260.402,
+    "dur": 13.15
+   },
+   "subs": [
+    {
+     "t0": 260.482,
+     "t1": 262.522,
+     "text": "下一次，夏天的风吹过来",
+     "who": "m"
+    },
+    {
+     "t0": 262.872,
+     "t1": 265.862,
+     "text": "抬头看看那两颗并肩的星星",
+     "who": "f"
+    },
+    {
+     "t0": 265.882,
+     "t1": 267.272,
+     "text": "你从来不是一个人",
+     "who": "m"
+    },
+    {
+     "t0": 267.292,
+     "t1": 270.272,
+     "text": "你是两束光，也是一整片星空",
+     "who": "f"
+    },
+    {
+     "t0": 270.292,
+     "t1": 273.602,
+     "text": "双子座，保持好奇，闪闪发光",
+     "who": "fm"
+    }
+   ]
+  }
+ ]
+};

gemini/tools/align.mjs

@@ -0,0 +1,23 @@
+// ♊ 字幕 ↔ 旁白波形对齐（全新编写）。node gemini/tools/align.mjs  （环境变量 FF = ffmpeg）
+// 起点：吸附到真实发声点前 LEAD 秒；终点：到下一句开口前、本句最后一个有声帧之后 TAIL 秒
+import fs from 'fs'; import path from 'path'; import { execFileSync } from 'child_process'; import { fileURLToPath } from 'url';
+const DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'), FILE = path.join(DIR, 'engine/timeline.js');
+const src = fs.readFileSync(FILE, 'utf8'), TL = JSON.parse(src.slice(src.indexOf('{'), src.lastIndexOf('}') + 1));
+const SR = 8000, FR = 100, LEAD = .06, TAIL = .15, stats = [];
+for (const A of TL.acts) {
+  const b = execFileSync(process.env.FF || 'ffmpeg', ['-v', 'error', '-i', path.join(DIR, A.voice.file), '-ac', '1', '-ar', '' + SR, '-f', 'f32le', '-'], { maxBuffer: 1 << 26 });
+  const x = new Float32Array(b.buffer, b.byteOffset, b.length / 4), hop = SR / FR, e = [];
+  for (let i = 0; i < x.length; i += hop) { let s = 0; for (let j = i; j < i + hop && j < x.length; j++) s += x[j] * x[j]; e.push(Math.sqrt(s / hop)); }
+  const th = Math.max(.01, Math.max(...e) * .055), loud = f => e[f] > th;
+  const onset = f0 => { let best = null; for (let d = -40; d <= 40; d++) { const f = f0 + d; if (f >= 0 && loud(f) && [1, 2, 3, 4, 5].every(k => f - k < 0 || !loud(f - k)) && (best === null || Math.abs(d) < Math.abs(best))) best = d; } return best === null ? f0 : f0 + best; };
+  const on = A.subs.map((s, i) => i === 0 ? e.findIndex(v => v > th) : onset(Math.round((s.t0 - A.voice.at) * FR))); // 每幕首句 = 音频第一个有声帧
+  A.subs.forEach((s, i) => { const t0 = A.voice.at + on[i] / FR - LEAD; stats.push(Math.round((t0 + LEAD - s.t0) * 1000)); s.t0 = +t0.toFixed(3);
+    const lim = i < on.length - 1 ? on[i + 1] : e.length; let last = on[i]; for (let f = on[i]; f < lim; f++) if (loud(f)) last = f;
+    s.t1 = +(A.voice.at + last / FR + TAIL).toFixed(3); });
+  A.subs.forEach((s, i) => { const n = A.subs[i + 1]; if (n && (s.t1 > n.t0 - .02 || n.t0 - s.t1 < .3)) s.t1 = +(n.t0 - .02).toFixed(3); if (s.t1 < s.t0 + .5) s.t1 = +(s.t0 + .5).toFixed(3); });
+  // 校验：每个有声帧都应被某条字幕覆盖
+  let miss = 0; e.forEach((v, f) => { if (v > th) { const t = A.voice.at + f / FR; if (!A.subs.some(s => t >= s.t0 && t <= s.t1)) miss++; } }); A._miss = miss;
+}
+const miss = TL.acts.reduce((a, A) => a + A._miss, 0); TL.acts.forEach(A => delete A._miss);
+fs.writeFileSync(FILE, src.slice(0, src.indexOf('{')) + JSON.stringify(TL, null, 1) + src.slice(src.lastIndexOf('}') + 1));
+console.log(`对齐 ${stats.length} 条；原始偏差 ${Math.min(...stats)}~${Math.max(...stats)} ms；有声却无字幕的帧 ${miss}`);

gemini/tools/narrate.py

@@ -0,0 +1,109 @@
+# ♊ 双子座 —— 双声旁白生成（全新编写）
+# 用法（在仓库根目录）：PYTHONPATH=<含 edge_tts 的目录> python3 gemini/tools/narrate.py
+# 输出：gemini/audio/n01..n10.mp3 与 gemini/engine/timeline.js
+import asyncio, json, os, subprocess, sys, array
+import edge_tts, imageio_ffmpeg
+
+FF = imageio_ffmpeg.get_ffmpeg_exe()
+ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), '..')
+VOICE = {'f': 'zh-CN-XiaoxiaoNeural', 'm': 'zh-CN-YunxiNeural'}
+RATE = {'f': '-4%', 'm': '-2%'}
+SR = 24000
+LINE_GAP = 0.32          # 句间停顿
+LEAD = {0: 2.4}; DEFAULT_LEAD = 1.0
+GAP = 1.3; OUTRO = 6.0
+
+F, M, B = 'f', 'm', 'fm'
+# 字幕显示用写法（朗读仍用汉字读音）
+DISPLAY = {'二零零六年': '2006 年', '一七八一年': '1781 年', '一九三零年': '1930 年', '三十四光年': '34 光年', '五月二十一日到六月二十一日': '5 月 21 日到 6 月 21 日', '一百多颗': '100 多颗'}
+def shown(t):
+    for a, b in DISPLAY.items(): t = t.replace(a, b)
+    return t.rstrip('。，、')
+ACTS = [
+  ('twin', '序章 · 镜中的双星', 'dawn', [
+    (F, '五月的尾巴，夏天刚刚推开门。'), (M, '夜空里，有两颗星总是肩并着肩。'), (F, '一颗明亮温暖，'), (M, '一颗清澈闪烁。'),
+    (F, '它们像一面镜子的两边，'), (M, '又像同一个灵魂的两种声音。'), (F, '这就是黄道第三宫，双子座。'),
+    (M, '五月二十一日到六月二十一日出生的你，'), (F, '欢迎回到自己的星空。')]),
+  ('locate', '找到他们', 'night', [
+    (M, '冬天和早春的夜晚，先找到猎户座。'), (F, '从猎户脚下的参宿七出发，'), (M, '穿过肩头那颗橙红的参宿四，'), (F, '一直向东北方延伸。'),
+    (M, '你会看到两颗相距不远的亮星。'), (F, '西边那颗是北河二，卡斯托尔。'), (M, '东边更亮的那颗，是北河三，波吕克斯。'),
+    (F, '从两颗星向下，两串星星并排伸展，'), (M, '就像一对兄弟，手牵着手，站在银河边上。')]),
+  ('pair', '两颗星的秘密', 'violet', [
+    (F, '有意思的是，排名第一的北河二，'), (M, '其实没有北河三亮。'), (F, '北河三是一颗橙色的巨星，'), (M, '离我们大约三十四光年。'),
+    (F, '二零零六年，天文学家确认，它身边有一颗行星在转动。'), (M, '而北河二更神奇。'), (F, '它看起来是一颗星，'),
+    (M, '其实是六颗恒星组成的大家庭。'), (F, '三对双星彼此环绕，'), (M, '一起跳着一支很慢很慢的舞。'), (F, '你看，双子座连星星本身，都喜欢热闹。')]),
+  ('myth', '卡斯托尔与波吕克斯', 'amber', [
+    (M, '古希腊传说里，卡斯托尔和波吕克斯是一对孪生兄弟。'), (F, '一个擅长驯马，一个擅长拳击。'), (M, '他们一起航海，一起冒险，从不分开。'),
+    (F, '可是卡斯托尔是凡人，'), (M, '波吕克斯却拥有不死之身。'), (F, '当卡斯托尔在战斗中倒下，'), (M, '波吕克斯请求宙斯，'),
+    (F, '把自己的永生，分一半给兄弟。'), (M, '从此，他们一天在天上，一天在冥界，永远在一起。'), (F, '宙斯被这份情谊打动，把他们升上星空。'),
+    (M, '后来的水手们相信，看见桅杆上的蓝色火光，'), (F, '就是双子在为他们护航。')]),
+  ('china', '北河与井宿', 'ink', [
+    (F, '在中国古代的星空里，他们有一个好听的名字，'), (M, '北河。'), (F, '北河二，北河三，守在银河的北岸。'),
+    (M, '它们属于二十八宿中的井宿。'), (F, '井宿，是南方朱雀七宿的第一宿。'), (M, '古人看着它，观测天象，校准历法。'),
+    (F, '东方和西方，看见的是同一片星空，'), (M, '却讲出了不同的故事。')]),
+  ('discover', '两颗行星的发现', 'deep', [
+    (M, '双子座还有一个了不起的身份，'), (F, '发现之地。'), (M, '一七八一年，英国天文学家威廉·赫歇尔，'), (F, '在双子座里，看见一个缓缓移动的光点。'),
+    (M, '那是天王星，人类用望远镜发现的第一颗行星。'), (F, '一九三零年，美国青年克莱德·汤博，'), (M, '一张一张地比对星空底片。'),
+    (F, '他在双子座的星星之间，找到了冥王星。'), (M, '好奇心，在这里两次改写了太阳系的地图。')]),
+  ('meteor', '双子座流星雨', 'snow', [
+    (F, '每年十二月中旬，双子座还会送出一份礼物，'), (M, '双子座流星雨。'), (F, '它是一年中最壮观的流星雨之一，'),
+    (M, '高峰时，每小时可以看到一百多颗。'), (F, '它的源头不是彗星，'), (M, '而是一颗叫法厄同的小行星。'),
+    (F, '冬夜里抬头许愿吧，'), (M, '星星会从双子的方向飞来。')]),
+  ('sign', '风象 · 水星 · ♊', 'aurora', [
+    (F, '双子座的符号，像罗马数字二，'), (M, '两根柱子，被上下两道横梁连在一起。'), (F, '它属于风象星座，'), (M, '守护星是��星。'),
+    (F, '水星是众神的信使，跑得最快，消息最灵。'), (M, '所以人们说，双子座好奇，聪明，反应快，'), (F, '会表达，爱学习，'),
+    (M, '总能把陌生人变成朋友。'), (F, '有人说双子座善变，'), (M, '其实，那是一颗心里，装着两倍的世界。')]),
+  ('medal', '双星荣誉徽章', 'royal', [
+    (M, '所以，如果你是双子座，'), (F, '这枚双星荣誉徽章，属于你。'), (M, '一半是北河二的银，'), (F, '一半是北河三的金。'),
+    (M, '上面刻着你的名字，'), (F, '和你最闪亮的天赋，好奇，灵动，真诚。'), (M, '双子座，星空的信使。'), (F, '世界因为你的好奇，变得更有趣。')]),
+  ('coda', '尾声 · 两束光', 'dusk', [
+    (M, '下一次，夏天的风吹过来，'), (F, '抬头看看那两颗并肩的星星。'), (M, '你从来不是一个人，'), (F, '你是两束光，也是一整片星空。'),
+    (B, '双子座，保持好奇，闪闪发光。')]),
+]
+
+async def tts(text, who):
+    com = edge_tts.Communicate(text, VOICE[who], rate=RATE[who], boundary='WordBoundary')
+    audio = bytearray(); words = []
+    async for ch in com.stream():
+        if ch['type'] == 'audio': audio += ch['data']
+        elif ch['type'] == 'WordBoundary': words.append((ch['offset'] / 1e7, (ch['offset'] + ch['duration']) / 1e7, ch['text']))
+    pcm = subprocess.run([FF, '-v', 'error', '-i', 'pipe:0', '-f', 's16le', '-ac', '1', '-ar', str(SR), 'pipe:1'], input=bytes(audio), capture_output=True, check=True).stdout
+    a = array.array('h'); a.frombytes(pcm)
+    # 去掉首尾静音（保留 40ms）
+    th = 500; i0 = next((i for i, v in enumerate(a) if abs(v) > th), 0); i1 = len(a) - next((i for i, v in enumerate(reversed(a)) if abs(v) > th), 0)
+    i0 = max(0, i0 - int(.04 * SR)); i1 = min(len(a), i1 + int(.06 * SR))
+    return a[i0:i1], [(s - i0 / SR, e - i0 / SR, w) for s, e, w in words]
+
+async def line(who, text):
+    if who != B: return await tts(text, who)
+    (a, w), (b, _) = await tts(text, F), await tts(text, M)
+    n = max(len(a), len(b)); out = array.array('h', [0] * n)
+    for i in range(n):
+        v = (a[i] if i < len(a) else 0) * .62 + (b[i] if i < len(b) else 0) * .62
+        out[i] = int(max(-32767, min(32767, v)))
+    return out, w
+
+async def main():
+    os.makedirs(os.path.join(ROOT, 'audio'), exist_ok=True)
+    t = 0.0; acts = []
+    for k, (aid, title, tone, lines) in enumerate(ACTS):
+        lead = LEAD.get(k, DEFAULT_LEAD); at = t + lead
+        pcm = array.array('h'); subs = []
+        for who, text in lines:
+            a, _ = await line(who, text)
+            st = len(pcm) / SR
+            subs.append({'t0': round(at + st, 3), 't1': round(at + st + len(a) / SR, 3), 'text': shown(text), 'who': who})
+            pcm += a; pcm += array.array('h', [0] * int(LINE_GAP * SR))
+            print(aid, who, text, flush=True)
+        dur = len(pcm) / SR - LINE_GAP
+        f = f'audio/n{k + 1:02d}.mp3'
+        subprocess.run([FF, '-v', 'error', '-y', '-f', 's16le', '-ar', str(SR), '-ac', '1', '-i', 'pipe:0', '-c:a', 'libmp3lame', '-b:a', '96k', os.path.join(ROOT, f)], input=pcm.tobytes(), check=True)
+        end = at + dur + GAP + (OUTRO if k == len(ACTS) - 1 else 0)
+        acts.append({'id': aid, 'title': title, 'tone': tone, 'start': round(t, 3), 'end': round(end, 3), 'voice': {'file': f, 'at': round(at, 3), 'dur': round(dur, 3)}, 'subs': subs})
+        t = end
+    tl = {'duration': round(t, 3), 'voices': VOICE, 'acts': acts}
+    with open(os.path.join(ROOT, 'engine/timeline.js'), 'w') as fp:
+        fp.write('// 由 tools/narrate.py 生成、tools/align.mjs 校准：双声旁白时间轴与字幕\nexport const TIMELINE = ' + json.dumps(tl, ensure_ascii=False, indent=1) + ';\n')
+    print('total', round(t, 2), 'subs', sum(len(a['subs']) for a in acts))
+
+asyncio.run(main())