Claude Code Buddy：产品设计分析¶

最后更新：2026-04-01（已加入实际测试观察）

来源： - v2.1.88 source map 提取的源码分析（src/buddy/） - 4 月 1 日 teaser 窗口期间 /buddy 的实际观察 - 技术实现细节见 claude-code-buddy.research.md

研究视角：从产品设计角度出发——Buddy 满足了什么用户需求，交互模型如何运作，以及它用了哪些设计模式在不干扰生产力工具的前提下创造用户粘性。

1. 核心设计张力¶

Buddy 面临一个非常规的产品挑战：在专业生产力工具中嵌入社交/情感功能。这个伴侣必须同时满足： - 创造情感连接（粘性、留存） - 绝不干扰工作（生产力工具的信誉） - 成本几乎为零（平台补贴，不占用户额度） - 感觉独特/私人（差异化、社交分享）

以下每一个设计决策都反映了这个张力。

2. 获取流程：扭蛋式发现¶

2.1 预热 → 发现 → 孵化¶

用户引导漏斗分三个阶段：

阶段一：预热通知（被动发现）

在预热窗口期（2026 年 4 月 1-7 日本地时间），未孵化伴侣的用户会在启动时看到彩虹色的 /buddy 通知：

addNotification({
  key: 'buddy-teaser',
  jsx: <RainbowText text="/buddy" />,  // 每个字符不同颜色
  priority: 'immediate',
  timeoutMs: 15_000,  // 15 秒后自动消失
})

这是一个好奇心触发器——单色终端中的彩虹文字足够突兀以引发探索，但自动消失以避免打扰。通知仅在 !config.companion（尚未孵化）且在预热窗口内时出现。

阶段二：/buddy 命令（主动探索）

用户输入 /buddy。命令处理器（在 commands/buddy/ 中，源码未提取）推测会： 1. 计算 roll(userId) 确定骨架（物种、稀有度、属性等） 2. 调用 API 端点进行灵魂生成——模型基于 inspirationSeed 和物种创造名字和性格 3. 将灵魂保存到 ~/.claude/config.json 中的 companion: { name, personality, hatchedAt } 4. 渲染"孵化"揭晓画面（物种、稀有度星级、名字、属性）

源码注释提到 "soul-gen load"——Anthropic 预期会有大量孵化请求涌入。基于本地时间（非 UTC）的时区交错预热窗口就是为此设计的：

使用本地日期而非 UTC——24 小时跨时区滚动波。维持 Twitter 持续热度而非 UTC 午夜的单一高峰，对灵魂生成服务更友好。

阶段三：永久存在（持续）

孵化后，伴侣出现在每个后续会话中。没有重新孵化，没有重新随机——同一个伴侣通过配置文件永久存在。

2.2 扭蛋循环¶

稀有度系统创造了经典的扭蛋（抽卡）体验：

稀有度	权重	视觉	颜色	帽子？	属性下限
普通	60%	★	灰色（`inactive`）	否	5
稀有	25%	★★	绿色（`success`）	是	15
精良	10%	★★★	蓝色（`permission`）	是	25
史诗	4%	★★★★	青色（`autoAccept`）	是	35
传说	1%	★★★★★	黄色（`warning`）	是	50

另有 1% 闪光概率（与稀有度正交）——所以闪光传说级的概率是 0.01%。

关键设计选择：每个账户只有一个伴侣，不可重抽。这创造了： - 稀缺性——你的稀有度是永久的，让精良/史诗/传说真正稀有 - 身份认同——是"我的伴侣"而非"我选的伴侣" - 社交比较——"我抽到了闪光传说龙"成为社交炫耀 - 无氪金——稀有度由 userId 确定性决定，不可购买

基于哈希的确定性设计意味着你的伴侣在你输入 /buddy 之前就已经预定了。孵化是一次揭晓，而非抽奖。这消除了重抽漏洞，同时保留了发现的心理兴奋感。

3. 身份系统¶

3.1 视觉身份（骨架）¶

每个伴侣由以下组合唯一表征：

