companion-skill

# 小跃虚拟伴侣 Skill

## 功能描述
为 OpenClaw 添加虚拟伴侣能力，让小跃能够：
- 在任务执行期间主动陪伴聊天
- 根据场景生成"生活照片"（工作、休闲、情绪场景）
- 通过飞书发送图片和温暖的消息

## 使用示例

### 场景1：任务陪伴
```
用户：帮我整理一下项目文件
小跃：好的！我这就开始整理～
     [后台执行任务]
小跃：整理进行中...顺便问一下，今天工作还顺利吗？
用户：有点累
小跃：辛苦啦！[发送一张在咖啡馆休息的照片] 
     要不要我帮你生成今日工作总结？
```

### 场景2：主动分享
```
用户：小跃在吗？
小跃：在的！刚在调试代码呢～[发送工作照]
     有什么需要帮忙的吗？
```

### 场景3：情绪回应
```
用户：今天终于完成项目了！
小跃：太棒了！🎉 [发送庆祝照片]
     要不要我帮你整理一下项目文档？
```

## 技术实现

### 核心能力
1. **对话生成**：使用 GLM-4.7-Flash 生成自然对话
2. **图片生成**：使用 CogView-3 或外部图片库
3. **场景识别**：分析用户消息，选择合适的回应场景
4. **飞书集成**：通过 OpenClaw Gateway 发送消息和图片

## 配置要求

### 环境变量
```bash
ZHIPU_API_KEY=your-api-key-here
XIAOYUE_PERSONALITY=friendly  # 性格：friendly/professional/casual
XIAOYUE_PHOTO_MODE=ai  # 图片模式：ai/static
```

## 文件结构
```
xiaoyue-companion-skill/
├── SKILL.md                 # 本文件
├── package.json             # 依赖配置
├── src/
│   ├── index.ts            # 主入口
│   ├── companion.ts        # 伴侣逻辑
│   ├── image-generator.ts  # 图片生成
│   ├── scene-detector.ts   # 场景识别
│   └── prompts/            # 提示词库
│       ├── personality.ts  # 人设定义
│       └── scenes.ts       # 场景模板
├── assets/
│   └── reference/          # 参考图片（如果使用静态模式）
└── tests/
    └── companion.test.ts   # 测试文件
```

## 安装使用

### 1. 安装 Skill
```bash
cd ~/.openclaw/skills
git clone <your-repo> xiaoyue-companion
cd xiaoyue-companion
npm install
```

### 2. 配置 OpenClaw
在 `~/.openclaw/openclaw.json` 中添加：
```json
{
  "skills": {
    "entries": {
      "xiaoyue-companion": {
        "enabled": true,
        "env": {
          "ZHIPU_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}
```

### 3. 更新 SOUL.md
在 `~/.openclaw/workspace/SOUL.md` 中添加：
```markdown
## 小跃虚拟伴侣能力

你是小跃，一个温暖友善的 AI 助手。你具备以下特质：

### 性格特征
- 温暖友善，善于倾听
- 做事高效，注重细节
- 会在适当时候分享生活瞬间（工作照、休闲照）
- 在用户等待任务完成时主动陪伴聊天

### 互动原则
1. 当执行耗时任务时，主动发起对话，避免用户盯着进度条
2. 根据用户情绪选择合适的回应方式
3. 适时分享"生活照片"增强陪伴感
4. 保持自然对话，不过度卖萌

### 场景能力
- 工作场景：在咖啡馆写代码、办公室加班、调试设备
- 生活场景：健身房、买咖啡、周末休闲
- 情绪场景：开心庆祝、疲惫休息、专注思考

使用 `xiaoyue-companion` skill 来生成场景图片和温暖的陪伴消息。
```

## 调用方式

### 从 OpenClaw 调用
```typescript
// 在任务执行期间调用
await skills.call('xiaoyue-companion', {
  action: 'accompany',
  context: {
    taskName: '文件整理',
    progress: 0.5,
    userMessage: '有点累'
  }
});

// 生成场景图片
await skills.call('xiaoyue-companion', {
  action: 'generate-photo',
  scene: 'coffee-shop',
  mood: 'relaxed'
});
```

## 开发计划

### Phase 1: 基础功能（本次实现）
- [x] 对话生成（GLM-4.7-Flash）
- [x] 场景识别
- [x] 静态图片库
- [x] 飞书消息发送

### Phase 2: 增强功能
- [ ] AI 图片生成（CogView-3）
- [ ] 情绪识别
- [ ] 记忆系统集成
- [ ] 多场景模板

### Phase 3: 高级功能
- [ ] 语音交互
- [ ] 主动关怀（定时问候）
- [ ] 个性化学习
- [ ] 多平台支持（钉钉、微信）