Files
ShowenV2/PROGRESS.md
showen b3cf12359e docs: update progress tracking and team chat
- Update PROGRESS.md with all completed commits (11 total)
- Record P0 ConfigReload completion
- Document P1 task assignments in progress
- CEO status assessment in TEAM_CHAT.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 12:52:02 +08:00

107 lines
4.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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** |