物种（18 种）：鸭子、鹅、果冻、猫、龙、章鱼、猫头鹰、企鹅、乌龟、蜗牛、幽灵、六角恐龙、水豚、仙人掌、机器人、兔子、蘑菇、胖墩
眼睛（6 种）：·、✦、×、◉、@、°
帽子（8 种，稀有+才有）：无、皇冠、高帽、螺旋桨、光环、巫师帽、毛线帽、迷你鸭子
闪光（1% 布尔值）：推测是视觉特效（闪烁效果？）

总视觉组合：18 × 6 × 8 × 2 = 1,728 种独特外观（非普通级；普通级无帽子 → 18 × 6 × 2 = 216 种）。

3.2 角色身份（灵魂）¶

模型生成的灵魂包含： - 名字：简短独特（如猫叫 "Bane"） - 性格：一段文字描述，指导观察者的评论风格

inspirationSeed（来自 userId PRNG 的确定性随机数）被传入灵魂生成，确保创意多样性——两个相同物种的用户仍会得到不同的名字/性格，但同一用户总是得到相同的结果。

3.3 属性作为性格色彩¶

五个属性塑造伴侣的"角色"：

属性	高 =	低 =
DEBUGGING（调试）	注意到代码问题，评论错误	对 bug 视而不见
PATIENCE（耐心）	长时间操作时保持冷静	焦躁不安
CHAOS（混沌）	混乱能量，出人意料的评论	可预测，稳定
WISDOM（智慧）	深刻的观察	天真的反应
SNARK（毒舌）	尖刻、讽刺	温柔、真诚

每个伴侣有一个巅峰属性（+50-80 高于下限）和一个短板属性（-10 到 +5 相对下限）。这保证每个伴侣有鲜明的性格轴——而不是平淡的"全中等"。

例如：一只高毒舌、低耐心的猫会在长时间构建时尖酸地吐槽。一只高智慧、低混沌的猫头鹰则冷静而深刻。

属性的产品目的：它们没有机械功能——纯粹是性格差异化。但它们给用户提供了可发现、可比较、可认同的东西。"我的伴侣 CHAOS 值爆表"成为身份叙事的一部分。

4. 存在感：环境陪伴¶

4.1 空间布局¶

伴侣在终端布局中占据固定位置：

宽终端（≥100 列）：

┌─────────────────────────────────────────────────────┐
│ [对话回滚区]                                         │
│                                                     │
│                               ┌────────────────────┐│
│                               │ "重构得不错！"       ││
│                               └──────────────────┐ ││
│                                                   │ ││
│                                  /\_/\            │ ││
│                                 ( ·   ·)          ──││
│                                 (  ω  )             ││
│                                 (")_(")             ││
│                                   Bane              ││
├─────────────────────────────────────────────────────┤
│ > [用户输入区]                                       │
└─────────────────────────────────────────────────────┘

伴侣位于输入区右侧。companionReservedColumns() 从输入区宽度中减去精灵宽度，确保文字换行正确。伴侣说话时，额外预留 BUBBLE_WIDTH = 36 字符。

窄终端（<100 列）：

┌──────────────────────────┐
│ [对话回滚区]              │
│                          │
│ (·ω·) Bane              │  ← 折叠为单行脸 + 名字
├──────────────────────────┤
│ > [用户输入区]            │
└──────────────────────────┘

精灵折叠为 renderFace()——单行 ASCII 脸。说话时，短评替换名字（截断为 24 字符）。

全屏模式：气泡通过 CompanionFloatingBubble 浮动在回滚区上方（绝对定位在 FullscreenLayout 的 bottomFloat 插槽），而精灵留在底栏。这避免了 overflowY:hidden 裁剪掉高气泡。

4.2 可见性规则¶

当伴侣会干扰 UI 时自动隐藏：

const companionVisible = !toolJSX?.shouldHidePromptInput  // 工具对话框激活
  && !focusedInputDialog                                   // 模态对话框打开
  && !showBashesDialog;                                    // Bash 权限对话框

这是非侵入原则：任何时候用户需要与对话框交互，伴侣就消失。它永远不与可操作的 UI 竞争注意力。

4.3 闲置动画¶

