BUDDY 🐙 宠物伴侣系统

概述

BUDDY 是一个拓麻歌子风格的虚拟宠物系统，为 AI 编程体验增添陪伴感和趣味性。完整参考 Claude Code src/buddy/ 实现。

命令列表

执行方式

cd /root/.openclaw/skills/buddy
bun scripts/buddy.ts <command> <userId>

宠物生成机制

物种系统（18种）

完整 ASCII 精灵图，5行×12字符，3帧动画（idle/fidget/special）

稀有度（5级）

闪光系统

1% 概率，独立于稀有度

五维属性

功能特性

气泡对话

宠物通过气泡说话：

  ┌──────────────────┐
  │   咕噜咕噜~      │
  │   好舒服！        │
  └──────────────────┘

AI 上下文注入

当宠物存在且未静音时，可注入提示到 AI 上下文：

• 告知宠物在旁边
• 用户直接对宠物说话时，AI 保持简短回复
• AI 不会模拟宠物说话

静音功能

• mute - 宠物不再显示气泡对话
• unmute - 恢复宠物互动

交互示例

/buddy hatch - 孵化宠物

🎉 恭喜！你获得了一只新宠物！
   🐙 小墨 - ★★★★★

   ▄▄▄▄▄▄   
  (·◉·)    
 >( ═══ )< 
  ══════   
    UU   

/buddy pet - 抚摸宠物

   🐙   
  (·◉·)  
 >( ═══ )<
  ══════ 
    UU   

  ✨ +1  爱心    ✨ +1  爱心    ✨ +1  爱心
     ↑           ↑           ↑
    0.5s        1.0s        1.5s

  ┌──────────────────┐
  │   咕噜咕噜~      │
  │   好舒服！        │
  └──────────────────┘

小墨发出了满足的咕噜声~ 🐙✨

/buddy card - 查看卡片

╔══════════════════════════════════════════╗
║         🐙 BUDDY PET CARD 🐙           ║
╠══════════════════════════════════════════╣
║  Name:     小墨                          ║
║  Species:  octopus                       ║
║  Rarity:   ★★★★★                       ║
║  Shiny:    ✨ YES ✨                    ║
║  Personality: 聪明、好奇、有点傲娇         ║
╠══════════════════════════════════════════╣
║           📊 FIVE STATS                 ║
║  DEBUGGING: 150                   ║
║  PATIENCE:  150                   ║
║  CHAOS:     150                   ║
║  WISDOM:    150                   ║
║  SNARK:     150                   ║
╚══════════════════════════════════════════╝

文件结构

buddy/
├── SKILL.md              # 本文件
├── scripts/
│   └── buddy.ts         # 主执行脚本
└── references/
    └── buddy/           # 核心模块
        ├── types.ts      # 类型定义
        ├── companion.ts  # 生成逻辑
        ├── sprites.ts    # 18物种 ASCII 精灵
        └── index.ts     # 导出

技术细节

• 确定性生成：userId + salt → FNV-1a 哈希 → Mulberry32 PRNG
• 防作弊：只有灵魂数据（name, personality, hatchedAt）持久化，骨架数据每次重新计算
• 动画：15帧序列 [0,0,0,0,1,0,0,0,-1,0,0,2,0,0,0]
• 0 = idle
• 1 = fidget
• -1 = idle with blink (眼睛替换为 -)
• 2 = special

调用时机

当用户请求：

• "摸摸我的宠物"
• "查看宠物状态"
• "孵化新宠物"
• "/buddy pet"
• "/buddy card"
• "/buddy hatch"
• "/buddy mute" / "/buddy unmute"
• 任何与 BUDDY、小墨、宠物相关的问题