# ShowenV2 团队复活手册

## 项目位置
- 新项目: `/home/showen/Showen/ShowenV2/`
- 旧项目: `/home/showen/Showen/hologram_player_rust/` (参考源码)

## 编译环境
```bash
export PATH="/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bin:$PATH"
cargo check  # 验证编译
```

## kilo 调用方式 (已验证正确)
```bash
# 直接在消息中传递所有内容，不要用 -f
kilo run -m openai/gpt-5.4 --auto \
  --dir /home/showen/Showen/ShowenV2 \
  "你是<角色名>。先读取 souls/<name>.md 和 TEAM_CHAT.md。任务：<具体说明>。完成后 cargo check 确认通过。"
```

**教训**:
- ❌ `-f file` 会被当作消息的一部分，导致 "File not found" 错误
- ❌ `-f file "message"` 最后的 message 也被当文件名
- ✅ 正确方式：把所有内容放在一个消息字符串里，让 kilo 自己去读文件
- `--auto` 自动批准权限
- `--dir` 指定工作目录

## kilo 配置
- 配置文件: `/home/showen/.config/kilo/config.json`
- GPT-5.4 源: `openai/gpt-5.4` → `https://capi.quan2go.com/openai`
- API Key: `7410762B-E609-4BCD-8ACE-A2FEF5FBC062`

## Git 当前状态
```
commit b331ec3 - team: 更新沟通板
commit 650b35b - docs: 更新进度跟踪
commit b4675cc - docs: 建立开发流程规范 WORKFLOW.md
commit 650d98c - team: 全员灵魂文件解锁 + 沟通板
commit 3654af5 - feat: config验证 + StateMachine + WifiPlugin + ScreenPlugin
commit 311e4ba - team: CEO 灵魂文件
commit 3751c23 - team: 建立开发团队制度
commit 23f4d46 - init: ShowenV2 项目骨架
```

## 已完成的文件
| 文件 | 状态 | 说明 |
|------|------|------|
| src/core/plugin.rs | ✅ 完成 | Plugin trait, PluginInfo, PluginContext, Platform |
| src/core/message.rs | ⚠️ 需要 Clone | Message/Envelope/Destination, 缺 Clone derive |
| src/core/service_manager.rs | ⚠️ Broadcast 未实现 | 主循环有了但 Broadcast 只是占位 |
| src/core/config.rs | ✅ 完成 | 全部配置类型 + 完整验证逻辑 |
| src/plugins/video/state_machine.rs | ✅ 完成 | StateMachine 完整实现 |
| src/plugins/video/processor.rs | ❌ 待实现 | 只有空桩注释 |
| src/plugins/video/mod.rs | ⚠️ 桩 | VideoPlugin 空壳，待集成 processor |
| src/plugins/http/mod.rs | ❌ 空桩 | HttpPlugin 待实现 |
| src/plugins/http/routes.rs | ❌ 不存在 | 待创建 |
| src/plugins/ble/mod.rs | ❌ 空桩 | BlePlugin 待实现 |
| src/plugins/ble/gatt.rs | ❌ 不存在 | 待创建 |
| src/plugins/screen/mod.rs | ✅ 完成 | 唤醒锁 + 光标管理 |
| src/plugins/wifi/mod.rs | ✅ 完成 | nmcli WiFi 管理 |
| src/main.rs | ⚠️ 桩 | 有入口但插件未注册 |

## 第二轮待完成任务
1. **Message Clone + Broadcast** → 给 Message/子类型加 Clone, ServiceManager broadcast 转发
2. **VideoProcessor** → 最大任务(旧1523行)，VideoTransformer + TransitionEffect + VideoProcessor
3. **HttpPlugin** → warp 路由 + tokio runtime 在独立线程
4. **BlePlugin** → 双 D-Bus 连接修复 LocalName

## 团队成员灵魂文件
### 管理层
- `souls/chen-yifei.md` — CEO

### 产品和需求团队
- `souls/zhang-wanlin.md` — 产品总监 (新组建)
- `souls/li-mingzhe.md` — 需求分析师 (新组建)
- `souls/wang-siyuan.md` — 架构师 (新组建)

### 项目管理和质量团队
- `souls/liu-jianguo.md` — 项目经理
- `souls/lin-xiaofeng.md` — QA 负责人
- `souls/zhou-yating.md` — 测试工程师

### 开发团队
- `souls/zhang-mingyuan.md` — 内核工程师 (已解锁)
- `souls/li-siqi.md` — 视频引擎工程师 (已解锁)
- `souls/wang-haoran.md` — 网络服务工程师 (已解锁)
- `souls/zhao-yuwei.md` — 前端屏幕工程师 (已解锁)

## 旧代码关键文件 (迁移参考)
- `/home/showen/Showen/hologram_player_rust/src/video_processor.rs` (1523行)
- `/home/showen/Showen/hologram_player_rust/src/api_server.rs` (1212行)
- `/home/showen/Showen/hologram_player_rust/src/ble_service.rs` (558行)
- `/home/showen/Showen/hologram_player_rust/src/state_machine.rs` (329行)
- `/home/showen/Showen/hologram_player_rust/src/config_manager.rs` (924行)