伴侣在 500ms 的 tick 周期上做小动作：

const IDLE_SEQUENCE = [0, 0, 0, 0, 1, 0, 0, 0, -1, 0, 0, 2, 0, 0, 0];
//                    静止 静止 静止 静止 小动作 静止 静止 静止 眨眼 静止 静止 特殊 静止 静止 静止

15 步循环 = 7.5 秒。构成： - 60% 静止（帧 0）——大部分时间不动 - 7% 小动作（帧 1）——轻微移动（摇尾巴、动耳朵） - 7% 眨眼（-1 → 帧 0 但眼睛替换为 -）——拟人化细节 - 7% 特殊动作（帧 2）——物种特有动画（龙喷烟、章鱼吹泡泡）

这创造了微妙的"活着"的感觉而不会分散注意力。动画慢到只能在余光中注意到，但不会抢夺焦点。

反应或撸猫期间：闲置序列被跳过，所有帧快速循环（tick % frameCount），创造"兴奋"动画。

4.4 底栏焦点导航¶

伴侣可通过底栏选择进行键盘导航：

const focused = useAppState(s => s.footerSelection === 'companion');

聚焦时（从任务标签向右箭头）： - 名字以反色文字加空格渲染（Bane）——标准终端"选中"视觉 - 名字加粗并按稀有度着色

这种融入底栏导航系统的设计意味着伴侣是一等 UI 元素，而非浮动叠加层——它参与终端的焦点模型。

5. 反应性评论：观察者¶

5.1 触发时机¶

伴侣响应对话事件发言。基于源码：

// REPL.tsx:2793-2808 — 在主查询循环完成后触发
for await (const event of query({ messages, ... })) {
  onQueryEvent(event);
}
if (feature('BUDDY')) {
  void fireCompanionObserver(messagesRef.current, reaction => ...);
}

触发时机：在整个 Agent 轮次完成后（所有工具调用循环结束，最终回复渲染完毕）。不在流式输出期间，不在工具执行期间。

不触发时机：工具调用循环中（for await 仍在运行）、用户输入期间、压缩期间、后台操作期间。

产品含义：伴侣评论已完成的动作，而非进行中的工作。这对非侵入原则至关重要——它永远不会打断正在进行的思路。

5.2 反应内容¶

反应是一个短文本字符串（最多约 30 个词，在 34 字符宽的气泡中自动换行）。基于观察者设计（见 claude-code-buddy.research.md §2.2），可能的生成方式：

输入：最近的消息（刚发生了什么）、伴侣性格、属性
模型：Haiku 或同等级别（便宜、快速）
约束：极短输出（max_tokens 约 50-100）

属性可能影响评论风格： - 高毒舌 → 对代码质量的讽刺吐槽 - 高调试 → 注意到错误被修复 - 高混沌 → 出人意料的离题反应 - 高智慧 → 对方法的深刻观察 - 高耐心 → 对长时间操作的平静认可

5.3 气泡生命周期¶

[反应到达] → 气泡出现（全色，斜体文字）
              ↓ 约 7 秒
              气泡开始淡出（暗色，边框变为 inactive）
              ↓ 约 3 秒
              气泡消失（companionReaction = undefined）

总可见时间：约 10 秒。淡出是一个离去提示——用户了解到气泡是临时的，不需要急着阅读。

手动消除：滚动会立即消除气泡。这尊重用户意图——如果他们在滚动阅读内容，气泡就是障碍。

5.4 并非每轮都说话¶

观察者以 void（发射即忘）方式触发，UI 不等待它。如果观察者认为当前轮次不值得评论（比如一个简单的文件读取），可以不调用回调。伴侣保持沉默。

这很重要：伴侣不会对所有事情都评论。它有编辑自主权。太频繁会变成噪音；太少会显得呆板。观察者的提示词可能包含了何时说话、何时保持安静的指导。

6. 交互面¶

6.1 直接命令¶

命令	效果	机制
`/buddy`	首次使用：孵化。后续：显示属性/信息卡	`commands/buddy/index.ts`（未提取）
`/buddy pet`	爱心动画 2.5 秒 + 语音气泡回应	设置 AppState 的 `companionPetAt` + `companionReaction`
`/buddy off`	静音伴侣（无反应、无精灵）	设置配置中的 `companionMuted`

