快速开始
以下流程从源码构建当前 Rust 版。暂时没有单独的 EXE 下载地址。
1. 获取并构建
bash
git clone https://gitee.com/ricky/cc-blue.git
cd cc-blue
cargo build --release1
2
3
2
3
构建产物位于：
text
target/release/blue-puppet.exe1
直接双击该文件，或在 PowerShell 中运行：
powershell
.\target\release\blue-puppet.exe1
程序是 Windows GUI 应用，不会弹出命令行黑框。启动后桌面暂时没有宠物，只出现系统托盘图标，这是正常现象。
2. 复制 Hooks 配置
在托盘图标上打开菜单，选择 复制配置。程序会把完整 HTTP Hooks JSON 复制到剪贴板，端口会随 BLUE_PUPPET_PORT 自动调整。
把剪贴板中的 hooks 内容合并到需要使用宠物的项目：
text
你的项目/.claude/settings.json1
注意合并现有配置
如果 .claude/settings.json 已经有其他设置或 Hooks，请合并对应字段，不要直接覆盖整个文件。完整配置示例见 Hooks 配置。
也可以在其他项目复用同一份配置，只要那台机器正在运行蓝木偶，并且 Hook URL 中的端口一致。
3. 重启并开始提问
修改配置后重启 Claude Code，然后在新会话中提交第一句提问。
首个已配置事件到达时，蓝木偶会：
- 识别新的
session_id； - 在随机位置创建一只宠物；
- 按顺序分配一款立体形象；
- 显示该会话首条提问的短摘要；
- 根据后续事件更新表情和动作。
为什么第一句提问前没有宠物？
当前配置不包含 SessionStart。实例采用懒创建方式，只有首个已配置事件到达后才会出现。
可选：压缩发布版本
仓库的 release.bat 会依次执行 release 构建和 UPX 压缩：
bat
release.bat1
使用前需要自行准备 UPX，并放到脚本约定的 tools/upx-4.2.4-win64/ 目录。UPX 不是运行或普通构建的必需项；如果介意首次启动解压或杀软对压缩壳敏感，直接使用未压缩的 cargo build --release 产物即可。