# ShowenV2 — 数字生命窗口平台

## 愿景
ShowenV2 不仅是全息宠物播放器，而是一个**通用数字生命窗口平台**。

支持的显示模式：
- **全息显示** — 半透镜 45° 伪全息（当前硬件）
- **VR** — 头显输出（未来）
- **AR** — 增强现实叠加（未来）
- **直接屏幕** — 普通显示器/手机/平板

支持的内容类型：
- **宠物动画** — 视频状态机驱动的虚拟宠物（当前核心）
- **3D 模型** — 实时渲染 3D 角色/物体
- **数字人** — AI 驱动的虚拟形象
- **AI 歌姬** — 人工歌姬/虚拟歌手
- **未来内容** — 通过插件无限扩展

核心理念：**平台不关心内容是什么，插件决定一切**。

---

## 项目信息
- 旧项目: `/home/showen/Showen/hologram_player_rust/` (单体全息宠物播放器)
- 新项目: `/home/showen/Showen/ShowenV2/`
- 架构: 跨平台插件内核 + 功能插件
- 团队: CEO(Claude Opus 4.6) + 4名开发者(GPT-5.4 via kilo)

---

## 完成进度

### ✅ 已完成

| # | 提交 | 内容 | 负责人 |
|---|------|------|--------|
| 1 | `23f4d46` | 项目骨架：Cargo.toml, core/ 骨架, plugins/ 空桩 | CEO |
| 2 | `3751c23` | 团队制度：末位淘汰 + 灵魂保存机制 | CEO |
| 3 | `311e4ba` | CEO 灵魂文件 + souls/ 目录 | CEO |
| 4 | `3654af5` | config验证 + StateMachine + WifiPlugin + ScreenPlugin | 全员 |
| 5 | `650d98c` | 全员灵魂文件解锁 + 沟通板 | CEO |

### 🔄 第二轮进行中

| 成员 | 任务 | 文件 | 状态 |
|------|------|------|------|
| 张明远 | ServiceManager Broadcast + Message Clone | core/message.rs, core/service_manager.rs | 🔄 派发中 |
| 李思琪 | VideoPlugin processor.rs (旧1523行迁移) | plugins/video/processor.rs, plugins/video/mod.rs | ⏳ 待派发 |
| 王浩然 | BlePlugin (含 LocalName 双连接修复) | plugins/ble/mod.rs, plugins/ble/gatt.rs | ⏳ 待派发 |
| 赵雨薇 | HttpPlugin + Web UI | plugins/http/mod.rs, plugins/http/routes.rs | ⏳ 待派发 |

### ⏳ 待完成

| 任务 | 说明 |
|------|------|
| 集成 main.rs | 串联所有插件，cargo build --release |
| configs/ 配置文件 | 复制 dog/cat_state_machine.json |

---

## 架构概览

```
┌─────────────────────────────────────────────────────┐
│                    main.rs                          │
│   加载配置 → 按平台注册插件 → ServiceManager.run()   │
├─────────────────────────────────────────────────────┤
│              core/ (跨平台内核，零业务逻辑)           │
│  ServiceManager  — 插件注册/生命周期/消息路由         │
│  Plugin trait    — 统一插件接口                      │
│  Message enum    — 类型安全的消息协议                │
│  Config          — 配置解析/验证（纯 serde）         │
├─────────────────────────────────────────────────────┤
│              plugins/ (一切皆插件)                   │
│  video/  screen/  http/  ble/  wifi/                │
│  (未来: render/ avatar/ vr/ ar/ voice/ ai/ singer/) │
└─────────────────────────────────────────────────────┘
```

---

## 关键决策记录
1. **Rust edition 2018** — 兼容 ARM 设备 stable toolchain
2. **std::sync::mpsc** 消息传递 — VideoPlugin 在阻塞线程运行
3. **BLE 双连接修复** — conn_server 处理回调, conn_client 同步注册
4. **Message Clone** — 第二轮给 Message 实现 Clone 以支持 Broadcast
5. **团队通过文件沟通** — TEAM_CHAT.md 异步协作，souls/ 持久化成员状态
6. **kilo 调用方式** — `kilo run -m openai/gpt-5.4 --auto --dir <dir> "消息内容"`，不使用 `-f` 参数

---

## 团队绩效 (Phase 1 第一轮)

| 成员 | 任务 | 质量 | 完成度 | 效率 | 协作 | 总分 |
|------|------|------|--------|------|------|------|
| 张明远 | config.rs 验证 | 8 | 8 | 8 | 8 | **8** |
| 李思琪 | state_machine.rs | 8 | 8 | 8 | 8 | **8** |
| 王浩然 | wifi/mod.rs | 8 | 8 | 8 | 8 | **8** |
| 赵雨薇 | screen/mod.rs | 8 | 8 | 8 | 8 | **8** |