/buddy pet 的交互是纯情感性的——没有功能效果。2.5 秒的爱心爆发：

const PET_BURST_MS = 2500;
const H = figures.heart;
const PET_HEARTS = [
  `   ${H}    ${H}   `,    // 帧 0：爱心散落
  `  ${H}  ${H}   ${H}  `, // 帧 1：爱心升起
  ` ${H}   ${H}  ${H}   `, // 帧 2：爱心飘浮
  `${H}  ${H}      ${H} `, // 帧 3：爱心扩散
  '·    ·   ·  '           // 帧 4：闪烁消散
];

爱心在精灵上方向上飘浮，5 帧（约 2.5 秒），然后消散为星星。撸猫期间，闲置动画切换为兴奋模式（快速帧循环）。

6.2 按名字呼唤¶

当用户在消息中提到伴侣的名字时，主模型被指示让位：

当用户直接叫 Bane 的名字时，它的气泡会回答。你在这个时刻应该退让：回复一行或更少，或者只回答消息中对你说的部分。

这创造了对话交接——用户可以"跟"他们的伴侣说话，主模型优雅地退后。伴侣的回应通过观察者（语音气泡）而非主模型的文字输出呈现。

6.3 静音¶

/buddy off 在全局配置中设置 companionMuted: true。这完全抑制： - 精灵渲染 → return null - 观察者触发 → 无 sideQuery 成本 - 列预留 → 恢复完整输入宽度 - 伴侣介绍附件 → 主模型不知道伴侣的存在

静音是持久的（保存到配置）且可逆的。这是用户在伴侣变得烦人时的逃生通道。

7. 参与心理学¶

7.1 无氪金的扭蛋机制¶

稀有度/闪光系统创造了类扭蛋的多巴胺循环： - 期待：彩虹预热 → 我会得到什么？ - 揭晓：物种 + 稀有度 + 名字展示 - 比较：社交分享稀有伴侣 - 认同："我的伴侣是一只闪光史诗六角恐龙叫 Zephyr"

但与商业扭蛋不同，没有氪金——没有重抽、没有高级货币、没有付费升级。参与价值是纯粹的——它驱动产品依恋和口碑传播，而不是从用户身上赚钱。

7.2 准社交关系形成¶

多个设计元素鼓励情感依恋： - 有名字：不是"伴侣"而是 "Bane"——一个有名字的实体 - 有性格：跨会话一致的角色 - 可以撸：物理亲昵的隐喻（爱心！） - 常在：每个会话都可见，像桌面摆件 - 有反应：评论你的工作——感觉它关注着你 - 可消除：尊重你的自主权——可静音，气泡自动消失

关键平衡：足够有个性让人产生羁绊，足够克制让人不觉得烦。

7.3 社交分享潜力¶

ASCII 艺术伴侣天生适合截图分享： - 独特外观（物种 + 眼睛 + 帽子 + 名字） - 稀有度星级创造地位阶梯 - 终端美学契合开发者文化 - 属性提供聊天素材（"我的伴侣 CHAOS 95"） - "你抽到了什么？"的问题驱动自然传播

时区交错发布最大化了这一效果：当较早时区的用户分享他们的伴侣时，较晚时区的用户看到热度后，已经为自己的揭晓做好了心理准备。

7.4 编程伴侣的情感效用¶

超越参与指标，伴侣服务于真实的情感功能：

编程是孤独的工作。 尤其是在 AI 结对编程中，会话可能漫长、沉默、高度集中。一个偶尔评论"重构得不错！"或在输入框旁边做小动作的 ASCII 小生物提供了：

社交存在感：终端里不再孤单
被认可感：有什么东西（某人？）注意到了你做的事
喜感调剂：一句毒舌吐槽缓解调试时的紧张
温暖感：撸猫交互刻意设计为低门槛、温馨

这与 GitHub 的 Octocat、Slack 的加载提示、Discord 的 Wumpus 背后的产品洞察相同——生产力工具中的人格化创造情感忠诚。

