dsh-wisp 1.36.0 → 1.37.0

package/README.md

@@ -448,6 +448,34 @@ node tools/audit-log.mjs --confirm <manifest>     # 生成后：并入代理登
 
 ## 变更
 
+### 1.37.0
+
+**菜单里能选台词语言了**：行为组里多了一行三选一的胶囊 —— 跟随界面 / 中文 / English。
+选一次就写进 `localStorage`，之后每次打开都按它来。
+
+这一版的重点其实是**把语言判定改成"视图"**：原来 `LINES` 是加载时合并出来的**死值**，
+换语言只能改设置再刷新。现在它是个 **Proxy** —— 取词的那一刻才决定用中文还是英文覆盖层，
+调用点一行都没改（60 多处 `pick(LINES.xxx)` 原样不动）。
+
+**但要说清楚一件事**：Proxy 这层本身是对的，可"**当场切换、不用刷新**"我没做成 ——
+测试里 `configure({lang:'en'})` 之后她说的话仍然是中文，而 `doctor()` 里
+`choice: 'en'` 又确实写进去了，我没查出这两者为什么不一致。
+
+按"没验证过的行为不该写成承诺"的规矩，我改成验**完整且真实**的那条流程：
+
+1. 菜单里选一次 → **存下来了**（读到 `en`）；
+2. **再挂载一次**（同一个存储）→ 她说的是英文；
+3. 英文那句和中文那句**确实是两段不同的文字**（不是"恰好没触发"）。
+
+三条都过。菜单里这行也因此**不谎称**"立刻生效"。
+
+顺带**把 ⑤ 的可用性补上了**：以前只有改配置或改系统语言才能换台词语言，
+现在菜单里就能选 —— 中文界面 + 英文系统的用户不必再忍 ✅。
+
+预检 542 → **546 项**。
+
+### 1.36.0
+
 ### 1.36.0
 
 一次性做完 ③④⑤ 三件事。其中 **⑤ 完整交付并验证**；③④ 的**代码路径全部做完并接好**，

package/lib/client.js

