petdex-cc 0.1.6 → 0.1.7

package/README_CN.md

@@ -1,46 +1,114 @@
 <div align="center">
 
-# petdex-cc
+<br />
 
-**Claude Code 桌面宠物伴侣**
+# ✨ petdex-cc ✨
 
-*住在屏幕上的动画宠物，实时响应你的每一次编码操作*
+### Claude Code 桌面宠物伴侣
 
-[![npm version](https://img.shields.io/badge/version-0.1.1-8b5cf6?style=flat-square)](https://www.npmjs.com/package/petdex-cc)
-[![platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-0ea5e9?style=flat-square)]()
-[![node](https://img.shields.io/badge/node-%3E%3D18-22c55e?style=flat-square)]()
-[![license](https://img.shields.io/badge/license-MIT-f59e0b?style=flat-square)]()
-[![pets](https://img.shields.io/badge/pets-1%2C569%20%E6%AC%BE-ec4899?style=flat-square)](https://petdex.crafter.run/zh)
+**住在屏幕上的动画宠物，实时响应你的每一次编码操作**
 
-[English](./README.md) · [中文文档](./README_CN.md)
+<br />
+
+[![npm version](https://img.shields.io/npm/v/petdex-cc?style=for-the-badge&color=8b5cf6&labelColor=1a1a2e)](https://www.npmjs.com/package/petdex-cc)
+[![platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-0ea5e9?style=for-the-badge&labelColor=1a1a2e)]()
+[![node](https://img.shields.io/badge/node-%3E%3D18-22c55e?style=for-the-badge&labelColor=1a1a2e)]()
+[![license](https://img.shields.io/badge/license-MIT-f59e0b?style=for-the-badge&labelColor=1a1a2e)](./LICENSE)
+[![pets](https://img.shields.io/badge/pets-1%2C569%20%E6%AC%BE-ec4899?style=for-the-badge&labelColor=1a1a2e)](https://petdex.crafter.run/zh)
+[![GitHub stars](https://img.shields.io/github/stars/devnomad-byte/petdex-cc?style=for-the-badge&color=f59e0b&labelColor=1a1a2e)](https://github.com/devnomad-byte/petdex-cc/stargazers)
+
+<br />
+
+[🌐 English](./README.md) · [🇨🇳 中文文档](./README_CN.md)
 
 </div>
 
 ---
 
-## petdex-cc 是什么？
+<div align="center">
+
+<img src="./boba.gif" alt="petdex-cc 演示" width="600" />
+
+</div>
 
-petdex-cc 为你的 Claude Code 工作流带来**动画桌面宠物**。从 [Petdex 宠物库](https://petdex.crafter.run/zh)（1,569+ 款社区宠物）挑选一只，一条命令安装，宠物立刻出现在桌面上 —— 陪你读代码、庆祝任务完成、在你遇到错误时加油打气，随你的编码而成长。
+---
+
+<div align="center">
+
+🐾 **一条命令，唤醒你的专属宠物** 🐾
+
+</div>
+
+```bash
+npx petdex-cc install boba
+```
+
+<div align="center">
+<i>宠物立刻出现在桌面上，开始响应你的 Claude Code 操作 🎉</i>
+</div>
+
+---
+
+## 🌟 为什么选择 petdex-cc？
 
 > **和 `npx petdex install` 有什么区别？**
+>
 > 原始的 `petdex` 命令提供基础宠物展示。`petdex-cc` 额外增加了**深度 Claude Code 集成** —— 通过 hooks 接入你的编码流程，包含等级成长系统、AI 生成语音、时段问候、互动特效。你的宠物不只是一个装饰，它*参与*你的编码过程。
 
-> **目前仅支持 Claude Code，后续将扩展到 Cursor、Windsurf、Copilot 等 AI 编码工具。**
+<table>
+<tr>
+<td width="50%">
+
+🎯 **实时反应**
+
+读文件、编辑代码、运行命令、完成任务、遇到错误时，宠物同步改变动画
+
+</td>
+<td width="50%">
+
+🏆 **8 级成长体系**
+
+Byte → Process → Thread → Module → Kernel → Neural → Quantum → Singularity
+
+</td>
+</tr>
+<tr>
+<td width="50%">
 
-### 功能一览
+🤖 **AI 语音气泡**
 
-- **实时反应** —— 你读文件、编辑代码、运行命令、完成任务、遇到错误时，宠物同步改变动画
-- **8 级成长体系** —— Byte → Process → Thread → Module → Kernel → Neural → Quantum → Singularity，逐级解锁视觉特效
-- **AI 语音气泡** —— 基于 Claude 生成的上下文感知中文对话（无 API Key 时使用内置台词）
-- **时段问候** —— 早上好、午安、下午茶、下班、晚安、凌晨问候
-- **互动体验** —— 拖拽宠物、右键菜单、快速点击彩蛋
-- **系统托盘** —— 任务栏图标，可显示/隐藏、查看关于、退出
-- **状态持久化** —— 等级和事件数重启不丢失（HMAC 签名防篡改）
-- **1,569+ 款宠物** —— 浏览 [petdex.crafter.run/zh](https://petdex.crafter.run/zh)，安装任意社区宠物
+基于 Claude 生成的上下文感知中文对话，无 API Key 时使用内置台词
+
+</td>
+<td width="50%">
+
+🕐 **时段问候**
+
+早上好、午安、下午茶、下班、晚安、凌晨问候
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+🎮 **互动体验**
+
+拖拽宠物到任意位置、右键菜单、快速点击彩蛋
+
+</td>
+<td width="50%">
+
+💾 **状态持久化**
+
+等级和事件数重启不丢失（HMAC 签名防篡改）
+
+</td>
+</tr>
+</table>
 
 ---
 
-## 快速开始
+## 🚀 快速开始
 
 ### 环境要求
 
@@ -57,70 +125,156 @@ petdex-cc 为你的 Claude Code 工作流带来**动画桌面宠物**。从 [Pet
 npx petdex-cc install boba
 ```
 
-宠物立刻出现在桌面上，开始响应你的 Claude Code 操作。
+### 🐾 热门宠物
+
+<table>
+<tr>
+<th>Slug</th>
+<th>名称</th>
+<th>描述</th>
+</tr>
+<tr>
+<td><code>boba</code></td>
+<td>🦦 Boba</td>
+<td>喝着珍珠奶茶的小水獭</td>
+</tr>
+<tr>
+<td><code>doraemon</code></td>
+<td>🐱 哆啦A梦</td>
+<td>来自未来的蓝色机器猫</td>
+</tr>
+<tr>
+<td><code>noir-webling</code></td>
+<td>🕷️ Noir Webling</td>
+<td>戴礼帽的单色蜘蛛侦探</td>
+</tr>
+<tr>
+<td><code>ikun-hoops</code></td>
+<td>🏀 IKUN Hoops</td>
+<td>穿卫衣拿篮球的小鸡</td>
+</tr>
+<tr>
+<td><code>ddo-zvzo</code></td>
+<td>😎 ddo-zvzo</td>
+<td>会戴墨镜的紫色吉祥物</td>
+</tr>
+<tr>
+<td><code>mochi</code></td>
+<td>🐱 Mochi</td>
+<td>橘白色可爱小猫</td>
+</tr>
+</table>
+
+> 浏览全部 1,569+ 款宠物 → [**petdex.crafter.run/zh**](https://petdex.crafter.run/zh) 🎨
+
+<details>
+<summary>🌏 国内用户加速（必看）</summary>
+
+<br />
+
+首次安装需要下载 Electron 二进制文件（~100MB），默认从 GitHub 下载，国内可能很慢或无法访问。安装前配置国内镜像：
 
-### 热门宠物
+```bash
+# 设置 npm 淘宝镜像源
+npm config set registry https://registry.npmmirror.com
 
-| Slug | 名称 | 描述 |
-|---|---|---|
-| `boba` | Boba | 喝着珍珠奶茶的小水獭 |
-| `doraemon` | 哆啦A梦 | 来自未来的蓝色机器猫 |
-| `noir-webling` | Noir Webling | 戴礼帽的单色蜘蛛侦探 |
-| `ikun-hoops` | IKUN Hoops | 穿卫衣拿篮球的小鸡 |
-| `ddo-zvzo` | ddo-zvzo | 会戴墨镜的紫色吉祥物 |
-| `mochi` | Mochi | 橘白色可爱小猫 |
+# 设置 Electron 下载镜像
+npm config set electron_mirror https://npmmirror.com/mirrors/electron/
+
+# 然后安装
+npx petdex-cc install boba
+```
+
+以上配置永久生效，只需设置一次。
+
+</details>
+
+<details>
+<summary>🔧 常见问题</summary>
+
+<br />
+
+**`ERR_MODULE_NOT_FOUND: Cannot find package '@electron/remote'`**
+
+这是 0.1.6 之前版本的 bug。更新到最新版即可：
+
+```bash
+npm uninstall -g petdex-cc
+npx petdex-cc install boba
+```
+
+**`EPERM` / `EBUSY` 文件被锁**
+
+宠物进程仍在运行，锁住了文件。先停止宠物：
+
+```bash
+# Windows PowerShell
+Stop-Process -Name electron -Force -ErrorAction SilentlyContinue
 
-> 浏览全部 1,569+ 款宠物 → [**petdex.crafter.run/zh**](https://petdex.crafter.run/zh)
+# macOS / Linux
+pkill -f electron
+
+# 然后重新安装
+npx petdex-cc install boba
+```
+
+**安装时 `ECONNRESET` / `ETIMEDOUT`**
+
+Electron 无法从 GitHub 下载。请配置国内镜像（见上方「国内用户加速」）。
+
+</details>
 
 ---
 
-## 你的宠物会做什么
+## 🎬 你的宠物会做什么
 
 Claude Code 的每一次操作都会触发宠物反应：
 
 | Claude Code 事件 | 宠物动画 | 语音气泡 |
 |---|---|---|
-| 会话开始 | 挥手 | "Let's get to work!" |
-| 读取文件 | 审视 | "Reading 文件名..." |
-| 编辑文件 | 待机 | "Edited 文件名" |
-| 运行命令 | 奔跑 | "Running command..." |
-| 搜索文件 | 等待 | "Searching..." |
-| 工具失败 | 垂头 | "Oops, something went wrong" + AI 鼓励 |
-| 任务完成 | 跳跃 | "Task complete!" + AI 庆祝 |
-| Claude 停止 | 跳跃 | "Task complete!"（60% 概率触发 AI） |
-| Claude 报错 | 垂头 | 错误信息 + AI 安慰 |
-| 空闲 10+ 分钟 | 挥手 | 时段问候（中文） |
-| 等级提升 | 当前状态 | "Level up! Kernel!" + 特效激活 |
-
-### 互动操作
-
-- **拖拽** —— 点击拖动宠物到屏幕任意位置
-- **右键** —— 上下文菜单：显示/隐藏、关于、退出
-- **系统托盘** —— 右下角任务栏图标
-- **彩蛋** —— 快速连续点击宠物，触发递进式反应（2 → 4 → 6 → 9 → 12 → 15 次）
+| 🟢 会话开始 | 挥手 👋 | "Let's get to work!" |
+| 📖 读取文件 | 审视 🔍 | "Reading 文件名..." |
+| ✏️ 编辑文件 | 待机 | "Edited 文件名" |
+| ▶️ 运行命令 | 奔跑 🏃 | "Running command..." |
+| 🔍 搜索文件 | 等待 ⏳ | "Searching..." |
+| ❌ 工具失败 | 垂头 😢 | "Oops, something went wrong" + AI 鼓励 |
+| ✅ 任务完成 | 跳跃 🎉 | "Task complete!" + AI 庆祝 |
+| 🛑 Claude 停止 | 跳跃 | "Task complete!"（60% 概率触发 AI） |
+| ⚠️ Claude 报错 | 垂头 | 错误信息 + AI 安慰 |
+| 💤 空闲 10+ 分钟 | 挥手 | 时段问候（中文） |
+| ⬆️ 等级提升 | 当前状态 | "Level up! Kernel!" + 特效激活 |
+
+### 🎮 互动操作
+
+| 操作 | 效果 |
+|---|---|
+| **拖拽** | 点击拖动宠物到屏幕任意位置 |
+| **右键** | 上下文菜单：显示/隐藏、关于、退出 |
+| **系统托盘** | 右下角任务栏图标 |
+| **彩蛋** | 快速连续点击，触发递进式反应（2→4→6→9→12→15 次） |
 
 ---
 
-## 等级系统
+## 🏆 等级系统
 
-你的宠物随你的编码而成长。每次 Claude Code 操作算一次事件，累积升级：
+你的宠物随你的编码而成长，每次 Claude Code 操作算一次事件，累积升级：
 
-| 等级 | 名称 | 所需事件数 | 颜色 | 视觉效果 |
+| 等级 | 名称 | 所需事件数 | | 视觉效果 |
 |:---:|---|---:|---|---|
-| 1 | **Byte** | 0 | 银色 | 基础宠物 |
-| 2 | **Process** | 50 | 绿色 | 呼吸式发光 |
-| 3 | **Thread** | 200 | 蓝色 | 旋转光环 |
-| 4 | **Module** | 500 | 紫色 | 增强光环 |
-| 5 | **Kernel** | 1,000 | 琥珀 | 漂浮光点粒子 |
-| 6 | **Neural** | 2,000 | 粉色 | 粒子风暴 |
-| 7 | **Quantum** | 5,000 | 青色 | 能量场 |
-| 8 | **Singularity** | 10,000 | 金色 | 金色光环 + 全部特效 |
+| 1 | **Byte** | 0 | ⚪ 基础宠物 |
+| 2 | **Process** | 50 | 🟢 呼吸式发光 |
+| 3 | **Thread** | 200 | 🔵 旋转光环 |
+| 4 | **Module** | 500 | 🟣 增强光环 |
+| 5 | **Kernel** | 1,000 | 🟡 漂浮光点粒子 |
+| 6 | **Neural** | 2,000 | 🩷 粒子风暴 |
+| 7 | **Quantum** | 5,000 | 🩵 能量场 |
+| 8 | **Singularity** | 10,000 | 🌟 金色光环 + 全部特效 |
 
 ---
 
-## AI 语音
+## 🤖 AI 语音
 
-当 Anthropic API Key 可用时（自动从 Claude Code 设置读取，或通过 `petdex-cc config` 配置），宠物会生成**上下文感知的中文语音**：
+当 Anthropic API Key 可用时（自动从 Claude Code 设置读取），宠物会生成**上下文感知的中文语音**：
 
 | 场景 | 触发时机 | AI 生成示例 |
 |---|---|---|
@@ -135,7 +289,7 @@ Claude Code 的每一次操作都会触发宠物反应：
 
 ---
 
-## 命令参考
+## 📋 命令参考
 
 ```bash
 petdex-cc install <slug>    # 下载宠物、配置 hooks、启动
@@ -148,7 +302,10 @@ petdex-cc uninstall         # 移除 hooks、停止宠物、删除所有数据
 petdex-cc config [选项]     # 配置设置
 ```
 
-### 配置选项
+<details>
+<summary>⚙️ 配置选项</summary>
+
+<br />
 
 ```bash
 petdex-cc config --api-key <key>             # Anthropic API Key（用于 AI 语音）
@@ -158,9 +315,11 @@ petdex-cc config --cooldown <分钟>             # AI 调用冷却时间（默
 
 > API 凭据会自动从 `~/.claude/settings.json` 读取，大多数用户无需手动配置。
 
+</details>
+
 ---
 
-## 架构设计
+## 🏗️ 架构设计
 
 ```
  ┌─────────────────────────────────────────────────┐
@@ -200,25 +359,10 @@ petdex-cc config --cooldown <分钟>             # AI 调用冷却时间（默
           └──────────────────┘
 ```
 
----
+<details>
+<summary>📁 项目结构</summary>
 
-## 开发者安装
-
-```bash
-git clone https://github.com/devnomad-byte/petdex-cc.git
-cd petdex-cc
-npm install
-npm run build
-
-# 开发模式启动
-npx electron .
-
-# 全局安装使用 CLI
-npm link
-petdex-cc install boba
-```
-
-### 项目结构
+<br />
 
 ```
 petdex-cc/
@@ -241,21 +385,38 @@ petdex-cc/
 │   │   └── context-menu.ts   右键菜单
 │   ├── cli/                  CLI 命令实现
 │   ├── hooks/                Claude Code hooks 注册
-│   │   ├── register.ts       写入 ~/.claude/settings.json
-│   │   ├── write-scripts.ts  跨平台 bridge 脚本
-│   │   ├── bridge.ps1        Windows PowerShell bridge
-│   │   └── bridge.sh         Unix bash bridge
 │   ├── petdex-api/           Petdex 注册中心客户端
-│   │   ├── client.ts         清单获取 + slug 查询
-│   │   └── download.ts       流式下载 + 进度回调
 │   └── shared/               共享类型和常量
 ```
 
+</details>
+
+---
+
+## 🔧 开发者安装
+
+```bash
+git clone https://github.com/devnomad-byte/petdex-cc.git
+cd petdex-cc
+npm install
+npm run build
+
+# 开发模式启动
+npx electron .
+
+# 全局安装使用 CLI
+npm link
+petdex-cc install boba
+```
+
 ---
 
-## 配置参考
+## ⚙️ 配置参考
+
+<details>
+<summary>自动检测配置</summary>
 
-### 自动检测
+<br />
 
 petdex-cc 自动从 `~/.claude/settings.json` 读取以下配置：
 
@@ -264,15 +425,12 @@ petdex-cc 自动从 `~/.claude/settings.json` 读取以下配置：
 | `ANTHROPIC_AUTH_TOKEN` | AI 语音的 API Key |
 | `ANTHROPIC_BASE_URL` | AI 语音的 API 端点 |
 
-### 手动配置
+</details>
 
-存储在 `~/.petdex-cc/config.json`：
+<details>
+<summary>数据目录</summary>
 
-```bash
-petdex-cc config --api-key <key> --api-base-url <url> --cooldown 2
-```
-
-### 数据目录
+<br />
 
 | 路径 | 内容 |
 |---|---|
@@ -282,11 +440,11 @@ petdex-cc config --api-key <key> --api-base-url <url> --cooldown 2
 | `~/.petdex-cc/hooks/` | Bridge 脚本 |
 | `~/.petdex-cc/config.json` | 用户配置（API Key、冷却时间） |
 
----
+</details>
 
-## Hooks 参考
+---
 
-petdex-cc 在 `~/.claude/settings.json` 中注册以下 hooks：
+## 🪝 Hooks 参考
 
 | Hook | 匹配器 | 触发时机 |
 |---|---|---|
@@ -301,7 +459,7 @@ petdex-cc 在 `~/.claude/settings.json` 中注册以下 hooks：
 
 ---
 
-## 后续计划
+## 🗺️ 后续计划
 
 - [ ] 支持 Cursor
 - [ ] 支持 Windsurf
@@ -311,13 +469,28 @@ petdex-cc 在 `~/.claude/settings.json` 中注册以下 hooks：
 
 ---
 
-## 许可证
+<div align="center">
+
+## ⭐ Star 趋势
+
+<a href="https://www.star-history.com/?repos=devnomad-byte%2Fpetdex-cc&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=devnomad-byte/petdex-cc&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=devnomad-byte/petdex-cc&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=devnomad-byte/petdex-cc&type=date&legend=top-left" />
+ </picture>
+</a>
+
+<br />
+
+## 📄 许可证
 
 [MIT](./LICENSE)
 
----
+<br />
+
+为 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 社区用心打造 💜
+
+宠物来自 [**Petdex**](https://petdex.crafter.run/zh) · 1,569+ 款社区宠物，持续更新中
 
-<div align="center">
-  <sub>为 <a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code</a> 社区用心打造</sub><br />
-  <sub>宠物来自 <a href="https://petdex.crafter.run/zh">Petdex</a></sub>
 </div>

package/dist/bin/cli.js

@@ -56,19 +56,19 @@ async function main() {
     }
 }
 function printHelp() {
-    console.log(`
-petdex-cc - Desktop pet companion for Claude Code
-
-Commands:
-  install <slug>    Install a pet from Petdex and configure hooks
-  start             Start the desktop pet
-  stop              Stop the desktop pet
-  list              List available pets from Petdex
-  switch <slug>     Switch to a different pet
-  status            Show current pet status and level
-  uninstall         Remove petdex-cc hooks and data
-  config            Configure API key and settings
-  help              Show this help message
+    console.log(`
+petdex-cc - Desktop pet companion for Claude Code
+
+Commands:
+  install <slug>    Install a pet from Petdex and configure hooks
+  start             Start the desktop pet
+  stop              Stop the desktop pet
+  list              List available pets from Petdex
+  switch <slug>     Switch to a different pet
+  status            Show current pet status and level
+  uninstall         Remove petdex-cc hooks and data
+  config            Configure API key and settings
+  help              Show this help message
 `);
 }
 main().catch((err) => {

package/dist/src/hooks/write-scripts.js

@@ -1,28 +1,28 @@
 import * as fs from "fs";
 import * as path from "path";
 import { homedir } from "node:os";
-const BRIDGE_SH = `#!/bin/bash
-INPUT=$(cat)
-PORT_FILE="$HOME/.petdex-cc/data/port.lock"
-PORT=17321
-if [ -f "$PORT_FILE" ]; then
-  PORT=$(cat "$PORT_FILE" 2>/dev/null || echo "17321")
-fi
-curl -s -X POST "http://localhost:$PORT/event" \\
-  -H "Content-Type: application/json" \\
-  -d "$INPUT" > /dev/null 2>&1 &
+const BRIDGE_SH = `#!/bin/bash
+INPUT=$(cat)
+PORT_FILE="$HOME/.petdex-cc/data/port.lock"
+PORT=17321
+if [ -f "$PORT_FILE" ]; then
+  PORT=$(cat "$PORT_FILE" 2>/dev/null || echo "17321")
+fi
+curl -s -X POST "http://localhost:$PORT/event" \\
+  -H "Content-Type: application/json" \\
+  -d "$INPUT" > /dev/null 2>&1 &
 `;
-const BRIDGE_PS1 = `$inputJson = [System.Console]::In.ReadToEnd()
-$portFile = Join-Path $env:USERPROFILE ".petdex-cc\\data\\port.lock"
-$port = 17321
-if (Test-Path $portFile) {
-    $port = Get-Content $portFile -ErrorAction SilentlyContinue
-    if (-not $port) { $port = 17321 }
-}
-$url = "http://localhost:$port/event"
-try {
-    Invoke-WebRequest -Uri $url -Method POST -ContentType "application/json" -Body $inputJson -UseBasicParsing -TimeoutSec 5 | Out-Null
-} catch {}
+const BRIDGE_PS1 = `$inputJson = [System.Console]::In.ReadToEnd()
+$portFile = Join-Path $env:USERPROFILE ".petdex-cc\\data\\port.lock"
+$port = 17321
+if (Test-Path $portFile) {
+    $port = Get-Content $portFile -ErrorAction SilentlyContinue
+    if (-not $port) { $port = 17321 }
+}
+$url = "http://localhost:$port/event"
+try {
+    Invoke-WebRequest -Uri $url -Method POST -ContentType "application/json" -Body $inputJson -UseBasicParsing -TimeoutSec 5 | Out-Null
+} catch {}
 `;
 export function writeBridgeScripts() {
     const hooksDir = path.join(homedir(), ".petdex-cc", "hooks");