@seastart/srtc-plugin-deepfilternet 0.1.0 → 0.1.1

package/README.md

@@ -29,15 +29,7 @@ npm run fetch-assets --prefix node_modules/@seastart/srtc-plugin-deepfilternet
 cp -r node_modules/@seastart/srtc-plugin-deepfilternet/assets/v2 public/deepfilternet/v2
 ```
 
-（发布流程见下；npm 上的版本已内置 `assets/v2`，安装后即存在，上面的 `fetch-assets` 仅作兜底。）
-
-## 发布
-
-在仓库根目录执行（会先构建 web SDK 产出类型、再拉取资源、编译并发布）：
-
-```bash
-npm run publishdeepfilternet
-```
+（npm 上的版本已内置 `assets/v2`，安装后即存在；上面的 `fetch-assets` 仅在缺失时作兜底。）
 
 ## 使用
 
@@ -93,3 +85,9 @@ await mic.removeProcessor();
 - DeepFilterNet 计算量高于 RNNoise，STFT 最小延迟约 20ms；请在目标设备实测 CPU 与延迟。
 - 切换设备（`changeDeviceId`）或重新 `startCapture` 后，SDK 会自动重建处理器，无需再次 `setProcessor`。
 - 许可：DeepFilterNet 本体为 Apache-2.0/MIT；模型权重的授权请在分发前自行核实。
+
+### 关于模型 `.tar.gz` 与 `Content-Encoding`
+
+模型文件本身是 gzip。部分服务器/代理会对 `.gz` 再加 `Content-Encoding: gzip`，浏览器据此自动解压一次，导致底层拿到的是未压缩的 `.tar` 而初始化崩溃（`RuntimeError: unreachable`）。
+
+本插件已**自动兜底**：检测到模型被解压后会在浏览器内重新 gzip 还原，无需改服务器配置。该还原依赖 [`CompressionStream`](https://developer.mozilla.org/docs/Web/API/CompressionStream)（Chrome 80+ / Edge 80+ / Safari 16.4+ / Firefox 113+）；若环境不支持，会抛出明确错误提示你关闭该响应头。此外，若资源路径错误返回了 HTML（如 SPA fallback），也会抛出清晰的内容无效错误，而非晦涩的 `unreachable`。

package/dist/deepfilternet-processor.js

@@ -1,5 +1,36 @@
 import { TrackKind } from "@seastart/srtc-web-sdk";
-import { DeepFilterNet3Core } from "deepfilternet3-noise-filter";
+import { AssetLoader, DeepFilterNet3Core } from "deepfilternet3-noise-filter";
+const GZIP_FIX_FLAG = "__srtcGzipFix";
+function patchAssetLoaderGzipFix() {
+    const proto = AssetLoader.prototype;
+    if (proto[GZIP_FIX_FLAG]) {
+        return;
+    }
+    const original = proto.fetchAsset;
+    proto.fetchAsset = async function (url) {
+        const buf = await original.call(this, url);
+        if (!url.endsWith(".tar.gz")) {
+            return buf;
+        }
+        const head = new Uint8Array(buf);
+        if (head[0] === 0x1f && head[1] === 0x8b) {
+            return buf;
+        }
+        const isTar = head.length > 262 &&
+            head[257] === 0x75 && head[258] === 0x73 && head[259] === 0x74 &&
+            head[260] === 0x61 && head[261] === 0x72;
+        if (isTar) {
+            if (typeof CompressionStream === "undefined") {
+                throw new Error("DeepFilterNet 模型被服务器以 Content-Encoding 解压，且当前环境不支持 CompressionStream 无法自动还原；" +
+                    "请让服务器对 .tar.gz 不要设置 Content-Encoding: gzip。");
+            }
+            const stream = new Response(buf).body.pipeThrough(new CompressionStream("gzip"));
+            return await new Response(stream).arrayBuffer();
+        }
+        throw new Error(`DeepFilterNet 模型内容无效（既非 gzip 也非 tar，可能路径错误或命中 SPA fallback）：${url}`);
+    };
+    proto[GZIP_FIX_FLAG] = true;
+}
 export class DeepFilterNetProcessor {
     constructor(options = {}) {
         this.name = "deepfilternet";
@@ -26,6 +57,7 @@ export class DeepFilterNetProcessor {
             });
             this.ownContext = true;
         }
+        patchAssetLoaderGzipFix();
         this.core = new DeepFilterNet3Core({
             sampleRate: 48000,
             noiseReductionLevel: this.suppressionLevel,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seastart/srtc-plugin-deepfilternet",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "SRTC Web SDK DeepFilterNet 降噪处理器插件",
   "type": "module",
   "main": "dist/index.js",