gemini-stars: 旁白文案、TTS 音频与时间轴（step 2）

gemini-stars/README.md

@@ -59,7 +59,7 @@ gemini-stars/
 ## 4. 步骤与进度看板
 
 - [x] Step 1：撰写本计划（本文件）并推送
-- [ ] Step 2：撰写旁白文案，生成 TTS 音频与 `timeline.js`，推送
+- [x] Step 2：撰写旁白文案，生成 TTS 音频与 `timeline.js`，推送
 - [ ] Step 3：场景动画引擎与全部场景（横/竖屏自适应），推送
 - [ ] Step 4：配乐与音效合成、混音、播放器，推送
 - [ ] Step 5：MP4 本地导出（24/30/60fps，横/竖屏），推送

gemini-stars/timeline.js

@@ -0,0 +1,243 @@
+// 由 tools/make_voice.py 自动生成，请勿手改
+export const TIMELINE = {
+ "duration": 214.32,
+ "scenes": [
+  {
+   "id": "intro",
+   "start": 0,
+   "lines": [
+    {
+     "file": "audio/v01.mp3",
+     "text": "冬天的夜里，如果你抬头望向东方，会看到两颗明亮的星星，肩并着肩。",
+     "start": 2.6,
+     "end": 9.63
+    },
+    {
+     "file": "audio/v02.mp3",
+     "text": "它们就像一对形影不离的兄弟——这，就是双子座。",
+     "start": 10.01,
+     "end": 14.86
+    }
+   ],
+   "end": 15.64
+  },
+  {
+   "id": "find",
+   "start": 15.64,
+   "lines": [
+    {
+     "file": "audio/v03.mp3",
+     "text": "想找到它很简单。先找到猎户座腰带上的三颗星，",
+     "start": 16.24,
+     "end": 21.74
+    },
+    {
+     "file": "audio/v04.mp3",
+     "text": "再顺着猎户座的身体，向东北方向望过去。",
+     "start": 22.12,
+     "end": 26.39
+    },
+    {
+     "file": "audio/v05.mp3",
+     "text": "那两颗挨得很近的亮星，就是双子的头：北河二和北河三。",
+     "start": 26.77,
+     "end": 32.63
+    },
+    {
+     "file": "audio/v06.mp3",
+     "text": "从它们向下延伸出两串星，像两个手拉着手的小人，站在银河岸边。",
+     "start": 33.01,
+     "end": 39.78
+    }
+   ],
+   "end": 40.64
+  },
+  {
+   "id": "myth",
+   "start": 40.64,
+   "lines": [
+    {
+     "file": "audio/v07.mp3",
+     "text": "在古希腊神话里，他们是一对孪生兄弟：哥哥卡斯托尔擅长驯马，弟弟波吕克斯是拳击高手。",
+     "start": 41.36,
+     "end": 50.82
+    },
+    {
+     "file": "audio/v08.mp3",
+     "text": "可他们的命运并不相同：卡斯托尔是凡人，而波吕克斯是宙斯之子，拥有不朽的生命。",
+     "start": 51.2,
+     "end": 59.74
+    },
+    {
+     "file": "audio/v09.mp3",
+     "text": "一次争斗中，卡斯托尔中箭身亡。",
+     "start": 60.12,
+     "end": 63.89
+    },
+    {
+     "file": "audio/v10.mp3",
+     "text": "波吕克斯悲痛万分，他请求宙斯：把我的不朽，分一半给哥哥吧。",
+     "start": 64.27,
+     "end": 70.75
+    },
+    {
+     "file": "audio/v11.mp3",
+     "text": "宙斯被打动了。从此兄弟俩一天在天上，一天在冥界，永远不再分开，并肩化作了夜空中的双子座。",
+     "start": 71.13,
+     "end": 81.59
+    }
+   ],
+   "end": 82.45
+  },
+  {
+   "id": "castor",
+   "start": 82.45,
+   "lines": [
+    {
+     "file": "audio/v12.mp3",
+     "text": "神话很浪漫，而科学更惊奇。",
+     "start": 83.17,
+     "end": 86.79
+    },
+    {
+     "file": "audio/v13.mp3",
+     "text": "哥哥北河二，用肉眼看只是一颗星，可在望远镜里，它分成了好几颗。",
+     "start": 87.17,
+     "end": 94.32
+    },
+    {
+     "file": "audio/v14.mp3",
+     "text": "天文学家发现，它其实是六颗恒星组成的大家庭：三对双星彼此绕转，距离我们大约五十一光年。",
+     "start": 94.7,
+     "end": 104.44
+    }
+   ],
+   "end": 105.22
+  },
+  {
+   "id": "pollux",
+   "start": 105.22,
+   "lines": [
+    {
+     "file": "audio/v15.mp3",
+     "text": "弟弟北河三，是一颗橙色的巨星，距离我们大约三十四光年。",
+     "start": 105.82,
+     "end": 111.87
+    },
+    {
+     "file": "audio/v16.mp3",
+     "text": "有趣的是，它排名叫“三”，却比“二”号哥哥更亮，是整个双子座最亮的星。",
+     "start": 112.25,
+     "end": 119.31
+    },
+    {
+     "file": "audio/v17.mp3",
+     "text": "在它身旁，还有一颗质量至少是木星两倍的行星，默默绕转。",
+     "start": 119.69,
+     "end": 125.71
+    }
+   ],
+   "end": 126.57
+  },
+  {
+   "id": "meteor",
+   "start": 126.57,
+   "lines": [
+    {
+     "file": "audio/v18.mp3",
+     "text": "每年十二月中旬，双子座还会送来一份盛大的礼物——双子座流星雨。",
+     "start": 127.29,
+     "end": 134.15
+    },
+    {
+     "file": "audio/v19.mp3",
+     "text": "在理想的暗夜里，高峰时每小时能看到一百多颗流星。",
+     "start": 134.53,
+     "end": 140.12
+    },
+    {
+     "file": "audio/v20.mp3",
+     "text": "大多数流星雨来自彗星，而它的母体，却是一颗名叫法厄同的小行星。",
+     "start": 140.5,
+     "end": 147.58
+    }
+   ],
+   "end": 148.44
+  },
+  {
+   "id": "discover",
+   "start": 148.44,
+   "lines": [
+    {
+     "file": "audio/v21.mp3",
+     "text": "双子座还见证过天文史上的重要时刻。",
+     "start": 149.16,
+     "end": 153.24
+    },
+    {
+     "file": "audio/v22.mp3",
+     "text": "一七八一年，赫歇尔在双子座附近发现了天王星；",
+     "start": 153.62,
+     "end": 158.92
+    },
+    {
+     "file": "audio/v23.mp3",
+     "text": "一九三零年，汤博在双子座天区的照片里，找到了冥王星。",
+     "start": 159.3,
+     "end": 165.35
+    }
+   ],
+   "end": 166.21
+  },
+  {
+   "id": "zodiac",
+   "start": 166.21,
+   "lines": [
+    {
+     "file": "audio/v24.mp3",
+     "text": "双子座也是黄道星座之一。每年六月下旬到七月下旬，太阳会从它的天区穿过。",
+     "start": 166.93,
+     "end": 175.57
+    },
+    {
+     "file": "audio/v25.mp3",
+     "text": "而在占星文化里，五月二十一日到六月二十一日出生的人被称作双子座，",
+     "start": 175.95,
+     "end": 183.27
+    },
+    {
+     "file": "audio/v26.mp3",
+     "text": "人们常用好奇、健谈、灵动来形容他们——当然，这只是一种有趣的文化想象。",
+     "start": 183.65,
+     "end": 191.33
+    }
+   ],
+   "end": 192.19
+  },
+  {
+   "id": "outro",
+   "start": 192.19,
+   "lines": [
+    {
+     "file": "audio/v27.mp3",
+     "text": "两颗星，一段兄弟情，一场流星雨，和一个装满秘密的六星家族。",
+     "start": 192.91,
+     "end": 199.63
+    },
+    {
+     "file": "audio/v28.mp3",
+     "text": "下一个晴朗的冬夜，记得抬头，找一找那对并肩的星星。",
+     "start": 200.01,
+     "end": 205.51
+    },
+    {
+     "file": "audio/v29.mp3",
+     "text": "它们已经在那里，等了你很久很久。",
+     "start": 205.89,
+     "end": 209.44
+    }
+   ],
+   "end": 214.32
+  }
+ ]
+};

