@ganziliang/desktop-pet 0.1.0 → 0.1.1

package/README.md

@@ -24,6 +24,7 @@ desktop-pet
 ```
 
 包内自带 electron 依赖，命令行参数原样透传给主进程（`--snapshot`、`--anim=<walk|run|swim|awaken:seraph>`、`--no-auto`）。
+首次启动会先下载 Electron 运行时（约 100MB，只在第一次），终端会打印 `Downloading Electron binary...`。
 只发布运行需要的素材，`assets/source/`（生图原始图，约 39MB）与 `character_green*.png` 不进包。
 
 
@@ -59,21 +60,29 @@ desktop-pet
 和特效事件共用同一条时间轴，所以「动作推到哪一帧」和「特效炸在哪一刻」是对死的：
 
 ```
-0ms          黑屏切入（canvas 暗幕，全黑 0.94）
-180ms        窗口放大（藏在黑幕里，看不见窗口在变形）
-560ms        暗幕提到 0.6 —— 角色以「蓄力」序列帧亮相
+0ms          切入（默认不铺暗幕，桌面直接透出去）
+180ms        窗口放大（只向上、向两侧长，脚下那条线和水平中心都不动，所以看不到变形）
+560ms        角色以「蓄力」序列帧亮相
              蓄力 4 帧 × 360ms：合手聚气 → 抬手 → 上举 → 蓄力顶点
              同时跑魔法阵、向心汇聚、脚下螺旋
 2000ms       爆发（revealAt）：白闪 + 抖屏 + 冲击波，切到「爆发」序列帧
              爆发 4 帧 × 300ms：张臂 → 光爆 → 释放 → 收势
 2200ms       光柱冲天 + 主爆星屑
 2650ms       技能名落字
-4400ms       暗幕再进 + 窗口收回（同样藏在黑幕里）
-5700ms       暗幕退掉，回到站立
+4400ms       窗口收回（同样只向上向两侧收，角色不动）
+5700ms       回到站立
 ```
 
-暗幕在 `charge.at` 就从全黑提到 0.6，所以**蓄力动作是真的看得见的** ——
-不是一层黑幕盖满五秒再炸一下。
+**演出期间窗口背景完全透明**：桌面上只看得到角色和光效，不会出现一块暗色矩形。
+这一点靠 `assets/outfits.json` 的 `curtain` 控制，默认 `false`：
+
+```json
+{ "curtain": false }
+```
+
+要不要铺暗幕，取决于壁纸：加色混合的光效（金光、雷光）在**亮色壁纸**上本来就很难拉开对比，
+垫一层暗底才亮得起来 —— 想回到老的「黑屏切入」就把 `curtain` 改成 `true`（代价是屏幕上会多一个暗窗）。
+关掉时光效照跑，只是没有暗底垫着。
 
 ### 素材是两步，不是一步
 
@@ -315,7 +324,7 @@ npx electron . --snapshot
 #    --anim=<walk|run|swim> 先把角色摆到某个动作再截，用来查动作素材
 npx electron . --snapshot --anim=swim
 #    觉醒也能截：--anim=awaken:<id>；换 PET_SNAPSHOT_MS 就能逐帧看整场演出
-PET_SNAPSHOT_MS=1200 npx electron . --snapshot --anim=awaken:seraph   # 蓄力：黑屏 + 魔法阵
+PET_SNAPSHOT_MS=1200 npx electron . --snapshot --anim=awaken:seraph   # 蓄力：魔法阵 + 聚气
 PET_SNAPSHOT_MS=3400 npx electron . --snapshot --anim=awaken:seraph   # 亮相 + 技能名
 PET_SNAPSHOT_MS=6500 npx electron . --snapshot --anim=awaken:seraph   # 收招：窗口应该已还原
 #    PET_SNAPSHOT_MS 改截帧时刻。用两个不同值各截一张做差分，就能证明逐帧动画真的在推进：

package/assets/awaken/README.md

@@ -18,11 +18,12 @@
 ```js
 sheet: { charge: { at: 560, step: 360 }, burst: { at: 2000, step: 300 } },
 revealAt: 2000,   // = burst.at，爆发那一刻（白闪 + 抖屏）
