Skip to content

jnMetaCode/codepet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

码宠 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+。

cd codepet
npm install
npm start

桌宠出现在屏幕右下角。托盘菜单有:今日数据 / 喂食 / 设置 / 点击穿透 / 退出。

选你的宠物

设置窗 →「🐾 选择宠物」,8 只任选,点一下即热切换:

🐱 奶猫(高冷傲娇) · 🐶 柴犬(热情憨憨) · 🦖 小恐龙(中二热血) · 🫧 史莱姆(慵懒躺平) 🦊 小狐狸(机灵腹黑) · 🐧 企鹅(社畜共情) · 🦆 小黄鸭(解谜搭子) · 🐹 仓鼠(囤货摸鱼)

立绘未生成时显示 emoji 占位(也会动)。生成原创立绘:

# 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 正常使用。

打包安装包

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,Copyright © 2026 AI不止语。可自由使用、修改、分发、商用,含明确的专利授权。

宠物形象立绘:由 AI 图像工具生成。AI 生成内容的版权状态依各生成工具的服务条款与所在地法律而定,作者不对其主张独占版权;如需用于你自己的发布,请自行确认所用生成工具的条款。


AI不止语 出品。欢迎 PR、提 issue、晒你的码宠。

About

码宠 CodePet — 桌面养成桌宠:你写代码/用 AI 编程,它就涨经验、升级、换状态、跳舞。全本地、隐私优先、开源。

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors