跨 agent、可扩展的桌面宠物。宠物会对 Claude Code、Codex、zcode、DeepSeek Harness（DSH）等 AI 编程 agent 的活动做出反应；美术可以全部用 AI 生成（图片 / GIF / 短视频）；几乎所有功能都是插件，插件作者的自由度尽量高。
本仓库是旧版 Petween 的重做：先写文档定契约，再按契约移植旧代码。旧版的三个仓库已停止维护：petween-dsh（DeepSeek Harness 插件，原名 petween）、petween-desktop（Electron 桌面版）、petween-physics（抛掷物理插件）。
当前状态：开发中，仅支持 Windows。里程碑与每一步怎么看效果见 路线图。
| # | 文档 | 回答什么 |
|---|---|---|
| 00 | 愿景与边界 | 做给谁、v1 做什么、明确不做什么 |
| 01 | 架构总览 | 进程/窗口、内核职责、每只宠物的管线 |
| 02 | 资源与仲裁 | 谁能改宠物的什么、冲突怎么解决 |
| 03 | 片段与动作 | 画面和运动如何分离、如何合成 |
| 04 | 宠物包格式 | 画图的人交付什么 |
| 05 | Agent 信号 | 各 agent 的 hook 如何变成统一信号、如何绑定到宠物 |
| 06 | 插件 API | 写插件的人能做什么、L0–L4 分级 |
| 07 | 从 v0 迁移 | 旧仓库哪些搬、哪些扔 |
| 08 | 技术原型计划 | 开工前要先验证的风险（已验证，含实测） |
| 09 | 路线图 | 里程碑、已确认的取舍、怎么看当前效果 |
给 AI 助手的工作约定见 AGENTS.md。
前置：Windows 10+、Node.js ≥ 20、Rust stable（MSVC）。
npm install
npm run tauri dev # 开发运行
npm test # 单元测试（vitest）
npm run typecheck
npm run tauri build # NSIS 安装包 → src-tauri/target/release/bundle/nsis/目录：src-tauri/ 宿主（Rust）· src/kernel/ 内核 · src/render/ 渲染器 · src/plugins/ 内置插件 · src/api/types.ts 插件 API 类型 · public/packs/default/ 内置宠物包 · examples/plugins/ 示例插件 · tools/ 一次性脚本 · spike/ 已冻结的技术原型。
AGPL-3.0-or-later。