cotutor 0.2.0 → 0.4.0

package/dist/media/mp4.js

@@ -0,0 +1,58 @@
+/**
+ * mp4 的时长(视频小课堂的课长第 4 步):走顶层的盒子找 moov,再在里面找 mvhd,读 timescale 与 duration。
+ * 只读盒子头,不把整个文件读进来(moov 在末尾也行);认不出来回 null,不抛。
+ */
+import { open } from 'node:fs/promises';
+export async function mp4DurationMs(file) {
+    const fh = await open(file, 'r').catch(() => null);
+    if (!fh)
+        return null;
+    try {
+        const size = (await fh.stat()).size;
+        const read = async (at, n) => {
+            const b = Buffer.alloc(n);
+            const { bytesRead } = await fh.read(b, 0, n, at);
+            return b.subarray(0, bytesRead);
+        };
+        /** [from, to) 里找某个盒子:回它的正文起点与终点 */
+        const find = async (from, to, type) => {
+            let at = from;
+            while (at + 8 <= to) {
+                const h = await read(at, 16);
+                if (h.length < 8)
+                    return null;
+                let len = h.readUInt32BE(0);
+                let head = 8;
+                if (len === 1) {
+                    if (h.length < 16)
+                        return null;
+                    len = Number(h.readBigUInt64BE(8));
+                    head = 16;
+                }
+                else if (len === 0)
+                    len = to - at;
+                if (len < head)
+                    return null;
+                if (h.toString('latin1', 4, 8) === type)
+                    return { body: at + head, end: Math.min(at + len, to) };
+                at += len;
+            }
+            return null;
+        };
+        const moov = await find(0, size, 'moov');
+        const mvhd = moov ? await find(moov.body, moov.end, 'mvhd') : null;
+        if (!mvhd)
+            return null;
+        const b = await read(mvhd.body, 32);
+        const v1 = b[0] === 1;
+        const scale = v1 ? b.readUInt32BE(20) : b.readUInt32BE(12);
+        const dur = v1 ? Number(b.readBigUInt64BE(24)) : b.readUInt32BE(16);
+        return scale > 0 ? Math.round((dur / scale) * 1000) : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        await fh.close();
+    }
+}

package/dist/media/tts-voices.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 卡的配音认的音色:百炼 Qwen-Audio-TTS(qwen-audio-3.0-tts-plus)的 597 个基础音色。2026-10-31 从 voxtell 的 data/voices.json 搬来
+ * (那份是官方音色列表经 video-script 的 docs/qwen3-tts 整理的);id 带模型前缀,旧代短名(如 longanlingxin)也能合成,但不在表里。
+ * 工作台音色页「卡的配音」照这张表列、试听、挑(写进 cotutor.json 的 tutors.<名>.voice);老师开口的嘴是另一张表(src/realtime/voices.ts)。
+ */
+export interface TtsVoice {
+    /** 合成请求的 voice 参数,也是 tutors.<名>.voice 里写的 */
+    voice: string;
+    /** 官方的中文名 */
+    name: string;
+    /** 女 / 男 / 未标注 */
+    gender: string;
+    age: number;
+    trait: string;
+    scene: string;
+    lang: string;
+}
+export declare const TTS_VOICES: readonly TtsVoice[];