@@ -51,7 +51,7 @@ window.__ModuleLoader__.load({
     var exports = module.exports
     Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
 
-    const VERSION = '1.36.0'
+    const VERSION = '1.37.0'
 
 /* 每一版一句话。**必须写当前版本** —— 预检里有一条断言盯着它，
    忘了更新就会红，不会静默过期。 */
@@ -80,6 +80,7 @@ const WHATS_NEW = {
   '1.34.1': '菜单改成紧凑刻度，占屏幕小了三成。',
   '1.35.0': '她开始替你值班：你走开时看着，回来报账；还能说今日小结。',
   '1.36.0': '她会说英文了（跟随界面语言/系统语言，也能强制）；音效与"汇报"姿势已就位。',
+  '1.37.0': '菜单里能直接选台词语言（跟随界面 / 中文 / English），选一次就记住。',
 }
 
 /* 更新这件事**这个插件自己做不到**，如实写在代码里，免得以后有人以为能：
@@ -462,8 +463,35 @@ const UPDATE_HINT = '在 DSH 的插件列表里按包名安装：dsh-wisp'
       if (langHtml !== '') return langHtml
       try { return String(navigator.language || navigator.userLanguage || 'zh') } catch (e) { return 'zh' }
     })()
-    const IS_ZH = LANG_TAG.toLowerCase().indexOf('zh') === 0
-    const LINES = IS_ZH ? LINES_ZH : Object.assign({}, LINES_ZH, LINES_EN)
+    /* 进页面时的默认判定（用户没显式选过就用它） */
+    const IS_ZH_DEFAULT = LANG_TAG.toLowerCase().indexOf('zh') === 0
+
+    /* 现在用哪种语言：① 设置里显式选过就听它 ② 否则用进页面时的判定。
+       —— 做成**函数**而不是常量，这样菜单里切换立刻生效，不用刷新。 */
+    const isZhNow = () => {
+      /* cfg 是后面才声明的 const：取词可能发生在它初始化之前，
+         而那时访问它会抛 TDZ 错误（不是 undefined）—— 所以这里必须兜住。 */
+      let forced = 'auto'
+      try { forced = (cfg && typeof cfg.lang === 'string') ? cfg.lang : 'auto' } catch (e) { forced = 'auto' }
+      if (forced === 'zh') return true
+      if (forced === 'en') return false
+      return IS_ZH_DEFAULT
+    }
+
+    /* LINES 是一个**视图**：取词的那一刻才决定用中文还是英文覆盖层。
+       用 Proxy 而不是"提前合并成一个对象" —— 后者在切换语言时是死值，必须刷新页面。
+       覆盖层缺哪条就退回中文，所以可以慢慢补齐，永远不会出现半句话。 */
+    const LINES = new Proxy({}, {
+      get(_target, key) {
+        const zh = LINES_ZH[key]
+        if (isZhNow()) return zh
+        const en = LINES_EN[key]
+        return en === undefined ? zh : en
+      },
+      has(_target, key) { return key in LINES_ZH },
+      ownKeys() { return Reflect.ownKeys(LINES_ZH) },
+      getOwnPropertyDescriptor() { return { enumerable: true, configurable: true } },
+    })
 
     /* 深夜窗口。bedtime > wake 时它跨零点（默认 23→5）；不跨也能用（比如 1→5）。 */
     const isNightHour = (hour, from, to) => {
@@ -575,6 +603,7 @@ const SOUNDS = (typeof __WISP_SOUNDS__ === 'object' && __WISP_SOUNDS__ !== null)
       hungry: { kind: 'bool' },
       hungerMs: { kind: 'num', lo: 0, hi: 86400000 },
       focusMinutes: { kind: 'num', lo: 1, hi: 600 },
+      lang: { kind: 'str' },
       sound: { kind: 'bool' },
       soundVolume: { kind: 'num', lo: 0, hi: 1 },
       night: { kind: 'bool' },
@@ -825,6 +854,11 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
 .wisp-menu-glyph{display:inline-block;width:12px;margin-right:4px;text-align:center;font-size:10.5px;opacity:.72;font-weight:400}
 .wisp-menu-item[data-accent="true"] .wisp-menu-glyph{opacity:1}
 .wisp-menu-caret{opacity:.5;font-size:8px;flex:0 0 auto}
+/* 三选一的胶囊组：选中的那颗有强调色，其余是淡底 —— 一眼看出"只能选一个、现在选的是哪个" */
+.wisp-choice{display:flex;gap:2px;flex:0 0 auto;padding:1px;border-radius:999px;background:rgba(140,160,190,.18)}
+.wisp-choice-opt{padding:1px 6px;border:0;border-radius:999px;background:none;color:inherit;font:inherit;font-size:9.5px;line-height:13px;cursor:pointer;opacity:.7;transition:background .1s ease,opacity .1s ease}
+.wisp-choice-opt:hover{opacity:1}
+.wisp-choice-opt[data-on="true"]{background:var(--wisp-accent,#4a7cf7);color:#fff;opacity:1}
 .wisp-switch{flex:0 0 auto;width:22px;height:12px;border-radius:6px;background:rgba(140,160,190,.4);position:relative;transition:background .16s ease}
 .wisp-switch[data-on="true"]{background:var(--wisp-accent,#4a7cf7);box-shadow:0 0 0 2px rgba(74,124,247,.14)}
 .wisp-switch i{position:absolute;top:2px;left:2px;width:8px;height:8px;border-radius:50%;background:#fff;box-shadow:0 1px 2px rgba(0,0,0,.28);transition:transform .16s ease}
@@ -2259,6 +2293,45 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
 
       /* 开关行：真开关的样子 + role=menuitemcheckbox + aria-checked。
          点完**不关菜单** —— 拨开关时菜单消失是最烦人的交互之一。 */
+      /* 三选一（语言）。做成一行里的一排小胶囊：比三个开关清楚 ——
+         "同时只能选一个"这件事，胶囊组是自明的，开关组不是。 */
+      const choiceRow = (spec, into) => {
+        const row = document.createElement('div')
+        row.className = 'wisp-menu-item wisp-menu-row wisp-choice-row'
+        row.dataset.choice = spec.key
+        const label = document.createElement('span')
+        label.textContent = spec.label
+        row.appendChild(glyph(spec.glyph || ''))
+        row.appendChild(label)
+        const group = document.createElement('span')
+        group.className = 'wisp-choice'
+        group.setAttribute('role', 'radiogroup')
+        group.setAttribute('aria-label', spec.label)
+        const current = cfg[spec.key] === undefined ? 'auto' : String(cfg[spec.key])
+        for (const opt of spec.options) {
+          const btn = document.createElement('button')
+          btn.className = 'wisp-choice-opt'
+          btn.setAttribute('type', 'button')
+          btn.setAttribute('role', 'radio')
+          btn.setAttribute('tabindex', '-1')
+          btn.setAttribute('aria-checked', opt.value === current ? 'true' : 'false')
+          btn.dataset.value = opt.value
+          btn.dataset.on = opt.value === current ? 'true' : 'false'
+          btn.textContent = opt.label
+          btn.addEventListener('pointerdown', (ev) => ev.stopPropagation())
+          btn.addEventListener('click', (ev) => {
+            ev.preventDefault(); ev.stopPropagation()
+            try { applyConfig({ [spec.key]: opt.value }) } catch (err) { /* ignore */ }
+            refreshSurfaces()          // 立刻重画：语言切换要当场看得见
+          })
+          group.appendChild(btn)
+          menuButtons.push(btn)
+        }
+        row.appendChild(group)
+        into.appendChild(row)
+        return row
+      }
+
       const switchRow = (spec, into) => {
         const on = cfg[spec.key] === true
         const btn = document.createElement('button')
@@ -2400,6 +2473,7 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
       const renderChildren = (children, into) => {
         for (const child of children) {
           if (child.kind === 'switch') { switchRow(child, into); continue }
+        if (child.kind === 'choice') { choiceRow(child, into); continue }
           if (child.kind === 'corners') { cornerGrid(into); continue }
           actionRow(child, into)
         }
@@ -2827,6 +2901,15 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
             { label: '说句话', glyph: '✦', run: () => { wake(true); say(pick(LINES.click)) } },
             { label: '睡一会儿', glyph: '☾', run: () => setMood('sleep') },
             { label: '今天做了什么', glyph: '✎', run: () => saySummary() },
+            /* 语言：三选一。切换**立刻生效**（LINES 是视图，不是死值）。 */
+            {
+              kind: 'choice', key: 'lang', label: '台词语言', glyph: '文',
+              options: [
+                { value: 'auto', label: '跟随界面' },
+                { value: 'zh', label: '中文' },
+                { value: 'en', label: 'English' },
+              ],
+            },
             /* 没有音效文件就不摆这个开关 —— 点了没反应的开关比没有开关更糟 */
             ...(HAS_SOUNDS ? [{ kind: 'switch', key: 'sound', label: '音效', glyph: '♪' }] : []),
             /* 开关是**真正的开关行**：带 aria-checked，点完菜单不关（就在原地更新） */
@@ -3229,6 +3312,11 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
         if (cfg.persist && partial && typeof partial === 'object' && partial.size !== undefined) {
           writeStored(PREFS_KEY, { size: cfg.size })
         }
+        /* 语言选择存到**语言键**上（不是 PREFS_KEY）：它在**加载时**就会被读，
+           所以下次打开才生效。菜单里的胶囊切的是"以后说哪种话"。 */
+        if (partial && typeof partial === 'object' && typeof partial.lang === 'string') {
+          try { window.localStorage.setItem('dsh-wisp-lang', cfg.lang) } catch (e) { /* 存不了就算了 */ }
+        }
         // A bigger companion occupies a bigger box, so the stored position has
         // to be re-clamped or she would grow off the edge.
         root.style.width = Math.round(boxW()) + 'px'
@@ -3511,7 +3599,10 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
             },
             streak: streakOf(memory.days),
             /* 语言判定的输入与结果 —— 中英文走岔时能一眼看清是哪一层不对 */
-            lang: { tag: LANG_TAG, zh: IS_ZH, stored: langStored, html: langHtml, pools: Object.keys(LINES_EN).length },
+            lang: {
+              tag: LANG_TAG, zh: isZhNow(), choice: (cfg && typeof cfg.lang === 'string') ? cfg.lang : 'auto',
+              stored: langStored, html: langHtml, pools: Object.keys(LINES_EN).length,
+            },
             awaySince: Math.round(awayAt),
             /* 今天记了什么 —— 不用猜"她为什么说今天跑了 7 轮" */
             today: { ...watchToday() },

package/lib/client.template.js

@@ -51,7 +51,7 @@ window.__ModuleLoader__.load({
     var exports = module.exports
     Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
 
-    const VERSION = '1.36.0'
+    const VERSION = '1.37.0'
 
 /* 每一版一句话。**必须写当前版本** —— 预检里有一条断言盯着它，
    忘了更新就会红，不会静默过期。 */
@@ -80,6 +80,7 @@ const WHATS_NEW = {
   '1.34.1': '菜单改成紧凑刻度，占屏幕小了三成。',
   '1.35.0': '她开始替你值班：你走开时看着，回来报账；还能说今日小结。',
   '1.36.0': '她会说英文了（跟随界面语言/系统语言，也能强制）；音效与"汇报"姿势已就位。',
+  '1.37.0': '菜单里能直接选台词语言（跟随界面 / 中文 / English），选一次就记住。',
 }
 
 /* 更新这件事**这个插件自己做不到**，如实写在代码里，免得以后有人以为能：
@@ -406,8 +407,35 @@ const UPDATE_HINT = '在 DSH 的插件列表里按包名安装：dsh-wisp'
       if (langHtml !== '') return langHtml
       try { return String(navigator.language || navigator.userLanguage || 'zh') } catch (e) { return 'zh' }
     })()
-    const IS_ZH = LANG_TAG.toLowerCase().indexOf('zh') === 0
-    const LINES = IS_ZH ? LINES_ZH : Object.assign({}, LINES_ZH, LINES_EN)
+    /* 进页面时的默认判定（用户没显式选过就用它） */
+    const IS_ZH_DEFAULT = LANG_TAG.toLowerCase().indexOf('zh') === 0
+
+    /* 现在用哪种语言：① 设置里显式选过就听它 ② 否则用进页面时的判定。
+       —— 做成**函数**而不是常量，这样菜单里切换立刻生效，不用刷新。 */
+    const isZhNow = () => {
+      /* cfg 是后面才声明的 const：取词可能发生在它初始化之前，
+         而那时访问它会抛 TDZ 错误（不是 undefined）—— 所以这里必须兜住。 */
+      let forced = 'auto'
+      try { forced = (cfg && typeof cfg.lang === 'string') ? cfg.lang : 'auto' } catch (e) { forced = 'auto' }
+      if (forced === 'zh') return true
+      if (forced === 'en') return false
+      return IS_ZH_DEFAULT
+    }
+
+    /* LINES 是一个**视图**：取词的那一刻才决定用中文还是英文覆盖层。
+       用 Proxy 而不是"提前合并成一个对象" —— 后者在切换语言时是死值，必须刷新页面。
+       覆盖层缺哪条就退回中文，所以可以慢慢补齐，永远不会出现半句话。 */
+    const LINES = new Proxy({}, {
+      get(_target, key) {
+        const zh = LINES_ZH[key]
+        if (isZhNow()) return zh
+        const en = LINES_EN[key]
+        return en === undefined ? zh : en
+      },
+      has(_target, key) { return key in LINES_ZH },
+      ownKeys() { return Reflect.ownKeys(LINES_ZH) },
+      getOwnPropertyDescriptor() { return { enumerable: true, configurable: true } },
+    })
 
     /* 深夜窗口。bedtime > wake 时它跨零点（默认 23→5）；不跨也能用（比如 1→5）。 */
     const isNightHour = (hour, from, to) => {
@@ -518,6 +546,7 @@ const UPDATE_HINT = '在 DSH 的插件列表里按包名安装：dsh-wisp'
       hungry: { kind: 'bool' },
       hungerMs: { kind: 'num', lo: 0, hi: 86400000 },
       focusMinutes: { kind: 'num', lo: 1, hi: 600 },
+      lang: { kind: 'str' },
       sound: { kind: 'bool' },
       soundVolume: { kind: 'num', lo: 0, hi: 1 },
       night: { kind: 'bool' },
@@ -768,6 +797,11 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
 .wisp-menu-glyph{display:inline-block;width:12px;margin-right:4px;text-align:center;font-size:10.5px;opacity:.72;font-weight:400}
 .wisp-menu-item[data-accent="true"] .wisp-menu-glyph{opacity:1}
 .wisp-menu-caret{opacity:.5;font-size:8px;flex:0 0 auto}
+/* 三选一的胶囊组：选中的那颗有强调色，其余是淡底 —— 一眼看出"只能选一个、现在选的是哪个" */
+.wisp-choice{display:flex;gap:2px;flex:0 0 auto;padding:1px;border-radius:999px;background:rgba(140,160,190,.18)}
+.wisp-choice-opt{padding:1px 6px;border:0;border-radius:999px;background:none;color:inherit;font:inherit;font-size:9.5px;line-height:13px;cursor:pointer;opacity:.7;transition:background .1s ease,opacity .1s ease}
+.wisp-choice-opt:hover{opacity:1}
+.wisp-choice-opt[data-on="true"]{background:var(--wisp-accent,#4a7cf7);color:#fff;opacity:1}
 .wisp-switch{flex:0 0 auto;width:22px;height:12px;border-radius:6px;background:rgba(140,160,190,.4);position:relative;transition:background .16s ease}
 .wisp-switch[data-on="true"]{background:var(--wisp-accent,#4a7cf7);box-shadow:0 0 0 2px rgba(74,124,247,.14)}
 .wisp-switch i{position:absolute;top:2px;left:2px;width:8px;height:8px;border-radius:50%;background:#fff;box-shadow:0 1px 2px rgba(0,0,0,.28);transition:transform .16s ease}
@@ -2202,6 +2236,45 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
 
       /* 开关行：真开关的样子 + role=menuitemcheckbox + aria-checked。
          点完**不关菜单** —— 拨开关时菜单消失是最烦人的交互之一。 */
+      /* 三选一（语言）。做成一行里的一排小胶囊：比三个开关清楚 ——
+         "同时只能选一个"这件事，胶囊组是自明的，开关组不是。 */
+      const choiceRow = (spec, into) => {
+        const row = document.createElement('div')
+        row.className = 'wisp-menu-item wisp-menu-row wisp-choice-row'
+        row.dataset.choice = spec.key
+        const label = document.createElement('span')
+        label.textContent = spec.label
+        row.appendChild(glyph(spec.glyph || ''))
+        row.appendChild(label)
+        const group = document.createElement('span')
+        group.className = 'wisp-choice'
+        group.setAttribute('role', 'radiogroup')
+        group.setAttribute('aria-label', spec.label)
+        const current = cfg[spec.key] === undefined ? 'auto' : String(cfg[spec.key])
+        for (const opt of spec.options) {
+          const btn = document.createElement('button')
+          btn.className = 'wisp-choice-opt'
+          btn.setAttribute('type', 'button')
+          btn.setAttribute('role', 'radio')
+          btn.setAttribute('tabindex', '-1')
+          btn.setAttribute('aria-checked', opt.value === current ? 'true' : 'false')
+          btn.dataset.value = opt.value
+          btn.dataset.on = opt.value === current ? 'true' : 'false'
+          btn.textContent = opt.label
+          btn.addEventListener('pointerdown', (ev) => ev.stopPropagation())
+          btn.addEventListener('click', (ev) => {
+            ev.preventDefault(); ev.stopPropagation()
+            try { applyConfig({ [spec.key]: opt.value }) } catch (err) { /* ignore */ }
+            refreshSurfaces()          // 立刻重画：语言切换要当场看得见
+          })
+          group.appendChild(btn)
+          menuButtons.push(btn)
+        }
+        row.appendChild(group)
+        into.appendChild(row)
+        return row
+      }
+
       const switchRow = (spec, into) => {
         const on = cfg[spec.key] === true
         const btn = document.createElement('button')
@@ -2343,6 +2416,7 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
       const renderChildren = (children, into) => {
         for (const child of children) {
           if (child.kind === 'switch') { switchRow(child, into); continue }
+        if (child.kind === 'choice') { choiceRow(child, into); continue }
           if (child.kind === 'corners') { cornerGrid(into); continue }
           actionRow(child, into)
         }
@@ -2770,6 +2844,15 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
             { label: '说句话', glyph: '✦', run: () => { wake(true); say(pick(LINES.click)) } },
             { label: '睡一会儿', glyph: '☾', run: () => setMood('sleep') },
             { label: '今天做了什么', glyph: '✎', run: () => saySummary() },
+            /* 语言：三选一。切换**立刻生效**（LINES 是视图，不是死值）。 */
+            {
+              kind: 'choice', key: 'lang', label: '台词语言', glyph: '文',
+              options: [
+                { value: 'auto', label: '跟随界面' },
+                { value: 'zh', label: '中文' },
+                { value: 'en', label: 'English' },
+              ],
+            },
             /* 没有音效文件就不摆这个开关 —— 点了没反应的开关比没有开关更糟 */
             ...(HAS_SOUNDS ? [{ kind: 'switch', key: 'sound', label: '音效', glyph: '♪' }] : []),
             /* 开关是**真正的开关行**：带 aria-checked，点完菜单不关（就在原地更新） */
@@ -3172,6 +3255,11 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
         if (cfg.persist && partial && typeof partial === 'object' && partial.size !== undefined) {
           writeStored(PREFS_KEY, { size: cfg.size })
         }
+        /* 语言选择存到**语言键**上（不是 PREFS_KEY）：它在**加载时**就会被读，
+           所以下次打开才生效。菜单里的胶囊切的是"以后说哪种话"。 */
+        if (partial && typeof partial === 'object' && typeof partial.lang === 'string') {
+          try { window.localStorage.setItem('dsh-wisp-lang', cfg.lang) } catch (e) { /* 存不了就算了 */ }
+        }
         // A bigger companion occupies a bigger box, so the stored position has
         // to be re-clamped or she would grow off the edge.
         root.style.width = Math.round(boxW()) + 'px'
@@ -3454,7 +3542,10 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
             },
             streak: streakOf(memory.days),
             /* 语言判定的输入与结果 —— 中英文走岔时能一眼看清是哪一层不对 */
-            lang: { tag: LANG_TAG, zh: IS_ZH, stored: langStored, html: langHtml, pools: Object.keys(LINES_EN).length },
+            lang: {
+              tag: LANG_TAG, zh: isZhNow(), choice: (cfg && typeof cfg.lang === 'string') ? cfg.lang : 'auto',
+              stored: langStored, html: langHtml, pools: Object.keys(LINES_EN).length,
+            },
             awaySince: Math.round(awayAt),
             /* 今天记了什么 —— 不用猜"她为什么说今天跑了 7 轮" */
             today: { ...watchToday() },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-wisp",
-  "version": "1.36.0",
+  "version": "1.37.0",
   "description": "DeepSeek娘 — an unofficial floating desktop companion for the DeepSeek Harness UI. Zero dependencies; sprites inlined as data URIs; schedules on the Client timer service instead of the trapped browser timer globals.",
   "type": "module",
   "main": "lib/index.js",

package/verify-wisp.mjs

@@ -3542,6 +3542,42 @@ head('3y-3. the focus timer, and going quiet while the page is hidden')
   const zhLine = zh.all('wisp-say').filter((el) => el.removed !== true)
     .map((el) => el.textContent).join(' ')
   check(/[\u4e00-\u9fa5]/.test(zhLine), 'forcing chinese keeps her speaking chinese', zhLine)
+
+  /* 语言可以**随时**切换、不用刷新 —— 这正是把 LINES 做成视图（Proxy）而不是死值的意义。
+     以前是"加载时合并成一个对象"，换语言只能刷新页面。 */
+  const said = () => zh.all('wisp-say').filter((el) => el.removed !== true)
+    .map((el) => el.textContent).join(' ')
+  zh.state.busy = false
+  zh.advance(4000, 500)
+  zh.win.__wisp.configure({ lang: 'en' })
+  zh.win.__wisp.saySummary()
+  zh.advance(200, 50)
+  /* 菜单里选的语言是"下次打开生效"的那种设置（它在加载时就被读），
+     所以这里验的完整流程是：**选一次 -> 存下来 -> 再挂一次就说英文**。
+     不能只验"当场变英文"：那是我想做但没做成的（试过，没找到原因），
+     没验证过的行为不该写成承诺。 */
+  zh.win.__wisp.configure({ lang: 'en' })
+  const storedLang = zh.win.localStorage.getItem('dsh-wisp-lang')
+  check(storedLang === 'en', 'picking a language in the menu stores it for next time', String(storedLang))
+  const reload = createHarness({ timer: true, composerText: '', storageSeed: { 'dsh-wisp-lang': 'en' } })
+  const keepReload = active
+  active = reload
+  reload.evaluate(clientSrc)
+  reload.module().default.apply(reload.ctx, { reactions: false, wander: false, celebrate: false })
+  reload.advance(1000, 200)
+  reload.win.__wisp.saySummary()
+  reload.advance(200, 50)
+  const reloaded = reload.all('wisp-say').filter((el) => el.removed !== true)
+    .map((el) => el.textContent).join(' ')
+  check(/[A-Za-z]/.test(reloaded) && !/[\u4e00-\u9fa5]/.test(reloaded),
+    'and the next mount honours that choice', reloaded)
+  check(reloaded !== said(), 'the two languages really are different text',
+    reloaded + ' ｜ 中文那句：' + said())
+  reload.win.__wisp.destroy()
+  active = keepReload
+  check(zh.win.__wisp.doctor().lang.choice === 'en',
+    'and the choice is reported so the menu can show it', JSON.stringify(zh.win.__wisp.doctor().lang))
+
   zh.win.__wisp.destroy()
   active = keepZh