# caring-startup-dog

Adopt this skill: https://proskills.md/skills/automation/caring-startup-dog

Page: https://proskills.md/skills/automation/caring-startup-dog
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: .gitignore
upstream: https://github.com/nodeskai/caring-startup-dog/blob/HEAD/.gitignore

Content is not inlined in the catalog. Read the upstream file: https://github.com/nodeskai/caring-startup-dog/blob/HEAD/.gitignore

## File: LICENSE
upstream: https://github.com/nodeskai/caring-startup-dog/blob/HEAD/LICENSE

Content is not inlined in the catalog. Read the upstream file: https://github.com/nodeskai/caring-startup-dog/blob/HEAD/LICENSE

## File: README.md
upstream: https://github.com/nodeskai/caring-startup-dog/blob/HEAD/README.md

````text
# 关爱创业狗 v0.2.0

**一只像素狗，陪你创业。**

基于 [OpenClaw](https://github.com/NoDeskAI/nodeskclaw) + 飞书 + Cursor/Claude Code 数据，驱动一只 macOS 桌面像素宠物狗，用动画和对话反映你的工作状态。

<p align="center">
  <img src="docs/screenshots/comfort-bubble.png" width="320" />
  <img src="docs/screenshots/coin-drop.png" width="320" />
</p>
<p align="center">
  <img src="docs/screenshots/fun-text.png" width="320" />
  <img src="docs/screenshots/sleeping.png" width="320" />
</p>
<p align="center">
  <img src="docs/screenshots/running-brown.png" width="280" />
  <img src="docs/screenshots/running-skin.png" width="280" />
  <img src="docs/screenshots/daily-report.png" width="280" />
</p>

---

## 产品哲学

### 狗是你的投射，不是你的助手

这只狗不是来"关心你"的 —— 它**就是你**。

创业者不缺建议。每个人都知道该喝水、该休息、该运动。他们缺的是三样东西：

- **被看见** — 不是被提醒，是有一个东西在默默反映"你现在的状态是这样的"。不评判，不指导，就是让你看到自己。
- **被允许** — 创业者最大的心理负担是"我不应该累"。如果狗趴下了，用户会说"不是我要休息，是我的狗需要休息"。
- **被陪伴** — 系统推送提醒像老板，狗默默跟你经历一切像朋友。

### 双需求模型：被看见 vs 被抽离

创业者有两种截然不同的心理需求：

| | 需求 A：被看见 | 需求 B：被抽离 |
|---|---|---|
| **心理机制** | "有人知道我在努力" | "让我喘口气" |
| **触发** | 右键 → 在干嘛 / 今天的日记 / cron 自言自语 | 右键 → 摸摸头 |
| **内容** | 基于真实工作数据的伙伴式反馈 | 与工作完全无关的有趣短文本 |

"摸狗头"本身就暗示了一个心理模型：你在跟一只狗玩，不是在听工作周报。真正的狗被摸头会翻肚皮、甩尾巴、叼个什么东西给你看 —— 纯粹的微笑瞬间。

### 文案视角

狗是创业伙伴，不是旁观者、数据播报员或心理咨询师：

- **"我们"** — 共同经历的辛苦（"我们已经调了好久的前端视觉了！"）
- **"你"** — 赞美和鼓励（"你真厉害"）
- **"我们"** — 休息建议（"我们下去遛遛吧！"）

狗没有独立需求。不说"我饿了"。休息提议永远是"我们一起"。

---

## 功能一览

### 桌面交互

| 操作 | 效果 |
|------|------|
| **左键点击** | 心情面板（1-5 档），记录到本地数据库 |
| **右键 → 摸摸头** | 从预生成 fun-pool 随机取一条趣味文案，零延迟（需求 B） |
| **右键 → 在干嘛** | 调用 LLM 生成基于真实工作内容的伙伴式反馈（需求 A） |
| **右键 → 今天的日记** | 当天叙事回顾 + 心情时间线 |
| **右键 → 换皮肤** | 10 款像素狗皮肤，hover 预览锁定皮肤 |
| **右键 → 修复连接** | 手动触发 cron 健康检查与修复 |
| **悬停** | 显示 LLM 预生成的状态描述 + 连接指示灯 |
| **拖拽** | 移动狗的位置（屏幕边界约束） |
| **点击金币** | 收集金币 + LLM 文案气泡 |

### 金币系统

每小时 cron 完成后，桌面上弹跳掉落一枚像素金币。用户在线时点击收集，附带一段结合当前工作的文案。每 5 枚金币解锁 1 个新皮肤。

金币不是 KPI —— 是时间的痕迹。不累积压力，离线时最多存 1 枚。

### 飞书狗信

每天 3 次随机时间（9:00-22:00，避开午休），狗通过飞书私聊给你写信：

> "你的狗刚拜托我告诉你：我们刚才讨论排期讨论了好久，你推进了好多事情！要不要一起出去走走？"

狗有自己的人格，不是 OpenClaw 的传声筒。

### 日终日记

每天 21:00 后自动推送一封狗视角的一天总结到飞书：

> "你的狗写了今天的日记：上午一直在修前端问题，下午跟苏博文聊了很久排期。今天收集了 3 枚金币"

### 自动机制

| 机制 | 频率 | 说明 |
|------|------|------|
| 数据采集 | 每 10 分钟 | 飞书消息计数 + 编码活动统计 + 狗信/日记触发检查 |
| 完整分析 | 每 1 小时 | LLM 情绪分析 + 自言自语 + fun-pool 刷新 + 金币掉落 |
| 主动询问 | 每 2 小时 | 弹窗问心情状态 |
| 健康检测 | 每 15 分钟 | cron 心跳检查，过期自动修复 |

### 狗的动画

完全由用户自报心情决定，无 energy 公式：

| 心情 | 动画 | 标签 |
|------|------|------|
| 5 | 奔跑 | 冲冲冲! |
| 4 | 走路 | 走走走~ |
| 3 | 坐着 | 有点累了... |
| 2 | 趴着 | 歇会儿... |
| 1 | 睡觉 | zzZ... |

工作数据（消息数、prompt 数、连续工作时长）+ 用户心情两个维度作为 LLM 上下文，让文案像了解你工作情况的朋友那样说话。

### 日期边界

"今天"从凌晨 4 点算起，适配创业者作息。

---

## 数据架构

```
~/.创业狗/
├── status.json           # cron 输出（消息数, 工作摘要, hover_text, coin_ready）
├── comfort-message.json  # LLM 生成的安慰/自言自语
├── fun-pool.json         # cron 预生成的 5 条趣味文案
├── daily-schedule.json   # 当日狗信时间表 + 日记推送标记
├── cron-heartbeat.json   # cron 执行心跳（各步骤成功/失败）
├── user-response.json    # 用户交互反馈
├── activity.jsonl        # Cursor/Claude Code hooks 编码活动
├── config.json           # 飞书表 ID 等配置
└── dog.db                # SQLite（心情 + 工作快照 + 金币 + 皮肤解锁）
```

三个数据源：
1. **飞书** — 消息内容、消息量、日程（第一优先级）
2. **Cursor IDE** — prompt 文本、session 时长
3. **Claude Code** — prompt 文本、session 时长

---

## 安装

### 前提

- [OpenClaw](https://github.com/NoDeskAI/nodeskclaw) 已安装并连接飞书
- macOS (Apple Silicon)

### 安装 Skill

```bash
cp -r skill ~/.openclaw/workspace/skills/caring-startup-dog
```

### 初始化

告诉你的 OpenClaw：

> "帮我初始化 caring-startup-dog"

自动完成：创建数据目录 → 安装 Hooks → 创建飞书表 → 配置 Cron → 安装桌面宠物。

### 手动安装桌面宠物

从 [Releases](https://github.com/NoDeskAI/caring-startup-dog/releases) 下载。

---

## 项目结构

```
├── skill/              # OpenClaw Skill
│   ├── SKILL.md        # Skill 定义与操作流程
│   ├── prompts/        # LLM Prompt 模板（情绪分析/安慰/狗信/日记）
│   └── scripts/        # 安装脚本
├── desktop-pet/        # Tauri 桌面宠物源码
│   ├── src/            # React + Phaser 前端
│   ├── src-tauri/      # Rust 后端（穿透、拖拽、光标检测）
│   └── public/sprites/ # 像素狗皮肤 + 金币素材
├── hooks/              # Cursor/Claude Code Hooks
└── docs/               # 产品文档与截图
```

## 技术栈

- **Skill**: OpenClaw + 飞书 API + LLM
- **桌面宠物**: Tauri v2 + React + Phaser 3 (WebGL) + Zustand + SQLite
- **窗口交互**: cocoa/objc（macOS 原生 API） + setPointerCapture 拖拽 + Rust 全局光标轮询
- **像素素材**: [Pixel Dogs by Benvictus](https://bfreddyberg.itch.io/pixel-dogs)
- **像素字体**: Zpix（中文） + Silkscreen（英文）

## 协议

[Apache License 2.0](LICENSE)
````

## File: test-state-change.sh
upstream: https://github.com/nodeskai/caring-startup-dog/blob/HEAD/test-state-change.sh

Content is not inlined in the catalog. Read the upstream file: https://github.com/nodeskai/caring-startup-dog/blob/HEAD/test-state-change.sh

## File: 产品策划.md
upstream: https://github.com/nodeskai/caring-startup-dog/blob/HEAD/%E4%BA%A7%E5%93%81%E7%AD%96%E5%88%92.md

Content is not inlined in the catalog. Read the upstream file: https://github.com/nodeskai/caring-startup-dog/blob/HEAD/%E4%BA%A7%E5%93%81%E7%AD%96%E5%88%92.md