-closeAt: 4400,    // 暗幕再进 + 窗口收回
+closeAt: 4400,    // 窗口收回（默认铺暗幕；见下）
 ```
 
 蓄力 4 帧 × 360ms（560→1640），爆发 4 帧 × 300ms（2000→2900），之后停在最后一帧收招式。
-暗幕在 `charge.at` 从全黑提到 0.6，所以**蓄力动作是真的看得见的**，不是一层黑幕盖完五秒。
+暗幕默认**关**（`assets/outfits.json` 的 `curtain: false`）：演出期间窗口背景全透明，墙上不会出现暗色矩形。
+改成 `true` 就回到「黑屏切入」—— 起步全黑、`charge.at` 提到 0.6 的柔暗底，蓄力动作依然看得见。
 
 ## 怎么加一张
 

package/assets/outfits.json

@@ -1,5 +1,6 @@
 {
   "comment": "战斗服装 / 觉醒技能清单。渲染层按 id 找 assets/awaken/<id>.png 作为觉醒立绘；素材缺失时用 idle 帧 + 纯特效兜底，不会崩。",
+  "curtain": false,
   "stage": {
     "widthRatio": 0.46,
     "heightRatio": 0.72,

package/main.js

@@ -128,12 +128,20 @@ function loadSpriteManifest() {
  * 而不会因为少个 json 让整个右键菜单空掉。
  */
 function loadOutfits() {
-  const fallback = { stage: {}, list: [{ id: 'seraph', name: '圣光 · 炽天使', skill: '圣裁之光' }] };
+  const fallback = {
+    stage: {},
+    list: [{ id: 'seraph', name: '圣光 · 炽天使', skill: '圣裁之光' }],
+    curtain: false,
+  };
   try {
     const raw = JSON.parse(fs.readFileSync(OUTFITS_FILE, 'utf8'));
     return {
       stage: raw.stage || {},
       list: Array.isArray(raw.list) && raw.list.length ? raw.list : fallback.list,
+      // 觉醒暗幕开关。默认关：演出期间窗口背景完全透明，桌面上只有角色和光效，
+      // 不会出现一块暗色矩形。显式写 true 才回到旧的「黑屏切入」
+      // （亮色壁纸下加色光效更清楚，代价是屏幕上多一个暗窗）。
+      curtain: raw.curtain === true,
     };
   } catch {
     return fallback;
@@ -1002,7 +1010,7 @@ function registerIpc() {
     roamGapMs: Number(process.env.PET_ROAM_GAP_MS) || null,
     assets: spriteAssets(),
     // 觉醒清单交给渲染层：菜单里的名字、角色缩放比例、窗口目标规模都从这取
-    awaken: { list: outfits.list, stage: outfits.stage },
+    awaken: { list: outfits.list, stage: outfits.stage, curtain: outfits.curtain },
     httpPort: HTTP_PORT,
   }));
 

package/package.json

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

package/renderer/app.js

@@ -716,18 +716,28 @@ function applyDemo(anim) {
 
 /**
  * 一场觉醒演出的时间线（毫秒）：
- *   0            黑屏切入（canvas 暗幕）
+ *   0            切入（curtain=true 时是黑屏，默认直接把桌面透出去）
  *   180          窗口放大 + 换上战斗服立绘 + 「镜头推近」
- *   revealAt     暗幕退 + 白闪 + 画面抖动 + 主爆发（具体特效由各套觉醒的 build 排）
- *   closeAt      暗幕再进 + 窗口收回（正好盖住窗口变回去的那一帧）
+ *   revealAt     亮相 + 白闪 + 画面抖动 + 主爆发（具体特效由各套觉醒的 build 排）
+ *   closeAt      暗幕再进 + 窗口收回
  *   duration     暗幕退掉，回到站立
  *
- * 关键点：窗口尺寸是在「暗幕已经盖满」之后才改的，所以看不到窗口在变形。
- * DNF 的觉醒也是这么处理的 —— 黑屏切入从来不只是省钱，它负责把不好看的那一帧藏起来。
+ * 窗口尺寸是在「画面已经被盖住」之后才改的。默认 curtain=false，也就是不铺暗幕：
+ * 窗口只向上、向两侧长（见 main.js 的 awakenTarget），角色脚下那条线和水平中心都不动，
+ * 所以窗口变形这一帧本来就看不出来 —— 没必要为了藏它而多一块暗色矩形。
+ * 亮色壁纸下想让金光/雷光更亮，可以在 assets/outfits.json 里把 curtain 改成 true。
  */
 
 let awakenToken = 0; // 每次演出一个令牌；旧演出的挂起回调拿它对不上号就自己失效
 
+/**
+ * 暗幕开关（assets/outfits.json 的 curtain，默认 false = 不铺暗色底）。
+ * 关掉时所有 dim 的 alpha 都走 0：FX 那套渐变/时间轴一行不用改，
+ * 只是每帧的 drawDim 直接 return，画布上除角色和光效之外没有别的东西。
+ */
+const curtainOn = () => cfg.awaken?.curtain === true;
+const curtainAlpha = (a) => (curtainOn() ? a : 0);
+
 /** 角色当前的屏幕位置，事件在触发的那一刻现取（窗口刚被放大过） */
 /**
  * 觉醒演出的逐帧播放：直接写 backgroundPositionX，不走 steps() 帧动画。
@@ -806,8 +816,8 @@ async function playAwaken(id, { auto = false } = {}) {
   }
   holdShow();
 
-  // 1) 先把屏幕压黑
-  FX.dim(def.dimAlpha, 170, def.palette.stroke);
+  // 1) 先把屏幕压黑（curtain=false 时是 0，等于什么都不铺）
+  FX.dim(curtainAlpha(def.dimAlpha), 170, def.palette.stroke);
 
   // 2) 暗幕盖满之后再把窗口放大，同时按新窗口高度算「镜头推近」的倍数
   await new Promise((r) => setTimeout(r, 180));
@@ -858,7 +868,8 @@ async function playAwaken(id, { auto = false } = {}) {
 
   // 蓄力：暗幕从全黑提到 0.6（soft），让玩家真的能看到蓄力动作在演，
   // 而不是从头到尾一层黑幕摆完五秒 —— 那多帧素材就白做了。
-  if (sheet.charge) {
+  // curtain=false 时这层不铺：桌面本来就透得出来，角色一直看得见。
+  if (sheet.charge && curtainOn()) {
     events.push([sheet.charge.at, () => FX.dim(0.6, 420, def.palette.stroke, true)]);
   }
 
@@ -885,8 +896,9 @@ async function playAwaken(id, { auto = false } = {}) {
     def.closeAt,
     () => {
       if (token !== awakenToken) return;
-      FX.dim(def.dimAlpha, 240, def.palette.stroke);
-      // 窗口变回去这一帧同样藏在暗幕后面，所以这里可以放心地提前收
+      FX.dim(curtainAlpha(def.dimAlpha), 240, def.palette.stroke);
+      // 窗口变回去的那一帧本来就不用遮（窗口只向上向两侧收回，角色不动），
+      // 这里留着只是让 curtain=true 的旧路径一样安全
       setTimeout(() => {
         if (token !== awakenToken) return;
         el.stage.classList.remove('awakening', 'flashing', 'shaking');