docs: 团队复活手册 RECOVERY.md

记录项目状态、编译环境、kilo正确调用方式、文件完成度、
待完成任务、灵魂文件位置、旧代码参考路径

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
showen
2026-03-12 05:39:50 +08:00
parent b331ec3acb
commit dfb194fc6b

80
RECOVERY.md Normal file
View File

@@ -0,0 +1,80 @@
# 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 \
-f /tmp/task-<name>.md \
"请按照附件中的任务说明执行"
```
**注意**:
- `kilo run -f file` 不够,必须有 message 参数
- `-f` 只是附件message 是必需的
- `--auto` 自动批准权限
## 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-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行)