MacDuo 1.4.0 — Attention Stats, Liquid Glass & Companion

注视统计、液态玻璃与陪伴视频

屏幕注视统计

• 只在「已就绪 + 面向屏幕 + 未模糊」时累计本次连续注视时长；触发模糊即结束一段，短暂转头只暂停不清零。
• 今日累计仅保存在本机，跨重启保留，午夜自动归零；菜单栏实时显示当前连续时长。

液态玻璃离开卡

• 深浅自适应的真透明玻璃：behind-window 采样、圆角完全透明、流动冷色 tint、缓慢扫过的高光带、镜面描边。
• 清晰的信息主次：大号注视计时（柔光晕）为主角，数值提亮、标签压暗、待办用冷青强调色。

全屏毛玻璃转为液态质感

• 透过率提高、饱和度回补、冷白透光与柔和高光带；清晰态与未覆盖区域仍逐像素等于原桌面。

内置示例陪伴视频「豆姐」

• 离开画面循环播放（静音、不阻止屏幕休眠）。两种样式可切换：
  • 融入整屏玻璃：氛围光晕铺满全屏 + 清晰主体居中、边缘径向融化；视频先完整播放一遍，统计卡再淡入至中下位置。
  • 显示在卡片中：视频作为圆角玻璃小窗嵌在卡片左侧。
• 替换 App 内 Contents/Resources/AttentionCompanion.mp4 即可换成自己的视频（横屏素材自动铺满屏宽）；删除该文件即关闭。

修复与改进

• 注视模式强制使用 Mac 内置 FaceTime 相机，连续互通 iPhone 相机不再被误选（此前会导致永远检测不到人脸）。
• 未开始时切换模式自动弹出屏幕选择器，不再需要单独点开始。
• 日志新增相机选择、标定进度与监测启动记录，便于排查。

9 项自动回归通过（新增注视统计累计/分段/跨天与四方向像素校验约束下的液态渲染）。真实身份验证与人脸识别已实机验证。

Apple Silicon / macOS 15.2+。开发签名、未公证试用版。公开包不包含开盖音效音频。

SHA256：8da835d36e67975c29af3fe58a02ea6132e0e7c11f396efee5b2604bb6dbf3ff

MacDuo 1.3.0 — Idle-Gated Attention & Auto Return

注视模式：闲置计时、自动恢复与「立刻」档

• 模糊计时改为双重条件：「没有面向屏幕」与「没有键盘鼠标操作」同时持续到设定时间才触发；任一条件中断立即清零重新计时。正在用电脑时不会被模糊。
• 新增「立刻」档位，延迟可选立刻或 3 秒至 5 分钟（默认 10 秒）。菜单栏实时显示「已转开 X 秒，Y 秒后模糊」。
• 头部姿态判定放宽（yaw 0.60 / pitch 0.55），看屏幕下半部分或低头瞄键盘不再误判为离开；检测到人脸但姿态无法解析时视为在场。
• 重新面向屏幕即自动恢复清晰，无需任何操作。「保持模糊，手动确认」改为可选项，勾选 Touch ID／系统密码验证时自动保持。
• 修复：注视模式下打开菜单栏或产生键鼠输入后，触发器基准被重置导致模糊永久失效的问题，需重启模式才能恢复。已加入回归测试。

设置及待办仅保存在本机，不保存或上传摄像头画面。视觉遮罩不等于安全锁屏：菜单栏暂停或退出仍可移除效果。锁屏/休眠会释放效果及摄像头。

9 项自动回归通过，新增闲置门控（含一小时持续输入不模糊）、零延迟语义、菜单/输入后重新武装共 3 组用例。姿态阈值基于本机摄像头实测数据（正常注视 pitch 实测可达 0.36，旧阈值 0.32 造成误触发）调整，已实机验证。

Apple Silicon / macOS 15.2+。开发签名、未公证试用版。公开包不包含个人录音。

SHA256：52eae044fa6ec9700827fb940faf685f568a17eea541cfef1e1deb9d0b3cebb1

MacDuo 1.2.0 — Flowing Glass & Away Timer

离开计时、保持模糊和随机液态扩散

