ShowenV2/PROGRESS.md

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