dsh-wisp 1.35.0 → 1.36.0

package/README.md

@@ -448,6 +448,59 @@ node tools/audit-log.mjs --confirm <manifest>     # 生成后：并入代理登
 
 ## 变更
 
+### 1.36.0
+
+一次性做完 ③④⑤ 三件事。其中 **⑤ 完整交付并验证**；③④ 的**代码路径全部做完并接好**，
+但素材生成这次没成功（原因见最后一节）。
+
+#### ⑤ 英文台词
+
+她会说英文了。**只翻译她说的话**（菜单按钮文案仍由 DSH 界面语言决定，不在这一层）。
+
+实现上是**覆盖层**而不是替换：中文词池原样保留，英文按 key 覆盖上去，
+缺哪条就自动退回中文 —— 所以可以慢慢补齐，永远不会出现半句话。
+
+语言来源按优先级：① 本地存的强制值 `localStorage['dsh-wisp-lang']`
+② 页面 `<html lang>` ③ `navigator.language`。
+
+**② 排在 ③ 前面是刻意的**：界面是中文、系统是英文的用户，不该听到英文台词 ——
+页面的 lang 比系统语言更能代表"我现在在看什么语言"。
+
+三条检查：英文环境下说英文 ✓、句子里**一个汉字都没有** ✓、强制中文时仍是中文 ✓（对照组，
+否则第一条可能只是"恰好没触发"）。
+
+#### ③ 音效（默认关闭）
+
+四个音效位：`poke`（戳一下）/ `done`（跑完）/ `focusEnd`（专注结束）/ `notice`（提醒你起来）。
+
+- **默认关闭** —— 无故出声是最招人烦的交互之一，必须是用户主动打开的。
+- **没有音频文件时整条路径静默**，而且**菜单里连那个开关都不显示** ——
+  摆一个点了没反应的开关，比没有开关更糟。
+- 素材落地方式：把 `poke.mp3` 等放进 `assets/audio/`，构建自动内联成 data URL，重启即生效。
+
+#### ④ 第九个情绪：`report`（抱着记录本汇报）
+
+给**值班汇报 / 今日小结 / 专注结束**用 —— 正好接上 1.35.0 那三件事。
+
+它和别的格子一样走 `SPRITE_FALLBACK`：**素材还没生成时自动退回 `idle`**，
+不会出现空白或坏图。构建也认这一点：`report` 是**可选心情**，缺素材只警告不中断。
+
+#### 这一节说清楚"没做完的部分"
+
+**五张 `report` 母版与四个音效这次没生成出来。** 两次 Maker 生成调用都**请求超时**，
+第二次挂了约一小时，事后检查三处可能的落地目录，**一个新文件都没有** —— 这是服务侧的挂起，
+不是提示词或参数的问题（同一个工具此前生成过 40 张素材）。
+
+所以这一版交付的是**可以立刻用上的代码路径**：素材一放进目录、重跑构建就生效，
+不需要再改一行代码。素材缺失时的行为是**静默降级**而不是报错。
+
+另外顺手修了构建里两处**只认必选心情**的守卫（它们会把"缺 report"当成致命错误直接退出）——
+这正是"素材可后补"这件事在构建侧的对应改动。
+
+预检 539 → **542 项**。
+
+### 1.35.0
+
 ### 1.35.0
 
 **她开始替你"值班"。** 在这之前，你走开时她只是**安静下来**；回来只说一句"你走了好久"。

package/build.mjs

@@ -45,7 +45,10 @@ const assetsDir = resolve(here, flagValue('--from', 'assets'))
 const templatePath = join(here, 'lib', 'client.template.js')
 const outPath = join(here, 'lib', 'client.js')
 
