QQPetWidget

简介

这是一个把 QQ 宠物做成桌面挂件的 Electron 小工具。

现在这只企鹅不只是卖萌，还会和本机的 Codex 工作状态联动：

• 企鹅会根据 Codex 当前进度切换状态
• 头顶会显示当前状态文案
• 下方会显示一句气泡提示
• 气泡下面会显示 Codex 额度 面板
• 面板里会展示 5h 和 7d 两个额度窗口

适合一边写代码，一边在桌面右下角看 Codex 现在是在思考、读码、改码、执行，还是等你回复。

这个桌宠怎么玩

启动后你会在桌面右下角看到一只企鹅。

它的玩法很简单：

• 看状态：企鹅头顶会显示当前状态
• 看气泡：企鹅下方会用一句短文告诉你它现在在干嘛
• 看额度：展开 Codex 额度 可以查看 5h / 7d 使用情况
• 点三角：点击 Codex 额度 右侧的小三角，可以折叠或展开面板
• 拖位置：按住企鹅本体区域拖动，可以把桌宠移动到你想放的位置

注意：

• 只有鼠标落在企鹅可交互区域时才能拖动
• Codex 额度 面板也支持鼠标交互，不会被点击穿透

企鹅会显示哪些状态

目前桌宠会根据 Codex 事件流切换这些状态：

• 待命
• 思考
• 读码
• 改码
• 执行
• 等你
• 完成
• 出错

你可以把它理解成一个挂在桌面的 Codex 小状态栏，只不过外形是一只 QQ 企鹅。

状态对应的宠物动作

下面这张表只看一件事：Codex 进入某个状态时，企鹅会做什么动作。

Codex 状态	头顶状态	宠物会做的动作	当前使用的动作语义
空闲 / 离线 / 没有新事件	待命	安静站着、轻微呼吸、偶尔眨眼	待机 / 眨眼 / 轻呼吸
正在思考	思考	短暂停顿、像在想事情、轻微摆头	停顿思考 / 轻微摆头
正在阅读代码	读码	进入专注查看状态，像在观察和翻阅内容	观察 / 翻阅 / 专注查看
正在修改代码	改码	保持忙碌工作中的状态，持续处理动作更明显	忙碌工作 / 持续处理
正在执行命令	执行	节奏更紧张，像在盯着任务执行结果	紧张等待 / 动作频率更快
等你回复	等你	抬头看向你，保持等待回应的姿态	抬头等待 / 面向用户期待回应
任务完成	完成	出现开心、正反馈、更轻松的动作表现	开心反馈 / 明显正向动作
任务出错	出错	进入异常、发懵、像卡住一样的状态	冰冻 / 异常卡住

当前动作资源倾向

为了让状态和企鹅表现更贴近，现在每种状态会优先使用这一类动作资源：

• 待命：眨眼、痒、心情
• 思考：学习
• 读码：休闲、学习
• 改码：休闲、工作
• 执行：洗澡、工作
• 等你：眨眼、来、招手
• 完成：吃饭、升级、ok
• 出错：生病

补充说明：

• 这里说的“动作”是当前状态下的表现语义，不一定每次都固定播放同一个 swf
• 同一类状态会在候选动作里挑选更接近当前语义的资源
• 出错 目前是最明确的固定映射，直接收敛到 病 这一类异常动作

怎么启动

开发模式

先进入项目目录：

cd Codex_Pet

安装依赖后启动：

npm install
npm start

常用命令：

npm start
npm run dev
npm run dist

其中：

• npm start：正常启动桌宠
• npm run dev：以开发模式启动，方便调试
• npm run dist：打包 Windows 安装包

Codex 联动是怎么工作的

这个桌宠会读取当前机器上的 Codex 本地数据目录，然后推断出桌宠状态和额度信息。

也就是说：

• 如果你的电脑上有 Codex 工作记录，企鹅会动起来并显示真实状态
• 如果没有对应的 Codex 数据，桌宠依然能启动，但通常只会显示待命或缓存状态

当前交互说明

目前这个桌宠的交互重点是“轻量陪伴 + 状态可视化”：

• 企鹅本体显示在桌面上
• 状态标签挂在企鹅头顶
• 气泡和 Codex 额度 面板显示在企鹅下方
• 额度面板默认展开，可手动折叠

适合谁用

如果你符合下面这些情况，这个项目会很好玩：

• 你喜欢 QQ 宠物风格
• 你平时用 Codex 协助写代码
• 你想在桌面边角实时看到 Codex 当前正在干什么
• 你希望状态显示更轻松一点，而不是一直盯着终端或编辑器

致谢

• QQ 宠物相关资源与灵感来源于原始客户端生态
• WinXP 场景部分灵感源自 Github 上 ShizukuIchi 的 winXP 项目
• 同时感谢相关资料整理者与历史资源提供者