LiPet 使用与功能指南

单击：基于当前姿态的真实触摸反应

单击时小猫不会突兀地切入不相干动作。它必定先播放 2–3 帧前导注意帧，让耳朵或眼神转向光标接触点，再根据当前姿态进入对应的反应分支：

• 站立/行走中： 停下脚步，歪头好奇观察、慢眨眼或轻抬前爪。
• 睡眠中： 耳朵先动，睁一只眼确认，伸个懒腰后若无后续打扰便继续睡下。
• 理毛中： 在安全切点暂停舔毛，抬头与你对视确认。
• 玩耍中： 收住扑击动作，转向光标接触点互动。

连续触摸与防烦躁（饱食度机制）

适度抚摸带来亲近反应，但如果 3 秒内连续狂戳，会累计 touchSaturation（触摸饱和）：

• 第 1 次点击： 正常亲和反应，眼神与耳朵定位。
• 约 1.5 秒内第 2 次： 延续同一反应序列的后半段。
• 约 3 秒内第 3 次及以上： 触发防烦躁边界——小猫甩尾巴、抬爪挡开光标或转身躲避。
• 恢复冷却： 停止点击约 6 秒后饱和度归零，小猫恢复温和状态。

双击与手势仲裁机制

为了避免双击时误触发单击触摸反应，系统内置约 250ms 的手势仲裁窗口。在有双击绑定或对话助理入口时，第一次点击抬起后进入候选等待；若 250ms 内且 6 像素范围内发生第二次点击，立即取消单击反应，干净利落地打开宠物卡片或助理面板。

长按与物理拖动

按住主键约 500ms 且保持微动，触发该区域绑定的长按技能。如果移动距离超过 4–6 像素阈值，则立即转入原生拖动：

• 被拎起反应： 姿态迅速收拢为被捏住后颈皮拎起的状态（被拎起），身体阴影与桌面分离。
• 跨屏漫游： 支持在多显示器、菜单栏与窗口边缘之间自由拖拽。
• 落地缓冲与记忆： 松开后播放缓冲落地动作（落地），张望确认新环境；经历 20–60 秒冷却后，它会根据自身记忆决定是否走回它钟爱的舒适角落。

四种身体分区切分模式

在宠物中心内，可以按需为小猫选择 4 种身体分区之一：

• whole — 全身作为一个统一区域（all）。
• rows2 — 上下切分：top（耳朵、头部、后背）与 bottom（肚皮、爪子、尾巴）。
• cols2 — 左右切分：left（前脸与前胸）与 right（后背与尾巴）。
• grid3 — 九宫格切分：r1c1 至 r3c3 共 9 个精细区域，适合多技能高玩。

像素级 Alpha 穿透遮罩

分区仅计算宠物当前可见的非透明像素。宠物窗口周围的透明空气完全穿透，点击直接传递给底层的 macOS 窗口和代码编辑器，绝不遮挡正常工作。

手势独立绑定技能命令

每个区域都可以独立为 tap（单击）、double-tap（双击）和 long-press（长按）绑定技能命令。例如：单击头部查实时天气，双击肚皮查 AI 余额，长按后背调出系统 CPU 面板。

宠物中心专属存储

触控映射属于每只宠物的专属配置，与行为表同级，通过 revision 乐观锁与云端同步，换机换设备设置不丢失。

五档频率权重调节

LiPet 的行为频率是自主选择器里的相对权重，并非死板的定时器：

• 1 — 极罕见：稀有彩蛋动作。
• 10 — 罕见：偶尔发生的伸懒腰与大幅度扑击。
• 50 — 中（既定默认）：日常走动、坐下与理毛的标准频率。
• 100 — 经常：偏活跃的张望与探索。
• 200 — 频繁：高活跃度的桌面漫步。

允许自发出现开关

每项行为行均配有独立的 [允许自发出现] 开关。关闭后该动作不会主动发起，仅在特定后继动作链或外部事件触发时执行。

精灵帧动画与按需调度引擎

LiPet 采用轻量精灵帧（Sprite Frames）动画渲染，渲染帧率严格不超过素材自身帧率。行为引擎按需决策而非固定高频轮询，决策间隔随当前行为动态安排；动作还可配置多档播放速度进行随机或有序切换以增加生动性。当屏幕锁定或系统休眠时，引擎完全停止运行，不占用任何后台资源。

外部现实事件与环境绑定

让屏幕里的小猫与你的真实环境产生共鸣：

• 天气联动： 室外下雨小猫会触发抖毛动作；寒潮来袭会蜷缩打颤。
• macOS 勿扰/专注状态： 系统进入专注模式时，小猫自动转入安静状态（不弹气泡、安静趴卧）。
• 全屏与投屏检测： 屏幕共享或全屏观影时，小猫自动停靠屏幕边缘不抢焦点。

声明式技能数据包架构

技能不以可执行二进制或不可控的脚本形式分发，而是统一为包含 Manifest、UI 呈现与查询命令的声明式数据包。官方技能更新由云端即时下发，秒级就绪。

透明权限模型与特权白名单

从技能商店安装时，明确展示所需权限清单（网络域名、通知权限、刷新频率）。特权操作严格受白名单约束并在沙盒中隔离运行。

三层投递呈现管线

技能产生的结果通过清晰的层级呈现：

• L1 宠物气泡： 最多一句精炼摘要，仅用于重要提醒。
• L2 时间线面板： 静默记录历史查询、AI 额度消耗明细与天气详情。
• L0 宠物动作： 触发小猫肢体动作，不制造弹窗打扰。

AI 额度 Gauge 面板与监控

内置针对 OpenAI、Anthropic Claude 与 Google Gemini 的 API 额度仪表盘，轻点爪子即可直观查看剩余 Tokens 与用量圆环。

菜单栏托盘与 Dock 栏独立开关

根据个人使用习惯自由定制 LiPet 的常驻位置：

• 菜单栏托盘图标： 在 macOS 顶部菜单栏显示轻巧的小猫图标，提供快捷菜单与状态入口。
• Dock 栏图标： 在 macOS 程序坞中显示应用图标，便于常规窗口管理与应用切换。

Dock 图标跟随宠物外观

开启 Dock 栏显示时，可启用图标动态同步，实时跟随你当前所选宠物的花色、外貌与状态。

双关拦截安全保障

系统施加了原生安全约束：不可同时关闭 Dock 图标与菜单栏托盘图标。系统必须至少保留一个恢复入口，确保随时能够打开设置面板。