dsh-wisp 1.29.0 → 1.30.0

package/README.md

@@ -448,6 +448,37 @@ node tools/audit-log.mjs --confirm <manifest>     # 生成后：并入代理登
 
 ## 变更
 
+### 1.30.0
+
+这一版是**功能**，不是台词。
+
+- **专注计时器。** 桌面陪伴插件最该有的实用功能：替你画出一段时间的边界。
+
+  - 菜单「行为」组里「**专注 25 分钟**」/「**专注 45 分钟**」（默认时长 `focusMinutes`），
+    专注中多一条「**结束专注**」（平时不出现 —— 菜单里不该有按不动的条目）；
+  - 专注期间**她保持"干活中"的姿势**：稳态轮询不许把她挪走 ✓。这条 hold 放在久坐 / 干饭 /
+    劝睡**之后** —— 那三件事该响还得响，只是姿势归专注管；
+  - **戳她一下 = 问还剩多久**（*"还有 23 分钟呢，盯着屏幕。"*），而且不计入"连戳"，
+    不会升级成抗议；
+  - 到点她换 `proud` 说收工（*"这一轮 25 分钟，结束了。"*），`doctor().focus.done` 累计完成次数；
+  - 她**不碰应用**：不改输入框、不发消息、不点任何按钮 —— 只陪着 + 计时。
+
+- **页面藏起来就安静。** 挂 `visibilitychange`：藏起来时停掉**轮询 / 絮叨 / 踱步**三个定时器，
+  回来再按配置重新挂上。没人在看的时候不该空转 CPU（顺带省电）。
+
+  - 这不是"少做点事"而是"诚实"：藏起来期间 DOM 再吵她也不该有反应 —— 测试就是这么断言的
+    （藏起来时来三个报错她一声不吭；回来之后同一批报错立刻被看见）；
+  - 恢复**先于**问候：先保证活着，再谈礼貌；
+  - `doctor().timers` 报告 `{ poll, chatter, wander, paused }`。
+
+- 预检 451 → **473 项**。
+
+- 记一个测试教训：戳她要用**既有的那套姿势**（`pointerdown` 落在 `.wisp-body`、
+  `pointerup` 落在 `window`、坐标要在她身上）—— 我第一版两个事件都发到 `root` 上，
+  她当然没反应，白查了一轮。
+
+### 1.29.0
+
 ### 1.29.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.29.0'
+    const VERSION = '1.30.0'
 
 /* 每一版一句话。**必须写当前版本** —— 预检里有一条断言盯着它，
    忘了更新就会红，不会静默过期。 */
@@ -70,6 +70,7 @@ const WHATS_NEW = {
   '1.27.0': '她饿了会捧出一碗白米饭，还有第八个表情。',
   '1.28.0': '菜单分成折叠分组，另外多了「关于她」和「动作一览」两个弹窗。',
   '1.29.0': '夜深了她会劝你去睡；你走开再回来她记得；连续来了几天她也记着。',
+  '1.30.0': '会陪你专注计时了；页面藏起来时她会安静下来，不再空转。',
 }
 
 /* 更新这件事**这个插件自己做不到**，如实写在代码里，免得以后有人以为能：
@@ -216,6 +217,7 @@ const UPDATE_HINT = '在 DSH 的插件列表里按包名安装：dsh-wisp'
       careAfterMs: 5400000,     // 连续活动这么久之后提醒你起来动动（90 分钟；0 = 关）
       hungry: true,             // 干饭：她饿了会说
       hungerMs: 2700000,        // 连续活动这么久就该吃一碗了（45 分钟；0 = 关）
+      focusMinutes: 25,         // 菜单里「专注 N 分钟」用的默认时长
       night: true,              // 深夜劝睡
       bedtimeHour: 23,          // 几点算深夜（0-23）
       wakeHour: 5,              // 几点算天亮（0-23）；bedtime > wake 时窗口跨零点
@@ -324,6 +326,19 @@ const UPDATE_HINT = '在 DSH 的插件列表里按包名安装：dsh-wisp'
         '算力不够了，得补点碳水。', '电量告急，切待机。', '你要不要也来一口？',
         '这碗不算加餐，算基础设施。', '吃饱了才有力气摸鱼。', '饭碗见底了，该续命了。', '我数着米粒呢。',
       ],
+      /* 专注计时器。她是陪着你干活的，所以"替你画出一段时间的边界"比再多说几句更实在。 */
+      focusStart: [
+        '{n} 分钟。开始吧。', '好，{n} 分钟，我盯着你。', '计时开始，{n} 分钟。', '{n} 分钟不看别的。',
+        '这段时间归你了。{n} 分钟。',
+      ],
+      focusDone: [
+        '{n} 分钟到了。收工。', '{n} 分钟，干完了？', '时间到。{n} 分钟，去喝口水。', '{n} 分钟到了 —— 站起来伸个懒腰。',
+        '这一轮 {n} 分钟，结束了。',
+      ],
+      focusStop: ['行，那就先到这儿。', '不专注了？那我歇着。', '计时取消了。', '好吧，下次再说。'],
+      focusLeft: [
+        '还有 {n} 分钟。', '{n} 分钟，快了。', '还剩 {n} 分钟，别分心。', '还有 {n} 分钟呢，盯着屏幕。',
+      ],
       /* 深夜劝睡：23 点后一种语气，凌晨 1 点后另一种 —— 后者是社区设定里"嘴硬心软"那一档。
          分档按 bedtimeHour + 2 推导，所以改了作息这套分档也跟着走。 */
       nightLate: [
@@ -450,6 +465,7 @@ const UPDATE_HINT = '在 DSH 的插件列表里按包名安装：dsh-wisp'
       careAfterMs: { kind: 'num', lo: 0, hi: 86400000 },
       hungry: { kind: 'bool' },
       hungerMs: { kind: 'num', lo: 0, hi: 86400000 },
+      focusMinutes: { kind: 'num', lo: 1, hi: 600 },
       night: { kind: 'bool' },
       bedtimeHour: { kind: 'num', lo: 0, hi: 23 },
       wakeHour: { kind: 'num', lo: 0, hi: 23 },
@@ -1642,6 +1658,13 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
           return
         }
 
