dsh-notify-say 0.4.33 → 0.4.34

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

@@ -1423,6 +1423,29 @@ 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。'))
       }
 
       if (s.msg) rows.push(h('div', { key: 'msg', style: S.ok }, s.msg))