@ganziliang/desktop-pet 0.1.1 → 0.1.2

package/README.md

@@ -80,6 +80,12 @@ desktop-pet
 { "curtain": false }
 ```
 
+开关只有**一个**生效点 —— `renderer/fx.js` 的 `FX.setDimEnabled()`：`dim()` 的调用点一半在
+`app.js` 的演出时间线，一半散在 `awaken.js` 每套觉醒亮相时的柔暗底（`fx.dim(0.34, …, c.stroke, true)`），
+只在调用点各自判会漏 —— 漏掉的那一处就是屏幕上那块暗紫色矩形（`capturePage` 的四角探针也看不见它，
+因为柔暗底在画面正中浓、到四角已经淡到 0，但**窗口的四条边**上依然是有颜色的）。
+要回归就往 `scripts/probe-dim.py` 那条命令，看环带的中位 alpha。
+
 要不要铺暗幕，取决于壁纸：加色混合的光效（金光、雷光）在**亮色壁纸**上本来就很难拉开对比，
 垫一层暗底才亮得起来 —— 想回到老的「黑屏切入」就把 `curtain` 改成 `true`（代价是屏幕上会多一个暗窗）。
 关掉时光效照跑，只是没有暗底垫着。
@@ -332,6 +338,11 @@ PET_SNAPSHOT_MS=6500 npx electron . --snapshot --anim=awaken:seraph   # 收招
 PET_SNAPSHOT_MS=1500 PET_SNAPSHOT_OUT=f1.png npx electron . --snapshot --anim=run
 PET_SNAPSHOT_MS=1580 PET_SNAPSHOT_OUT=f2.png npx electron . --snapshot --anim=run
 
+#    觉醒「不该有暗色矩形」的回归测试：沿画布四边取 18px 环带看 alpha。
+#    注意 --snapshot 的 capturePage 只证明「画布上没画暗色」，不能证明桌面上没有暗雾，
+#    所以真正要看的是脚本里的中位 alpha（整窗覆盖 ≈ 几十，只有粒子 ≈ 0）：
+python scripts/probe-dim.py /tmp/dim-probe 2000,2400,3000,3600 seraph nocturne thunder astral
+
 # 2) 带调试日志启动（写 pet-debug.log）
 powershell -ExecutionPolicy Bypass -File scripts/debug-run.ps1
 

package/assets/outfits.json

@@ -11,9 +11,29 @@
     "zoom": 1.5
   },
   "list": [
-    { "id": "seraph", "name": "圣光 · 炽天使", "skill": "圣裁之光", "hint": "金白光柱 / 羽翼 / 圆形符文阵" },
-    { "id": "nocturne", "name": "暗影 · 血月狂想", "skill": "夜狱降临", "hint": "血月升起 / 蝠影 / 黑雾" },
-    { "id": "thunder", "name": "雷霆 · 天罚", "skill": "雷神裁决", "hint": "雷云 / 连锁闪电 / 电磁环" },
-    { "id": "astral", "name": "幻梦 · 星海", "skill": "星海咏叹", "hint": "星尘漩涡 / 星河光带 / 水晶碎片" }
+    {
+      "id": "seraph",
+      "name": "圣光 · 炽天使",
+      "skill": "圣裁之光",
+      "hint": "金白光柱 / 羽翼 / 圆形符文阵"
+    },
+    {
+      "id": "nocturne",
+      "name": "暗影 · 血月狂想",
+      "skill": "夜狱降临",
+      "hint": "血月升起 / 蝠影 / 黑雾"
+    },
+    {
+      "id": "thunder",
+      "name": "雷霆 · 天罚",
+      "skill": "雷神裁决",
+      "hint": "雷云 / 连锁闪电 / 电磁环"
+    },
+    {
+      "id": "astral",
+      "name": "幻梦 · 星海",
+      "skill": "星海咏叹",
+      "hint": "星尘漩涡 / 星河光带 / 水晶碎片"
+    }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ganziliang/desktop-pet",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "桌面动漫角色小控件：透明置顶窗 + 像素级命中测试 + 鼠标交互 + 本地 HTTP 消息接口（Electron 桌宠）",
   "main": "main.js",
   "bin": {

package/renderer/app.js

@@ -732,11 +732,11 @@ let awakenToken = 0; // 每次演出一个令牌；旧演出的挂起回调拿
 
 /**
  * 暗幕开关（assets/outfits.json 的 curtain，默认 false = 不铺暗色底）。
- * 关掉时所有 dim 的 alpha 都走 0：FX 那套渐变/时间轴一行不用改，
- * 只是每帧的 drawDim 直接 return，画布上除角色和光效之外没有别的东西。
+ * 真正生效的位置在 fx.js 的 FX.setDimEnabled()：那里是唯一的开关，
+ * 因为 dim() 的调用点除了下面这条时间线，还有 awaken.js 里每套觉醒亮相时的柔暗底。
+ * 漏掉任何一处都会在屏幕上留一块暗色矩形，所以不要在调用点反复判。
  */
 const curtainOn = () => cfg.awaken?.curtain === true;
-const curtainAlpha = (a) => (curtainOn() ? a : 0);
 
 /** 角色当前的屏幕位置，事件在触发的那一刻现取（窗口刚被放大过） */
 /**
@@ -810,14 +810,16 @@ async function playAwaken(id, { auto = false } = {}) {
 
   const token = ++awakenToken;
   state.autoAwaken = !!auto;
+  // 整场演出的暗幕开关一次性定好（含 awaken.js 里各套觉醒自己排的柔暗底）
+  FX.setDimEnabled(curtainOn());
   if (state.roaming) {
     window.pet.haltRoam();
     endLoco('awaken');
   }
   holdShow();
 
-  // 1) 先把屏幕压黑（curtain=false 时是 0，等于什么都不铺）
-  FX.dim(curtainAlpha(def.dimAlpha), 170, def.palette.stroke);
+  // 1) 先把屏幕压黑（curtain=false 时 FX 内部直接忽略）
+  FX.dim(def.dimAlpha, 170, def.palette.stroke);
 
   // 2) 暗幕盖满之后再把窗口放大，同时按新窗口高度算「镜头推近」的倍数
   await new Promise((r) => setTimeout(r, 180));
@@ -868,8 +870,7 @@ async function playAwaken(id, { auto = false } = {}) {
 
   // 蓄力：暗幕从全黑提到 0.6（soft），让玩家真的能看到蓄力动作在演，
   // 而不是从头到尾一层黑幕摆完五秒 —— 那多帧素材就白做了。
-  // curtain=false 时这层不铺：桌面本来就透得出来，角色一直看得见。
-  if (sheet.charge && curtainOn()) {
+  if (sheet.charge) {
     events.push([sheet.charge.at, () => FX.dim(0.6, 420, def.palette.stroke, true)]);
   }
 
@@ -896,9 +897,9 @@ async function playAwaken(id, { auto = false } = {}) {
     def.closeAt,
     () => {
       if (token !== awakenToken) return;
-      FX.dim(curtainAlpha(def.dimAlpha), 240, def.palette.stroke);
-      // 窗口变回去的那一帧本来就不用遮（窗口只向上向两侧收回，角色不动），
-      // 这里留着只是让 curtain=true 的旧路径一样安全
+      FX.dim(def.dimAlpha, 240, def.palette.stroke);
+      // 窗口变回去的那一帧本来就不用遮（窗口只向上向两侧收回，角色不动）；
+      // curtain=true 时这层仍然和以前一样盖住收招
       setTimeout(() => {
         if (token !== awakenToken) return;
         el.stage.classList.remove('awakening', 'flashing', 'shaking');
@@ -1111,6 +1112,7 @@ async function init() {
   cfg = await window.pet.getConfig();
   dbgOn = !!cfg.debug;
   gapOverride = cfg.roamGapMs || null;
+  FX.setDimEnabled(cfg.awaken?.curtain === true); // 暗幕开关交给引擎，见 curtainOn 的注释
   dbg(`init debug=${dbgOn} roamGap=${gapOverride ?? '默认区间'}`);
   state.scale = cfg.scale ?? 1;
   applyScale(state.scale);

package/renderer/fx.js

@@ -550,6 +550,14 @@ const FX = (() => {
   let dimColor = '#0a0410';
   let dimSoft = false;
 
+  // 暗幕总开关。setDimEnabled(false) 之后 dim() 全部变成空操作，
+  // 也就是「演出期间窗口背景完全透明，桌面上只看得到角色和光效」。
+  //
+  // 为什么开关放在引擎里，而不是让每个调用点自己判：dim 的调用点一半在 app.js 的时间线、
+  // 一半散在 awaken.js 每套觉醒的 build 里（亮相那一下的柔暗底），
+  // 漏掉任何一处就会在屏幕上留下一层「暗色矩形」—— 这正是之前的 bug。
+  let dimAllowed = true;
+
   /**
    * 暗幕 / 全屏闪白。alpha 0 = 全透明，1 = 全黑。
    * 0→1 用来做「黑屏切入」，1→0 用来做「角色亮相」，alpha 1 + 白色 = 闪白。
@@ -558,6 +566,13 @@ const FX = (() => {
    * 本来就很难看清楚（白底上加白还是白），垫一层柔和的暗底，金光/雷光才能真的亮起来。
    */
   function dim(alpha, ms, color, soft) {
+    if (!dimAllowed) {
+      // 关掉时顺手把残留清干净，避免开关切换的瞬间卡在半透明
+      dimNow = 0;
+      dimTo = 0;
+      dimSoft = false;
+      return;
+    }
     if (color) dimColor = color;
     if (soft !== undefined) dimSoft = !!soft;
     const target = Math.max(0, Math.min(1, alpha));
@@ -1023,6 +1038,19 @@ const FX = (() => {
     play,
     stop,
     reset,
+    /** 暗幕总开关：false = 演出全程不铺任何暗色底（默认关，见 app.js 的 curtainOn） */
+    setDimEnabled(on) {
+      dimAllowed = !!on;
+      if (!dimAllowed) {
+        dimNow = 0;
+        dimTo = 0;
+        dimSoft = false;
+        drawDim(); // dimNow 已归零 → 内部直接 return，等效于不再画
+      }
+    },
+    get dimEnabled() {
+      return dimAllowed;
+    },
     get busy() {
       return (
         !!script || emitters.length > 0 || geo.length > 0 || dimNow !== dimTo || aliveParticles() > 0

package/scripts/probe-dim.py

@@ -0,0 +1,41 @@
+#!/usr/bin/env python
+# QA：用 capturePage 逐帧探「整窗覆盖物」——沿画布四边 18px 环带取 alpha
+# 用法: probe-dim.py <输出目录> <a,b,c... 时刻ms> <anim...>
+import os, subprocess, sys, glob
+from PIL import Image
+
+ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+outdir, stamps, anims = sys.argv[1], [int(v) for v in sys.argv[2].split(',')], sys.argv[3:]
+os.makedirs(outdir, exist_ok=True)
+
+def ring_stats(path):
+    im = Image.open(path).convert('RGBA')
+    W, H = im.size
+    px = im.load()
+    band = 18
+    alphas = []
+    for x in range(0, W, 3):
+        for y in list(range(0, band)) + list(range(H - band, H)):
+            alphas.append(px[x, y][3])
+    for y in range(0, H, 3):
+        for x in list(range(0, band)) + list(range(W - band, W)):
+            alphas.append(px[x, y][3])
+    alphas.sort()
+    return W, H, max(alphas), alphas[len(alphas) // 2], sum(alphas) / len(alphas)
+
+print(f"{'套装':<10}{'时刻ms':<8}{'画布':<12}{'环带max α':<11}{'环带中位 α':<11}{'环带均值 α'}")
+bad = []
+for anim in anims:
+    for ms in stamps:
+        dst = os.path.join(outdir, f'{anim}-{ms}.png')
+        env = dict(os.environ, PET_SNAPSHOT_OUT=dst, PET_SNAPSHOT_MS=str(ms))
+        subprocess.run(['node', 'bin/desktop-pet.js', '--snapshot', f'--anim=awaken:{anim}'],
+                       cwd=ROOT, env=env, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        W, H, mx, med, avg = ring_stats(dst)
+        flag = ''
+        if mx > 12:
+            flag = '   ← 整窗有覆盖物!'
+            bad.append((anim, ms, mx))
+        print(f"{anim:<10}{ms:<8}{f'{W}x{H}':<12}{mx:<11}{med:<11}{avg:<8.1f}{flag}")
+print()
+print("结论:", "环带上还有非零 alpha 的帧:" + str(bad) if bad else "全部帧环带 alpha 均为 0 —— 没有任何整窗覆盖物")

package/scripts/qa-awaken-capture.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+# QA：在「已确认是亮色」的背景板上，对同一段觉醒演出连拍整屏。
+# 用法: qa-awaken-capture.sh <输出目录> [curtain:false|true]
+set -u
+# 仓库根 = 本脚本所在目录的上一级，不写死绝对路径
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -W 2>/dev/null || cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+OUT="$1"; CURTAIN="${2:-false}"; ANIM="${3:-awaken:seraph}"
+mkdir -p "$OUT"
+
+kill_all() {
+  powershell -NoProfile -Command "Get-Process electron -ErrorAction SilentlyContinue | Stop-Process -Force" >/dev/null 2>&1
+  powershell -NoProfile -Command "Get-Process powershell -ErrorAction SilentlyContinue | Where-Object { \$_.MainWindowTitle -eq '' } | Stop-Process -Force" >/dev/null 2>&1
+  sleep 1
+}
+
+# 1) 背景板，等到「照片确实是亮的」再继续
+kill_all
+powershell -NoProfile -ExecutionPolicy Bypass -File "$ROOT/scripts/qa-backdrop.ps1" \
+  "$(cygpath -w $ROOT/outputs/qa-backdrop.png)" >/dev/null 2>&1 &
+for i in $(seq 1 25); do
+  sleep 1
+  powershell -NoProfile -ExecutionPolicy Bypass -File "$ROOT/scripts/shoot-screen.ps1" "$(cygpath -w $OUT/warmup.png)" >/dev/null 2>&1
+  bright=$(python - "$OUT/warmup.png" <<'PY'
+import sys
+from PIL import Image
+im = Image.open(sys.argv[1]).convert('L').resize((32,18))
+px = sorted(im.getdata()); print(px[len(px)//2])
+PY
+)
+  echo "背景板预热 ${i}s 中位亮度=$bright"
+  [ "$bright" -gt 200 ] && break
+done
+
+# 2) 开桌宠（curtain 由调用方先改好 outfits.json）
+cd "$ROOT"
+PET_DEBUG=1 nohup node bin/desktop-pet.js --no-auto > "$OUT/pet.out" 2>&1 &
+ok=0
+for i in $(seq 1 25); do
+  sleep 1
+  if curl -s --max-time 2 http://127.0.0.1:8520/health > "$OUT/health.json"; then ok=1; break; fi
+done
+if [ "$ok" != 1 ]; then
+  echo "!! /health 起不来，pet.out:"; cat "$OUT/pet.out"; tail -3 "$OUT/pet-debug.log" 2>/dev/null; exit 1
+fi
+echo "pet 就绪（${i}s）"
+grep -o '"bounds":{[^}]*}' "$OUT/health.json" || true
+
+# 3) 连拍整屏，中途触发一次觉醒
+powershell -NoProfile -ExecutionPolicy Bypass -File "$ROOT/scripts/qa-burst.ps1" \
+  "$(cygpath -w $OUT)" 6.5 2.0 "$ANIM"
+
+# 门禁：base 必须是亮的，否则背景板没真的在最上层，这轮数据不能用
+base_med=$(python - "$OUT/base.png" <<'PY2'
+import sys
+from PIL import Image
+im = Image.open(sys.argv[1]).convert('L').resize((60,34))
+px = sorted(im.getdata()); print(px[len(px)//2])
+PY2
+)
+echo "base.png 全屏中位亮度=$base_med"
+if [ "$base_med" -lt 180 ]; then
+  echo "!! 背景板被盖住了（base 偏暗），这轮作废"; exit 2
+fi
+
+cp "$ROOT/pet-debug.log" "$OUT/pet-debug.log" 2>/dev/null
+grep -o 'awaken-open {[^}]*}' "$OUT/pet-debug.log" | tail -1 > "$OUT/awaken-rect.txt"
+echo "curtain=$CURTAIN → $OUT  ($(ls "$OUT"/t*.png | wc -l) 帧)  觉醒矩形: $(cat "$OUT/awaken-rect.txt")"
+kill_all

package/scripts/qa-backdrop.ps1

@@ -0,0 +1,14 @@
+Add-Type -AssemblyName System.Windows.Forms, System.Drawing
+$img = [System.Drawing.Image]::FromFile($args[0])
+$f = New-Object System.Windows.Forms.Form
+$f.FormBorderStyle = 'None'
+$f.StartPosition = 'Manual'
+$f.Location = New-Object System.Drawing.Point(0, 0)
+$f.Size = [System.Windows.Forms.Screen]::PrimaryScreen.Bounds.Size
+$f.BackColor = [System.Drawing.Color]::White
+$f.BackgroundImage = $img
+$f.BackgroundImageLayout = 'Stretch'
+$f.ShowInTaskbar = $false
+$f.TopMost = $true
+$f.Add_Shown({ $f.Activate() })
+[System.Windows.Forms.Application]::Run($f)

package/scripts/qa-burst.ps1

@@ -0,0 +1,36 @@
+# QA: capture the whole screen on a fixed cadence and fire one awaken mid-way.
+# ASCII only on purpose: PowerShell 5.1 reads .ps1 as ANSI, CJK comments can break parsing.
+Add-Type -AssemblyName System.Windows.Forms, System.Drawing
+
+$outDir  = $args[0]
+$seconds = [double]$args[1]
+$delay   = [double]$args[2]   # wait before firing the awaken
+$anim    = $args[3]
+
+$screen = [System.Windows.Forms.Screen]::PrimaryScreen.Bounds
+$sw = [System.Diagnostics.Stopwatch]::StartNew()
+
+function Shoot([string]$name) {
+  $bmp = New-Object System.Drawing.Bitmap($screen.Width, $screen.Height)
+  $g = [System.Drawing.Graphics]::FromImage($bmp)
+  $g.CopyFromScreen($screen.Location, [System.Drawing.Point]::Empty, $screen.Size)
+  $bmp.Save((Join-Path $outDir $name), [System.Drawing.Imaging.ImageFormat]::Png)
+  $g.Dispose(); $bmp.Dispose()
+}
+
+Start-Sleep -Seconds $delay
+Shoot 'base.png'
+$t0 = $sw.Elapsed.TotalMilliseconds
+
+try {
+  Invoke-RestMethod -Method Post -Uri 'http://127.0.0.1:8520/action' `
+    -ContentType 'application/json' -Body ("{`"name`":`"$anim`"}") | Out-Null
+} catch { Write-Output "trigger failed: $_" }
+
+$i = 0
+while ($sw.Elapsed.TotalSeconds -lt ($delay + $seconds)) {
+  $ms = [int]($sw.Elapsed.TotalMilliseconds - $t0)
+  Shoot ('t{0:d5}.png' -f $ms)
+  $i++
+}
+Write-Output "shots=$i  dur=$([int]($sw.Elapsed.TotalSeconds - $delay))s"

package/scripts/shoot-screen.ps1

@@ -0,0 +1,7 @@
+Add-Type -AssemblyName System.Windows.Forms, System.Drawing
+$b = [System.Windows.Forms.Screen]::PrimaryScreen.Bounds
+$bmp = New-Object System.Drawing.Bitmap($b.Width, $b.Height)
+$g = [System.Drawing.Graphics]::FromImage($bmp)
+$g.CopyFromScreen($b.Location, [System.Drawing.Point]::Empty, $b.Size)
+$bmp.Save($args[0], [System.Drawing.Imaging.ImageFormat]::Png)
+$g.Dispose(); $bmp.Dispose()