# codepet **Repository Path**: banmao999/codepet ## Basic Information - **Project Name**: codepet - **Description**: No description available - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-17 - **Last Updated**: 2026-07-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 码宠 CodePet 🐾 > 一只挂在桌面的桌宠:**你写代码、用 Claude Code,它就涨经验、升级、换状态、冒话。** > 数据只读你本机的 git 提交和 `~/.claude` 用量,**全本地、绝不外传、可一键关闭**。 > 开源 · 中文 · 由「AI不止语」社群共建。 
会跳舞的小舞精灵 · 右键换宠物/喂食/数据 · 5 只原创宠物可选
--- ## 这是什么 把"干活"变成养成游戏。你每提交一次代码、每和 Claude Code 完成一个任务,桌宠都会**当场**抬头、蹦跶、涨经验。一天卷下来,它从摸鱼 😴 一路进化到卷王 🔥;好几天不写,它能量见底会"饿"。 它不是又一个 AI 聊天桌宠,而是**第一个把"桌面常驻可爱形象 + Claude Code 用量驱动养成 + 中文性格"三者合一**的开发者桌宠。 ## 为什么和别的不一样 同类项目要么是终端里的 ASCII 宠物,要么是只看键鼠活动的桌面宠物,要么是 Live2D 却没接编程活动。码宠的差异点在三者交集: - 🎨 **精致 2D 形象 + 程序化生命感**:呼吸、摇摆、眨眼、踩影子、时不时自己蹦一下——不是死图。 - ⚡ **深绑 Claude Code 用量**:通过官方 hooks **实时**感知你的提问/完成/工具调用,桌宠即时反应。 - 🀄 **中文性格**:8 只宠物各有人设(高冷奶猫、中二恐龙、社畜企鹅、调试搭子小黄鸭…),台词接地气。 ## 🔒 隐私(这是我们的底线,也是卖点) - **全本地**:所有数据存在你本机,**绝不联网外传**。 - **只读聚合元数据**:提交数、增删行数、prompt/任务/工具的**次数**——**从不读取你的对话正文或代码内容**。 - **完全 opt-in**:Claude Code 联动、用量采集默认可关,由你主动开启。 - **开源可查**:代码全公开,隐私承诺可逐行验证。 > 设计对齐 Anthropic 官方社区对开发者宠物的隐私期待(claude-code #59081)。 ## 快速开始(开发模式) 需要 Node 18+。 ```bash cd codepet npm install npm start ``` 桌宠出现在屏幕右下角。**托盘菜单**有:今日数据 / 喂食 / 设置 / 点击穿透 / 退出。 ## 选你的宠物 设置窗 →「🐾 选择宠物」,8 只任选,点一下即热切换: 🐱 奶猫(高冷傲娇) · 🐶 柴犬(热情憨憨) · 🦖 小恐龙(中二热血) · 🫧 史莱姆(慵懒躺平) 🦊 小狐狸(机灵腹黑) · 🐧 企鹅(社畜共情) · 🦆 小黄鸭(解谜搭子) · 🐹 仓鼠(囤货摸鱼) 立绘未生成时显示 emoji 占位(也会动)。生成原创立绘: ```bash # 1) 用你自己的 OpenAI key(用完记得吊销轮换;key 只留在本机环境变量,绝不写进代码) export OPENAI_API_KEY=sk-你的key # 2) 生成(gpt-image-1,透明背景原创小动物) node tools/gen-character.js list # 看有哪些宠物 node tools/gen-character.js all # 每只各出 1 张,做选择画廊 node tools/gen-character.js cat all # 出「猫」的 4 个表情 ``` 图落在 `src/renderer/assets/<宠物>/`,设置里选中即用。 ## 开启实时联动(推荐) 设置窗 →「⚡ 实时联动 Claude Code」→ 开启。它会安装一个**安全的 hook**(只记录"发生了什么",绝不读 prompt 内容),之后你在 Claude Code 里提问/完成任务时,桌宠**即时反应、即时涨经验**。随时可一键卸载,不影响 Claude Code 正常使用。 ## 打包安装包 ```bash npm run dist:mac # 产出 release/ 下的 .dmg npm run dist:win # 产出 .exe(需在 Windows 上构建) ``` > 公开分发需用你自己的 Apple Developer ID 签名+公证,否则 Gatekeeper 会拦截。 ## 成长机制 经验来自**有意义的事件**(不是 token 数——`~/.claude` 里的 token 计数不可靠): ``` 经验 = 提交数×10 + 增删行数×0.1 + prompt数×4 + 完成任务数×8 + 工具调用×1 ``` - 每 100 经验升 1 级;状态按今日经验:摸鱼 😴 / 热身 🌱 / 干劲十足 💪 / 卷王 🔥。 - **能量**随时间衰减(约 3 天满→空),靠当日活动补充——长期不写它会"饿"。 - 全部本地 JSON 持久化,重启不丢。 ## 路线图 - **v1(当前)**:AI 原创 2D 立绘 + 程序化生命感 + 8 宠物可选 + 实时 hooks + 打包。 - **v2**:Live2D 2.5D 形象(会转头/眨眼/摇摆)——需自备**正版授权** Live2D 模型,项目不内置任何模型。 - 更多宠物、更多性格、成就系统。 ## 技术栈 Electron · 原生 JS · PixiJS + pixi-live2d-display(v2)· Node 子进程读 git / `~/.claude`。 ## 协议 **源代码**:[Apache License 2.0](LICENSE),Copyright © 2026 AI不止语。可自由使用、修改、分发、商用,含明确的专利授权。 **宠物形象立绘**:由 AI 图像工具生成。AI 生成内容的版权状态依各生成工具的服务条款与所在地法律而定,作者不对其主张独占版权;如需用于你自己的发布,请自行确认所用生成工具的条款。 --- 由 **AI不止语** 出品。欢迎 PR、提 issue、晒你的码宠。