dsh-speak 1.7.2 → 1.7.4

package/README.md

@@ -71,9 +71,14 @@ Windows:
 
 - Windows 10 or 11, PowerShell (any recent version).
 - Natural voices:
-  - **Windows 11**: natural voice packs are built into the system — no extra
-    installation. Enable/switch them in *Settings → Accessibility → Narrator* or
-    *Settings → Time & Language → Speech*.
+  - **Windows 11 (21H2–23H2)**: natural voice packs are built into the system —
+    no extra installation. Enable/switch them in *Settings → Accessibility →
+    Narrator* or *Settings → Time & Language → Speech*.
+  - **Windows 11 24H2/25H2**: natural voices moved to MSIX app packages, which
+    `System.Speech` may not enumerate (falls back to a robotic stock voice). As
+    on Windows 10, install
+    [NaturalVoiceSAPIAdapter](https://github.com/gexgd0419/NaturalVoiceSAPIAdapter)
+    to bridge them.
   - **Windows 10**: install
     [NaturalVoiceSAPIAdapter](https://github.com/gexgd0419/NaturalVoiceSAPIAdapter)
     and use its VoiceDownloader to download the natural voice pack(s) you want

package/README.zh-CN.md

@@ -64,8 +64,12 @@ harness 事件（DSH 会话事件 / Claude Code Stop hook / 任意方式）
 
 - Windows 10 或 11，任意较新的 PowerShell。
 - 自然语音：
-  - **Windows 11**：系统已内置自然语音包，无需额外安装——在
+  - **Windows 11（21H2–23H2）**：系统已内置自然语音包，无需额外安装——在
     *设置 → 辅助功能 → 讲述人* 或 *设置 → 时间和语言 → 语音* 中启用/切换即可。
+  - **Windows 11 24H2/25H2**：自然语音已改为 MSIX 应用包，`System.Speech` 可能
+    枚举不到（`SpeechSynthesizer` 找不到自然语音、回退到机械音）——与 Windows 10
+    相同，需安装 [NaturalVoiceSAPIAdapter](https://github.com/gexgd0419/NaturalVoiceSAPIAdapter)
+    桥接。
   - **Windows 10**：需要安装
     [NaturalVoiceSAPIAdapter](https://github.com/gexgd0419/NaturalVoiceSAPIAdapter)，
     并用它的 VoiceDownloader 手动下载你需要的中文或其他语言的自然语音包。

package/adapters/dsh/install.ps1

@@ -1,4 +1,4 @@
-# install.ps1 — one-command installer for the DSH adapter
+# install.ps1 — one-command installer for the DSH adapter
 # ========================================================
 # 1. copies engine/*.ps1 to ~/.dsh/hooks/
 # 2. copies speech-hook.js to ~/.dsh/profiles/web/plugins/

package/engine/speak.ps1

@@ -1,4 +1,4 @@
-# speak.ps1 — Harness-agnostic speech engine (Windows SAPI5 + NaturalVoiceSAPIAdapter)
+# speak.ps1 — Harness-agnostic speech engine (Windows SAPI5 + NaturalVoiceSAPIAdapter)
 # ====================================================================================
 # Reads text (inline or from a UTF-8 file), cleans it for speech synthesis, and reads
 # it aloud through Windows SAPI5, preferring natural voices registered by
@@ -68,7 +68,12 @@ if (-not $fullReadMode -and $text.Length -gt $MaxChars -and $LongTextMode -eq 'h
     $candidate = ''
     $bestLevel = 7
     $firstNonEmpty = ''
+    # 代码块 fence 内的行跳过：其中的 "# 注释" 不是 markdown 标题，
+    # 否则长回复里的代码注释会被误当成标题只念注释
+    $inCodeBlock = $false
     foreach ($line in ($text -split "`n")) {
+        if ($line -match '^\s*```') { $inCodeBlock = -not $inCodeBlock; continue }
+        if ($inCodeBlock) { continue }
         if ($line -match '^\s*#{1,6}\s+') {
             $level = ([regex]::Match($line, '^(\s*)(#+)')).Groups[2].Value.Length
             if ($level -lt $bestLevel) {

package/engine/speak.sh

@@ -56,8 +56,10 @@ fi
 # -F (full read, manual replay) skips this guard entirely.
 if [ "$FULL_READ" != "1" ] && [ "$MAX_CHARS" -gt 0 ] && [ "${#TEXT}" -gt "$MAX_CHARS" ] && [ "$LONG_MODE" = "heading" ]; then
   TEXT=$(printf '%s' "$TEXT" | /usr/bin/perl -CSD -e '
-    my $best = 7; my $cand = ""; my $first = "";
+    my $best = 7; my $cand = ""; my $first = ""; my $inCode = 0;
     while (<STDIN>) {
+      if (/^\s*```/) { $inCode = !$inCode; next; }   # 跳过代码块内的 "# 注释"
+      next if $inCode;
       if (/^[ \t]*(\#{1,6})[ \t]+(.*)$/) { my $n = length($1); if ($n < $best) { $best = $n; $cand = $2; } }
       elsif ($first eq "" && /\S/) { $first = $_; }
     }

package/engine/speech-prompt.ps1

@@ -1,4 +1,4 @@
-# speech-prompt.ps1 — Short prompt announcement (synchronous, blocking)
+# speech-prompt.ps1 — Short prompt announcement (synchronous, blocking)
 # Use when a harness/agent needs the user's attention (a question, an approval
 # request). Reads the text through engine/speak.ps1 and waits until it finishes,
 # so the caller knows the announcement was actually spoken.

package/engine/speech-summary.ps1

@@ -1,4 +1,4 @@
-# speech-summary.ps1 — Reply summary announcement (synchronous, blocking)
+# speech-summary.ps1 — Reply summary announcement (synchronous, blocking)
 # For harnesses with no "reply finished" event (e.g. DSH has no Stop hook): the
 # agent calls this at the end of its final reply.
 #

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-speak",
-  "version": "1.7.2",
+  "version": "1.7.4",
   "description": "Make your AI harness speak — voice announcements for DSH and other AI coding harnesses (Windows SAPI5 + macOS system voices)",
   "main": "adapters/dsh/speech-hook.js",
   "exports": {