init: ShowenV2 项目骨架 — 数字生命窗口平台

- core/ 跨平台内核骨架 (Plugin trait, Message, ServiceManager, Config) - plugins/ 空桩 (video, http, ble, screen, wifi) - PROGRESS.md 进度跟踪, TEAM.md 团队档案 - cargo check 零 warning 通过 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 05:03:58 +08:00
commit 23f4d46287
21 changed files with 2223 additions and 0 deletions
--- a/PROGRESS.md
+++ b/PROGRESS.md
@@ -0,0 +1,147 @@
+# ShowenV2 — 数字生命窗口平台
+
+## 愿景
+ShowenV2 不仅是全息宠物播放器，而是一个**通用数字生命窗口平台**。
+
+支持的显示模式：
+- **全息显示** — 半透镜 45° 伪全息（当前硬件）
+- **VR** — 头显输出（未来）
+- **AR** — 增强现实叠加（未来）
+- **直接屏幕** — 普通显示器/手机/平板
+
+支持的内容类型：
+- **宠物动画** — 视频状态机驱动的虚拟宠物（当前核心）
+- **3D 模型** — 实时渲染 3D 角色/物体
+- **数字人** — AI 驱动的虚拟形象
+- **AI 歌姬** — 人工歌姬/虚拟歌手
+- **未来内容** — 通过插件无限扩展
+
+核心理念：**平台不关心内容是什么，插件决定一切**。
+
+---
+
+## 项目信息
+- 旧项目: `/home/showen/Showen/hologram_player_rust/` (单体全息宠物播放器)
+- 新项目: `/home/showen/Showen/ShowenV2/`
+- 架构: 跨平台插件内核 + 功能插件
+
+---
+
+## 架构概览
+
+```
+┌─────────────────────────────────────────────────────┐
+│                    main.rs                          │
+│   加载配置 → 按平台注册插件 → ServiceManager.run()   │
+├─────────────────────────────────────────────────────┤
+│              core/ (跨平台内核，零业务逻辑)           │
+│  ServiceManager  — 插件注册/生命周期/消息路由         │
+│  Plugin trait    — 统一插件接口                      │
+│  Message enum    — 类型安全的消息协议                │
+│  Config          — 配置解析/验证（纯 serde）         │
+├─────────────────────────────────────────────────────┤
+│              plugins/ (一切皆插件)                   │
+│                                                     │
+│  ┌─ 渲染引擎 ─────────────────────────────────┐     │
+│  │ video/   — 视频播放 (OpenCV, 当前核心)      │     │
+│  │ render/  — 3D渲染引擎 (未来: wgpu/vulkan)  │     │
+│  │ avatar/  — 数字人驱动 (未来: Live2D等)      │     │
+│  └────────────────────────────────────────────┘     │
+│                                                     │
+│  ┌─ 显示后端 ─────────────────────────────────┐     │
+│  │ screen/  — 屏幕管理 (X11/fbv/唤醒锁/光标) │     │
+│  │ vr/      — VR 输出 (未来: OpenXR)          │     │
+│  │ ar/      — AR 叠加 (未来)                  │     │
+│  └────────────────────────────────────────────┘     │
+│                                                     │
+│  ┌─ 连接/交互 ────────────────────────────────┐     │
+│  │ http/    — Web UI + REST API (warp)        │     │
+│  │ ble/     — BLE 配网 (dbus BlueZ)           │     │
+│  │ wifi/    — WiFi 管理 (nmcli)               │     │
+│  │ voice/   — 语音交互 (未来: ASR/TTS)        │     │
+│  │ sensor/  — 传感器输入 (未来: GPIO/触摸)     │     │
+│  └────────────────────────────────────────────┘     │
+│                                                     │
+│  ┌─ AI 引擎 ──────────────────────────────────┐     │
+│  │ ai/      — LLM 对话 (未来)                 │     │
+│  │ singer/  — AI 歌姬 (未来: 歌声合成)        │     │
+│  └────────────────────────────────────────────┘     │
+└─────────────────────────────────────────────────────┘
+```
+
+**关键**: 内核 core/ 完全不知道"宠物""歌姬""3D模型"的存在。
+它只知道"插件发消息、收消息、有生命周期"。
+内容类型、显示方式、交互模式全部由插件组合决定。
+
+---
+
+## 当前实现范围 (Phase 1)
+
+Phase 1 的目标：**完整迁移旧功能到新架构**，确保在 ARM 设备上运行正常。
+
+| 插件 | 来源 | 平台 | 状态 |
+|------|------|------|------|
+| core/ | 新建 | Any | 进行中 |
+| plugins/video/ | video_processor.rs + state_machine.rs | OpenCV | 待迁移 |
+| plugins/http/ | api_server.rs | warp | 待迁移 |
+| plugins/ble/ | ble_service.rs | Linux dbus | 待迁移 |
+| plugins/screen/ | screen_wake_lock.rs | Linux | 待迁移 |
+| plugins/wifi/ | api_server.rs WiFi部分 | Linux nmcli | 待迁移 |
+
+未来 Phase 的插件 (render/, avatar/, vr/, ar/, voice/, ai/, singer/) 只需定义接口预留，不实现。
+
+---
+
+## 提交计划
+
+### Commit 1: 项目骨架 + 愿景文档
+- [x] PROGRESS.md 平台愿景与架构
+- [x] Cargo.toml, rust-toolchain.toml
+- [ ] core/plugin.rs — Plugin trait + PluginInfo + PluginContext + Platform
+- [ ] core/message.rs — Message/Envelope/Destination (通用消息，不限于宠物)
+- [ ] core/service_manager.rs — ServiceManager 骨架
+- [ ] core/config.rs — AppConfig 类型定义
+- [ ] core/mod.rs, lib.rs
+- [ ] plugins/ 空桩 (video, http, ble, screen, wifi)
+- [ ] main.rs 入口
+- 验证: `cargo check` 通过
+
+### Commit 2: 配置系统完整实现
+- [ ] core/config.rs 完整验证逻辑
+- [ ] configs/dog_state_machine.json, cat_state_machine.json
+
+### Commit 3: ServiceManager 消息路由
+- [ ] register(), start_all(), run(), stop_all()
+- [ ] mpsc 通道消息循环 + Broadcast 支持
+
+### Commit 4: VideoPlugin 视频播放
+- [ ] plugins/video/processor.rs (VideoTransformer + VideoProcessor)
+- [ ] plugins/video/state_machine.rs (StateMachine)
+- [ ] plugins/video/mod.rs (Plugin trait impl)
+
+### Commit 5: HttpPlugin HTTP API
+- [ ] plugins/http/routes.rs (warp 路由)
+- [ ] plugins/http/mod.rs (Plugin trait impl)
+- [ ] 内嵌 Web UI HTML
+
+### Commit 6: BlePlugin (含 LocalName 修复)
+- [ ] plugins/ble/gatt.rs — 双 D-Bus 连接修复
+- [ ] plugins/ble/mod.rs (Plugin trait impl)
+
+### Commit 7: ScreenPlugin + WifiPlugin
+- [ ] plugins/screen/mod.rs (唤醒锁+光标)
+- [ ] plugins/wifi/mod.rs (nmcli)
+
+### Commit 8: 集成 main.rs + 编译验证
+- [ ] 串联所有插件
+- [ ] cargo build --release
+
+---
+
+## 关键决策记录
+1. **Rust edition 2018** — 兼容设备 stable toolchain
+2. **std::sync::mpsc** 消息传递 — VideoPlugin 在阻塞线程运行，不能全异步
+3. **BLE 双连接修复** — conn_server 处理回调, conn_client 同步注册
+4. **Message 枚举通用化** — 不绑定特定内容类型，Custom 变体支持未来插件
+5. **Platform 枚举** — 插件声明自己适用的平台，main.rs 按运行时平台选择
+6. **项目名 ShowenV2** — 不叫 hologram_player，因为不止全息