dsh-notify-say 0.4.33 → 0.4.35

package/dsh-notify.ps1

@@ -52,6 +52,12 @@ param(
   [string]$VoiceRoot = '',
   # 用户语音包根目录（可写），仅用于诊断日志。
   [string]$UserVoiceRoot = '',
+  # v0.4.34：日志级别。info（默认）= 只记元数据；debug = 记标题与正文。
+  #
+  # 为什么需要：日志会写进 %TEMP%，用户提 Issue 时经常直接上传。
+  # 标题与正文可能含项目名、人名，对诊断「为什么不响」却没帮助。
+  [ValidateSet('info', 'debug')]
+  [string]$LogLevel = 'info',
   # v0.4.16：数字增益倍数（1.0 = 原样；2.0 = 放大一倍）。
   #
   # 为什么需要：实测本包 247 个语音包峰值中位仅 **40.4%**
@@ -281,6 +287,23 @@ try {
   $logDir = Join-Path ([System.IO.Path]::GetTempPath()) 'dsh-notify-say'
   if (-not (Test-Path -LiteralPath $logDir)) { New-Item -ItemType Directory -Force -Path $logDir | Out-Null }
   $logFile = Join-Path $logDir 'notify.log'
+
+# v0.4.34：写一行日志。$detail = 含用户内容（标题/正文），只在 debug 档写。
+#
+# 用函数而不是内联 Add-Content：三处调用点都要同样判断，
+# 内联会让"某处忘了判断"这种遗漏很难看出来。
+function Write-NotifyLog([string]$KindTag, [string]$Extra, [string]$Detail) {
+  if (-not $logFile) { return }
+  try {
+    $ts = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
+    $parts = @($ts, "[$KindTag]", $Extra)
+    if ($Detail) {
+      if ($LogLevel -eq 'debug') { $parts += $Detail }
+      else { $parts += '(内容已隐藏，需 -LogLevel debug)' }
+    }
+    Add-Content -Path $logFile -Value (($parts -join ' ').Trim()) -Encoding utf8
+  } catch { }
+}
   # 审查建议采纳：容量护栏——超过 512KB 整文件重建（best-effort 诊断日志，不做轮转）
   if ((Test-Path -LiteralPath $logFile) -and ((Get-Item -LiteralPath $logFile -ErrorAction SilentlyContinue).Length -gt 524288)) {
     Remove-Item -LiteralPath $logFile -Force -ErrorAction SilentlyContinue
@@ -475,16 +498,16 @@ $pickedName = if ($script:playFile) { Split-Path $script:playFile -Leaf } else {
 if ($Preview) {
   if (-not $NoSound) { Play-VoiceLine }
   $soundTag = if ($NoSound) { '（静音）' } elseif ($script:lastSound) { " + 音效 $script:lastSound" } else { ' + 兜底提示音' }
-  if ($logFile) { try { Add-Content -Path $logFile -Value ("{0} [preview] [{1}] -Voice {2} pick={3}{4}" -f (Get-Date -Format 'yyyy-MM-dd HH:mm:ss'), $Kind, $Voice, $pickedName, $soundTag) -Encoding utf8 } catch { } }
+  Write-NotifyLog 'preview' ("-Voice $Voice pick=$pickedName$soundTag") ''
   Write-Host ("[dsh-notify-say] OK 试听 [$Kind] pick=" + $pickedName + $soundTag) -ForegroundColor Green
 } elseif ($shown) {
   if (-not $NoSound) { Play-VoiceLine }
   $soundTag = if ($NoSound) { '（静音）' } elseif ($script:lastSound) { " + 音效 $script:lastSound" } else { ' + 兜底提示音' }
-  if ($logFile) { try { Add-Content -Path $logFile -Value ("{0} [toast] [{1}] {2} - {3} pick={4}{5}" -f (Get-Date -Format 'yyyy-MM-dd HH:mm:ss'), $Kind, $Title, $Body, $pickedName, $soundTag) -Encoding utf8 } catch { } }
+  Write-NotifyLog 'toast' ("pick=$pickedName$soundTag") ("title=$Title body=$Body")
   Write-Host ("[dsh-notify-say] OK Toast [$Kind] pick=" + $pickedName + $soundTag) -ForegroundColor Green
 } else {
   if (-not $NoSound) { Play-VoiceLine }
   $soundTag = if ($NoSound) { '（静音）' } elseif ($script:lastSound) { " + 音效 $script:lastSound" } else { ' + 兜底提示音' }
-  if ($logFile) { try { Add-Content -Path $logFile -Value ("{0} [FALLBACK] [{1}] {2} - {3} pick={4}{5}" -f (Get-Date -Format 'yyyy-MM-dd HH:mm:ss'), $Kind, $Title, $Body, $pickedName, $soundTag) -Encoding utf8 } catch { } }
+  Write-NotifyLog 'FALLBACK' ("pick=$pickedName$soundTag") ("title=$Title body=$Body")
   Write-Host ("[dsh-notify-say] (Toast 不可用，走兜底) [$Kind] pick=" + $pickedName + $soundTag) -ForegroundColor Yellow
 }

package/lib/client.js

@@ -127,6 +127,15 @@ window.__ModuleLoader__.load({
         body: JSON.stringify({ key: key }),
       }).then(function (r) { return r ? r.json() : null }).catch(function () { return null })
     }
+    // 导出诊断（v0.4.35）：宿主读日志 → 脱敏 → 写文件，返回路径。
+    // 用 POST：它会写文件，GET 可被任意网页用 <img> 触发。
+    function exportDiagnostics() {
+      return fetch(apiUrl('diagnostics'), {
+        method: 'POST', cache: 'no-store', credentials: 'same-origin',
+        headers: { 'content-type': 'application/json' },
+        body: '{}',
+      }).then(function (r) { return r ? r.json() : null }).catch(function () { return null })
+    }
 
     function openSession(ctx, sessionId) {
       try {
@@ -514,6 +523,22 @@ window.__ModuleLoader__.load({
           if (ok) loadPacks()
         })
       }
+      // 导出诊断：成功后把路径显示出来（用户要能直接找到文件）。
+      function doExportDiagnostics() {
+        set(function (p) {
+          return { loaded: p.loaded, values: p.values, advOpen: p.advOpen, packs: p.packs, busy: true, msg: '正在导出诊断…', err: '' }
+        })
+        exportDiagnostics().then(function (r) {
+          var ok = r && r.ok
+          set(function (p) {
+            return {
+              loaded: p.loaded, values: p.values, advOpen: p.advOpen, packs: p.packs, busy: false,
+              msg: ok ? ("已导出：" + r.path + "（" + r.lines + " 行）") : "",
+              err: ok ? "" : ("导出失败：" + ((r && (r.error || r.reason)) || "未知原因")),
+            }
+          })
+        })
+      }
 
       var v = s.values || {}
       var rows = []
@@ -1423,6 +1448,46 @@ window.__ModuleLoader__.load({
               + '它依赖宿主内部结构，升级后可能失效；失效时只报错，不影响正常播报。'),
           ),
         ))
+
+        // ── 日志级别（v0.4.34）──────────────────────────────────────────────
+        //
+        // 默认 info：只记元数据（事件、音源、成败、数量）。
+        // debug：额外记台词正文与 Toast 标题正文 —— **可能含敏感信息**。
+        //
+        // 为什么放在高级区：多数人不需要改，但排查问题时要能开。
+        rows.push(h('div', { key: 'll-row', style: S.row },
+          h('span', { style: S.label }, '日志详细度'),
+          h('select', {
+            value: v.logLevel || 'info',
+            disabled: s.busy,
+            onChange: function (e) { apply({ logLevel: e.target.value }, '日志级别已更新') },
+          },
+            h('option', { value: 'info' }, '只记元数据（默认）'),
+            h('option', { value: 'debug' }, '含台词正文（可能敏感）'),
+          ),
+        ))
+        rows.push(h('div', { key: 'll-hint', style: S.subHint },
+          v.logLevel === 'debug'
+            ? '⚠️ debug 档会把台词和通知正文写进日志。日志在 %TEMP%\\dsh-notify-say\\notify.log，'
+              + '提 Issue 前请先切回「只记元数据」或自行删改。'
+            : '日志只记事件类型、音源、成败与数量，不含台词正文。排查问题时可切到 debug。'))
+
+        // ── 导出诊断（v0.4.35）───────────────────────────────────────────
+        //
+        // 用户提 Issue 时最需要的东西：一份**已脱敏**的日志。
+        // 让他自己去 %TEMP% 找、手动删用户名，多数人不会做。
+        rows.push(h('div', { key: 'dg-row', style: S.row },
+          h('span', { style: S.label }, '诊断'),
+          h('button', {
+            type: 'button',
+            disabled: s.busy,
+            style: S.btn,
+            onClick: function () { doExportDiagnostics() },
+          }, '导出诊断文件'),
+        ))
+        rows.push(h('div', { key: 'dg-hint', style: S.subHint },
+          '导出到日志同目录（%TEMP%\\dsh-notify-say\\）。会自动把用户名替换为 <user>、'
+            + '绝对路径替换为 <path>，但**仍请自己再看一遍**再上传。'))
       }
 
       if (s.msg) rows.push(h('div', { key: 'msg', style: S.ok }, s.msg))