“只属于你”使用说明

Windows：
1. 推荐双击「只属于你控制面板.vbs」。
2. 在控制面板里可以启动、停止、重启、设置 AI Key、测试 AI、查看/清除记忆。
3. 控制面板顶部会显示当前运行状态，包括动作、模式、动作队列、AI 是否正在回复。
4. 控制面板可以直接点「立即安静」「恢复陪伴」「活泼一下」「站好」，不用右键桌宠本体。
5. 控制面板内容支持鼠标滚轮滚动，小屏幕也能看到下面的聊天体验和状态提示。
6. 「外观和动作」可以调整大小、透明度、是否置顶、安静/陪伴/活泼模式、动作细腻度，并可以重置位置。
7. 「聊天体验」可以调整回复风格、回复长度、主动说话、本地记忆、AI 等待时间，并可以测试一句话。
8. 桌宠运行后，右键桌宠可以选择：AI 对话、摸摸头、动作、安静模式、陪伴模式、活泼一下、站好、回到屏幕内、控制面板、退出。
9. 也可以直接双击「启动只属于你.vbs」启动，双击「停止只属于你.vbs」关闭。

Windows 独立版：
1. 使用 `发布包\Windows独立版_只属于你.zip`，完整解压后双击 `只属于你\只属于你.exe`。
2. 不需要安装 Python；桌宠运行时右键可以打开控制面板。
3. 桌宠未运行时，可以双击同目录的「只属于你控制面板.vbs」。
4. 独立版首次使用需要在控制面板重新设置 AI Key。
5. 独立版的 Key、记忆、位置和运行状态保存在 `%APPDATA%\桌宠`。

当前保留的动作入口：
- 单动作：轻呼吸、眨眼、开心、挥手、睡觉。
- 组合动作：随机互动、打招呼、收到啦、慢慢呼吸、晚安、摸摸头、动作巡检。
- 已删除重复入口和素材：抬眼/看一下、点头、摇头、轻歪头、看鼠标、靠边探头、认真听、思考、害羞、伸懒腰、想你一下、陪我专心、鼓励一下、悄悄看你、醒一醒、陪着你、备用 wink、轻说话帧。

本轮动作优化（2026-07-13）：
- 轻呼吸、开心、挥手、睡觉、说话最初补成稳定关键帧，后续版本已经提高到 25 帧；眨眼保留 4 帧小动画。
- 透明过渡改为“轮廓保护”：人物轮廓变化大的透明区域不再半透明叠图，避免手臂、头发、裤脚出现灰色虚影。
- 自动打招呼改为“轻呼吸 -> 开心 -> 站好”，不再一启动就强制挥手。
- 右键“挥挥手”改为“开心 -> 挥手 -> 开心 -> 站好”，挥手后不会直接跳回站姿。
- 动作巡检里挥手后会先收回到开心姿势，再进入睡觉，减少大动作之间的硬跳。
- 最新体检结果：动作 5/5 平稳；组合 6/6；手动 3/3；AI 回复 11/11；AI 等待 11/11；组合最大切换 8.7%，手动最大切换 8.63%。
- 目前素材还是整个人物 PNG，没有单独手臂/表情分层；所以挥手只能做到干净、稳定，想要真正“活过来”的手臂丝滑摆动，需要后续做 Live2D / Spine / 分层骨骼素材。