+        /* 专注期间不让稳态把她从"干活中"挪走 —— 她在盯着你，这是这个功能的全部意义。
+           位置在这里而不是函数开头：久坐、干饭、劝睡该响还得响。 */
+        if (focusUntil > 0) {
+          if (mood !== 'alert') setMood('alert')
+          return
+        }
+
         // 临时状态（happy / worried）在自己的计时器到期前不能被稳态赋值覆盖 ——
         // 否则刚摆出的表情在同一个 poll 周期里就被 setMood('idle') 抹掉了。
         if (mood === 'sleep' || mood === 'happy' || mood === 'poked' || mood === 'proud' || mood === 'care'
@@ -1651,10 +1674,62 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
         setMood((busy || typing) ? 'alert' : 'idle')
       }
 
+      /* ---- 专注计时器 ---------------------------------------------------------
+         桌面陪伴插件最该有的实用功能：替你画出一段时间的边界。
+         专注期间她保持"干活中"的姿势（poll 里给她一个 hold —— 否则稳态会把她挪走），
+         到点收工庆祝；戳她一下就是问"还剩多久"。
+         她**不碰应用**：不改输入框、不发消息，只是陪着 + 计时。 */
+      let focusUntil = 0
+      let focusHandle = null
+      let focusMinutes = 0
+      let focusDone = 0
+
+      const focusLeftMs = () => Math.max(0, focusUntil - nowMs())
+      const focusState = () => (focusUntil > 0
+        ? { active: true, minutes: focusMinutes, leftMs: Math.round(focusLeftMs()), leftMin: Math.max(1, Math.ceil(focusLeftMs() / 60000)), done: focusDone }
+        : { active: false, minutes: 0, leftMs: 0, leftMin: 0, done: focusDone })
+
+      const stopFocus = (silent) => {
+        if (focusUntil === 0 && focusHandle === null) return false
+        focusUntil = 0
+        focusMinutes = 0
+        if (focusHandle) { clock.cancel(focusHandle); focusHandle = null }
+        if (silent !== true) {
+          wake(true)
+          flashHappy(pick(LINES.focusStop))
+        }
+        return true
+      }
+
+      const finishFocus = () => {
+        const minutes = focusMinutes
+        focusUntil = 0
+        focusHandle = null
+        focusMinutes = 0
+        focusDone++
+        wake(true)
+        flashProud(pick(LINES.focusDone).split('{n}').join(String(minutes)))
+      }
+
+      const startFocus = (minutes) => {
+        const mins = clamp(Math.round(Number(minutes) || cfg.focusMinutes), 1, 600)
+        stopFocus(true)
+        focusMinutes = mins
+        focusUntil = nowMs() + mins * 60000
+        wake(true)
+        say(pick(LINES.focusStart).split('{n}').join(String(mins)))
+        focusHandle = clock.after(mins * 60000, () => { if (focusUntil > 0) finishFocus() })
+        return focusState()
+      }
+
+      /* 没人在看的时候别空转：页面藏起来就停掉轮询、絮叨、踱步三个定时器。
+         它们本来就是"给看得见的人看的"，停下来是纯赚（CPU 与电量）。 */
+      let paused = false
+
       let chatterHandle = null
       const syncChatter = () => {
         if (chatterHandle) { clock.cancel(chatterHandle); chatterHandle = null }
-        if (cfg.chatterMs <= 0) return
+        if (cfg.chatterMs <= 0 || paused) return
         chatterHandle = clock.every(cfg.chatterMs, () => {
           if (destroyed || mood !== 'idle') return
           if (agentIsBusy()) return
@@ -1665,7 +1740,7 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
       let pollHandle = null
       const syncPoll = () => {
         if (pollHandle) { clock.cancel(pollHandle); pollHandle = null }
-        if (cfg.reactions) pollHandle = clock.every(POLL_MS, poll)
+        if (cfg.reactions && !paused) pollHandle = clock.every(POLL_MS, poll)
       }
       syncPoll()
       syncChatter()
@@ -1692,7 +1767,7 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
       let wanderHandle = null
       const syncWander = () => {
         if (wanderHandle) { clock.cancel(wanderHandle); wanderHandle = null }
-        if (!cfg.wander || cfg.wanderRange <= 0) return
+        if (!cfg.wander || cfg.wanderRange <= 0 || paused) return
         wanderHandle = clock.every(cfg.wanderMs, () => {
           if (destroyed || hidden || mood !== 'idle' || start !== null) return
           if (agentIsBusy()) return
@@ -1822,6 +1897,12 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
         if (now - pokeWindowStart > POKE_WINDOW_MS) { pokeWindowStart = now; pokeStreak = 0 }
         pokeStreak++
         wake(true)
+        /* 专注中戳她是在问进度，不算戳着玩（也就不会升级成"抗议"）。 */
+        if (focusUntil > 0) {
+          const left = Math.max(1, Math.ceil(focusLeftMs() / 60000))
+          say(pick(LINES.focusLeft).split('{n}').join(String(left)))
+          return
+        }
         if (pokeStreak >= POKE_ANNOYED_AT) {
           pokeStreak = 0
           flashPoked(pick(LINES.poked))
@@ -2098,6 +2179,7 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
           para('DeepSeek娘 —— DSH 界面上的浮动桌宠。她会跟着你的状态换表情：你打字她在忙，你闲着她在晃，你跑完一轮她替你高兴。'),
           para('她的样子照社区规范来：深蓝色渐变长直发、头顶一个大圆环呆毛、两片鲸鳍耳、女仆装。'),
           para('白米饭是算力的硬通货 —— 所以她每隔一阵会捧碗出来补点碳水。'),
+          para('她还能陪你专注计时：菜单里开一段 25 或 45 分钟，期间她保持"干活中"，戳她一下是问还剩多久，到点她替你收工。'),
           para('这一版：' + (note || VERSION)),
           para('形象与设定参考社区项目 Neko3000/deepseek-whalechan（设定文档 CC BY-NC-SA 4.0，原作者 B站 ZipZipPipe、上善无形）。'),
           dialogFoot('非官方同人作品，与 DeepSeek 官方无关', 'v' + VERSION),
@@ -2129,6 +2211,10 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
           children: [
             { label: '说句话', run: () => { wake(true); say(pick(LINES.click)) } },
             { label: '睡一会儿', run: () => setMood('sleep') },
+            { label: '专注 ' + cfg.focusMinutes + ' 分钟', run: () => startFocus(cfg.focusMinutes) },
+            { label: '专注 45 分钟', run: () => startFocus(45) },
+            /* 只有专注中才出现"结束专注" —— 平时的菜单不该多一个按不动的条目 */
+            ...(focusUntil > 0 ? [{ label: '结束专注', run: () => stopFocus(false) }] : []),
             ...TOGGLES.map((t) => ({
               label: (cfg[t.key] === true ? '✓ ' : '　') + t.label,
               run: () => applyConfig({ [t.key]: cfg[t.key] !== true }),
@@ -2329,7 +2415,22 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
       const onVisibility = () => {
         let state = 'visible'
         try { state = document.visibilityState === 'hidden' ? 'hidden' : 'visible' } catch (e) { state = 'visible' }
-        if (state === 'hidden') { awayAt = nowMs(); return }
+        if (state === 'hidden') {
+          awayAt = nowMs()
+          /* 没人在看，停掉三个"给看得见的人看"的定时器 */
+          paused = true
+          syncPoll()
+          syncChatter()
+          syncWander()
+          return
+        }
+        /* 回来了：先恢复再算问候 —— 恢复是必须的，问候才是锦上添花 */
+        if (paused) {
+          paused = false
+          syncPoll()
+          syncChatter()
+          syncWander()
+        }
         if (awayAt === 0) return
         const away = nowMs() - awayAt
         awayAt = 0
@@ -2563,6 +2664,10 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
         showUpdate,
         checkForUpdate,
         /* 弹窗与折叠分组：菜单结构变了之后，测试要能问"现在开着哪个弹窗 / 哪个分组"。 */
+        /* 专注计时器：脚本与测试都能驱动 */
+        startFocus,
+        stopFocus,
+        get focus() { return focusState() },
         openAbout: () => aboutDialog(),
         openActions: () => actionsDialog(),
         closeDialog,
@@ -2691,6 +2796,13 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
             },
             streak: streakOf(memory.days),
             awaySince: Math.round(awayAt),
+            /* 专注：不用猜"她为什么一直站在干活中" */
+            focus: focusState(),
+            /* 定时器是否挂着；页面藏起来时三个都该是 false */
+            timers: {
+              poll: pollHandle !== null, chatter: chatterHandle !== null,
+              wander: wanderHandle !== null, paused,
+            },
             /* 今日轮次：不用猜"她为什么突然得意"，数字就在这里 */
             runsToday: { day: runsToday.day, count: runsToday.count, said: runsToday.said.slice() },
             /* 她记着你：一起多少天、习惯放在哪、常穿哪套、已经说过哪些 */

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.29.0'
+    const VERSION = '1.30.0'
 
 /* 每一版一句话。**必须写当前版本** —— 预检里有一条断言盯着它，
    忘了更新就会红，不会静默过期。 */
@@ -70,6 +70,7 @@ const WHATS_NEW = {
   '1.27.0': '她饿了会捧出一碗白米饭，还有第八个表情。',
   '1.28.0': '菜单分成折叠分组，另外多了「关于她」和「动作一览」两个弹窗。',
   '1.29.0': '夜深了她会劝你去睡；你走开再回来她记得；连续来了几天她也记着。',
+  '1.30.0': '会陪你专注计时了；页面藏起来时她会安静下来，不再空转。',
 }
 
 /* 更新这件事**这个插件自己做不到**，如实写在代码里，免得以后有人以为能：
@@ -165,6 +166,7 @@ const UPDATE_HINT = '在 DSH 的插件列表里按包名安装：dsh-wisp'
       careAfterMs: 5400000,     // 连续活动这么久之后提醒你起来动动（90 分钟；0 = 关）
       hungry: true,             // 干饭：她饿了会说
       hungerMs: 2700000,        // 连续活动这么久就该吃一碗了（45 分钟；0 = 关）
+      focusMinutes: 25,         // 菜单里「专注 N 分钟」用的默认时长
       night: true,              // 深夜劝睡
       bedtimeHour: 23,          // 几点算深夜（0-23）
       wakeHour: 5,              // 几点算天亮（0-23）；bedtime > wake 时窗口跨零点
@@ -273,6 +275,19 @@ const UPDATE_HINT = '在 DSH 的插件列表里按包名安装：dsh-wisp'
         '算力不够了，得补点碳水。', '电量告急，切待机。', '你要不要也来一口？',
         '这碗不算加餐，算基础设施。', '吃饱了才有力气摸鱼。', '饭碗见底了，该续命了。', '我数着米粒呢。',
       ],
+      /* 专注计时器。她是陪着你干活的，所以"替你画出一段时间的边界"比再多说几句更实在。 */
+      focusStart: [
+        '{n} 分钟。开始吧。', '好，{n} 分钟，我盯着你。', '计时开始，{n} 分钟。', '{n} 分钟不看别的。',
+        '这段时间归你了。{n} 分钟。',
+      ],
+      focusDone: [
+        '{n} 分钟到了。收工。', '{n} 分钟，干完了？', '时间到。{n} 分钟，去喝口水。', '{n} 分钟到了 —— 站起来伸个懒腰。',
+        '这一轮 {n} 分钟，结束了。',
+      ],
+      focusStop: ['行，那就先到这儿。', '不专注了？那我歇着。', '计时取消了。', '好吧，下次再说。'],
+      focusLeft: [
+        '还有 {n} 分钟。', '{n} 分钟，快了。', '还剩 {n} 分钟，别分心。', '还有 {n} 分钟呢，盯着屏幕。',
+      ],
       /* 深夜劝睡：23 点后一种语气，凌晨 1 点后另一种 —— 后者是社区设定里"嘴硬心软"那一档。
          分档按 bedtimeHour + 2 推导，所以改了作息这套分档也跟着走。 */
       nightLate: [
@@ -399,6 +414,7 @@ const UPDATE_HINT = '在 DSH 的插件列表里按包名安装：dsh-wisp'
       careAfterMs: { kind: 'num', lo: 0, hi: 86400000 },
       hungry: { kind: 'bool' },
       hungerMs: { kind: 'num', lo: 0, hi: 86400000 },
+      focusMinutes: { kind: 'num', lo: 1, hi: 600 },
       night: { kind: 'bool' },
       bedtimeHour: { kind: 'num', lo: 0, hi: 23 },
       wakeHour: { kind: 'num', lo: 0, hi: 23 },
@@ -1591,6 +1607,13 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
           return
         }
 
+        /* 专注期间不让稳态把她从"干活中"挪走 —— 她在盯着你，这是这个功能的全部意义。
+           位置在这里而不是函数开头：久坐、干饭、劝睡该响还得响。 */
+        if (focusUntil > 0) {
+          if (mood !== 'alert') setMood('alert')
+          return
+        }
+
         // 临时状态（happy / worried）在自己的计时器到期前不能被稳态赋值覆盖 ——
         // 否则刚摆出的表情在同一个 poll 周期里就被 setMood('idle') 抹掉了。
         if (mood === 'sleep' || mood === 'happy' || mood === 'poked' || mood === 'proud' || mood === 'care'
@@ -1600,10 +1623,62 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
         setMood((busy || typing) ? 'alert' : 'idle')
       }
 
+      /* ---- 专注计时器 ---------------------------------------------------------
+         桌面陪伴插件最该有的实用功能：替你画出一段时间的边界。
+         专注期间她保持"干活中"的姿势（poll 里给她一个 hold —— 否则稳态会把她挪走），
+         到点收工庆祝；戳她一下就是问"还剩多久"。
+         她**不碰应用**：不改输入框、不发消息，只是陪着 + 计时。 */
+      let focusUntil = 0
+      let focusHandle = null
+      let focusMinutes = 0
+      let focusDone = 0
+
+      const focusLeftMs = () => Math.max(0, focusUntil - nowMs())
+      const focusState = () => (focusUntil > 0
+        ? { active: true, minutes: focusMinutes, leftMs: Math.round(focusLeftMs()), leftMin: Math.max(1, Math.ceil(focusLeftMs() / 60000)), done: focusDone }
+        : { active: false, minutes: 0, leftMs: 0, leftMin: 0, done: focusDone })
+
+      const stopFocus = (silent) => {
+        if (focusUntil === 0 && focusHandle === null) return false
+        focusUntil = 0
+        focusMinutes = 0
+        if (focusHandle) { clock.cancel(focusHandle); focusHandle = null }
+        if (silent !== true) {
+          wake(true)
+          flashHappy(pick(LINES.focusStop))
+        }
+        return true
+      }
+
+      const finishFocus = () => {
+        const minutes = focusMinutes
+        focusUntil = 0
+        focusHandle = null
+        focusMinutes = 0
+        focusDone++
+        wake(true)
+        flashProud(pick(LINES.focusDone).split('{n}').join(String(minutes)))
+      }
+
+      const startFocus = (minutes) => {
+        const mins = clamp(Math.round(Number(minutes) || cfg.focusMinutes), 1, 600)
+        stopFocus(true)
+        focusMinutes = mins
+        focusUntil = nowMs() + mins * 60000
+        wake(true)
+        say(pick(LINES.focusStart).split('{n}').join(String(mins)))
+        focusHandle = clock.after(mins * 60000, () => { if (focusUntil > 0) finishFocus() })
+        return focusState()
+      }
+
+      /* 没人在看的时候别空转：页面藏起来就停掉轮询、絮叨、踱步三个定时器。
+         它们本来就是"给看得见的人看的"，停下来是纯赚（CPU 与电量）。 */
+      let paused = false
+
       let chatterHandle = null
       const syncChatter = () => {
         if (chatterHandle) { clock.cancel(chatterHandle); chatterHandle = null }
-        if (cfg.chatterMs <= 0) return
+        if (cfg.chatterMs <= 0 || paused) return
         chatterHandle = clock.every(cfg.chatterMs, () => {
           if (destroyed || mood !== 'idle') return
           if (agentIsBusy()) return
@@ -1614,7 +1689,7 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
       let pollHandle = null
       const syncPoll = () => {
         if (pollHandle) { clock.cancel(pollHandle); pollHandle = null }
-        if (cfg.reactions) pollHandle = clock.every(POLL_MS, poll)
+        if (cfg.reactions && !paused) pollHandle = clock.every(POLL_MS, poll)
       }
       syncPoll()
       syncChatter()
@@ -1641,7 +1716,7 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
       let wanderHandle = null
       const syncWander = () => {
         if (wanderHandle) { clock.cancel(wanderHandle); wanderHandle = null }
-        if (!cfg.wander || cfg.wanderRange <= 0) return
+        if (!cfg.wander || cfg.wanderRange <= 0 || paused) return
         wanderHandle = clock.every(cfg.wanderMs, () => {
           if (destroyed || hidden || mood !== 'idle' || start !== null) return
           if (agentIsBusy()) return
@@ -1771,6 +1846,12 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
         if (now - pokeWindowStart > POKE_WINDOW_MS) { pokeWindowStart = now; pokeStreak = 0 }
         pokeStreak++
         wake(true)
+        /* 专注中戳她是在问进度，不算戳着玩（也就不会升级成"抗议"）。 */
+        if (focusUntil > 0) {
+          const left = Math.max(1, Math.ceil(focusLeftMs() / 60000))
+          say(pick(LINES.focusLeft).split('{n}').join(String(left)))
+          return
+        }
         if (pokeStreak >= POKE_ANNOYED_AT) {
           pokeStreak = 0
           flashPoked(pick(LINES.poked))
@@ -2047,6 +2128,7 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
           para('DeepSeek娘 —— DSH 界面上的浮动桌宠。她会跟着你的状态换表情：你打字她在忙，你闲着她在晃，你跑完一轮她替你高兴。'),
           para('她的样子照社区规范来：深蓝色渐变长直发、头顶一个大圆环呆毛、两片鲸鳍耳、女仆装。'),
           para('白米饭是算力的硬通货 —— 所以她每隔一阵会捧碗出来补点碳水。'),
+          para('她还能陪你专注计时：菜单里开一段 25 或 45 分钟，期间她保持"干活中"，戳她一下是问还剩多久，到点她替你收工。'),
           para('这一版：' + (note || VERSION)),
           para('形象与设定参考社区项目 Neko3000/deepseek-whalechan（设定文档 CC BY-NC-SA 4.0，原作者 B站 ZipZipPipe、上善无形）。'),
           dialogFoot('非官方同人作品，与 DeepSeek 官方无关', 'v' + VERSION),
@@ -2078,6 +2160,10 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
           children: [
             { label: '说句话', run: () => { wake(true); say(pick(LINES.click)) } },
             { label: '睡一会儿', run: () => setMood('sleep') },
+            { label: '专注 ' + cfg.focusMinutes + ' 分钟', run: () => startFocus(cfg.focusMinutes) },
+            { label: '专注 45 分钟', run: () => startFocus(45) },
+            /* 只有专注中才出现"结束专注" —— 平时的菜单不该多一个按不动的条目 */
+            ...(focusUntil > 0 ? [{ label: '结束专注', run: () => stopFocus(false) }] : []),
             ...TOGGLES.map((t) => ({
               label: (cfg[t.key] === true ? '✓ ' : '　') + t.label,
               run: () => applyConfig({ [t.key]: cfg[t.key] !== true }),
@@ -2278,7 +2364,22 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
       const onVisibility = () => {
         let state = 'visible'
         try { state = document.visibilityState === 'hidden' ? 'hidden' : 'visible' } catch (e) { state = 'visible' }
-        if (state === 'hidden') { awayAt = nowMs(); return }
+        if (state === 'hidden') {
+          awayAt = nowMs()
+          /* 没人在看，停掉三个"给看得见的人看"的定时器 */
+          paused = true
+          syncPoll()
+          syncChatter()
+          syncWander()
+          return
+        }
+        /* 回来了：先恢复再算问候 —— 恢复是必须的，问候才是锦上添花 */
+        if (paused) {
+          paused = false
+          syncPoll()
+          syncChatter()
+          syncWander()
+        }
         if (awayAt === 0) return
         const away = nowMs() - awayAt
         awayAt = 0
@@ -2512,6 +2613,10 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
         showUpdate,
         checkForUpdate,
         /* 弹窗与折叠分组：菜单结构变了之后，测试要能问"现在开着哪个弹窗 / 哪个分组"。 */
+        /* 专注计时器：脚本与测试都能驱动 */
+        startFocus,
+        stopFocus,
+        get focus() { return focusState() },
         openAbout: () => aboutDialog(),
         openActions: () => actionsDialog(),
         closeDialog,
@@ -2640,6 +2745,13 @@ body[data-ds-dark-theme] .wisp-layer{--wisp-say-fg:#eaf2f8;--wisp-say-bg:rgba(20
             },
             streak: streakOf(memory.days),
             awaySince: Math.round(awayAt),
+            /* 专注：不用猜"她为什么一直站在干活中" */
+            focus: focusState(),
+            /* 定时器是否挂着；页面藏起来时三个都该是 false */
+            timers: {
+              poll: pollHandle !== null, chatter: chatterHandle !== null,
+              wander: wanderHandle !== null, paused,
+            },
             /* 今日轮次：不用猜"她为什么突然得意"，数字就在这里 */
             runsToday: { day: runsToday.day, count: runsToday.count, said: runsToday.said.slice() },
             /* 她记着你：一起多少天、习惯放在哪、常穿哪套、已经说过哪些 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-wisp",
-  "version": "1.29.0",
+  "version": "1.30.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

@@ -3064,6 +3064,135 @@ head('3y-2. night nagging, coming back, and the streak')
   active = keepBroken
 }
 
+/* ============================== 3y-3. focus timer & hidden pause ========== */
+head('3y-3. the focus timer, and going quiet while the page is hidden')
+
+{
+  const watch = (h, ms, step = 250) => {
+    const live = () => h.all('wisp-say').filter((el) => el.removed !== true).map((el) => el.textContent)
+    const seen = new Set(live())
+    for (let left = ms; left > 0; left -= step) {
+      h.advance(Math.min(step, left), Math.min(step, 200))
+      for (const t of live()) seen.add(t)
+    }
+    return [...seen]
+  }
+  const strip = (pool, n) => (pool ?? []).map((t) => t.split('{n}').join(String(n)))
+  const moodOf = (h) => h.find('wisp-root').dataset.mood
+
+  /* ---- 专注计时器 -------------------------------------------------------- */
+  const focus = createHarness({ timer: true, composerText: '' })
+  const keepFocus = active
+  active = focus
+  focus.evaluate(clientSrc)
+  focus.module().default.apply(focus.ctx, {
+    reactions: true, wander: false, celebrate: false,
+    careAfterMs: 0, hungerMs: 0, night: false, sleepAfterMs: 3600000,
+  })
+  focus.advance(1300, 100)
+  const focusApi = focus.win.__wisp
+
+  check(focusApi.focus.active === false, 'no focus session at the start')
+  check(focusApi.doctor().focus.active === false && focusApi.doctor().focus.done === 0,
+    'and doctor says so', JSON.stringify(focusApi.doctor().focus))
+
+  const started = focusApi.startFocus(25)
+  check(started.active === true && started.minutes === 25 && started.leftMin === 25,
+    'starting a session reports it back', JSON.stringify(started))
+  check(focusApi.doctor().focus.active === true, 'doctor sees the session too')
+  const startSaid = watch(focus, 1200)
+  check(startSaid.some((t) => strip(linesInBundle()?.focusStart, 25).includes(t)),
+    'and she says the session started', startSaid.slice(-1).join('') || '(没说)')
+
+  /* 专注期间即使她没在忙，姿势也该是"干活中" —— 稳态不许把她挪走 */
+  focus.advance(120000, 5000)
+  check(moodOf(focus) === 'alert', 'she holds the working pose for the whole session', moodOf(focus))
+
+  /* 戳她 = 问还剩多久，而且不算戳着玩 */
+  const pokeOnce = () => {
+    const b = focus.find('wisp-body')
+    b.dispatch('pointerdown', {
+      button: 0, clientX: focusApi.position.x + 260, clientY: focusApi.position.y + 400,
+      preventDefault() {}, stopPropagation() {},
+    })
+    focus.win.dispatch('pointerup', {})
+    focus.advance(200, 50)
+  }
+  /* 24 分钟时戳她 —— 报的应该是"还剩 24 分钟"这类的话 */
+  pokeOnce()
+  const pokeSaid = watch(focus, 800)
+  const leftPool = [].concat(strip(linesInBundle()?.focusLeft, 24), strip(linesInBundle()?.focusLeft, 23))
+  check(pokeSaid.some((t) => leftPool.includes(t)),
+    'poking her during a session asks how long is left', pokeSaid.slice(-2).join(' / ') || '(没说)')
+  check(moodOf(focus) !== 'poked', 'and it does not count as poking for fun', moodOf(focus))
+
+  /* 到点：她说收工，状态回到非激活，计数 +1 */
+  const doneSaid = watch(focus, 26 * 60000, 30000)
+  check(focusApi.focus.active === false, 'the session ends on its own', JSON.stringify(focusApi.focus))
+  check(focusApi.focus.done === 1, 'and the finished count goes up', String(focusApi.focus.done))
+  check(doneSaid.some((t) => strip(linesInBundle()?.focusDone, 25).includes(t)),
+    'and she tells you it is over', doneSaid.slice(-1).join('') || '(没说)')
+
+  /* 参数夹取：0 用默认时长，过大的被夹到 600 */
+  check(focusApi.startFocus(0).minutes === focusApi.config.focusMinutes,
+    'zero falls back to the configured default', String(focusApi.startFocus(0).minutes))
+  check(focusApi.startFocus(9999).minutes === 600, 'an absurd duration is clamped', String(focusApi.focus.minutes))
+  const stopSaid = watch(focus, 400)
+  focusApi.stopFocus()
+  const stopSaid2 = watch(focus, 600)
+  void stopSaid
+  check(focusApi.focus.active === false, 'stopFocus ends it', JSON.stringify(focusApi.focus))
+  check([].concat(stopSaid, stopSaid2).some((t) => (linesInBundle()?.focusStop ?? []).includes(t)),
+    'and she acknowledges the stop', [].concat(stopSaid, stopSaid2).slice(-1).join('') || '(没说)')
+  check(focusApi.stopFocus() === false, 'stopping when nothing is running is a no-op')
+  focus.win.__wisp.destroy()
+  active = keepFocus
+
+  /* ---- 页面藏起来就暂停 -------------------------------------------------- */
+  const quiet = createHarness({ timer: true, composerText: '' })
+  const keepQuiet = active
+  active = quiet
+  quiet.evaluate(clientSrc)
+  quiet.module().default.apply(quiet.ctx, {
+    reactions: true, wander: true, celebrate: false,
+    careAfterMs: 0, hungerMs: 0, night: false, sleepAfterMs: 3600000, backAfterMs: 60000,
+  })
+  quiet.advance(1300, 100)
+  const quietApi = quiet.win.__wisp
+  check(quietApi.doctor().timers.poll === true && quietApi.doctor().timers.paused === false,
+    'while visible the poll is armed', JSON.stringify(quietApi.doctor().timers))
+
+  quiet.document.visibilityState = 'hidden'
+  quiet.document.dispatch('visibilitychange', {})
+  const timers = quietApi.doctor().timers
+  check(timers.paused === true && timers.poll === false && timers.chatter === false && timers.wander === false,
+    'hiding the page stops all three timers', JSON.stringify(timers))
+
+  /* 藏起来期间：来了一堆报错，她也不该有任何反应（轮询停了） */
+  quiet.state.errors = 3
+  quiet.state.busy = true
+  quiet.advance(2000, 500)
+  quiet.state.busy = false
+  quiet.advance(20000, 2000)
+  check(moodOf(quiet) !== 'worried', 'a hidden page gets no reaction at all', moodOf(quiet))
+  check(quiet.all('wisp-say').filter((el) => el.removed !== true).length === 0,
+    'and she stays completely quiet', String(quiet.all('wisp-say').length))
+
+  quiet.document.visibilityState = 'visible'
+  quiet.document.dispatch('visibilitychange', {})
+  const after = quietApi.doctor().timers
+  check(after.paused === false && after.poll === true && after.wander === true,
+    'coming back re-arms them', JSON.stringify(after))
+  /* 回来之后同一批报错就该被看见了 */
+  quiet.state.busy = true
+  quiet.advance(1300, 100)
+  quiet.state.busy = false
+  quiet.advance(3000, 200)
+  check(moodOf(quiet) === 'worried', 'and now the same errors do get a reaction', moodOf(quiet))
+  quiet.win.__wisp.destroy()
+  active = keepQuiet
+}
+
 /* ================================================== 3z. generation audit ==== */
 head('3z. every shipped sprite traces back to a text-only call')