奶蛙 · macOS 视觉重制版 3.0
基于用户提供的 Windows v2.1.1 源码与素材

打开 NaiwaPet-Mac-Visual-v3.app。支持 macOS 13+、Apple 芯片和 Intel。
不需要 Python、浏览器或额外运行库。建议先退出之前的奶蛙 App，避免同时出现多个桌宠。

垃圾桶互动
1. 右键奶蛙，在面板底部点“标记垃圾桶”。
2. 点一下 Dock 中垃圾桶的中心，位置会保存到本机。Esc 可以取消。
3. 奶蛙会走过去投一个小纸团。之后漫游经过，或拖到附近松手，都会触发。
   同一位置自动触发有 15 秒间隔；“走向垃圾桶”可以主动演示。
4. Dock 或显示器位置改变后，重新标记。Dock 自动隐藏时，建议显示 Dock 后再定位和观看。

无需授予辅助功能权限即可手动标记。若 App 已获 macOS 辅助功能权限，会尝试从 Dock
读取垃圾桶位置并随其更新；不会主动申请系统权限。没有定位时不会猜测垃圾桶位置。
投掷仅为视觉动画，不会读取、移动、删除或清空垃圾桶中的文件。

动作与交互
- 点头部：挥手、思考、耸肩依次轮换；点肚子：躺下捧腹笑；双击：默认扭一扭；勾选“工作待办快捷键”后打开待办。
- 面板“摸摸头”：原版开心动作和爱心；“打个盹”：睡眠帧与 Z 字反馈。
- 按住拖起：挣扎；松手：重力和落地回弹；快速甩动：惯性抛掷。
- 鼠标靠近时转头；桌面漫游、暂停、置顶、三档尺寸和五种颜色均保留。
- 90 秒未互动会打盹；轻点唤醒。打开面板时暂缓漫游，方便操作。
- 动画直接复用原版 Pet 状态机、素材帧与时序；旋转和缩放以脚底为中心。
- macOS 计时器在输入和拖动期间继续运行。没有使用网络动画或网页替代桌宠。

工作待办
- 右键面板新增“工作待办快捷键”，开启后双击桌宠或 Control+W 打开完整待办；关闭后释放快捷键。若快捷键被占用会提示。
- 悬停桌宠约半秒显示简版待办：输入、新增、滚动查看及完成/取消完成；移到简版窗口可继续操作，离开后自动收起。
- 简版与完整窗口共享任务；简版输入草稿独立保存，不覆盖完整窗口正在编辑的草稿。
- Mac 三档显示高度为 84 / 124 / 166 点，比之前缩小约 20%。
按原版 460×650 逻辑尺寸重绘布局，支持缩小到 360×520、滚动长列表。
输入框、按钮、日期时间、快捷选项、任务卡片和空状态使用统一间距与配色。
配套日历支持月份切换、选日和今天。文字输入保留 macOS 原生输入法。
支持新增、编辑、完成/取消完成、删除、截止时间、草稿自动保存和保存失败重试。
编辑时“添加”变为“保存”；取消编辑保留新草稿；已完成任务显示删除线。
Cmd+C/V/X/A、撤销、Enter 提交、Esc 收起可用。截止时间仅记录，不发送提醒。
数据存于 ~/Library/Application Support/NaiwaDesktopPet-MacVisual3/todos-v2.tsv
首次运行会复制前一个 Mac Full 版的待办。旧版数据保留；损坏文件不会被覆盖。

验证
实际启动并操作了新增、完成、编辑、删除、日历选日、中文粘贴、Enter 提交、摸头。
原版状态机测试 20 组、613748 条断言通过；十组动作导出的连续帧均发生变化。
自动靠近垃圾桶触发、抛物线和落点反馈使用生产代码导出检查。
真实 Dock 位置需要首次标记；不能从用户提供的单个图标裁剪图推断其屏幕坐标。

源码
main-visual.m、visual-controls.h、trash-interaction.h、quick-todo.h、pet_core.h、animations.h。
构建命令：./build-macos-visual.sh
可用 --render-previews <目录> 导出自身渲染的界面 PNG 和动画 GIF；此模式不保存待办。
原版代码与素材许可见 App/Contents/Resources 中的 LICENSE-code.txt、
LICENSE-upstream.txt、ATTRIBUTION.txt。此为非官方个人适配版。