活着感动作：
- 默认不会自动追鼠标；看鼠标、探头这类轻微重复动作已经移除。
- 「动作细腻度」有稳定、自然、明显三档：稳定最少乱动，自然适中，明显会更频繁反应。
- 默认空闲以站稳和自然眨眼为主，只会低频看一眼或抬眼。
- 陪伴模式不会无缘无故自动开心；开心主要来自点击、摸摸头、感谢或亲密对话。
- 安静/陪伴/活泼模式都不会无缘无故漂移位置；只有手动或低频大动作触发「探头」时才会移动窗口。
- 勾选「自动大动作（低频）」或临时点「活泼一下」后，才会低频出现睡觉。
- 启动时只短暂提示「我在。」并保持看着；30 分钟内重复启动不会反复弹提示。
- 连续点击或连续摸摸头会自动降噪：短时间内不重复弹气泡，只保持看着你。
- bibi/poses 里已经补了 mouse_watch、edge_peek、sleep、stretch 多帧素材。
- 控制面板的「外观和动作」里可以直接点动作测试，确认看着、看鼠标、抬眼、眨眼、开心、说话、思考、挥手、探头、睡觉、伸懒腰是否生效。
- 控制面板「外观和动作」有「空闲慢呼吸」开关；现在默认开启，站着不说话时会很慢地呼吸，安静模式下会自动收住。
- 右键和控制面板新增「慢慢呼吸」组合动作，会轻呼吸、轻眨眼，再自然回到站姿，适合日常陪伴。
- 右键和控制面板新增「轻歪头 / 嗯？」动作；当你问问题或确认事情时，她会轻轻歪头，再回到慢呼吸和站姿。
- 右键和控制面板新增「收到啦」组合动作；你说“好的、可以、嗯、收到、明白”时，她会轻点头回应。
- 右键和控制面板新增「害羞一下」动作；你夸她“好看、可爱、真棒、厉害”或说想她时，会用更轻的害羞反应。
- 控制面板可以点「生成动作预览图」，会输出总览 PNG、动态 GIF 和体检数据，检查哪些动作是真动画、合成动画、静态或重复帧。
- 眨眼已补成 4 帧小动画，并使用独立本地计时；空闲眨眼会从开眼自然过渡到闭眼，不会从随机中间帧开始。
- 生成预览时还会输出「组合动作预览.png」，按步骤展示摸摸头、随机互动、晚安等流程，方便看组合是否顺眼。
- 「聊天动作预览.png」会展示 AI 回复动作：普通回复、问题、感谢、夸奖、安慰、帮忙等都会显示动作步骤。
- 生成预览时会额外输出「聊天动作预览.png」，专门展示 AI 回复动作和等待动作；「组合动作预览.png」只保留右键/控制面板组合动作，更容易看。
- 等待 AI 回复的动作也会进入体检和组合预览：如果 AI 比较慢，她主要在看着、轻呼吸、站姿之间切换，只保留很短的语境反应。
- 如果想看聊天动作效果，不需要真的等 AI 慢；控制面板新增「等待动作」「回复动作」测试按钮，可以直接触发普通等待、问题等待、帮忙等待、夸奖回复、安慰回复等动作。
- 动作预览现在会额外显示稳定指标：锚点偏移和脚底偏移，用来检查动作是否会突然跳动。
- 动作体检数据现在是标准 JSON，并统一使用 `/` 路径，后续脚本可以直接解析，不会被 Windows 反斜杠转义影响。
- 动作体检现在会强制检查日常组合、AI 等待、AI 回复不能自动使用 `listen/typing` 低头/手机姿态；这些姿态只保留给手动测试和动作巡检。
- 动作体检也会检查「随机互动」动作池，只允许收到啦、慢慢呼吸、陪着你这类稳定陪伴组合。
- 控制面板可以直接打开最近生成的动作预览图、组合动作预览图、聊天动作预览图和体检数据，不需要手动找文件夹。
- 控制面板也可以打开「动作切换预览图」，专门查看两个姿势切换时 0% 到 100% 的过渡效果，方便定位哪里还硬。
- 控制面板生成预览后会直接显示体检摘要；正式打包前也会自动跑动作体检，发现缺动画或不平稳会停止打包。
- 动作体检现在也会检查组合动作：确认每个组合都引用真实动作、步骤时间不过短、结尾会回到站姿。
- 组合动作体检会记录「最大切换」分数，用来发现两个姿势之间是否跳得太突然；动作巡检因为故意连续展示全部姿势，分数偏大属于正常。
- 右键和控制面板里直接点的手动动作也会进入体检；手动动作切换超过 10% 会被拦住，避免挥手、伸懒腰这类大动作突然硬跳。
- 手动「挥挥手」「伸懒腰」已加入口和收尾缓冲：先轻呼吸/开心，再做动作，再回到开心和站姿，减少抽搐感。
- 挥手、伸懒腰、睡觉、探头、看鼠标、认真听、思考这类大幅姿势切换不再使用运行淡入叠图，优先避免虚影。
- 大幅姿势切换现在使用「局部蒙版」过渡：身体不变的区域保持清晰，只让手臂、头发、姿势差异区域逐步变化，减少整个人重影。
- 挥手和伸懒腰新增动作入场段：进入动作时先从开心姿势抬起手臂，避免第一帧直接举手；手动动作最大切换已降到 8.17%。
- 挥手和伸懒腰也新增收尾放手段；睡觉新增「醒来过渡」连接动作，睡着和醒来不再直接硬切回站姿。
- 新版体检结果已收敛到同一水平：组合、手动、AI 回复、AI 等待最大切换均为 6.79%；手动睡觉最大切换降到 2.73%。
- 开心和害羞新增内部「轻开心 / 轻害羞」连接动作；从呼吸进入开心/害羞不再硬切，摸摸头和夸奖回复也会更自然。
- 最新继续降噪：默认随机互动移除「悄悄看你」的看鼠标段，点头/开心/害羞/慢呼吸组合删掉连续小眨眼，点击反馈改为「轻开心 -> 收住 -> 回站」。
- 当前默认待机改为轻呼吸优先；基础站姿、看着、抬眼之间使用更长局部过渡，减少“几张图来回闪”的抽搐感。
- 新增黑影/暗边清理：缩放后、动作帧混合后、显示前都会清掉低透明暗边，减少人物外圈黑影。
- Windows 现在优先使用 Qt 真透明窗口，支持柔边透明和动作过渡，不再用 Tk 色键把运动过程混出黑边；没有 Qt 时才回退 Tk。
- 当前电脑已安装 PySide6-Essentials，运行状态里 `window_engine=qt` 表示正在使用真透明窗口。
- 默认启动刷新率改为 60fps，动作比 30fps 更顺；需要省资源时可设置 PET_SMOOTH_MODE=stable 回到 30fps。
- 动作体检新增「暗边」指标；低透明暗边超过 20% 会拦住打包，避免黑影问题反复回来。
- 最新体检结果：动作 5 个，平稳 5/5；组合 6/6，手动 2/2，AI 回复 11/11，AI 等待 11/11；组合最大切换 9.43%，手动最大 7.2%，AI 回复最大 8.96%，AI 等待最大 6.78%。
- 为了消除动作虚影，明显姿势切换不再使用半透明叠图；动作切换预览里显示「运行淡入 0s / 无叠图」时，25% 到 100% 会直接显示目标动作。
- 体检里的「最大切换」现在主要表示两个素材姿势差异大小，不代表运行时仍有双人影。
- AI 回复改为真正的聊天气泡：白色圆角气泡、底部小尾巴、深灰文字；保留原来的拖拽造型，拖拽改为全局鼠标跟手。
- 控制面板「查看记忆」修复：记忆窗口滚轮不再被主面板抢走，坏文件会显示原始内容；「清除记忆」会同步通知正在运行的桌宠清空内存。
- 「查看记忆」窗口改为顶部固定按钮栏，「复制记忆 / 清除记忆 / 关闭」不会再被记忆内容挤到窗口外。
- 动作衔接升级：运行时从 0 秒硬切改为 0.10-0.14 秒局部蒙版过渡，保留透明干净边缘，同时让说话、挥手、睡觉、回站姿更顺。
- 回复动作也会记录最大切换分数；夸奖和亲近回复会先看着再害羞，减少从说话姿势直接跳到害羞姿势。
- 等待动作也会记录最大切换分数；普通、帮忙、安慰、纠正、晚安等待已收敛为看着、轻呼吸、站姿，减少姿态跳变。
- 右键「动作」里可以直接触发挥手、看一下、眨眼、伸懒腰、睡一会；也可以触发「随机互动」「动作巡检」「打招呼」「小困一下」「陪我专心」「鼓励一下」「晚安」「想你一下」组合动作。
- 控制面板「组合动作」也能触发这些小流程；组合动作结束后会自动回到稳定站姿。
- 控制面板「等待动作」「回复动作」能单独测试聊天时的动作，不影响 API 设置和聊天记录。
- 控制面板运行状态会显示当前聊天动作名，例如「帮忙等待」「夸奖回复」，方便测试时确认执行到了哪一段。
- Windows 和 Mac 共用同一份组合动作配置；调整一次会同时影响两个版本，减少后续不同步。
- 打招呼、鼓励、醒一醒的组合动作已收顺：挥手后先回到开心姿势，醒来会先伸懒腰再开心一下，减少硬切。
- 右键和控制面板新增「摇头」动作，以及「不太对」组合动作；当你说“不对、不是这样、改一下”时，她会收住并轻轻摇头。
- 对话里出现“为什么、是不是、可以吗、？”这类问题时，会优先用轻歪头动作回应，不再只站着回话。
- 确认类短句会优先触发点头，不会再用过度开心的动作回应普通“收到/可以”。
- 等 AI 回复时会先保持站稳；问题、夸奖、感谢等只给很短的轻歪头、害羞或点头反应，然后回到轻呼吸/站姿。
- 亲近和夸奖类话术不再总是大开心，会优先轻害羞，再自然回到站姿。
- 「抬眼 / 看一下」已补轻动画，不再只是静态换图，偶尔看你一眼会更自然。
- 显示正式回复时会先短暂进入说话动作，再回到看着、点头、害羞或站姿，不再像静态贴图弹字。
- 「随机互动」只会抽取更安静的日常陪伴动作：收到啦、慢呼吸、陪着你；不会随机触发挥手开心、醒一醒、小困一下、晚安、不太对这类有明确语境或幅度偏大的动作。
- 右键和控制面板新增「悄悄看你」「醒一醒」「开心一下」三个轻组合动作，动作幅度小，适合日常互动。
- 右键和控制面板保留「点头」「认真听」手动动作；日常聊天默认不再自动切到认真听，减少低头姿态跳变。
- 右键和控制面板新增「轻呼吸」动作；需要更有陪伴感时可以手动触发，默认站姿仍保持稳定。
- 「动作巡检」会按顺序演示核心动作，并在气泡里显示当前动作名称，适合快速检查哪里还生硬。
- 现在默认是柔和版动作：不加文字特效，不旋转整张人物图，减少抽搐和乱跳。
- 眨眼使用独立的 blink_seq 动画，不再用大幅换姿势的 wink.png 做空闲眨眼。
- 轻动作优先稳定，只保留很慢、很小的呼吸式变化；明显姿势切换用短过渡收住，减少乱和抽。
- 空闲时会更少切换姿势；说话和等待回复时优先保持站稳。
- 点击、摸摸头、聊天、显示气泡后会进入短暂安静期，不会马上切到随机动作。
- 摸摸头现在会触发轻组合反馈：害羞一下、眨眼、轻点头，再回到站姿；控制面板也可以直接测试「摸摸头」。
- 主动说话改成低打扰节奏：陪伴模式约 7 到 15 分钟一次，活泼模式也不会太频繁。
- 主动冒泡只保持站稳陪伴，不再明显上下说话；气泡消失后会停留收尾。
- 默认动作进一步放慢：看鼠标、探头、伸懒腰都有较长冷却，减少抽搐感。
- 轻动作不再做每帧微缩放，避免 1 像素来回跳；生命感主要来自稳定注视和自然眨眼。
- 启动默认使用 60fps 刷新，减少动作卡顿；需要省资源时可设置 PET_SMOOTH_MODE=stable 回到 30fps。
- Windows 如需强制回旧 Tk 窗口，可用 `--tk` 或设置 `PET_FORCE_TK=true`，但 Tk 模式透明边缘更容易出现黑影。
- 眨眼节奏改为更慢的自然间隔，偶尔会出现一次很轻的二连眨。
- 对话气泡消失后会回到稳定站姿，减少频繁抬眼切换。
- 等待 AI 回复时保持站稳，不再默认切到低头输入姿态。
- AI 等待和正式回复进一步收敛：默认不再切到低头输入、认真听、摇头这类姿态差异大的图，避免看起来乱跳。
- 动作循环速度整体放慢；窗口随机微漂移已关闭，明显姿势切换不再用长淡入，减少“抽搐”、虚影和 1 像素跳动感。
- 「陪着你」和「随机互动」进一步稳态化：日常随机陪伴不再使用认真听/低头姿态，主要是看着、慢呼吸、轻眨眼、回站姿。
- 「陪我专心」「嗯？」「不太对」也改为站姿系小流程，不再自动切到认真听；低头/手机姿态只保留在手动动作测试和动作巡检里。
- 默认空闲慢呼吸改为开启；日常待机以很慢的呼吸为主，需要更静时可以在控制面板关闭或切到安静模式。
- 「动作巡检」按视觉相近程度重排，最大切换从 15.65% 降到 8.62%，不会再把差异很大的姿势连续硬切。
- 「小困一下」「晚安」「醒一醒」「想你一下」也收顺了过渡，减少睡觉、伸懒腰、开心之间突然变形。
- 动作体检现在会把“站姿进入第一个动作”的入口切换也算进去；打招呼、小困一下、害羞、晚安、AI 回复和等待都加了入口缓冲。
- 新版体检结果：组合最大切换 8.62%，AI 回复最大 8.96%，AI 等待最大 6.79%，入口切换也在这个分数内。
- 说话动作改为 `talk_soft` 轻说话帧：站姿系小动作，不再突然举手；AI 回复最大切换降到 6.79%。
- 挥手/伸懒腰保留干净原素材，不使用整图混合软帧，避免为了降分数产生重影。
- 动作巡检再次重排，避开低头姿态直接接慢呼吸；组合最大切换降到 8.29%。
- 气泡显示时间会按文字长度自动调整：短句不拖，长回复会多停留一会。
- 桌宠靠近屏幕边缘时，气泡会自动夹在屏幕内，不会跑出右侧或顶部。
- bibi 动作现在按下半身锚点对齐，不再因为手臂或手机伸出来导致身体横向跳。
- bibi 重复帧会自动折叠，不再把完全相同的图片当成动画循环播放。
- 静态动作不再做每帧上下左右微抖；没有真实动作帧时会稳定停住。
- 稳定档进一步收敛：没有真实连续帧的动作不会再强行做伪呼吸、伪晃动，减少抽搐感。
- 控制面板运行状态会显示组合动作名称和当前步骤，方便定位哪个动作还生硬。
- 开心、挥手、说话、思考、点头、认真听、轻呼吸、看鼠标、探头、睡觉、伸懒腰已补稳定锚点动作帧，并改为来回播放，避免末帧跳回首帧。
- 手动动作和组合动作会从动作第一帧开始播放，不再因为全局计时从中间帧开始。
- 多帧动作改为帧间柔和过渡，不再硬切换；摇头、点头、看鼠标、探头、挥手不再旋转整张人物图，幅度进一步收小，减少抽搐感。
- 动作切换现在优先无叠图显示；动作本身使用本地时间播放，避免从旧动作第一帧硬跳造成错位。
- 看鼠标和探头使用慢速轻动作；探头还会配合窗口靠边移动表达。
- 站立、看着、眨眼保持稳定；空闲慢呼吸只做很慢的微动，避免默认状态又变抽搐。
- 如果以后替换 bibi 基础姿势，可以运行 tools/build_bibi_motion_frames.py 重新生成轻动作帧。
- 如果动作预览里出现「需检查」或锚点/脚底偏移明显变大，说明该动作帧可能会抽搐，需要先修素材再使用。
- 靠边探头的移动幅度和速度已收敛，气泡也会跟随桌宠位置移动。
- 右键「回到屏幕内」或控制面板「重置位置」会让正在运行的桌宠立刻回到屏幕内。
- 如果觉得还是动得多，把「动作模式」调成安静或陪伴，或把「动作细腻度」调回稳定。
- 如果觉得太呆，把「动作细腻度」从稳定调成自然；想看更多反应时再点「活泼一下」。
- 「活泼一下」是临时状态，约 2 分钟后会自动回到稳定陪伴。
- 「站好」会立刻取消当前动作、组合动作和临时活泼，回到稳定站姿；不会像安静模式那样关闭主动陪伴。
- 控制面板发出的临时命令超过 5 分钟未被桌宠接收会自动作废，避免下次启动误触发旧动作。
- 右键切到安静模式后，也可以右键选择「陪伴模式」直接恢复主动陪伴。

