dsh-wisp 1.29.0 → 1.31.0

package/README.md

@@ -448,6 +448,97 @@ node tools/audit-log.mjs --confirm <manifest>     # 生成后：并入代理登
 
 ## 变更
 
+### 1.31.0
+
+**菜单重做。** 上一版只是"把 19 个条目收进三个分组" —— 那是分类，不是交互设计。
+这一版按交互本身重做。
+
+**问题（先认下来）**：
+
+- 信息和动作混在一起：「关于她…」「动作一览…」「版本与更新」和「专注 25 分钟」并列，
+  而版本号在「关于她」里还有一份 —— 同一件事出现在两个地方；
+- 三个分组**只看得到名字**：收起时不知道里面是什么、当前是什么状态；
+- 开关是「✓ 自己溜达」这种**带勾的文字**，而且点完菜单就关 —— 拨开关时菜单消失是最烦人的交互之一；
+- 「放大一点／缩小一点」把**连续量**做成了两个离散按钮；
+- 四个角落是四个**文字条目** —— 空间的事没有用空间的形式表达；
+- 最常用的「专注」埋在二级；专注中菜单里**看不出还剩多久**；
+- 7 行长得一模一样，没有分隔、没有层次、没有键盘提示。
+
+**现在**：
+
+```
+DeepSeek娘                          ← 头部：名字 + 版本 + 当前皮肤 +（专注中）
+v1.31.0 · 深海女仆
+─────────────────────────────
+专注 25 分钟                        ← 常用动作置顶；进行中时这一行就是状态 + 结束
+专注 45 分钟
+─────────────────────────────
+外观                 深海女仆 ▸     ← 摘要行：收起时也知道里面是什么、现在是什么
+行为                   4/5 开 ▸
+位置                 右下角 ▸
+大小   ──────●──────   100%        ← 滑块：拖动即时改；键盘 ←→ 各 0.25 档
+─────────────────────────────
+动作一览…
+关于她…                             ← 检查更新移到这里（版本号已在头部）
+─────────────────────────────
+先躲起来
+↑↓ 选择 · ←→ 调大小 · Esc 关闭
+```
+
+- **开关是真开关**：`role="menuitemcheckbox"` + `aria-checked` + 可见的滑轨，
+  点完**不关菜单**，原地更新（摘要里的「N/M 开」也跟着变）；
+- **大小是滑块**：`role="slider"` + `aria-valuenow`，指针拖、键盘调都可以，同样不关菜单；
+- **位置是 2×2 罗盘**：四个方位按钮，当前所在的那个有标记；
+- **版本与更新收进「关于她」**：菜单头部直接显示版本号，检查更新是弹窗里的一个按钮
+  （上下文才对得上）；
+- **三段式**：动作在上、设置在中间、信息在下，段间有分隔线；底部一行键盘提示。
+
+预检 473 → **502 项**，冒烟 53 项（真浏览器里新增：分组展开后菜单仍在视口内、
+关于弹窗真的在屏幕上、动作一览八张图真的解码 8/8）。
+
+**替身（简化 DOM）这次修了三处"不忠实"** —— 它们让真代码在测试里表现不对：
+
+1. 元素级 `querySelector`/`querySelectorAll` 与替身的 `all()`/`find()` 原来是**类名精确相等**，
+   而真实 DOM 的 `.a` 是**按类名列表**匹配 —— 于是 `wisp-menu-item wisp-menu-row` 这类行
+   在替身里"不存在"。这个坑前后踩过两次，这次统一成类名列表；
+2. 只支持**单个类名或标签**选择器（属性选择器、复合选择器都不行）→ 于是给滑块数值与角落按钮
+   各配了一个类名，测试不再依赖替身不支持的选择器；
+3. 测试里判断"焦点在滑块上"要**重新取当前元素**：菜单每次重画都换新元素，
+   拿之前抓到的做同一性比较会假失败。
+
+### 1.30.0
+
+### 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
 
 三件和"她真的陪着你"有关的事。都不需要新素材，全是行为 + 台词。