-const MOODS = ['idle', 'happy', 'sleepy', 'work', 'attn', 'poked', 'proud', 'eat']
+/* report = 抱着记录本汇报（值班汇报 / 今日小结 / 专注结束）。它和其它格子一样，
+   但**允许缺素材**：缺了就跳过，客户端由 SPRITE_FALLBACK 退回 idle。 */
+const MOODS = ['idle', 'happy', 'sleepy', 'work', 'attn', 'poked', 'proud', 'eat', 'report']
+const OPTIONAL_MOODS = ['report']
 
 /* 皮肤 = assets/ 下的一个子目录，里面是这套皮肤的 <mood>[_tier].webp。
    如果没有子目录含精灵图，就把 assets/ 本身当作一个名为 default 的皮肤 ——
@@ -102,6 +105,20 @@ if (skins.length === 0) {
   process.exit(1)
 }
 
+/* 音效：assets/audio/<名字>.mp3 -> { <名字>: "data:audio/mpeg;base64,…" }。
+   没有文件就是空对象 —— 客户端据此连菜单开关都不显示（点了没反应的开关更糟）。 */
+const audioDir = join(assetsDir, 'audio')
+const sounds = {}
+if (existsSync(audioDir)) {
+  const MIME = { '.mp3': 'audio/mpeg', '.m4a': 'audio/mp4', '.ogg': 'audio/ogg', '.wav': 'audio/wav' }
+  for (const name of readdirSync(audioDir).sort()) {
+    const ext = name.slice(name.lastIndexOf('.')).toLowerCase()
+    if (MIME[ext] === undefined) continue
+    sounds[name.slice(0, name.lastIndexOf('.'))] = `data:${MIME[ext]};base64,${readFileSync(join(audioDir, name)).toString('base64')}`
+  }
+}
+if (Object.keys(sounds).length > 0) console.log(`  audio: ${Object.keys(sounds).join(', ')}`)
+
 const sprites = {}
 let total = 0
 for (const skin of skins) {
@@ -111,6 +128,11 @@ for (const skin of skins) {
   for (const mood of MOODS) {
     const file = pickFile(dir, mood)
     if (!file) {
+      /* 可选心情（report）缺素材只警告不中断：客户端有回退表，缺它不会变成坏行为。 */
+      if (OPTIONAL_MOODS.includes(mood)) {
+        console.warn(`  ! ${skin}: 跳过可选心情 "${mood}"（还没有素材）`)
+        continue
+      }
       console.error(`build: skin "${skin}" has no sprite for mood "${mood}"`)
       process.exit(1)
     }
@@ -140,7 +162,11 @@ const literal = '{\n' + skins.map((skin) => (
   + MOODS.map((m) => `        ${m}: '${sprites[skin][m]}',`).join('\n')
   + '\n      },'
 )).join('\n') + '\n    }'
-const out = template.replace(PLACEHOLDER, literal)
+const soundsInlined = template.replace(
+  "const SOUNDS = (typeof __WISP_SOUNDS__",
+  `const __WISP_SOUNDS__ = ${JSON.stringify(sounds)}\nconst SOUNDS = (typeof __WISP_SOUNDS__`,
+)
+const out = soundsInlined.replace(PLACEHOLDER, literal)
 
 if (out.includes(PLACEHOLDER)) {
   console.error('build: placeholder survived the substitution; refusing to write a broken bundle')
@@ -174,8 +200,10 @@ if (stamped[1] !== pkg.version) {
 }
 
 // Prove the injected table survives parsing before writing anything.
+// 可选心情（report）允许缺失：客户端有 SPRITE_FALLBACK 兜底，缺它不会变成坏行为。
 const table = out.match(/const SPRITES = \{([\s\S]*?)\n {4}\}/)
-if (!table || MOODS.some((m) => !new RegExp(`\\b${m}:\\s*'data:image/`).test(table[1]))) {
+const requiredMoods = MOODS.filter((m) => !OPTIONAL_MOODS.includes(m))
+if (!table || requiredMoods.some((m) => !new RegExp(`\\b${m}:\\s*'data:image/`).test(table[1]))) {
   console.error('build: the injected SPRITES table is missing sprites; aborting')
   process.exit(1)
 }
@@ -187,6 +215,7 @@ try {
   const broken = []
   for (const skin of skins) {
     for (const mood of MOODS) {
+      if (OPTIONAL_MOODS.includes(mood)) continue      // 可缺：客户端由 SPRITE_FALLBACK 兜底
       const uri = value?.[skin]?.[mood]
       if (typeof uri !== 'string' || uri.indexOf('data:image/') !== 0) broken.push(`${skin}/${mood}`)
     }