本轮动作优化（2026-07-13，第二轮）：
- 轻呼吸、开心、挥手、睡觉、说话由 5 帧提高到 25 帧，动作起伏使用先慢、后快、再慢的节奏。
- 25 帧使用亚像素生成，缩小到桌宠尺寸后仍保持 25 张不同画面；不再出现文件很多、实际画面重复的问题。
- Windows Qt 使用精准刷新计时，相同画面不会重复转换和缩放窗口，减少播放时的微卡顿。
- 每个动作使用独立速度：挥手较快、说话自然、开心轻快、呼吸和睡觉较慢。
- 动作内部不再用半透明叠帧，直接播放密集小帧，避免透明边缘在运动中产生黑影和双影。
- 明显姿势切换会先轻微起势，在最高点更换姿势后落回，避免两个人物轮廓同时出现。
- 右键“挥挥手”缩短为 5 段；睡觉与动作巡检加入醒来动作，回站姿不再突然。
- 最新体检：动作 5/5 平稳，组合 6/6，手动 3/3，AI 回复 11/11，AI 等待 11/11。

稳定性优化（2026-07-13）：
- AI 网络失败会在总等待时间内进行一次短重试；失败后保留已经出现的快速回复，不再重复弹出另一条本地回答。
- 发送给 AI 的微信语气样本由 8 条减少到 4 条，降低请求长度。
- 记忆文件使用安全替换写入，异常退出时更不容易损坏。
- 包含密码、验证码、API Key、银行卡等敏感字样的对话不会保存到最近记忆。
- Windows 正式包不再包含 Mac `.app`；两个平台的压缩包会在生成后自动检查内容。

Mac：
1. 推荐双击「只属于你控制面板.command」。
2. 第一次可以在控制面板里设置 DeepSeek API Key。
3. 也可以双击「点我启动只属于你.command」或「启动只属于你.command」启动。
4. 如果没有显示，双击「可见测试启动.command」。
5. 关闭时双击「停止只属于你.command」。
6. 需要不依赖 Python 的 Mac 独立 `.app` 时，双击「生成Mac独立版.command」；生成结果在「发布包」文件夹。
7. 没有 Apple Developer ID 公证时，第一次打开生成的 `.app` 仍可能需要到「系统设置 -> 隐私与安全性」选择「仍要打开」。

注意：
- 控制面板里的设置保存后，一般需要重启桌宠才会生效。
- 如果以后还想更顺，可以在启动前设置 PET_SMOOTH_MODE=ultra；如果想省资源，可以设置 PET_SMOOTH_MODE=stable。
- Mac 会把位置和记忆放在 ~/Library/Application Support/桌宠。
- 发给别人的压缩包里不要放真实 API Key。
- Windows 微信聊天记录路径到了 Mac 上通常不能直接用，不影响桌宠启动。
