dg-lab-mcp-sse-server 1.1.3 → 1.2.0

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAE/E,OAAO,EAAE,WAAW,EAAwB,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,OAAO,EAAE,eAAe,EAAiB,MAAM,oBAAoB,CAAC;AAGpE;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,aAAa,CAAC;IACxB,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,IAAI,GAAG,CAkD/B;AA4HD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBtD"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAE/E,OAAO,EAAE,WAAW,EAAwB,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,OAAO,EAAE,eAAe,EAAiB,MAAM,oBAAoB,CAAC;AAGpE;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,aAAa,CAAC;IACxB,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,IAAI,GAAG,CAkD/B;AA2HD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBtD"}

package/dist/cli.js

@@ -1238,7 +1238,7 @@ var DGLabWSServer = class {
     this.waveformTimers.clear();
     for (const playback of this.continuousPlaybacks.values()) {
       if (playback.timerId) {
-        clearInterval(playback.timerId);
+        clearTimeout(playback.timerId);
       }
     }
     this.continuousPlaybacks.clear();
@@ -1401,7 +1401,7 @@ var DGLabWSServer = class {
     for (const [key, playback] of this.continuousPlaybacks.entries()) {
       if (playback.controllerId === clientId) {
         if (playback.timerId) {
-          clearInterval(playback.timerId);
+          clearTimeout(playback.timerId);
         }
         this.continuousPlaybacks.delete(key);
         console.log(`[WS \u670D\u52A1\u5668] \u5DF2\u505C\u6B62\u6301\u7EED\u64AD\u653E: ${key}`);
@@ -1559,7 +1559,7 @@ var DGLabWSServer = class {
       const state = this.continuousPlaybacks.get(key);
       if (state) {
         if (state.timerId) {
-          clearInterval(state.timerId);
+          clearTimeout(state.timerId);
         }
         this.continuousPlaybacks.delete(key);
         console.log(`[WS \u670D\u52A1\u5668] \u5DF2\u505C\u6B62\u6301\u7EED\u64AD\u653E: ${key}`);
@@ -1630,16 +1630,16 @@ var DGLabWSServer = class {
    * 启动持续播放
    * 
    * 循环发送波形数据到指定通道，直到手动停止。
-   * 每次发送一批波形，按间隔循环发送。
+   * 使用动态等待机制，根据实际播放时长和发送耗时计算等待时间。
    * 
    * @param controllerId - 控制器 ID
    * @param channel - 目标通道 A 或 B
    * @param waveforms - 要循环播放的波形数据
-   * @param interval - 发送间隔（毫秒），默认 100ms
    * @param batchSize - 每次发送的波形数量，默认 5
+   * @param bufferRatio - 缓冲比例（0.5-1.0），默认 0.9，用于计算等待时间
    * @returns 是否成功启动
    */
-  startContinuousPlayback(controllerId, channel, waveforms, interval = 100, batchSize = 5) {
+  startContinuousPlayback(controllerId, channel, waveforms, batchSize = 5, bufferRatio = 0.9) {
     if (!this.isControllerBound(controllerId)) {
       console.log(`[WS \u670D\u52A1\u5668] \u6301\u7EED\u64AD\u653E\u5931\u8D25: \u63A7\u5236\u5668 ${controllerId} \u672A\u7ED1\u5B9A APP`);
       return false;
@@ -1652,35 +1652,68 @@ var DGLabWSServer = class {
     if (this.continuousPlaybacks.has(key)) {
       this.stopContinuousPlayback(controllerId, channel);
     }
+    const validBufferRatio = bufferRatio >= 0.5 && bufferRatio <= 1 ? bufferRatio : 0.9;
+    const playbackDuration = batchSize * 100;
     const state = {
       controllerId,
       channel,
       waveforms,
       currentIndex: 0,
-      interval,
       batchSize,
+      bufferRatio: validBufferRatio,
+      playbackDuration,
       timerId: null,
-      active: true
-    };
-    state.timerId = setInterval(() => {
-      if (!state.active) {
-        return;
-      }
-      const batch = [];
-      for (let i = 0; i < state.batchSize; i++) {
-        batch.push(state.waveforms[state.currentIndex]);
-        state.currentIndex = (state.currentIndex + 1) % state.waveforms.length;
-      }
-      const success = this.sendWaveform(controllerId, channel, batch);
-      if (!success) {
-        console.log(`[WS \u670D\u52A1\u5668] \u6301\u7EED\u64AD\u653E\u53D1\u9001\u5931\u8D25\uFF0C\u505C\u6B62\u64AD\u653E: ${key}`);
-        this.stopContinuousPlayback(controllerId, channel);
+      active: true,
+      stats: {
+        sendCount: 0,
+        totalElapsedTime: 0,
+        lastSendTime: 0
       }
-    }, interval);
+    };
     this.continuousPlaybacks.set(key, state);
-    console.log(`[WS \u670D\u52A1\u5668] \u5DF2\u542F\u52A8\u6301\u7EED\u64AD\u653E: ${key}\uFF0C\u6CE2\u5F62\u6570: ${waveforms.length}\uFF0C\u95F4\u9694: ${interval}ms`);
+    console.log(`[WS \u670D\u52A1\u5668] \u5DF2\u542F\u52A8\u6301\u7EED\u64AD\u653E: ${key}\uFF0C\u6CE2\u5F62\u6570: ${waveforms.length}\uFF0C\u6279\u6B21\u5927\u5C0F: ${batchSize}\uFF0C\u64AD\u653E\u65F6\u957F: ${playbackDuration}ms\uFF0C\u7F13\u51B2\u6BD4\u4F8B: ${validBufferRatio}`);
+    this.scheduleSend(state);
     return true;
   }
+  /**
+   * 调度发送波形（内部方法）
+   * 
+   * 使用递归 setTimeout 实现动态等待机制：
+   * 1. 记录发送开始时间
+   * 2. 发送波形批次
+   * 3. 计算发送耗时
+   * 4. 计算等待时间 = 播放时长 × 缓冲比例 - 发送耗时
+   * 5. 调度下次发送
+   * 
+   * @param state - 持续播放状态
+   */
+  scheduleSend(state) {
+    if (!state.active) {
+      return;
+    }
+    const startTime = Date.now();
+    const batch = [];
+    for (let i = 0; i < state.batchSize; i++) {
+      batch.push(state.waveforms[state.currentIndex]);
+      state.currentIndex = (state.currentIndex + 1) % state.waveforms.length;
+    }
+    const success = this.sendWaveform(state.controllerId, state.channel, batch);
+    if (!success) {
+      console.log(`[WS \u670D\u52A1\u5668] \u6301\u7EED\u64AD\u653E\u53D1\u9001\u5931\u8D25\uFF0C\u505C\u6B62\u64AD\u653E: ${state.controllerId}-${state.channel}`);
+      this.stopContinuousPlayback(state.controllerId, state.channel);
+      return;
+    }
+    const elapsedTime = Date.now() - startTime;
+    state.stats.sendCount++;
+    state.stats.totalElapsedTime += elapsedTime;
+    state.stats.lastSendTime = startTime;
+    const targetWaitTime = state.playbackDuration * state.bufferRatio - elapsedTime;
+    const actualWaitTime = Math.max(10, targetWaitTime);
+    if (targetWaitTime < 0) {
+      console.warn(`[WS \u670D\u52A1\u5668] \u6301\u7EED\u64AD\u653E\u53D1\u9001\u592A\u6162: \u8017\u65F6 ${elapsedTime}ms > \u76EE\u6807\u65F6\u95F4 ${state.playbackDuration * state.bufferRatio}ms`);
+    }
+    state.timerId = setTimeout(() => this.scheduleSend(state), actualWaitTime);
+  }
   /**
    * 停止持续播放
    * 
@@ -1697,9 +1730,13 @@ var DGLabWSServer = class {
       console.log(`[WS \u670D\u52A1\u5668] \u505C\u6B62\u6301\u7EED\u64AD\u653E\u5931\u8D25: ${key} \u4E0D\u5B58\u5728`);
       return false;
     }
+    if (state.stats.sendCount > 0) {
+      const avgElapsedTime = state.stats.totalElapsedTime / state.stats.sendCount;
+      console.log(`[WS \u670D\u52A1\u5668] \u6301\u7EED\u64AD\u653E\u7EDF\u8BA1: ${key}\uFF0C\u53D1\u9001\u6B21\u6570: ${state.stats.sendCount}\uFF0C\u5E73\u5747\u8017\u65F6: ${avgElapsedTime.toFixed(2)}ms`);
+    }
     state.active = false;
     if (state.timerId) {
-      clearInterval(state.timerId);
+      clearTimeout(state.timerId);
       state.timerId = null;
     }
     this.clearWaveform(controllerId, channel);
@@ -1732,9 +1769,15 @@ var DGLabWSServer = class {
     if (!state) return null;
     return {
       waveformCount: state.waveforms.length,
-      interval: state.interval,
       batchSize: state.batchSize,
-      active: state.active
+      bufferRatio: state.bufferRatio,
+      playbackDuration: state.playbackDuration,
+      active: state.active,
+      stats: {
+        sendCount: state.stats.sendCount,
+        totalElapsedTime: state.stats.totalElapsedTime,
+        avgElapsedTime: state.stats.sendCount > 0 ? state.stats.totalElapsedTime / state.stats.sendCount : 0
+      }
     };
   }
   /** 获取 APP 扫描的二维码 URL */
@@ -2481,10 +2524,37 @@ function createToolSuccess(data) {
 }
 var dgParseWaveformTool = {
   name: "dg_parse_waveform",
-  description: `\u89E3\u6790\u5E76\u4FDD\u5B58\u6CE2\u5F62\u6570\u636E\u3002
-\u8F93\u5165\u683C\u5F0F\uFF1ADungeonlab+pulse:\u5F00\u5934\u7684Base64\u7F16\u7801\u5B57\u7B26\u4E32\uFF08\u4ECEDG-LAB APP\u5BFC\u51FA\uFF09\u3002
-\u89E3\u6790\u540E\u4FDD\u5B58\u4E3AhexWaveforms\u6570\u7EC4\uFF0C\u53EF\u901A\u8FC7dg_get_waveform\u83B7\u53D6\u5E76\u7528dg_send_waveform\u53D1\u9001\u3002
-\u5982\u679Cname\u5DF2\u5B58\u5728\u4F1A\u8986\u76D6\u539F\u6709\u6CE2\u5F62\u3002`,
+  description: `\u89E3\u6790 DG-LAB APP \u5BFC\u51FA\u7684\u6CE2\u5F62\u6570\u636E\u3002
+
+\u529F\u80FD\uFF1A
+- \u89E3\u6790 Dungeonlab+pulse: \u683C\u5F0F\u7684\u6CE2\u5F62\u6570\u636E
+- \u8F6C\u6362\u4E3A\u8BBE\u5907\u53EF\u7528\u7684 hexWaveforms \u6570\u7EC4
+- \u53EF\u9009\u62E9\u662F\u5426\u4FDD\u5B58\u5230\u5B58\u50A8\u4F9B\u540E\u7EED\u4F7F\u7528
+
+\u53C2\u6570\uFF1A
+- hexData (\u5FC5\u9700): \u6CE2\u5F62\u6570\u636E\u5B57\u7B26\u4E32\uFF0C\u5FC5\u987B\u4EE5 "Dungeonlab+pulse:" \u5F00\u5934
+- name (save=true\u65F6\u5FC5\u9700): \u6CE2\u5F62\u540D\u79F0\uFF0C\u7528\u4E8E\u4FDD\u5B58\u548C\u540E\u7EED\u5F15\u7528
+- save (\u53EF\u9009): \u662F\u5426\u4FDD\u5B58\u5230\u5B58\u50A8\uFF0C\u9ED8\u8BA4 false
+
+\u4F7F\u7528\u573A\u666F\uFF1A
+1. \u4E34\u65F6\u89E3\u6790\uFF1A\u53EA\u9700\u8981 hexWaveforms\uFF0C\u4E0D\u4FDD\u5B58
+   \u2192 \u53EA\u4F20 hexData\uFF0C\u8FD4\u56DE\u7ED3\u679C\u5305\u542B hexWaveforms
+2. \u4FDD\u5B58\u590D\u7528\uFF1A\u89E3\u6790\u5E76\u4FDD\u5B58\uFF0C\u540E\u7EED\u901A\u8FC7 dg_get_waveform \u83B7\u53D6
+   \u2192 \u4F20 hexData\u3001name\u3001save=true
+
+\u8FD4\u56DE\u503C\uFF1A
+- success: \u662F\u5426\u6210\u529F
+- name: \u6CE2\u5F62\u540D\u79F0
+- saved: \u662F\u5426\u5DF2\u4FDD\u5B58
+- hexWaveformCount: hexWaveforms \u6570\u91CF
+- hexWaveforms: \u6CE2\u5F62\u6570\u636E\u6570\u7EC4\uFF08\u4EC5\u5F53 save=false \u65F6\u8FD4\u56DE\uFF09
+- metadata: \u5143\u6570\u636E\uFF08sectionCount, totalDuration\uFF09
+- overwritten: \u662F\u5426\u8986\u76D6\u4E86\u5DF2\u5B58\u5728\u7684\u6CE2\u5F62\uFF08\u4EC5\u5F53\u8986\u76D6\u65F6\u8FD4\u56DE\uFF09
+
+\u6CE8\u610F\u4E8B\u9879\uFF1A
+- \u6CE2\u5F62\u6570\u636E\u4ECE DG-LAB APP \u7684"\u5206\u4EAB\u6CE2\u5F62"\u529F\u80FD\u5BFC\u51FA
+- \u6BCF\u4E2A hexWaveform \u4EE3\u8868 100ms \u7684\u64AD\u653E\u65F6\u95F4
+- \u76F8\u540C\u540D\u79F0\u4F1A\u8986\u76D6\u5DF2\u5B58\u5728\u7684\u6CE2\u5F62`,
   inputSchema: {
     type: "object",
     properties: {
@@ -2494,32 +2564,58 @@ var dgParseWaveformTool = {
       },
       name: {
         type: "string",
-        description: "\u6CE2\u5F62\u540D\u79F0\uFF0C\u7528\u4E8E\u4FDD\u5B58\u548C\u540E\u7EED\u5F15\u7528"
+        description: "\u6CE2\u5F62\u540D\u79F0\uFF0C\u7528\u4E8E\u4FDD\u5B58\u548C\u540E\u7EED\u5F15\u7528\u3002\u5F53 save=true \u65F6\u5FC5\u9700"
+      },
+      save: {
+        type: "boolean",
+        description: "\u662F\u5426\u4FDD\u5B58\u6CE2\u5F62\u5230\u5B58\u50A8\uFF08\u9ED8\u8BA4 false\uFF09\u3002\u8BBE\u4E3A true \u65F6\u9700\u8981\u63D0\u4F9B name \u53C2\u6570"
       }
     },
-    required: ["hexData", "name"]
+    required: ["hexData"]
   },
   handler: async (params) => {
     const hexData = params.hexData;
     const name = params.name;
+    const save = params.save;
     if (!hexData || typeof hexData !== "string") {
       return createToolError2("hexData \u662F\u5FC5\u9700\u7684\u4E14\u5FC5\u987B\u662F\u5B57\u7B26\u4E32");
     }
-    if (!name || typeof name !== "string" || name.trim().length === 0) {
-      return createToolError2("name \u662F\u5FC5\u9700\u7684\u4E14\u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32");
+    if (save !== void 0 && typeof save !== "boolean") {
+      return createToolError2("save \u53C2\u6570\u5FC5\u987B\u662F boolean \u7C7B\u578B");
     }
+    const shouldSave = save === true;
+    if (shouldSave && (!name || typeof name !== "string" || name.trim().length === 0)) {
+      return createToolError2("\u5F53 save=true \u65F6\uFF0Cname \u662F\u5FC5\u9700\u7684\u4E14\u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32");
+    }
+    const waveformName = name?.trim() || "unnamed";
     try {
-      const waveform = parseWaveform(hexData, name.trim());
-      const storage = getWaveformStorage();
-      const existed = storage.has(name.trim());
-      storage.save(waveform);
-      persistWaveforms(storage, storagePath);
-      return createToolSuccess({
+      const waveform = parseWaveform(hexData, waveformName);
+      let overwritten = false;
+      if (shouldSave) {
+        const storage = getWaveformStorage();
+        overwritten = storage.has(waveformName);
+        storage.save(waveform);
+        persistWaveforms(storage, storagePath);
+      }
+      const metadata = {
+        sectionCount: waveform.sections.length,
+        totalDuration: waveform.hexWaveforms.length * 100
+        // 每个 hexWaveform 代表 100ms
+      };
+      const result = {
         success: true,
         name: waveform.name,
-        overwritten: existed,
-        hexWaveformCount: waveform.hexWaveforms.length
-      });
+        saved: shouldSave,
+        hexWaveformCount: waveform.hexWaveforms.length,
+        metadata
+      };
+      if (shouldSave && overwritten) {
+        result.overwritten = true;
+      }
+      if (!shouldSave) {
+        result.hexWaveforms = waveform.hexWaveforms;
+      }
+      return createToolSuccess(result);
     } catch (error) {
       if (error instanceof Error) {
         return createToolError2(error.message);
@@ -2530,9 +2626,26 @@ var dgParseWaveformTool = {
 };
 var dgListWaveformsTool = {
   name: "dg_list_waveforms",
-  description: `\u5217\u51FA\u6240\u6709\u5DF2\u4FDD\u5B58\u7684\u6CE2\u5F62\u540D\u79F0\u548C\u6570\u636E\u91CF\u3002
-\u8FD4\u56DE\u6BCF\u4E2A\u6CE2\u5F62\u7684name\u548ChexWaveformCount\uFF08\u6CE2\u5F62\u6570\u636E\u6761\u6570\uFF09\u3002
-\u7528\u4E8E\u67E5\u770B\u53EF\u7528\u6CE2\u5F62\uFF0C\u7136\u540E\u901A\u8FC7dg_get_waveform\u83B7\u53D6\u5177\u4F53\u6570\u636E\u3002`,
+  description: `\u5217\u51FA\u6240\u6709\u5DF2\u4FDD\u5B58\u7684\u6CE2\u5F62\u3002
+
+\u529F\u80FD\uFF1A
+- \u83B7\u53D6\u5B58\u50A8\u4E2D\u6240\u6709\u6CE2\u5F62\u7684\u6982\u89C8\u4FE1\u606F
+- \u663E\u793A\u6BCF\u4E2A\u6CE2\u5F62\u7684\u540D\u79F0\u548C\u6570\u636E\u91CF
+
+\u8FD4\u56DE\u503C\uFF1A
+- count: \u6CE2\u5F62\u603B\u6570
+- waveforms: \u6CE2\u5F62\u5217\u8868\u6570\u7EC4
+  - name: \u6CE2\u5F62\u540D\u79F0
+  - hexWaveformCount: hexWaveforms \u6570\u91CF\uFF08\u6BCF\u4E2A\u4EE3\u8868 100ms\uFF09
+
+\u5178\u578B\u5DE5\u4F5C\u6D41\u7A0B\uFF1A
+1. dg_list_waveforms \u67E5\u770B\u53EF\u7528\u6CE2\u5F62
+2. dg_get_waveform \u83B7\u53D6\u5177\u4F53\u6CE2\u5F62\u6570\u636E
+3. dg_send_waveform \u53D1\u9001\u5230\u8BBE\u5907
+
+\u6CE8\u610F\u4E8B\u9879\uFF1A
+- \u53EA\u663E\u793A\u901A\u8FC7 dg_parse_waveform (save=true) \u4FDD\u5B58\u7684\u6CE2\u5F62
+- hexWaveformCount \xD7 100ms = \u6CE2\u5F62\u603B\u65F6\u957F`,
   inputSchema: {
     type: "object",
     properties: {},
@@ -2553,9 +2666,31 @@ var dgListWaveformsTool = {
 };
 var dgGetWaveformTool = {
   name: "dg_get_waveform",
-  description: `\u6309\u540D\u79F0\u83B7\u53D6\u6CE2\u5F62\u7684hexWaveforms\u6570\u7EC4\u3002
-\u8FD4\u56DE\u7684hexWaveforms\u53EF\u76F4\u63A5\u4F20\u7ED9dg_send_waveform\u7684waveforms\u53C2\u6570\u4F7F\u7528\u3002
-\u5178\u578B\u6D41\u7A0B\uFF1Adg_list_waveforms\u67E5\u770B\u53EF\u7528\u6CE2\u5F62 \u2192 dg_get_waveform\u83B7\u53D6\u6570\u636E \u2192 dg_send_waveform\u53D1\u9001\u5230\u8BBE\u5907\u3002`,
+  description: `\u6309\u540D\u79F0\u83B7\u53D6\u5DF2\u4FDD\u5B58\u7684\u6CE2\u5F62\u6570\u636E\u3002
+
+\u529F\u80FD\uFF1A
+- \u4ECE\u5B58\u50A8\u4E2D\u83B7\u53D6\u6307\u5B9A\u540D\u79F0\u7684\u6CE2\u5F62
+- \u8FD4\u56DE\u5B8C\u6574\u7684 hexWaveforms \u6570\u7EC4
+
+\u53C2\u6570\uFF1A
+- name (\u5FC5\u9700): \u6CE2\u5F62\u540D\u79F0
+
+\u8FD4\u56DE\u503C\uFF1A
+- name: \u6CE2\u5F62\u540D\u79F0
+- hexWaveforms: \u6CE2\u5F62\u6570\u636E\u6570\u7EC4\uFF0C\u53EF\u76F4\u63A5\u7528\u4E8E dg_send_waveform
+
+\u5178\u578B\u5DE5\u4F5C\u6D41\u7A0B\uFF1A
+1. dg_list_waveforms \u67E5\u770B\u53EF\u7528\u6CE2\u5F62
+2. dg_get_waveform \u83B7\u53D6\u5177\u4F53\u6CE2\u5F62\u6570\u636E
+3. dg_send_waveform \u6216 dg_start_continuous_playback \u53D1\u9001\u5230\u8BBE\u5907
+
+\u4E0E\u5176\u4ED6\u5DE5\u5177\u914D\u5408\uFF1A
+- dg_send_waveform: \u4E00\u6B21\u6027\u53D1\u9001\u6CE2\u5F62
+- dg_start_continuous_playback: \u6301\u7EED\u5FAA\u73AF\u64AD\u653E\u6CE2\u5F62
+
+\u6CE8\u610F\u4E8B\u9879\uFF1A
+- \u6CE2\u5F62\u5FC5\u987B\u5148\u901A\u8FC7 dg_parse_waveform (save=true) \u4FDD\u5B58
+- \u5982\u679C\u6CE2\u5F62\u4E0D\u5B58\u5728\u4F1A\u8FD4\u56DE\u9519\u8BEF`,
   inputSchema: {
     type: "object",
     properties: {
@@ -2585,7 +2720,26 @@ var dgGetWaveformTool = {
 var dgDeleteWaveformTool = {
   name: "dg_delete_waveform",
   description: `\u6309\u540D\u79F0\u5220\u9664\u5DF2\u4FDD\u5B58\u7684\u6CE2\u5F62\u3002
-\u5220\u9664\u540E\u65E0\u6CD5\u6062\u590D\uFF0C\u9700\u8981\u91CD\u65B0\u7528dg_parse_waveform\u89E3\u6790\u4FDD\u5B58\u3002`,
+
+\u529F\u80FD\uFF1A
+- \u4ECE\u5B58\u50A8\u4E2D\u6C38\u4E45\u5220\u9664\u6307\u5B9A\u6CE2\u5F62
+- \u540C\u65F6\u4ECE\u78C1\u76D8\u6301\u4E45\u5316\u6587\u4EF6\u4E2D\u79FB\u9664
+
+\u53C2\u6570\uFF1A
+- name (\u5FC5\u9700): \u8981\u5220\u9664\u7684\u6CE2\u5F62\u540D\u79F0
+
+\u8FD4\u56DE\u503C\uFF1A
+- success: \u662F\u5426\u6210\u529F
+- deleted: \u88AB\u5220\u9664\u7684\u6CE2\u5F62\u540D\u79F0
+
+\u26A0\uFE0F \u8B66\u544A\uFF1A
+- \u5220\u9664\u64CD\u4F5C\u4E0D\u53EF\u9006\uFF01
+- \u5220\u9664\u540E\u9700\u8981\u91CD\u65B0\u7528 dg_parse_waveform \u89E3\u6790\u4FDD\u5B58
+- \u5EFA\u8BAE\u5220\u9664\u524D\u786E\u8BA4\u6CE2\u5F62\u540D\u79F0
+
+\u6CE8\u610F\u4E8B\u9879\uFF1A
+- \u5982\u679C\u6CE2\u5F62\u4E0D\u5B58\u5728\u4F1A\u8FD4\u56DE\u9519\u8BEF
+- \u5220\u9664\u4E0D\u4F1A\u5F71\u54CD\u6B63\u5728\u8FDB\u884C\u7684\u6301\u7EED\u64AD\u653E`,
   inputSchema: {
     type: "object",
     properties: {
@@ -2928,13 +3082,27 @@ function registerControlTools(toolManager, sessionManager, wsServer) {
   toolManager.registerTool(
     "dg_start_continuous_playback",
     `\u542F\u52A8\u6301\u7EED\u64AD\u653E\u6A21\u5F0F\uFF0C\u5FAA\u73AF\u53D1\u9001\u6CE2\u5F62\u6570\u636E\u76F4\u5230\u624B\u52A8\u505C\u6B62\u3002
-\u4E0Edg_send_waveform\u4E0D\u540C\uFF0C\u6301\u7EED\u64AD\u653E\u4F1A\u81EA\u52A8\u5FAA\u73AF\u53D1\u9001\u6CE2\u5F62\uFF0C\u9002\u5408\u9700\u8981\u6301\u7EED\u8F93\u51FA\u7684\u573A\u666F\u3002
-\u652F\u6301\u4E24\u79CD\u65B9\u5F0F\u63D0\u4F9B\u6CE2\u5F62\uFF1A
-1. \u76F4\u63A5\u63D0\u4F9Bwaveforms\u6570\u7EC4
-2. \u63D0\u4F9BwaveformName\u5F15\u7528\u5DF2\u4FDD\u5B58\u7684\u6CE2\u5F62
-\u53EF\u9009\u53C2\u6570\uFF1A
-- interval: \u53D1\u9001\u95F4\u9694\uFF08\u6BEB\u79D2\uFF09\uFF0C\u9ED8\u8BA4100ms
-- batchSize: \u6BCF\u6B21\u53D1\u9001\u7684\u6CE2\u5F62\u6570\u91CF\uFF0C\u9ED8\u8BA45`,
+
+\u529F\u80FD\uFF1A
+- \u81EA\u52A8\u5FAA\u73AF\u53D1\u9001\u6CE2\u5F62\uFF0C\u9002\u5408\u9700\u8981\u6301\u7EED\u8F93\u51FA\u7684\u573A\u666F
+- \u4F7F\u7528\u52A8\u6001\u7B49\u5F85\u673A\u5236\uFF0C\u6839\u636E\u5B9E\u9645\u64AD\u653E\u65F6\u957F\u548C\u53D1\u9001\u8017\u65F6\u8BA1\u7B97\u7B49\u5F85\u65F6\u95F4
+- \u6BCF\u4E2A hexWaveform \u4EE3\u8868 100ms \u7684\u64AD\u653E\u65F6\u95F4
+
+\u53C2\u6570\uFF1A
+- deviceId \u6216 alias: \u8BBE\u5907\u6807\u8BC6\uFF08\u4E8C\u9009\u4E00\uFF0CdeviceId\u4F18\u5148\uFF09
+- channel: A\u6216B\u901A\u9053
+- waveforms \u6216 waveformName: \u6CE2\u5F62\u6570\u636E\u6765\u6E90\uFF08\u4E8C\u9009\u4E00\uFF09
+- batchSize: \u6BCF\u6B21\u53D1\u9001\u7684\u6CE2\u5F62\u6570\u91CF\uFF0C\u9ED8\u8BA45\uFF08\u64AD\u653E\u65F6\u957F = batchSize \xD7 100ms\uFF09
+- bufferRatio: \u7F13\u51B2\u6BD4\u4F8B\uFF080.5-1.0\uFF09\uFF0C\u9ED8\u8BA40.9\uFF0C\u7528\u4E8E\u8BA1\u7B97\u7B49\u5F85\u65F6\u95F4
+
+\u65F6\u5E8F\u673A\u5236\uFF1A
+- \u64AD\u653E\u65F6\u957F = batchSize \xD7 100ms
+- \u7B49\u5F85\u65F6\u95F4 = \u64AD\u653E\u65F6\u957F \xD7 bufferRatio - \u53D1\u9001\u8017\u65F6
+- \u6700\u5C0F\u7B49\u5F85\u65F6\u95F4 = 10ms
+
+\u4E0E dg_send_waveform \u7684\u533A\u522B\uFF1A
+- dg_send_waveform: \u4E00\u6B21\u6027\u53D1\u9001\uFF0C\u64AD\u653E\u5B8C\u6BD5\u540E\u505C\u6B62
+- dg_start_continuous_playback: \u5FAA\u73AF\u53D1\u9001\uFF0C\u76F4\u5230\u624B\u52A8\u505C\u6B62`,
     {
       type: "object",
       properties: {
@@ -2951,17 +3119,17 @@ function registerControlTools(toolManager, sessionManager, wsServer) {
           type: "string",
           description: "\u5DF2\u4FDD\u5B58\u7684\u6CE2\u5F62\u540D\u79F0\u3002\u4E0Ewaveforms\u4E8C\u9009\u4E00"
         },
-        interval: {
-          type: "number",
-          minimum: 50,
-          maximum: 5e3,
-          description: "\u53D1\u9001\u95F4\u9694\uFF08\u6BEB\u79D2\uFF09\uFF0C\u9ED8\u8BA4100"
-        },
         batchSize: {
           type: "number",
           minimum: 1,
           maximum: 20,
-          description: "\u6BCF\u6B21\u53D1\u9001\u7684\u6CE2\u5F62\u6570\u91CF\uFF0C\u9ED8\u8BA45"
+          description: "\u6BCF\u6B21\u53D1\u9001\u7684\u6CE2\u5F62\u6570\u91CF\uFF0C\u9ED8\u8BA45\uFF08\u64AD\u653E\u65F6\u957F = batchSize \xD7 100ms\uFF09"
+        },
+        bufferRatio: {
+          type: "number",
+          minimum: 0.5,
+          maximum: 1,
+          description: "\u7F13\u51B2\u6BD4\u4F8B\uFF080.5-1.0\uFF09\uFF0C\u9ED8\u8BA40.9\uFF0C\u7528\u4E8E\u8BA1\u7B97\u7B49\u5F85\u65F6\u95F4"
         }
       },
       required: ["channel"]
@@ -3002,27 +3170,29 @@ function registerControlTools(toolManager, sessionManager, wsServer) {
       if (!isBound) {
         return createToolError("\u8BBE\u5907\u672A\u7ED1\u5B9AAPP");
       }
-      const interval = typeof params.interval === "number" ? params.interval : 100;
       const batchSize = typeof params.batchSize === "number" ? params.batchSize : 5;
+      const bufferRatio = typeof params.bufferRatio === "number" ? params.bufferRatio : 0.9;
       const success = wsServer.startContinuousPlayback(
         session.clientId,
         channel,
         waveforms,
-        interval,
-        batchSize
+        batchSize,
+        bufferRatio
       );
       if (!success) {
         return createToolError("\u542F\u52A8\u6301\u7EED\u64AD\u653E\u5931\u8D25");
       }
       sessionManager.touchSession(session.deviceId);
+      const playbackDuration = batchSize * 100;
       return createToolResult(
         JSON.stringify({
           success: true,
           deviceId: session.deviceId,
           channel,
           waveformCount: waveforms.length,
-          interval,
           batchSize,
+          bufferRatio,
+          playbackDuration,
           source: rawWaveforms ? "direct" : `waveform:${waveformName}`
         })
       );
@@ -3072,7 +3242,14 @@ function registerControlTools(toolManager, sessionManager, wsServer) {
   toolManager.registerTool(
     "dg_get_playback_status",
     `\u83B7\u53D6\u8BBE\u5907\u7684\u6301\u7EED\u64AD\u653E\u72B6\u6001\u3002
-\u8FD4\u56DEA\u548CB\u901A\u9053\u7684\u64AD\u653E\u72B6\u6001\uFF0C\u5305\u62EC\u662F\u5426\u6B63\u5728\u64AD\u653E\u3001\u6CE2\u5F62\u6570\u91CF\u3001\u53D1\u9001\u95F4\u9694\u7B49\u4FE1\u606F\u3002`,
+
+\u8FD4\u56DE A \u548C B \u901A\u9053\u7684\u64AD\u653E\u72B6\u6001\uFF0C\u5305\u62EC\uFF1A
+- playing: \u662F\u5426\u6B63\u5728\u64AD\u653E
+- waveformCount: \u6CE2\u5F62\u6570\u91CF
+- batchSize: \u6BCF\u6B21\u53D1\u9001\u7684\u6CE2\u5F62\u6570\u91CF
+- bufferRatio: \u7F13\u51B2\u6BD4\u4F8B
+- playbackDuration: \u64AD\u653E\u65F6\u957F\uFF08\u6BEB\u79D2\uFF09
+- stats: \u7EDF\u8BA1\u4FE1\u606F\uFF08\u53D1\u9001\u6B21\u6570\u3001\u5E73\u5747\u8017\u65F6\uFF09`,
     {
       type: "object",
       properties: {
@@ -3100,14 +3277,18 @@ function registerControlTools(toolManager, sessionManager, wsServer) {
           channelA: statusA ? {
             playing: statusA.active,
             waveformCount: statusA.waveformCount,
-            interval: statusA.interval,
-            batchSize: statusA.batchSize
+            batchSize: statusA.batchSize,
+            bufferRatio: statusA.bufferRatio,
+            playbackDuration: statusA.playbackDuration,
+            stats: statusA.stats
           } : { playing: false },
           channelB: statusB ? {
             playing: statusB.active,
             waveformCount: statusB.waveformCount,
-            interval: statusB.interval,
-            batchSize: statusB.batchSize
+            batchSize: statusB.batchSize,
+            bufferRatio: statusB.bufferRatio,
+            playbackDuration: statusB.playbackDuration,
+            stats: statusB.stats
           } : { playing: false }
         })
       );
@@ -3192,12 +3373,7 @@ function createWSServer(config, sessionManager) {
       console.log(`[WS] \u63A7\u5236\u5668\u65AD\u5F00: ${controllerId}`);
       const session = sessionManager.getSessionByClientId(controllerId);
       if (session) {
-        sessionManager.updateConnectionState(session.deviceId, {
-          connected: false,
-          boundToApp: false,
-          clientId: null,
-          targetId: null
-        });
+        sessionManager.handleDisconnection(session.deviceId);
       }
     },
     onAppDisconnect: (appId) => {