buddy-finder-by-userid

Claude Code Buddy 宠物属性穷举工具 - 通过穷举 userID 找到理想的 buddy 属性

🚀 快速开始

方式一：npm 全局安装（推荐）

# 安装
npm install -g buddy-finder-by-userid

# 使用
buddy-finder --help

方式二：GitHub 源码安装

git clone https://github.com/Lee920311/buddy-finder-by-userID.git
cd buddy-finder-by-userID
node cli.js --help

方式三：Claude Code 直接调用

安装后，在 Claude Code 对话中直接说：

帮我找一个闪光传奇龙

或

运行 buddy-finder 找完美搭配

📖 快速上手指南（3 步找到完美 buddy）

第 1 步：安装工具

npm install -g buddy-finder-by-userid

第 2 步：选择搜索模式

# 模式 A：使用预设（推荐新手）
buddy-finder -p perfect

# 模式 B：自定义条件
buddy-finder -r legendary -s dragon --shiny --min-stat DEBUGGING:95

第 3 步：获取 userID 并复制

找到满意的 buddy 后，记录输出的 userID
复制该 userID 到 Claude Code 配置中即可

💻 使用方式

方式 1：命令行工具（CLI）

# 查看帮助
buddy-finder --help

# 列出所有可用选项
buddy-finder --list

# 测试指定 userID
buddy-finder --test 3a36224b57ca29e7f91a973131a565289378e898bcaebfe397f88483b5ef45d0

方式 2：Claude Code 对话调用

在 Claude Code 中直接说：

简单搜索：

帮我找一个闪光传奇龙

自定义条件：

帮我找一个传奇龙，要巫师帽，DEBUGGING 属性高于 90

使用预设：

用 buddy-finder 找完美搭配

验证 userID：

帮我验证这个 userID 的 buddy 属性：3a36224b57ca29e7f91a973131a565289378e898bcaebfe397f88483b5ef45d0

方式 3：Node.js 直接运行

# 使用预设搜索
node cli.js -p perfect -i 50000000

# 自定义条件搜索
node cli.js -r legendary -s dragon --shiny

🎯 使用示例

使用预设搜索

# 搜索完美搭配 (闪光传奇龙 + 巫师帽 + 高 DEBUGGING)
buddy-finder -p perfect

# 搜索闪光传奇龙
buddy-finder -p legendary_dragon_shiny

# 搜索任意传奇宠物
buddy-finder -p any_legendary

自定义条件搜索

# 搜索闪光传奇龙
buddy-finder -r legendary -s dragon --shiny

# 搜索传奇龙 + 巫师帽
buddy-finder -r legendary -s dragon -h wizard

# 搜索高 DEBUGGING 属性
buddy-finder --peak-stat DEBUGGING

# 指定最低属性值
buddy-finder --min-stat DEBUGGING:80 --min-stat CHAOS:90

其他选项

# 设置最大迭代次数 (默认 1000 万)
buddy-finder -p perfect -i 50000000

# 输出结果到文件
buddy-finder -p perfect -o result.json

📋 可用选项

稀有度

| 选项 | 说明 | |------|------| | common | 普通 | | uncommon | 不常见 | | rare | 稀有 | | epic | 史诗 | | legendary | 传奇 |

物种

duck, goose, blob, cat, dragon, octopus, owl, penguin, turtle, snail, ghost, axolotl, capybara, cactus, robot, rabbit, mushroom, chonk

帽子

none, crown, tophat, propeller, halo, wizard, beanie, tinyduck

属性

DEBUGGING, PATIENCE, CHAOS, WISDOM, SNACK

🎁 预设列表

| 预设 | 说明 | |------|------| | legendary_dragon | 传奇龙 | | legendary_dragon_shiny | 闪光传奇龙 | | legendary_dragon_wizard | 传奇龙 + 巫师帽 | | perfect | 完美搭配 (闪光传奇龙 + 巫师帽 + 高 DEBUGGING) | | any_legendary | 任意传奇宠物 | | shiny_hunter | 闪光传奇宠物 |

🎯 Claude Code 使用场景

场景 1：国内用户替代方案

使用 Kimi/通义千问等国内模型，但想体验 Claude Code 的 buddy 系统

解决方案：

1. 用本工具找到理想的 buddy 属性
2. 获取对应的 userID
3. 在国内模型的配置中模拟 buddy 属性

场景 2：技术研究与学习

想了解 buddy 系统的算法原理和属性分布

使用方式：

# 批量导出 1000 个 buddy 数据分析
buddy-finder -i 1000 -o buddy-data.json

场景 3：快速找到完美搭配

不想浪费时间随机刷，直接锁定目标属性

推荐预设：

• perfect - 闪光传奇龙 + 巫师帽 + 高 DEBUGGING
• legendary_dragon_wizard - 传奇龙 + 巫师帽
• shiny_hunter - 任意闪光传奇宠物

场景 4：属性验证工具

已有 userID，想验证对应的 buddy 属性

buddy-finder --test <你的 userID>

⚠️ 适用人群

重要：本工具仅适用于以下用户

✅ 国内模型使用者 - 使用 Kimi、通义千问、文心一言等国内 AI 模型
✅ 未注册 Claude 账号 - 没有 Claude 官方账号，无法使用 Claude Code
✅ 想体验 buddy 系统 - 想了解 Claude Code buddy 属性机制的技术爱好者

❌ 不适用场景

• 已有 Claude 账号并订阅 Claude Code
• 可以直接在 Claude Code 中正常使用 buddy 功能
• 国外用户可正常访问 Claude 服务

🔧 技术实现

本工具实现了与 Claude Code buddy 系统完全一致的算法：

• Mulberry32 PRNG - 确定性伪随机数生成器
• FNV-1a hash - 字符串转数字种子
• 稀有度权重抽取 - 基于权重的稀有度计算
• 属性值生成 - 峰值/垃圾属性分配逻辑

📦 功能特点

• 🎯 穷举搜索 - 随机生成 userID 并计算对应的 buddy 属性
• 🔍 条件过滤 - 按稀有度、物种、帽子、闪光、属性值筛选
• 📊 评分系统 - 计算与目标的匹配分数
• ⚡ 进度显示 - 实时显示搜索进度和速率
• 💾 结果导出 - 保存匹配结果到 JSON 文件

📄 许可证

MIT

🔗 相关链接

• GitHub 仓库
• npm 包页面
• 问题反馈