dfb194fc6b
记录项目状态、编译环境、kilo正确调用方式、文件完成度、 待完成任务、灵魂文件位置、旧代码参考路径 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
81 lines
3.4 KiB
Markdown
81 lines
3.4 KiB
Markdown
# 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行)
|