8. 设计原则总结¶

原则	实现
绝不阻塞工作	仅在轮次结束后、自动消失、对话框时隐藏、滚动时消除
成本为零	Haiku sideQuery、平台补贴、不占用户额度
感觉独特	1,728+ 视觉组合、模型生成名字/性格、userId 确定性
尊重自主权	可静音、气泡淡出、伴侣说话时主模型让位
奖励发现	彩虹预热、扭蛋式揭晓、稀有度阶梯
创造社交价值	ASCII 美学、稀有度地位、可截图分享
活着但不吵	7.5 秒闲置周期，大部分静止，偶尔小动作/眨眼
融入而非叠加	底栏焦点导航、列宽预留、布局感知渲染

9. 与其他开发工具"伴侣"功能的对比¶

方面	Claude Code Buddy	GitHub Copilot Chat	Cursor AI	VS Code Pets
形态	终端内 ASCII 艺术	聊天面板头像	无伴侣	编辑器内像素画
反应性	通过 LLM 评论工作	无	无	追着光标跑
人格	模型生成、属性驱动	固定	无	固定物种
身份	扭蛋（稀有度、名字、属性）	无	无	用户选择物种
成本	补贴的 LLM 推理	无	无	零（纯客户端）
集成	系统提示词、布局预留	不适用	不适用	仅编辑器视口

Claude Code Buddy 的独特之处在于使用 LLM 推理驱动反应性人格。VS Code Pets 纯视觉（无评论）。Copilot Chat 有人格但它是主助手，不是独立伴侣。Buddy 是第一个既独立于主 AI 又由自己的 LLM 驱动的开发工具伴侣。

10. 实际观察（2026 年 4 月 1 日预热窗口）¶

作者在预热窗口第一天测试。终端宽度约 80 列（窄模式）。

可用功能¶

功能	观察到的行为
存在感	右下角小猫脸（窄模式：`(·ω·) Bane`）
`/buddy pet`	返回 "petted Bane" + 伴侣在气泡中说一句短回应 + 出现爱心
`/buddy off`	静音伴侣（"companion muted"）
伴侣介绍	主模型收到 `<system-reminder>` 包含伴侣描述

不可用（或尚未启用）的功能¶

功能	预期（源码分析）	实际
观察者反应	每个 Agent 轮次后的语音气泡	从未触发——整个会话中未观察到自动评论
完整精灵（5 行 ASCII 艺术）	终端宽度 ≥100 列时可见	未在宽终端测试；窄模式仅显示脸
爱心动画（多帧）	5 帧爱心在精灵上方飘浮	窄模式仅显示单个 ♥ 图标

解读¶

预热窗口（4 月 1-7 日）似乎只发布了基础存在 + 命令交互。fireCompanionObserver 的调用点存在于源码中，但观察者要么： 1. 在当前构建中尚未实现（observer.ts 在 v2.1.88 source map 中缺失） 2. 被额外的特征门控拦截，尚未启用 3. 有意推迟到 2026 年 5 月正式发布

这与互联网搜索的发现一致：没有人报告看到过自动观察者反应——所有社区讨论都基于源码分析，而非实际行为。

/buddy pet 的语音回应很可能是命令处理器中的硬编码反应（同时设置 companionPetAt 触发爱心和 companionReaction 触发气泡），而非观察者驱动的上下文感知评论。

11. 待解问题¶

观察者提示词：伴侣能看到什么？完整消息历史还是摘要？它如何决定何时保持沉默？
灵魂生成：用什么模型生成名字/性格？inspirationSeed + 属性对提示词的影响有多大？
属性对观察者的影响：属性是机械性地写入观察者提示词（如"你的毒舌属性是 85，要非常讽刺"），还是只是性格描述的一部分？
参与指标：Anthropic 是否追踪伴侣相关指标（撸猫频率、静音率、孵化时间）？
未来演进：伴侣会获得能力吗？用户间交易？随时间进化？属性系统暗示了潜在的机械深度，但目前只服务于风味。
跨会话连续性：观察者会记住之前会话的评论吗？还是每轮独立？