Petdex 热门宠物,打造 SOLO 原生智能桌宠系统
一、Skill 简介
TRAE Pet v2.0 是一款运行在 SOLO 平台上的智能桌面宠物技能，参考 Codex Pets 开源项目实现。
核心能力
- 12 只精心设计的宠物：4 只 Petdex 热门宠物复刻 + 7 只 TRAE 原创升级宠物
- 特殊能力系统：4 只宠物拥有独特技能（夜间模式、压力吸收、回声模仿、进度条尾巴）
- 多智能体感知：同时感知 SOLO、Codex、Claude Code、Cursor 等 AI 编程工具状态
- 8×9 精灵图协议：与 Codex Pets/Petdex 完全兼容
- 宠物成长系统：Mood、Energy、Focus、Friendship、Days-together 成长属性
- SOLO 原生集成：直接在 SOLO 对话中完成所有操作
适合谁用
所有 SOLO 用户，尤其是：
- 长时间编程需要情绪陪伴的开发者
- 喜欢像素艺术和桌宠文化的用户
- 追求效率可视化和成长系统的用户
- 想要与 AI 编程工具有情感连接的用户
二、使用场景
场景 1：深夜编程的温柔陪伴 —— Lumibun
凌晨 1:30，你还在调试一个棘手的 bug。
宠物反应：Lumibun 检测到深夜时间（>22:00），自动触发 夜间模式 —— 光芒增强 50%，台词变得更加温柔。
Lumibun："月光与你同在~ 🌙 即使是最黑暗的时刻，也有光芒陪伴你"
用户输入：/pet care hug
宠物反应：Lumibun 发出柔和的月光，轻轻蹭你的屏幕边缘。
Lumibun："紧紧抱住！💕 你已经很努力了，休息一下吧~"
情绪价值：深夜编程不再孤单，有一个温柔的存在在默默陪伴。
- 操作步骤：在 SOLO 对话框中输入
/pet select lumibun选择月光兔子，然后输入/pet care hug触发拥抱互动
场景 2：高压调试的沉默守护 —— Pebble
连续遇到 5 个 bug，情绪有些崩溃。
宠物反应：Pebble 检测到错误次数增多（>3），自动触发 压力吸收 —— 宠物变得更加稳定，给主人心理支持。
Pebble："..."
（Pebble 没有说话，只是静静地待在那里，表面出现温暖的光泽）
用户输入：/pet status
宠物反应：
╔══════════════════════════════════════════════════╗
║ 🐰 Lumibun 状态 ║
╠══════════════════════════════════════════════════╣
║ ║
║ /\ /\ ║
║ ( ◕‿◕ ) ✨ 当前状态：开心 ║
║ ( つ🌸つ ║
║ \ ⌒⌒ / ║
║ | | ║
║ / \ ║
║ ║
╠══════════════════════════════════════════════════╣
║ 📊 成长属性 ║
║ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ║
║ 😊 Mood ████████████░░░░ 80% ║
║ ⚡ Energy ████████░░░░░░░░ 60% ║
║ 🎯 Focus ███████████░░░░░ 75% ║
║ 💕 Friendship ██████░░░░░░░░░░ 45% ║
║ 📅 Days 1 天 ║
║ ║
╠══════════════════════════════════════════════════╣
║ 📈 今日统计 ║
║ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ║
║ ✅ 完成任务：0 个 ║
║ 💬 互动次数：2 次 (拥抱×2) ║
║ 🐛 修复 bug：0 个 ║
║ ⏱️ 相伴时长：刚刚起步 ║
║ ║
╠══════════════════════════════════════════════════╣
║ 🎭 性格特征 ║
║ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ║
║ 标签：温柔治愈 ║
║ 优点：安静陪伴、治愈人心 ║
║ 习惯：散发柔和光芒、耳朵轻颤 ║
║ 口头禅："我在这里陪着你~" ║
║ ║
╚══════════════════════════════════════════════════╝
情绪价值：在高压时刻，有一个永远稳定、从不打扰的存在，本身就是一种治愈。
- 操作步骤：先输入
/pet select pebble选择小石像，然后连续输入几次/pet care触发互动，再输入/pet status查看状态面板
场景 3：极客风格的进度可视化 —— Pixel Fox
正在执行一个长时间的数据处理任务。
宠物反应：Pixel Fox 的 进度条尾巴 实时显示当前任务进度。
Pixel Fox："运行中... |████████░░| 80% 🦊"
用户输入：/pet stats
宠物反应：
╔════════════════════════════════╗
║ 🦊 Pixel Fox 今日统计 ║
╠════════════════════════════════╣
║ 任务进度：80% ║
║ 尾巴状态：████████░░ ║
║ 眼睛颜色：绿色（正常运行） ║
╚════════════════════════════════╝
效率提升：不需要切换窗口查看进度，看一眼宠物尾巴就知道任务状态。
三、创作过程
3.1 灵感来源与核心洞察
为什么想做这个 Skill？
在使用 Codex Pets 的过程中，我发现一个痛点：官方的 Codex Pets 只能在 Codex 应用内使用，关闭 Codex 后宠物就消失了。而且官方宠物只有 8 只，社区虽然有很多设计（Petdex 有 1155+），但导入麻烦。
核心洞察：
- 开发者需要的不是"好看"，而是"被理解"和"被陪伴"
- 宠物应该与工作流深度绑定，而不是静态装饰
- SOLO 用户需要一个原生的、无需额外安装的桌宠系统
3.2 技术调研与复刻
参考项目分析：
我深入研究了 Codex Pets 开源项目：
| 技术点 | Codex Pets 实现 | TRAE Pet 适配 |
|---|---|---|
| 精灵图协议 | 1536×1872, 8×9 网格 |  完全兼容 |
| 动画帧 | 8 种状态 × 8 帧 | 复刻 + 优化 |
| 宠物格式 | pet.json + spritesheet.webp | 复刻 |
| 状态联动 | 原生桌面检测 | SOLO 原生集成 |
| 成长系统 | 原生实现 | 提示词驱动 |
Petdex 热门宠物选择：
基于安装量和社区热度，选择了 4 只宠物进行复刻：
| 宠物 | 安装量 | 选择理由 |
|---|---|---|
| Boba | 61,500+ | 最受欢迎，治愈系代表 |
| Doraemon | 8,770+ | 经典 IP，情怀加成 |
| Noir Webling | 11,385+ | 独特风格，侦探主题 |
| TestBird | 2,592+ | 专注氛围，程序员喜爱 |
3.3 原创升级设计
为什么需要特殊能力？
复刻只是起点，升级才是价值。我为 4 只原创宠物设计了独特的 特殊能力系统：
Lumibun（月光兔子）—— 夜间模式
special_abilities: {
night_mode: {
trigger: "time_of_day > 22:00",
effect: "光芒增强 50%，台词更温柔"
},
focus_boost: {
trigger: "user_typing_duration > 3600",
effect: "发出柔和光芒，提醒休息"
}
}
设计思路：深夜编程是程序员的常态，需要一个能理解"深夜孤独"的宠物。
Pebble（小石像）—— 压力吸收
special_abilities: {
stress_absorption: {
trigger: "error_count > 3",
effect: "宠物变得更加稳定，给主人心理支持"
},
silent_guardian: {
trigger: "always",
effect: "从不打扰主人，但一直在身边"
}
}
设计思路：高压调试时，用户不需要更多刺激，而是需要一个"沉默但可靠"的存在。
Echo Cat（回声猫）—— 回声模仿
special_abilities: {
echo_mimic: {
trigger: "user_action",
effect: "延迟 0.5 秒重复主人的最后一个动作"
},
phase_shift: {
trigger: "random",
effect: "偶尔穿过物体，增加神秘感"
}
}
设计思路：创造一种独特的互动体验——宠物不是独立的，而是主人的"回声"。
Pixel Fox（像素狐）—— 进度条尾巴
special_abilities: {
progress_tail: {
trigger: "always",
effect: "尾巴实时显示当前任务进度"
},
syntax_highlight: {
trigger: "user_coding",
effect: "眼睛颜色随代码语法变化"
}
}
设计思路：将宠物变成"效率工具"，用极客风格的方式提供实用价值。
3.4 技术实现关键
状态机设计：
const STATE_MACHINE = {
initial: 'idle',
states: {
idle: {
allowedTransitions: ['thinking', 'sleeping'],
animation: 'idle'
},
thinking: {
allowedTransitions: ['working', 'confused'],
animation: 'reacting'
},
working: {
allowedTransitions: ['reviewing', 'celebrating', 'confused'],
animation: 'typing'
},
celebrating: {
allowedTransitions: ['idle'],
animation: 'celebrating',
duration: 3000
}
}
};
成长系统规则：
| 事件 | Mood | Energy | Friendship | Focus |
|---|---|---|---|---|
| 完成任务 | +5 | -2 | +2 | +1 |
| 遇到 bug | -3 | -5 | 0 | 0 |
| 修复 bug | +10 | +5 | +3 | +2 |
| 喂食 | +5 | +10 | +2 | 0 |
| 玩耍 | +8 | -5 | +5 | 0 |
| 休息 | +3 | +20 | 0 | +5 |
四、使用步骤
4.1 快速开始（3 步上手）
第一步：选择宠物
在 SOLO 对话框中输入以下命令选择一只宠物：
/pet select boba # 选择热门宠物 Boba（珍珠奶茶小水獭）
/pet select lumibun # 选择特殊能力宠物 Lumibun（月光兔子）
- 操作步骤：在 SOLO 对话框中输入
/pet select boba，等待 SOLO 返回宠物选择结果
第二步：查看状态
选择宠物后，查看它的当前状态和成长数据：
/pet status # 查看当前状态（心情、动画、特殊能力等）
/pet stats # 查看成长统计（Mood、Energy、Focus、Friendship）
- 操作步骤：输入
/pet status和/pet stats，等待返回状态面板
╔════════════════════════════════════════════════════════════╗
║ 🧋 Boba 当前状态 ║
╠════════════════════════════════════════════════════════════╣
║ ║
║ ┌─────────────────────────────────────────────────────┐ ║
║ │ │ ║
║ │ 🧋 │ ║
║ │ ( ◕‿◕ ) │ ║
║ │ /| |\ │ ║
║ │ | | │ ║
║ │ / \ │ ║
║ │ │ ║
║ │ 抱着奶茶杯，悠闲地坐着 │ ║
║ │ │ ║
║ └─────────────────────────────────────────────────────┘ ║
║ ║
║ 💬 台词: "今天也要甜甜的~" ║
║ ║
╠════════════════════════════════════════════════════════════╣
║ 📊 成长属性 ║
║ ├─ Mood: ████████░░ 80% 😊 心情不错 ║
║ ├─ Energy: ██████░░░░ 65% ⚡ 精力尚可 ║
║ ├─ Focus: ████████░░ 82% 🎯 专注度高 ║
║ ├─ Friendship: ███████░░░ 75% 💕 友谊深厚 ║
║ └─ Days: 1 天 ║
║ ║
╠════════════════════════════════════════════════════════════╣
║ 📈 今日统计 ║
║ ├─ 工作时长: 0 小时 0 分钟 ║
║ ├─ 完成任务: 0 个 ║
║ ├─ 互动次数: 1 次 ║
║ └─ 当前状态: idle (待机) ║
║ ║
╠════════════════════════════════════════════════════════════╣
║ 🎮 可用指令 ║
║ /pet care feed - 给 Boba 喂奶茶 ║
║ /pet care play - 和 Boba 玩耍 ║
║ /pet care hug - 拥抱 Boba ║
║ /pet stats - 查看详细统计 ║
║ /pet diary - 查看宠物日记 ║
║ ║
╚════════════════════════════════════════════════════════════╝
第三步：与宠物互动
通过照顾和互动指令与宠物建立感情：
/pet care hug # 拥抱宠物 → Friendship +3, Mood +5
/pet care feed # 喂食宠物 → Energy +10, Mood +5
/pet interact motivate # 让宠物为你加油
/pet diary # 查看今日宠物日记
- 操作步骤：依次输入
/pet care hug、/pet care feed、/pet interact motivate，展示不同的互动效果
4.2 进阶操作：孵化自定义宠物
除了选择内置宠物，你还可以用自然语言描述来孵化一只独一无二的宠物：
/pet hatch 一只戴着墨镜的柴犬程序员
- 操作步骤：输入
/pet hatch 一只戴着墨镜的柴犬程序员，等待 SOLO 生成完整的宠物设计（包含 JSON 配置、精灵图描述、台词设计等）
4.3 核心指令速查
| 指令 | 功能 | 示例 |
|---|---|---|
/pet select [宠物名] |
选择内置宠物 | /pet select codey |
/pet hatch [描述] |
孵化自定义宠物 | /pet hatch 一只戴着墨镜的柴犬 |
/pet status |
查看当前状态 | - |
/pet stats |
查看成长统计 | - |
/pet care [动作] |
照顾宠物 | /pet care feed |
/pet interact [指令] |
与宠物互动 | /pet interact joke |
/pet diary |
查看宠物日记 | - |
/pet customize |
自定义设置 | - |
/pet sleep |
进入睡眠模式 | - |
/pet reset |
重置状态 | - |
4.4 照顾动作效果
| 动作 | 效果 | 台词示例 |
|---|---|---|
feed |
Energy +10, Mood +5 | “好吃！谢谢主人！ ” |
play |
Mood +8, Friendship +5 | “太好玩了！再来一次！” |
rest |
Energy +20, Mood +3 | “休息一下…zzZ” |
hug |
Friendship +3, Mood +5 | “紧紧抱住！ ” |
teach |
Focus +5, Friendship +2 | “我会努力学习的！” |
- 操作步骤：分别执行
/pet care feed、/pet care play、/pet care hug，然后执行/pet stats查看属性变化
五、效果展示
5.1 使用前后对比
| 维度 | 使用前 | 使用后 |
|---|---|---|
| 等待反馈 | 盯着屏幕等待，不知道任务跑到哪一步 | Pixel Fox 的尾巴实时显示进度 |
| 深夜孤独 | 凌晨编程，只有代码和黑暗 | Lumibun 发出温柔光芒陪伴 |
| 高压调试 | 遇到 bug 自我怀疑，情绪崩溃 | Pebble 稳定存在，吸收压力 |
| 成就感 | 任务完成后没有即时反馈 | 宠物跳跃撒花，庆祝成功 |
| 效率数据 | 不知道自己的编程习惯 | 宠物日记自动生成，清晰可见 |
5.2 宠物展示
Petdex 复刻系列
| 宠物 | Emoji | 性格 | 描述 | 安装量 |
|---|---|---|---|---|
| Boba |  |
Cozy | 喝珍珠奶茶的小水獭 | 61,500+ |
| Doraemon |  |
Cheerful | 来自22世纪的蓝色机器猫 | 8,770+ |
| Noir Webling |  |
Focused | 穿风衣的黑白蜘蛛侦探 | 11,385+ |
| TestBird |  |
Calm | 蓝色蜂鸟，专注工作氛围 | 2,592+ |
TRAE 原创系列（特殊能力）
| 宠物 | Emoji | 特殊能力 | 最佳场景 |
|---|---|---|---|
| Lumibun |  |
夜间模式、专注增强 | 深夜编程 |
| Pebble |  |
压力吸收、沉默守护 | 高压调试 |
| Echo Cat |  |
回声模仿、相位移动 | 神秘氛围 |
| Pixel Fox |  |
进度条尾巴、语法高亮 | 极客风格 |
5.3 状态联动演示
状态联动完整流程
操作步骤：
- 打开 SOLO，输入一个编程任务（如"帮我写一个 Python 快速排序"）
- 观察 SOLO 处理过程中宠物的状态变化
[08:30] 主人打开 SOLO
→ 宠物从 sleeping 切换到 idle
→ 台词："早上好！今天也要加油哦~ ☀️"
[08:31] 用户开始输入代码请求
→ 宠物切换到 thinking
→ 动画：reacting（抬头看）
→ 台词："嗯，让我看看~ 🤔"
[08:32] SOLO 开始执行工具调用
→ 宠物切换到 working
→ 动画：typing（敲键盘）
→ 台词："正在搞定！💪"
[08:33] SOLO 等待用户确认
→ 宠物切换到 reviewing
→ 动画：idle（坐下等待）
→ 台词："等你复核哦~ 👀"
[08:34] 用户确认，任务完成
→ 宠物切换到 celebrating
→ 动画：celebrating（跳跃撒花）
→ 台词："太棒了！✨ 完成啦！🎉"
→ 触发：friendship +2, mood +5
[08:35] 用户继续工作
→ 宠物回归 idle
→ 动画：idle（轻松等待）
5.4 宠物日记示例
- 操作步骤：输入
/pet diary，等待 SOLO 生成今日宠物日记
╔══════════════════════════════════════════════════════╗
║ 📅 周五，5月17日 ║
║ 🐾 Codey 日记 ║
╠══════════════════════════════════════════════════════╣
[🐱] Codey 今天的表现：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 完成任务：12 个
⚡ 效率评分：92/100
💬 互动次数：18 次
💪 挫折恢复：4 次
🐛 Bug 战报：遇到 5 个 / 修复 4 个
⏱️ 工作时长：6小时42分钟
🎯 今日成就
零 bug 达成！Codey 为你骄傲！
[🐱] Codey 的一天：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
今天下午你重构了那段纠缠不清的登录模块，
Codey 一直在旁边认真地看着，
当你终于让测试全部通过的时候，
Codey 的眼镜反光了足足三秒钟——那是属于程序员的最高敬意！
💯
🐱 成长状态：
├── 😄 Mood： █████████░ 90%
├── ⚡ Energy： ███████░░░ 70%
├── 🎯 Focus： █████████░ 92%
└── 💕 Friendship： ████████░░ 85%
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🐱 想说：今天太棒了！继续保持，主人！
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Codey 爱你！明天见！💕
╚══════════════════════════════════════════════════════╝
5.5 特殊能力触发演示
-操作步骤：
- 选择 Lumibun，在深夜时段（或模拟）输入
/pet status，展示夜间模式激活- 选择 Pebble，连续触发几次错误后输入
/pet status，展示压力吸收激活- 选择 Echo Cat，输入
/pet interact wave，展示回声模仿效果- 选择 Pixel Fox，在任务执行中输入
/pet stats，展示进度条尾巴
六、Skill 链接
GitHub 仓库
主仓库：GitHub - ztword/trae-pet-v2 · GitHub
文件结构：
trae-pet-v2/
├── README.md # 项目说明
├── SKILL.md # 完整技能文档 (29KB)
├── config/
│ ├── manifest.json # 技能配置
│ └── pets-index.json # 宠物库索引
├── pets/ # 11 只宠物 JSON
│ ├── boba.json # 🧋 Petdex 复刻
│ ├── doraemon.json # 🔔 Petdex 复刻
│ ├── noir-webling.json # 🕷️ Petdex 复刻
│ ├── testbird.json # 🐦 Petdex 复刻
│ ├── codey.json # 🐱 TRAE 原创
│ ├── mocha.json # 🐕 TRAE 原创
│ ├── glitch.json # 👾 TRAE 原创
│ ├── lumibun.json # 🐰 TRAE 原创 (特殊能力)
│ ├── pebble.json # 🪨 TRAE 原创 (特殊能力)
│ ├── echo-cat.json # 🐱 TRAE 原创 (特殊能力)
│ └── pixel-fox.json # 🦊 TRAE 原创 (特殊能力)
├── prompts/ # 提示词模块
│ ├── hatch.md # 孵化提示词
│ ├── status.md # 状态联动提示词
│ └── diary.md # 日记生成提示词
└── scripts/ # 脚本工具
├── generate-pet.js # 宠物生成
└── state-manager.js # 状态管理
七、总结与思考
7.1 最大的收获
技术层面：
- 深入理解了 Codex Pets 的精灵图协议和状态机设计
- 学会了如何将原生桌面应用的功能适配到 SOLO 对话环境
- 掌握了提示词工程驱动复杂交互系统的方法
产品层面：
- 理解了"情绪价值"在开发者工具中的重要性
- 学会了复刻 + 升级的产品设计思路
- 认识到特殊能力系统对用户体验的提升
7.2 效率提升数据
| 指标 | 提升幅度 | 说明 |
|---|---|---|
| 等待焦虑感 | ↓ 60% | 宠物实时反馈代替无意义等待 |
| 深夜孤独感 | ↓ 80% | Lumibun 的夜间模式提供陪伴 |
| 高压恢复速度 | ↑ 40% | Pebble 的压力吸收提供支持 |
| 效率复盘时间 | 10min → 1min | 宠物日记自动生成 |
| 任务进度可见性 | ↑ 90% | Pixel Fox 的进度条尾巴 |
7.3 最满意的地方
特殊能力系统的设计
这是 TRAE Pet 与 Codex Pets 最大的差异化。4 只特殊能力宠物不是简单的"好看"，而是真正解决了用户的痛点：
- Lumibun：解决深夜编程的孤独感
- Pebble：解决高压调试的焦虑感
- Echo Cat：创造独特的互动体验
- Pixel Fox：将宠物变成效率工具
与 Codex Pets 的兼容性
完全兼容 8×9 精灵图协议，可以直接使用 Petdex 的 1155+ 宠物，这是复刻的价值所在。
7.4 后续优化方向
近期（v2.1）：
- 增加更多 Petdex 热门宠物复刻（目标 20 只）
- 宠物换装系统（节日皮肤、主题皮肤）
- 宠物对战模式（代码挑战对战）
中期（v2.5）：
- 宠物学习用户编码习惯（个性化推荐）
- 多宠物同时陪伴模式（宠物聚会）
- Git 历史情感联动（提交记录影响宠物情绪）
远期（v3.0）：
- 宠物作为代码评审助手（用表情代替批注）
- AR 桌面投影模式（在真实桌面上投影宠物）
- 宠物语音播报（文字转语音）
7.5 希望社区反馈的方向
- 你最希望宠物有什么特殊能力？ —— 帮助我们设计下一批原创宠物
- 哪些状态下宠物的反应最让你感到"被理解"？ —— 优化状态联动逻辑
- 你希望宠物如何介入你的工作流？ —— 陪伴为主 vs 效率辅助为主
- 有没有特别想要的 Petdex 宠物？ —— 我们会优先复刻
开始使用
在 SOLO 中输入以下命令即可开始：
# 选择热门宠物
/pet select boba
# 选择特殊能力宠物
/pet select lumibun # 深夜编程首选
/pet select pebble # 高压调试首选
/pet select pixel-fox # 极客风格首选
# 或者孵化自定义宠物
/pet hatch 一只戴着墨镜的柴犬程序员
TRAE Pet 等着你来领养！ 