gemini-stars/tools/make_voice.py

@@ -0,0 +1,85 @@
+"""生成双子座旁白音频与时间轴 timeline.js
+依赖: pip install edge-tts imageio-ffmpeg
+用法: python tools/make_voice.py
+"""
+import asyncio, json, os, re, subprocess
+import edge_tts, imageio_ffmpeg
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+ROOT = os.path.dirname(HERE)
+VOICE = "zh-CN-XiaoxiaoNeural"
+RATE = "-4%"
+
+SCENES = [
+ ("intro", 2.6, [
+  "冬天的夜里，如果你抬头望向东方，会看到两颗明亮的星星，肩并着肩。",
+  "它们就像一对形影不离的兄弟——这，就是双子座。"]),
+ ("find", 1.0, [
+  "想找到它很简单。先找到猎户座腰带上的三颗星，",
+  "再顺着猎户座的身体，向东北方向望过去。",
+  "那两颗挨得很近的亮星，就是双子的头：北河二和北河三。",
+  "从它们向下延伸出两串星，像两个手拉着手的小人，站在银河岸边。"]),
+ ("myth", 1.2, [
+  "在古希腊神话里，他们是一对孪生兄弟：哥哥卡斯托尔擅长驯马，弟弟波吕克斯是拳击高手。",
+  "可他们的命运并不相同：卡斯托尔是凡人，而波吕克斯是宙斯之子，拥有不朽的生命。",
+  "一次争斗中，卡斯托尔中箭身亡。",
+  "波吕克斯悲痛万分，他请求宙斯：把我的不朽，分一半给哥哥吧。",
+  "宙斯被打动了。从此兄弟俩一天在天上，一天在冥界，永远不再分开，并肩化作了夜空中的双子座。"]),
+ ("castor", 1.2, [
+  "神话很浪漫，而科学更惊奇。",
+  "哥哥北河二，用肉眼看只是一颗星，可在望远镜里，它分成了好几颗。",
+  "天文学家发现，它其实是六颗恒星组成的大家庭：三对双星彼此绕转，距离我们大约五十一光年。"]),
+ ("pollux", 1.0, [
+  "弟弟北河三，是一颗橙色的巨星，距离我们大约三十四光年。",
+  "有趣的是，它排名叫“三”，却比“二”号哥哥更亮，是整个双子座最亮的星。",
+  "在它身旁，还有一颗质量至少是木星两倍的行星，默默绕转。"]),
+ ("meteor", 1.2, [
+  "每年十二月中旬，双子座还会送来一份盛大的礼物——双子座流星雨。",
+  "在理想的暗夜里，高峰时每小时能看到一百多颗流星。",
+  "大多数流星雨来自彗星，而它的母体，却是一颗名叫法厄同的小行星。"]),
+ ("discover", 1.2, [
+  "双子座还见证过天文史上的重要时刻。",
+  "一七八一年，赫歇尔在双子座附近发现了天王星；",
+  "一九三零年，汤博在双子座天区的照片里，找到了冥王星。"]),
+ ("zodiac", 1.2, [
+  "双子座也是黄道星座之一。每年六月下旬到七月下旬，太阳会从它的天区穿过。",
+  "而在占星文化里，五月二十一日到六月二十一日出生的人被称作双子座，",
+  "人们常用好奇、健谈、灵动来形容他们——当然，这只是一种有趣的文化想象。"]),
+ ("outro", 1.2, [
+  "两颗星，一段兄弟情，一场流星雨，和一个装满秘密的六星家族。",
+  "下一个晴朗的冬夜，记得抬头，找一找那对并肩的星星。",
+  "它们已经在那里，等了你很久很久。"]),
+]
+GAP = 0.38
+TAIL = 4.5
+FF = imageio_ffmpeg.get_ffmpeg_exe()
+
+def dur(path):
+    r = subprocess.run([FF, "-i", path], capture_output=True, text=True).stderr
+    h, m, s = re.search(r"Duration: (\d+):(\d+):([\d.]+)", r).groups()
+    return int(h) * 3600 + int(m) * 60 + float(s)
+
+async def main():
+    os.makedirs(os.path.join(ROOT, "audio"), exist_ok=True)
+    t = 0.0; idx = 0; scenes = []
+    for sid, lead, lines in SCENES:
+        t += lead
+        sc = {"id": sid, "start": round(t - lead * 0.6 if scenes else 0, 3), "lines": []}
+        for text in lines:
+            idx += 1
+            fn = f"audio/v{idx:02d}.mp3"
+            out = os.path.join(ROOT, fn)
+            if not os.path.exists(out):
+                await edge_tts.Communicate(text, VOICE, rate=RATE).save(out)
+            d = dur(out)
+            sc["lines"].append({"file": fn, "text": text, "start": round(t, 3), "end": round(t + d, 3)})
+            t += d + GAP
+        scenes.append(sc)
+    for i, sc in enumerate(scenes):
+        sc["end"] = scenes[i + 1]["start"] if i + 1 < len(scenes) else round(t + TAIL, 3)
+    total = scenes[-1]["end"]
+    js = "// 由 tools/make_voice.py 自动生成，请勿手改\nexport const TIMELINE = " + json.dumps({"duration": total, "scenes": scenes}, ensure_ascii=False, indent=1) + ";\n"
+    open(os.path.join(ROOT, "timeline.js"), "w").write(js)
+    print("total", total)
+
+asyncio.run(main())