源码位置：
src/buddy/编译开关：feature('BUDDY')预计上线：2026 年 4 月
终端里的拓麻歌子！一个完整的虚拟宠物伴侣系统，藏在 Claude Code 的源码里。
共 18 种物种，定义在 src/buddy/types.ts。每种物种都有 3 帧 ASCII 精灵动画（idle / fidget / 特殊），精灵图为 5 行高、12 字符宽。
| 物种 | 英文 | 物种 | 英文 |
|---|---|---|---|
| 🦆 鸭子 | duck | 🐢 乌龟 | turtle |
| 🪿 鹅 | goose | 🐌 蜗牛 | snail |
| 🫧 果冻 | blob | 👻 幽灵 | ghost |
| 🐱 猫 | cat | 🦎 六角恐龙 | axolotl |
| 🐉 龙 | dragon | 🦫 水豚 | capybara |
| 🐙 章鱼 | octopus | 🌵 仙人掌 | cactus |
| 🦉 猫头鹰 | owl | 🤖 机器人 | robot |
| 🐧 企鹅 | penguin | 🐰 兔子 | rabbit |
| 🍄 蘑菇 | mushroom | 🐈 胖猫 | chonk |
有趣的细节：源码中物种名全部用
String.fromCharCode十六进制编码（如c(0x64,0x75,0x63,0x6b)="duck"）。注释说明原因是某个物种名与内部模型代号冲突，会被excluded-strings.txt构建检查拦截，所以全部改用编码绕过。
5 个等级，总权重 100：
| 稀有度 | 概率 | 星级 | 显示颜色 | 属性下限 |
|---|---|---|---|---|
| Common（普通） | 60% | ★ | 灰色 | 5 |
| Uncommon（非凡） | 25% | ★★ | 绿色 | 15 |
| Rare（稀有） | 10% | ★★★ | 蓝色 | 25 |
| Epic（史诗） | 4% | ★★★★ | 紫色 | 35 |
| Legendary（传说） | 1% | ★★★★★ | 金色 | 50 |
- Common 没有帽子，其他稀有度随机分配帽子
- 稀有度越高，属性下限越高
shiny: rng() < 0.01 // companion.ts 第 98 行1% 闪光概率，独立于稀有度。任何物种、任何稀有度都有 1% 概率成为闪光个体。
· ✦ × ◉ @ °
| 帽子 | 英文 | 帽子 | 英文 |
|---|---|---|---|
| 无 | none | 光环 | halo |
| 皇冠 | crown | 巫师帽 | wizard |
| 礼帽 | tophat | 毛线帽 | beanie |
| 螺旋桨帽 | propeller | 小鸭子头饰 | tinyduck |
每人只会得到一只固定的宠物，改配置也没用。
生成流程（src/buddy/companion.ts）：
用户 ID（OAuth accountUuid / userID / 'anon'）
↓
+ 固定盐值 'friend-2026-401'
↓
FNV-1a 哈希（Bun 环境用 Bun.hash）
↓
Mulberry32 伪随机数生成器（确定性 PRNG）
↓
依次抽取：物种 → 眼睛 → 稀有度 → 帽子 → 闪光 → 属性
防作弊设计：只有"灵魂"数据（name, personality, hatchedAt）存入配置文件。"骨架"数据（species, rarity, shiny, eye, hat, stats）每次都从 userId 重新计算，不持久化。你编辑配置文件也改不了稀有度。
每只宠物有 5 项属性：
| 属性 | 说明 |
|---|---|
| DEBUGGING | 调试能力 |
| PATIENCE | 耐心 |
| CHAOS | 混乱值 |
| WISDOM | 智慧 |
| SNARK | 毒舌值 |
生成规则：随机选一个峰值属性和一个最低属性。峰值 = 下限 + 50 + random(0-29)，最低 = max(1, 下限 - 10 + random(0-14))，其余 = 下限 + random(0-39)。
| 命令 | 功能 |
|---|---|
/buddy hatch |
孵化宠物（AI 模型生成名字和性格） |
/buddy pet |
抚摸宠物（2.5 秒爱心上浮动画） |
/buddy card |
查看宠物卡片（精灵图 + 属性 + 稀有度） |
/buddy mute |
静音宠物 |
/buddy unmute |
取消静音 |
- idle 动画：500ms 一帧，按 15 帧序列
[0,0,0,0,1,0,0,0,-1,0,0,2,0,0,0]循环。大部分时间静止，偶尔 fidget，极少眨眼（-1= 把眼睛替换为-） - 被摸/说话时：快速循环所有帧
- 窄终端（<100 列）：退化为一行表情文字脸（如
=·ω·=猫脸、(·>鸭子脸）
宠物会通过气泡说话（companionReaction 状态），气泡显示约 10 秒（20 ticks × 500ms），最后 3 秒渐隐。全屏模式下气泡浮动渲染，非全屏模式下内联在精灵旁边。
当宠物存在且未静音时，会向 Claude 的上下文注入一段提示（src/buddy/prompt.ts），告诉模型旁边有一只小宠物。当用户直接对宠物说话时，Claude 会保持低调（一行或更少的回复），不会模拟宠物。
src/buddy/useBuddyNotification.tsx 中定义了上线计划：
- 2026 年 4 月 1-7 日：预热窗口期，启动时显示 15 秒的彩虹色
/buddy提示 - 2026 年 4 月起：
isBuddyLive返回true，命令永久可用 - 输入框中输入
/buddy会有特殊高亮效果
| 文件 | 职责 |
|---|---|
src/buddy/types.ts |
类型定义、物种/稀有度/眼睛/帽子常量 |
src/buddy/companion.ts |
核心生成逻辑：哈希、PRNG、属性计算 |
src/buddy/sprites.ts |
18 种物种的 ASCII 精灵图（3 帧动画） |
src/buddy/CompanionSprite.tsx |
React 组件：动画、气泡、交互渲染 |
src/buddy/prompt.ts |
AI 上下文注入 |
src/buddy/useBuddyNotification.tsx |
启动预热提示、输入框高亮 |