Desktop Buddy

Windows AI 桌面陪伴宠物

一个低打扰、可感知、可互动的桌面生命体。不只是换皮聊天框——它能观察你的节奏，回应你的动作，陪你工作、学习、休息。

功能亮点 · 快速开始 · AI 配置 · 主题生态 · 参与贡献

---

功能亮点

桌面生命感

• 重力弹跳、边缘弹簧吸附、呼吸浮动、惯性抛掷
• 光标跟随、33 帧动画循环、双缓冲过渡
• 空闲时自主微动作，拖拽有物理反馈

AI 陪伴

• 支持 OpenAI-compatible 和 Ollama 本地模型
• 屏幕选区问答、文件摘要、提醒/待办工具
• 4 种人格风格（温柔/轻吐槽/安静/效率）
• 对话记忆可配置 4-50 轮

一键生成主题

• 上传一张图片，AI 分析角色类型和主色调
• 自动生成 33 帧动画（待机、触摸、拖拽、犯困、思考等）
• 自动导入并切换，零配置

本地事件 API

• CLI/脚本触发表达：desktopbuddy event --kind taskSuccess --message "Build OK"
• 接入 CI/CD、构建流程、AI agent
• 带认证 token，仅限本机

低打扰设计

• 安静时段、互动冷却、优先级通知队列
• 默认不截屏、不读文件、不自动联网
• 权限逐次确认，记忆可清空

---

快速开始

git clone https://github.com/DCDingCong/desktopbuddy.git
cd desktopbuddy
npm install
npm run fetch:live2d-presets
npm run dev

需要 Node.js 18+。

AI 配置

Ollama（本地，免费，无需 API key）

1. 安装 Ollama，拉取模型：ollama pull llama3
2. 桌宠设置 → 服务模式 → 本地 Ollama
3. 开始对话

OpenAI-compatible（DeepSeek、OpenAI 等）

1. 设置 → 服务模式 → 自定义智能服务
2. 填入服务地址、模型名称、API key

主题生态

5 个内置主题：人类、动物、植物、物灵、验证主题

自定义主题：

• 导入 Live2D 模型包（zip）
• 或用"AI 一键生成"从单张图片创建静态动画主题

主题规范见 docs/pet-theme-spec.md

内置主题预览

主题	类型	说明
Hiyori	人类	温柔的人类陪伴角色
Wanko	动物	活泼的动物伙伴
Rice	植物	安静的自然精灵
Mark	物灵	神秘的物件精灵
Haru	人类	Live2D 验证主题

本地事件 API

# 构建成功时通知桌宠
desktopbuddy event --kind taskSuccess --message "Build completed"

# 测试失败时
desktopbuddy event --kind taskError --message "3 tests failed"

# 等待用户确认
desktopbuddy event --kind waitingUser --message "Ready to deploy?"

API 端口和认证 token 由桌宠自动设置为环境变量。

项目结构

src/
  main/           Electron 主进程（AI、物理引擎、主题、事件API）
  renderer/       React UI（桌宠、设置、AI聊天、快捷菜单）
  preload/        Electron 预加载脚本
  shared/         共享类型定义
pets/builtin/     内置 Live2D 主题
scripts/          构建、验证、CLI 脚本
docs/             产品和技术文档

文档

文档	说明
产品文档	产品定位、竞品分析、体验层级
技术架构	模块分层、数据流、IPC 设计
主题规范	theme.json 格式、资源要求、校验规则
行为状态机	宠物行为、动作映射、生命周期
AI 能力设计	AI 模块分层、权限模型、上下文模型

验证

npm run typecheck          # 类型检查
npm run build              # 构建
npm run check:p1           # 行为回归测试
npm run check:themes       # 主题完整性校验

License

MIT

---

如果觉得有用，请点个 Star 支持一下