From dfb194fc6bc86ec40774ac27cc0f428851052b6d Mon Sep 17 00:00:00 2001
From: showen <showen@local>
Date: Thu, 12 Mar 2026 05:39:50 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=9B=A2=E9=98=9F=E5=A4=8D=E6=B4=BB?=
 =?UTF-8?q?=E6=89=8B=E5=86=8C=20RECOVERY.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 RECOVERY.md | 80 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 RECOVERY.md

diff --git a/RECOVERY.md b/RECOVERY.md
new file mode 100644
index 0000000..e61a9aa
--- /dev/null
+++ b/RECOVERY.md
@@ -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行)