为 ZCode 而生的桌宠
代码在跑，Z-Buddy 在陪。
一只挂在桌面角落的像素小宠物：ZCode 干活时它打字，出错时它冒汗，完成时它庆祝，深夜它会冒 Zzz 睡着。点它一下，随时让 AI 停一停。
v0.1.0 · Windows 10/11 · 免费 · 仅 4.2 MB · GitHub
任务
- 修复宠物拖动竞态
- 重构 parser 模块
- 补齐单测
- 发布 v0.1.0
GoalComplete · 89K tokens
帮我修一下宠物不能拖动的 bug，好像是和点击穿透的竞态。
已定位根因：穿透守护线程每 200ms 检测光标，拖动一开始就把穿透打开了。 我改成 mousedown 阈值 + 拖拽期守护静默，正在改 3 个文件。
● Edit src/main.js · ● Edit lib.rs · ⋯
团子 · working
ZCode 干活中，点一下团子可以随时暂停
为什么养一只 Z-Buddy
看得见的状态
Agent 在后台干活时，桌宠把状态演给你看：干活打字、出错冒汗、完成庆祝、深夜睡觉——AI 在干什么，一眼可知。
点一下就暂停
点团子 = ZCode 停手，再点恢复。通过 hook 硬拦截实现，不是装饰按钮——人随时插队，AI 让位。
宠物包即装即换
一张精灵图 + 一个 JSON 就是新宠物，丢进 ~/.z-buddy/pets/ 立刻换宠；格式兼容 Codex hatch-pet 生态思路。
产品能力
v0.1.0 已实现的能力如下；更多在路上的，见下方路线图。
六种状态全覆盖
idle / thinking / working / 等待审批 / 出错 / 深夜睡觉，动画实时映射 Agent 生命周期。
悬浮拖动
置顶无边框悬浮窗，点按穿透（不挡鼠标）、自由拖动、多显示器与 DPI 适配。
托盘与开机自启
系统托盘菜单：显示/隐藏、切换宠物、退出；支持开机自启，随叫随到。
宠物包加载器
外部宠物包目录扫描 + 热切换，偏好持久化；为宠物商店生态打好了地基。
超轻量
安装包 4.2 MB、内存 ~30 MB、单进程。挂机一整天，毫无存在感。
隐私优先
状态数据只写本机 ~/.z-buddy/，不上传任何东西；聊天历史（规划中）也永不落盘。
路线图
Phase 0 · 技术验证
hooks 事件流、点按暂停闭环、打断自愈、Tauri 选型
✅ 已完成
Phase 1 · MVP
状态联动 / 悬浮暂停 / 托盘自启 / 宠物包加载 —— 已达成第一里程碑
🔄 进行中
Phase 2 · 生态与可视化
hatch 生成宠物、GLM 对话气泡、电脑操作可视化、任务气泡
⬜ 计划中
Phase 3 · 护城河
人机接力、审批桌面卡片、子代理多宠物、养成系统
⬜ 计划中
全部下载
v0.1.0 · 2026-09-06 · 前往 GitHub Releases
Windows 安装包（推荐）
NSIS 向导 · 自选路径 · 支持开机自启
Windows 便携版
解压即用 · 不写注册表
SHA256 校验文件
SHA256SUMS.txt常见问题
和 Codex 的宠物模式是什么关系？＋
Codex Pet Mode 是灵感和敬意来源。Z-Buddy 是为 ZCode 而生的独立开源实现：宠物包格式参考其开放的精灵图思路，并计划做兼容，让存量宠物生态直接可用。
收费吗？＋
免费且开源（MIT，发布前确定）。运行中唯一的可选成本是聊天功能调用 GLM API 的费用——用的是你自己配置的 Key，与本项目无关。
它会读我的代码、上传数据吗？＋
不上传任何数据。插件只把 Agent 状态（如 working / error）写到本机 ~/.z-buddy/state.json，桌宠读取它来播放动画，全程不出你的电脑。
支持 macOS / Linux 吗？＋
目前 Windows 优先（10/11 x64）。应用基于 Tauri，跨平台在技术上可行，排在 Windows 版打磨稳定之后，具体排期待定。