• 设定离开 1/3/5/10/30 秒或 1/2/5 分钟后触发。
• 不再选择方向：每次自动随机从一侧缓缓流过，约 1.6 秒扩散，宽柔边缘、轻微折射，无扫光线。
• 默认保持模糊；卡片显示离开时长、待办提醒，检测到回看后显示欢迎回来。
• 点击恢复，可选 macOS Touch ID／系统密码验证；取消验证会保持遮罩。
• 取消保持选项可恢复自动回看变清晰的模式。

设置及待办仅保存在本机，不保存或上传摄像头画面。应用不读取身份验证密码。视觉遮罩不等于安全锁屏：菜单栏暂停或退出仍可移除效果。锁屏/休眠会释放效果及摄像头。Escape 请求恢复，不是系统级快捷键拦截。

9 项自动回归通过，包含自定义延迟、保持/返回/计时、四个扩散方向的像素检查。设置界面已在本机查看；真实身份验证与人脸识别仍需实机验收，不宣称自动测试完成这些步骤。

Apple Silicon / macOS 15.2+。开发签名、未公证试用版。公开包不包含个人录音。

MacDuo 1.1.1 — Directional Diffusion

注视模式改为有方向的毛玻璃扩散，不再全屏同时淡入。

• 默认从左到右，可在控制窗口切换从上到下，方向自动保存。
• 约 0.9 秒扩散铺开，回看时约 0.45 秒反向退去。
• 柔和过渡边缘，没有扫光线；扩散未到达的区域保持清晰。
• 动画按实际时间推进，保留鼠标键盘立即恢复、摄像头生命周期和原有合盖模式。

9 项自动回归通过，新增两种方向的中途清晰区域与最终全屏模糊像素检查。本机已验证注视模式方向选择入口。

注视模式仍为实验性人脸朝向判断，不是精确眼球追踪。Apple Silicon / macOS 15.2+；开发签名、未公证试用版。公开包不含个人音频。

MacDuo 1.1.0 — Attention Mode Preview

新增「注视模式 · 使用摄像头」（实验功能）：看向屏幕清晰，转头或离开约 1 秒后全屏毛玻璃，回看后恢复。控制窗口和菜单栏均可切换，默认仍为原来的合盖模式。

• 内置摄像头 + 本地 Vision 人脸朝向估计，约 5 Hz 分析，不保存、不上传图像，不使用麦克风。
• 先面向屏幕就绪，短暂转头不闪烁；输入立即恢复桌面并暂缓再次模糊 2 秒。
• 暂停、切换到合盖模式、锁屏和退出停止摄像头；画面中断超时后撤销覆盖并停止。
• 单张桌面快照和渐变渲染，无连续桌面录制，无扫描光带。

这是人脸朝向估计，不是精确眼球追踪；眼球单独移动可能无法识别。光线、眼镜与多人入镜会影响结果。注视模式运行时摄像头保持检测，以便识别回看，不采用合盖模式的 90 秒待机规则。不是安全锁屏或隐私保护工具。

构建和 9 项自动检查通过，包括新模式状态机与全屏 Metal 像素检查。真实摄像头姿态识别、权限和物理转头效果仍需实机验收；本次未自动开启用户摄像头进行测试。

Apple Silicon / macOS 15.2+，开发签名、未公证试用版。公开包不含个人录音；支持自行添加 WAV。详细说明见 README。

MacDuo 1.0.20 — Open Source Preview

MacDuo 首个开源版本：随 MacBook 开合角度变化的桌面毛玻璃效果。

• 原位渐进磨砂与轻微折射，无扫描光带。
• 输入立即交还桌面，菜单栏控制，90 秒无动作自动待机。
• MIT 源码、中英文文档和三张 AI 场景示意图。
• 公开版不附带录音，可自行安装 WAV 开启音效。

适用于 macOS 15.2+、Apple Silicon MacBook 和可读取的开盖角度传感器。其他机型兼容性尚未逐一验证。开发签名、未公证试用版；macOS 可能阻止启动。

下载 DMG 后拖入 Applications，打开并选择内置屏幕。完整用法与源码构建见 README。

Build and all 8 regression checks passed on the development Mac. Physical lid movement, screen-sharing authorization and sleep/wake behavior remain hardware-dependent. This is a single-snapshot effect, not continuous desktop video or a lock-screen effect.

The DMG contains the public source build without the private development recording. SHA-256 checksum is attached.