@memef1f1y/dsh-plugin-tts 0.6.0 → 0.6.1

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,51 @@
+name: Bug 反馈
+description: 报告插件使用中遇到的问题
+title: "[Bug] "
+labels: ["bug"]
+body:
+  - type: textarea
+    id: repro
+    attributes:
+      label: 复现步骤
+      description: 让维护者能复现问题的最简操作，1-2-3 列出来
+      placeholder: |
+        1. 打开 ……
+        2. 点击 ……
+        3. 出现报错 ……
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: 期望结果 vs 实际结果
+      description: 你期望发生什么，实际发生了什么
+      placeholder: |
+        期望： assistant 回复后自动朗读
+        实际： 没有任何声音，也没有报错
+    validations:
+      required: true
+  - type: input
+    id: env
+    attributes:
+      label: 环境
+      description: 插件版本 / opencode 版本 / 操作系统
+      placeholder: "插件 v0.3.0 / opencode 1.18.x / Windows 11"
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: 日志或报错信息
+      description: 相关报错、控制台输出贴进来；确认没有请填"无"
+      render: shell
+      placeholder: "把报错堆栈粘在这里，没有请填 无"
+    validations:
+      required: true
+  - type: input
+    id: code
+    attributes:
+      label: 相关代码 / 文件（选填）
+      description: 出问题的文件路径、配置片段
+      placeholder: "如 hooks/useEdgeSpeech.ts，或相关配置"
+    validations:
+      required: false

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,2 @@
+blank_issues_enabled: false
+contact_links: []

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,28 @@
+name: 功能建议
+description: 给插件提新功能或改进想法
+title: "[Feature] "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: scene
+    attributes:
+      label: 使用场景
+      description: 你在什么情况下需要这个功能，现在是怎么凑合的
+      placeholder: "比如：开车时想听长回复，但当前只能手动点朗读……"
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: 建议方案
+      description: 你希望做成什么样，越具体越好
+      placeholder: "比如：加一个超过 200 字自动朗读的开关……"
+    validations:
+      required: true
+  - type: textarea
+    id: alt
+    attributes:
+      label: 替代方案（选填）
+      description: 有没有退而求其次也能接受的做法
+    validations:
+      required: false

package/.github/pull_request_template.md

@@ -0,0 +1,7 @@
+### 关联 issue
+
+Closes #
+
+### 改了什么，为什么
+
+### 怎么验证的

package/.github/workflows/contrib-triage.yml

@@ -0,0 +1,66 @@
+# 内容初筛：正文过薄的 issue / PR 自动索要信息（只提醒不关闭）。
+# 关闭逻辑在 stale.yml（7 天提醒 + 7 天关闭）。不 checkout 任何代码，
+# pull_request_target 在此是安全的。
+name: contrib-triage
+
+on:
+  issues:
+    types: [opened, edited, reopened]
+  pull_request_target:
+    types: [opened, edited, reopened, ready_for_review]
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  triage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/github-script@v8
+        with:
+          script: |
+            const isPR = !!context.payload.pull_request;
+            const target = isPR ? context.payload.pull_request : context.payload.issue;
+            // 注意：author_association 在 sender 上没有，要从 issue / PR 对象上取
+            const assoc = target.author_association ?? "";
+
+            // 豁免只管"打标"不管"摘标"：自己人补了信息也要清标记，
+            // 否则标记永远烂在自己人手里，最后被 stale 误关
+            const privileged =
+              ["OWNER", "MEMBER", "COLLABORATOR"].includes(assoc) ||
+              context.payload.sender?.type === "Bot" ||
+              (isPR && target.draft);
+
+            // 去掉标题行/空行/注释后看有效字数
+            const effective = (target.body ?? "")
+              .split("\n")
+              .map((l) => l.trim())
+              .filter((l) => l && !l.startsWith("#") && !l.startsWith("<!--") && l !== "---")
+              .join("\n");
+            const thin = effective.length < (isPR ? 30 : 50);
+
+            const labels = target.labels.map((l) => l.name);
+            const hasFlag = labels.includes("needs:info");
+
+            if (!thin && hasFlag) {
+              await github.rest.issues.removeLabel({
+                ...context.repo,
+                issue_number: target.number,
+                name: "needs:info",
+              });
+            } else if (thin && !hasFlag && !privileged) {
+              await github.rest.issues.addLabels({
+                ...context.repo,
+                issue_number: target.number,
+                labels: ["needs:info"],
+              });
+              const msg = isPR
+                ? "感谢贡献！这个 PR 描述有点简单，维护者可能看不懂改了什么，麻烦按模板补一下：关联哪个 issue、改了什么为什么、怎么验证的。直接编辑 PR 正文即可，补好后标记会自动摘掉。"
+                : "感谢反馈！这个 issue 信息有点少，维护者可能无法定位问题，麻烦补充一下：1）复现步骤；2）期望结果 vs 实际结果；3）日志或报错信息。直接编辑 issue 正文补上就行，补好后标记会自动摘掉。";
+              await github.rest.issues.createComment({
+                ...context.repo,
+                issue_number: target.number,
+                body: msg,
+              });
+            }

