SnowCat 雪猫底层全源码：NapCat 4.18.28 底座 + SnowLuma 能力移植 + V8 通道适配 9.9.37

26 包 monorepo（TS 全源码）：
- snowcat-core: NT 内核 API 封装 + listener（含 9.9.37 六回调适配）+ Packet 发包
- snowcat-onebot: OneBot v11 全动作 + MCP Streamable HTTP 适配器 + 稳定线
- snowcat-webui-frontend/backend: 雪猫控制台（React+HeroUI）
- snowcat-shell: 单文件 bundle 出口（vite inlineDynamicImports）
- snowcat-native: napi2native / MoeHoo / ffmpeg / pty 运行时
- 56 项 SnowLuma 独门动作移植（qzone 全家桶/群相册/装扮/闪照/收藏）
- 工具件: 解包器/启动器/便携制作器/doctor

GitHub 关联已全量指向 DandanLLab/SnowCatQQ

packages/snowcat-core/helper/ffmpeg/ffmpeg-addon.ts

@@ -0,0 +1,75 @@
+/**
+ * FFmpeg Node.js Native Addon Type Definitions
+ *
+ * This addon provides FFmpeg functionality for Node.js including:
+ * - Video information extraction with thumbnail generation
+ * - Audio/Video duration detection
+ * - Audio format conversion to NTSILK
+ * - Audio decoding to PCM
+ */
+
+/**
+ * Video information result object
+ */
+export interface VideoInfo {
+  /** Video width in pixels */
+  width: number;
+
+  /** Video height in pixels */
+  height: number;
+
+  /** Video duration in seconds */
+  duration: number;
+
+  /** Generated thumbnail image format */
+  format: string;
+
+  /** Video codec name (e.g., "h264", "hevc", "vp9") */
+  videoCodec: string;
+
+  /** First frame thumbnail as JPEG image buffer */
+  image: Buffer;
+}
+
+/**
+ * Audio PCM decoding result object
+ */
+export interface AudioPCMResult {
+  /** PCM audio data as 16-bit signed integer samples */
+  pcm: Buffer;
+
+  /** Sample rate in Hz (e.g., 44100, 48000, 24000) */
+  sampleRate: number;
+
+  /** Number of audio channels (1 for mono, 2 for stereo) */
+  channels: number;
+}
+
+/**
+ * FFmpeg interface providing all audio/video processing methods
+ */
+export interface FFmpeg {
+  convertFile (inputFile: string, outputFile: string, format: string): Promise<{ success: boolean; }>;
+  /**
+     * Get video information including resolution, duration, format, codec and first frame thumbnail
+     */
+  getVideoInfo (filePath: string, format?: 'bmp' | 'bmp24'): Promise<VideoInfo>;
+
+  /**
+     * Get duration of audio or video file in seconds
+     */
+  getDuration (filePath: string): Promise<number>;
+
+  /**
+     * Convert audio file to NTSILK format (WeChat voice message format)
+     */
+  convertToNTSilkTct (inputPath: string, outputPath: string): Promise<void>;
+
+  /**
+     * Decode audio file to raw PCM data
+     */
+  decodeAudioToPCM (filePath: string, pcmPath: string, sampleRate?: number): Promise<{ result: boolean, sampleRate: number; }>;
+  decodeAudioToFmt (filePath: string, pcmPath: string, format: string): Promise<{ channels: number; sampleRate: number; format: string; }>;
+
+  convertToNTSilkTct (inputFile: string, outputFile: string): Promise<void>;
+}