# 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 |
| 6 | `8ed9c93` | BLE/WiFi 状态回传 + WebSocket 编译修复 | 全员 |
| 7 | `45c0a8d` | Video 单元测试 + on_video_completed 逻辑修复 | 全员 |
| 8 | `404196f` | 插件架构审查报告 | 王思远 |
| 9 | `6048831` | 新旧功能差异分析 | 李明哲 |
| 10 | `5af7fc1` | core 集成测试 + bug修复 + API文档重写 + HTTP兼容路由 | CEO+全员 |
| 11 | `4edbd34` | ConfigReloadRequest 闭环（P0消除）| CEO |

### 🔄 第四轮 P1 进行中

| 成员 | 任务 | 文件 | 状态 |
|------|------|------|------|
| 张明远 | 自由模式随机游走回补 | plugins/video/state_machine.rs | 🔄 执行中 |
| 李思琪 | /api/playlist 快照语义 | plugins/http/routes.rs, plugins/video/mod.rs | 🔄 执行中 |
| 赵雨薇 | 暂停释放防息屏 | core/message.rs, plugins/video/mod.rs, plugins/screen/mod.rs | 🔄 执行中 |

### ⏳ 待完成

| 任务 | 说明 | 优先级 |
|------|------|--------|
| BLE notify 真实落地 | GATT PropertiesChanged 信号 | P1 |
| 依赖图自动化测试 | 防止文档与代码漂移 | P1 |
| cargo build --release | 完整编译验证 | P0 |
| 实机运行测试 | 在 ARM 设备上验证 | P0 |

---

## 架构概览

```
┌─────────────────────────────────────────────────────┐
│                    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** |