package/.github/workflows/linked-issue.yml

@@ -0,0 +1,21 @@
+# PR 必须关联 issue（描述里写 Closes #x / Fixes #x）。
+# 贴 no-issue 标签可豁免（如纯文档、发版类 PR）。不 checkout 代码。
+name: linked-issue
+
+on:
+  pull_request_target:
+    types: [opened, edited, reopened, ready_for_review, labeled, unlabeled]
+
+permissions:
+  issues: read
+  pull-requests: write
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: nearform-actions/github-action-check-linked-issues@v1.8.3
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          exclude-branches: "dependabot/**"
+          custom-body-comment: "这个 PR 还没有关联 issue，请在描述里加上 `Closes #xxx`（把 xxx 换成 issue 号）。纯文档/发版类 PR 可贴 `no-issue` 标签跳过此检查。"

package/.github/workflows/stale.yml

@@ -0,0 +1,30 @@
+# 只处理被 needs:info 标记的 issue / PR：7 天无更新提醒，再 7 天无更新关闭。
+# 任何回复/编辑都会自动摘标并重启计时。
+name: stale-guard
+
+on:
+  schedule:
+    - cron: "0 1 * * *"
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/stale@v10
+        with:
+          only-issue-labels: "needs:info"
+          only-pr-labels: "needs:info"
+          days-before-stale: 7
+          days-before-close: 7
+          stale-issue-label: "needs:info"
+          stale-pr-label: "needs:info"
+          exempt-draft-pr: true
+          stale-issue-message: "这个 issue 已 7 天没有补充信息，再过 7 天仍无更新将自动关闭。直接编辑正文或回复补充即可（随时可重开）。"
+          stale-pr-message: "这个 PR 已 7 天没有补充信息，再过 7 天仍无更新将自动关闭。直接编辑正文或回复补充即可（随时可重开）。"
+          close-issue-message: "因长期缺少定位信息自动关闭。如仍有问题，补充信息后可随时重开。"
+          close-pr-message: "因长期缺少信息自动关闭。补齐描述后可随时重开。"

package/.github/workflows/welcome.yml

@@ -0,0 +1,22 @@
+# 首次贡献者欢迎（每人只打扰一次）。不 checkout 代码。
+name: welcome
+
+on:
+  issues:
+    types: [opened]
+  pull_request_target:
+    types: [opened]
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  greet:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/first-interaction@v3
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          issue_message: "欢迎第一次提 issue！如果还没填过信息模板，麻烦按表单把复现步骤和日志补一下，定位会快很多。"
+          pr_message: "欢迎第一次贡献代码！麻烦确认 PR 描述里写了关联 issue、改动原因和验证方式，review 会顺利很多。"

package/lib/client.js

