claude-buddy-cli 1.0.0 → 1.0.1

package/CLAUDE.md

@@ -9,12 +9,19 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 ## 命令
 
 ```bash
-# 运行 CLI（暴力搜索 legendary ID）
-node index.js
+# 从 npm 全局安装（推荐）
+npm install -g claude-buddy-cli
+buddy-cli
 
-# 或全局安装后运行
+# 开发时本地链接
 npm link
 buddy-cli
+
+# 直接运行
+node index.js
+
+# 卸载全局安装
+npm uninstall -g claude-buddy-cli
 ```
 
 ## 架构

package/README.md

@@ -0,0 +1,61 @@
+# claude-buddy-cli
+
+为 Claude Code 生成 lucky buddy ID 的 CLI 工具。
+
+## 功能
+
+Claude Code 有一个 buddy system，会给每个用户分配一个稀有度等级。本工具通过暴力搜索生成 "legendary" 稀有度的用户 ID，让你的 Claude Code 拥有最幸运的 buddy。
+
+稀有度概率：
+- **legendary**: 1%（金色，最稀有）
+- **epic**: 4%
+- **rare**: 10%
+- **uncommon**: 25%
+- **common**: 60%
+
+## 解决的问题
+
+Claude Code 的 buddy 稀有度由用户 ID 决定，但默认分配的 ID 通常是普通稀有度。本工具帮你找到一个 legendary ID，写入 `~/.claude.json` 配置文件，让你的 Claude Code 从此拥有金色 legendary buddy。
+
+## 安装
+
+```bash
+npm install -g claude-buddy-cli
+```
+
+## 使用
+
+```bash
+buddy-cli
+```
+
+运行后会自动搜索 legendary ID：
+
+```
+🎰 Buddy Gacha
+Searching for legendary...
+
+✨ LEGENDARY FOUND!
+ID: user_abc12345
+Draws: 42
+
+Updated ~/.claude.json
+```
+
+找到 legendary 后会自动更新 Claude Code 配置文件，下次启动 Claude Code 即可生效。
+
+## 卸载
+
+```bash
+npm uninstall -g claude-buddy-cli
+```
+
+## 技术原理
+
+- 使用 FNV-1a 哈希算法生成确定性种子
+- Mulberry32 PRNG 确保结果可重现
+- 每个 ID 的稀有度完全由哈希值决定，无法伪造
+
+## 许可证
+
+ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-buddy-cli",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "description": "Find legendary buddy ID for Claude Code",
   "main": "index.js",
@@ -10,4 +10,4 @@
   "keywords": [],
   "author": "",
   "license": "ISC"
-}
+}