@@ -18,7 +18,7 @@ window.__ModuleLoader__.load({
 
     // Bundle build tag: bump on every client fix so a console line proves
     // WHICH code is actually running (rules out stale-bundle confusion).
-    const CLIENT_BUILD = "2026-09-22.01-no-starve-overlap";
+    const CLIENT_BUILD = "2026-09-26.01-prewarm-skip-toast";
     const apply = ctx => {
       const slots = ctx.slots ?? (typeof ctx.get === "function" ? ctx.get("slots") : undefined);
       if (!slots) throw new Error("[dsh-plugin-tts] slots service unavailable");
@@ -2775,6 +2775,14 @@ window.__ModuleLoader__.load({
             shared.currentJobId = result.jobId || null;
             shared.chunkProgress = { index: 1, total };
             notify();
+            // Prewarm skips happened during /speak (not at /rvc-next time),
+            // so the queue holes below would be walked over silently without
+            // this: surface each one now like any on-demand skip.
+            if (Array.isArray(result.skipped)) {
+              for (const n of result.skipped) {
+                if (typeof onError === "function") onError(t("err.chunkSkip") + " (" + n + "/" + total + ")");
+              }
+            }
             playChunks(result.jobId, result.chunks, total, token, onError);
             return { ok: true, chunked: true, total };
           }

package/lib/index.mjs

@@ -2283,13 +2283,17 @@ export function apply(ctx) {
             }
             const urls = [];
             let playable = 0;
+            const prewarmSkipped = [];
             for (let i = 0; i < prewarm; i++) {
               job.synthIdx = i + 1;
               const r = await synthChunkAt(job, i);
               // Keep index alignment (a skipped prewarm chunk stays a `false`
               // hole the client walks over in order) instead of compacting.
+              // Skipped prewarm chunks are SILENT otherwise (the skip happened
+              // during /speak, not at /rvc-next time), so report their 1-based
+              // numbers explicitly for the client toast.
               if (r && r.url) { urls.push(r.url); playable++; }
-              else urls.push(false);
+              else { urls.push(false); prewarmSkipped.push(i + 1); }
             }
             job.serveIdx = prewarm;
             if (!playable) {
@@ -2303,7 +2307,8 @@ export function apply(ctx) {
               chunks: urls,
               total: parts.length,
               ratio: cal.ratio,
-              chunkSec: cal.chunkSec
+              chunkSec: cal.chunkSec,
+              skipped: prewarmSkipped
             });
             return;
           }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memef1f1y/dsh-plugin-tts",
   "description": "Edge TTS 语音大集成插件：消息朗读按钮、自动朗读开关、语音设置面板（Edge TTS / RVC / Index-TTS2 / CosyVoice / Google Cloud TTS）",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "type": "module",
   "engines": {
     "node": ">=22"

package/tests/smoke.mjs

@@ -140,6 +140,40 @@ if (speakRoute && audioRoute) {
       ep.jobId ? `jobId=${ep.jobId} chunks=${ep.chunks.length} total=${ep.total}` : er.body);
   }
 
+  // Regression: fastFirst 1/3/2 chunk-swap. After /speak returns chunk 0, the
+  // background prewarm of chunk 1 is still in flight — the old shared-nextIdx
+  // code served parts[2] as want=1 (or orphaned parts[1] in ready with
+  // more=false). Draining immediately must yield indices strictly 0..N-1.
+  {
+    const orderText = '第一段测试文本，用于验证分段顺序是否正确。'.repeat(9); // ~180 chars -> 3 parts
+    const or = await call(speakRoute, mockReq('/dsh-tts-api/speak', JSON.stringify({
+      text: orderText, voice: 'zh-CN-XiaoxuanNeural', provider: 'edge-tts'
+    })), mockRes());
+    const op = JSON.parse(or.body);
+    const orderNext = routes.find((r) => r.kind === 'exact' && r.path === '/dsh-tts-api/rvc-next');
+    if (or.head.code === 200 && typeof op.jobId === 'string' && op.total > 2 && orderNext) {
+      const seenIdx = [0];
+      const seenUrls = [op.chunks[0]];
+      let oMore = true;
+      let oGuard = 0;
+      while (oMore && oGuard++ < 20) {
+        const nr = await call(orderNext, mockReq(`/dsh-tts-api/rvc-next?job=${op.jobId}`), mockRes());
+        const np = JSON.parse(nr.body);
+        if (np.url || np.skipped) { seenIdx.push(np.index); if (np.url) seenUrls.push(np.url); }
+        oMore = !!np.more;
+        if (np.done) break;
+      }
+      const expectIdx = seenIdx.map((_, i) => i);
+      check('edge chunked job serves indices strictly 0..N-1 (no swap/drop)',
+        JSON.stringify(seenIdx) === JSON.stringify(expectIdx) && seenIdx.length === op.total && oMore === false,
+        `got [${seenIdx}] total=${op.total}`);
+      check('edge chunked job serves distinct URLs',
+        new Set(seenUrls).size === seenUrls.length, `distinct=${new Set(seenUrls).size}/${seenUrls.length}`);
+    } else {
+      check('edge ordering regression precondition: short chunked job', false, or.body.slice(0, 160));
+    }
+  }
+
   // M1+ local-piper provider: registered in the abstraction; unconfigured -> graceful
   // localized error (not a crash)
   {
@@ -307,6 +341,76 @@ if (speakRoute && audioRoute) {
       }
     }
 
+    // ---- prewarm skip surfacing: a prewarm chunk that exhausts retries must
+    // be reported (not walked over silently). index-tts2 is used because it
+    // has no calibration probe (absolute /tts-task call counting is exact). The mock fails task calls #2 and #3 (= chunk idx1's two
+    // attempts), so /speak must return chunks [url, false] + skipped [2],
+    // and draining must serve the skip at index 1 in order before continuing.
+    {
+      let taskCalls = 0;
+      const failServer = createServer((req, res) => {
+        let body = '';
+        req.on('data', (d) => (body += d));
+        req.on('end', () => {
+          if (req.url === '/health' || req.url === '/api/v1/voices') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: true, voices: ['demo.wav'], count: 1 }));
+          } else if (req.url === '/api/v1/tts/tasks') {
+            taskCalls++;
+            if (taskCalls === 2 || taskCalls === 3) {
+              res.writeHead(500, { 'Content-Type': 'application/json' });
+              res.end(JSON.stringify({ detail: 'mock tts boom' }));
+              return;
+            }
+            res.writeHead(200, { 'Content-Type': 'audio/wav' });
+            res.end(miniWav());
+          } else {
+            res.writeHead(404);
+            res.end();
+          }
+        });
+      });
+      await new Promise((r) => failServer.listen(0, '127.0.0.1', r));
+      try {
+        const failPort = failServer.address().port;
+        const skipText = '这是一段用于验证预热跳段上报的长文本朗读测试。'.repeat(12);
+        const skipRes = await call(speakRoute, mockReq('/dsh-tts-api/speak', JSON.stringify({
+          text: skipText,
+          voice: 'zh-CN-XiaoxuanNeural',
+          provider: 'index-tts2',
+          custom: { baseUrl: `http://127.0.0.1:${failPort}`, voice: 'demo.wav' }
+        })), mockRes());
+        const skipParsed = JSON.parse(skipRes.body);
+        check('prewarm skip reported in /speak (chunks[1] hole + skipped [2])',
+          skipRes.head.code === 200 && Array.isArray(skipParsed.chunks)
+          && skipParsed.chunks.length >= 2 && skipParsed.chunks[0] && skipParsed.chunks[1] === false
+          && Array.isArray(skipParsed.skipped) && skipParsed.skipped.length === 1 && skipParsed.skipped[0] === 2,
+          skipRes.body.slice(0, 200));
+        if (typeof skipParsed.jobId === 'string' && Array.isArray(skipParsed.chunks)) {
+          const nextRoute = routes.find((r) => r.kind === 'exact' && r.path === '/dsh-tts-api/rvc-next');
+          // serveIdx starts past prewarm; the on-demand serves must be the
+          // remaining indices strictly in order through to total.
+          const seen = [];
+          let sMore = true;
+          let sGuard = 0;
+          while (sMore && sGuard++ < 100) {
+            const nr = await call(nextRoute, mockReq(`/dsh-tts-api/rvc-next?job=${skipParsed.jobId}`), mockRes());
+            const np = JSON.parse(nr.body);
+            if (np.url || np.skipped) seen.push(np.index);
+            sMore = !!np.more;
+            if (np.done) break;
+          }
+          const expect = [];
+          for (let i = skipParsed.chunks.length; i < skipParsed.total; i++) expect.push(i);
+          check('post-prewarm serves continue strictly in order to total',
+            JSON.stringify(seen) === JSON.stringify(expect) && sMore === false,
+            `got [${seen}] expect [${expect}] total=${skipParsed.total}`);
+        }
+      } finally {
+        await new Promise((r) => failServer.close(r));
+      }
+    }
+
     // file-discovery proxy route
     const filesRoute = routes.find((r) => r.kind === 'exact' && r.path === '/dsh-tts-api/rvc-files');
     const fr = await call(filesRoute, mockReq(`/dsh-tts-api/rvc-files?baseUrl=http://127.0.0.1:${mock.port}&kind=pth`), mockRes());