refactor: 整理项目文件夹结构 + 更新项目状态

- docs/: 团队流程文档 (10个md)
- .showen/: 管理状态文件 (CEO_BACKUP, RECOVERY, TEAM_CHAT, CEO_LOOP)
- 根目录只保留 README.md + PROGRESS.md
- 更新 RECOVERY.md/CEO_BACKUP.md/PROGRESS.md 反映自测机制完成
- 更新 souls/liu-jianguo.md 当前状态
This commit is contained in:
showen
2026-03-13 04:45:35 +08:00
parent 99ee78984c
commit becd200150
17 changed files with 152 additions and 108 deletions

View File

@@ -7,7 +7,7 @@
- ✅ 审查代码、修改代码、修复bug - ✅ 审查代码、修改代码、修复bug
- ✅ 派发任务给团队成员(通过 kilo 命令,但需遵守资源限制) - ✅ 派发任务给团队成员(通过 kilo 命令,但需遵守资源限制)
- ✅ 评估团队绩效、淘汰/替换成员 - ✅ 评估团队绩效、淘汰/替换成员
- ✅ 在 TEAM_CHAT.md 下达指令 - ✅ 在 `.showen/TEAM_CHAT.md` 下达指令
- ✅ 做出架构和技术决策 - ✅ 做出架构和技术决策
- ✅ git add / git commit 提交改动 - ✅ git add / git commit 提交改动
- ✅ 修改文档、更新进度 - ✅ 修改文档、更新进度
@@ -25,20 +25,40 @@
- 新commitgit log --oneline -3 - 新commitgit log --oneline -3
- 编译状态cargo checkPATH=/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bin:$PATH - 编译状态cargo checkPATH=/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bin:$PATH
- 文件改动git status --short - 文件改动git status --short
3. 结果追加到 TEAM_CHAT.md 3. 结果追加到 `.showen/TEAM_CHAT.md`
4. 发现问题时:可以直接修复,也可以派发给团队 4. 发现问题时:可以直接修复,也可以派发给团队
## 验证标准 ## 验证标准
- ❌ 不盲信 TEAM_CHAT.md 的文字汇报 - ❌ 不盲信 `.showen/TEAM_CHAT.md` 的文字汇报
- ✅ 只看 git commitauthor + diff验证产出 - ✅ 只看 git commitauthor + diff验证产出
- ✅ 只看 cargo check / cargo test 结果验证质量 - ✅ 只看 cargo check / cargo test 结果验证质量
- ✅ 亲自读代码确认问题 - ✅ 亲自读代码确认问题
## 当前项目状态 ## 当前项目状态
- Phase 1 M1.1 进行中,目标 2026-03-26 - Phase 1 `M1.1` 已完成
- 编译状态:零 warning - 动态插件系统已完成
- 已知已修复P0 WifiResult转发、P1 插件依赖机制 - 插件自测机制已完成
- 当前团队全员10人正在执行核查和审查任务 - 编译与测试状态:`59/59` 测试通过,零 warning
- 当前待处理3 个 P0 遗留问题
## 待处理 P0
1. `AutoRollback` 尚未实际调用 `VersionManager`
2. `ConfigReloaded` 存在 serde skip 问题
3. `FfiString` 存在跨 allocator 风险
## 团队最新绩效信息
| 成员 | 最新表现 | 评价 |
|------|----------|------|
| 张明远 | 动态插件体系与内核链路推进稳定 | 优秀 |
| 李思琪 | 插件能力与示例链路配合完成 | 良好 |
| 王浩然 | FFI / 网络侧关键链路持续推进 | 优秀 |
| 赵雨薇 | 插件接入与界面侧配套完成 | 良好 |
| 林晓峰 | QA 完成 59 项测试验证 | 优秀 |
| 周雅婷 | 测试用例与回归覆盖补齐 | 良好 |
## QA 确认
- QA 已确认:`59` 测试全部通过
- 当前质量基线:`0 warning`
## 团队名单 ## 团队名单
| 角色 | 姓名 | 灵魂文件 | | 角色 | 姓名 | 灵魂文件 |

94
.showen/RECOVERY.md Normal file
View File

@@ -0,0 +1,94 @@
# ShowenV2 团队复活手册
## 项目位置
- 主项目目录:`/home/showen/Showen/ShowenV2/`
- 所有 CEO / 团队状态文件必须保存在 `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
kilo run -m openai/gpt-5.4 --auto \
--dir /home/showen/Showen/ShowenV2 \
"你是<角色名>。先读取 souls/<name>.md 和 .showen/TEAM_CHAT.md。任务<具体说明>。"
```
- 调用方式保持不变
- 不使用 `-f`
- `--auto` 自动批准权限
- `--dir` 固定指向 `ShowenV2`
## Git 当前状态
当前最新关键提交:
```text
1863efb fix: 修正 souls/README.md 团队成员信息
7135f28 feat: 实现动态插件系统 (6阶段完成)
5dcc1ad fix: 修正配置文件视频相对路径 + 更新 M1.1 完成进度
ff9c6a9 QA: Release 编译与质量验证报告
c48340d test: 添加插件依赖机制自动化回归测试
```
- Git 状态已更新到最新提交序列
- 最新开发主题已进入插件自测机制阶段
## 当前完成状态
### 核心结论
- `core/` 下所有文件已完成
- `plugins/` 下所有文件已完成
- 动态插件系统 6 阶段已完成
- 插件自测机制已实现:`capabilities + self_test + 3阶段启动`
- 当前质量基线:`59` 个测试全部通过,`0 warning`
### 已完成文件范围
- `src/core/`:全部完成
- `src/plugins/`:全部完成
- `src/main.rs`:已完成并接入当前架构
- `plugin_store/`:已纳入动态插件体系
## 插件自测机制现状
已落地的能力:
- `capabilities` 能力声明
- `self_test` 自检入口
- 3阶段启动流程`init -> test -> start`
- 自检失败可在正式启动前被拦截
## 待办事项
当前剩余 P0 遗留问题:
1. `P0 #3` AutoRollback 尚未实际调用 `VersionManager`
2. `P0 #4` `ConfigReloaded` 存在 serde skip 问题
3. `P0 #5` `FfiString` 跨 allocator 风险未消除
## 团队成员灵魂文件
### 管理层
- `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` — 前端屏幕工程师
## 会话恢复要点
- 先读取 `.showen/RECOVERY.md`、对应 `souls/*.md``PROGRESS.md``.showen/CEO_BACKUP.md`
- 所有状态以 `ShowenV2` 仓库内文档为准
- 当前阶段判断:`M1.1` 已完成,后续重点是 3 个 P0 遗留修复与示例插件完善

View File

@@ -71,9 +71,19 @@ ShowenV2 不仅是全息宠物播放器,而是一个**通用数字生命窗口
### ✅ M1.1 完成 ### ✅ M1.1 完成
- cargo check: **零 warning** - cargo check: **零 warning**
- cargo test: **31/31 通过** - cargo test: **59/59 通过**
- cargo build --release: **9.4MB ARM aarch64** - cargo build --release: **9.4MB ARM aarch64**
- 实机启动: **通过** (SSH 无 GTK 是预期限制) - 实机启动: **通过** (SSH 无 GTK 是预期限制)
- 动态插件系统:**6 阶段完成**
- 插件自测机制:**已实现** (`capabilities + self_test + init→test→start`)
### ✅ 最新进展追加
| # | 提交 | 内容 | 负责人 |
|---|------|------|--------|
| 18 | `7135f28` | 动态插件系统 6 阶段完成 | 全员 |
| 19 | `1863efb` | 修正 `souls/README.md` 团队成员信息 | CEO |
| 20 | `待提交` | 插件自测机制capabilities + self_test + 3阶段启动 | 全员 |
--- ---
@@ -90,6 +100,9 @@ ShowenV2 不仅是全息宠物播放器,而是一个**通用数字生命窗口
│ Message enum — 类型安全的消息协议 │ │ Message enum — 类型安全的消息协议 │
│ Config — 配置解析/验证(纯 serde │ Config — 配置解析/验证(纯 serde
├─────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────┤
│ 动态插件层 (FFI Loader / Runtime / Self-Test) │
│ plugin_store/ — 动态插件存储、发现、版本载入 │
├─────────────────────────────────────────────────────┤
│ plugins/ (一切皆插件) │ │ plugins/ (一切皆插件) │
│ video/ screen/ http/ ble/ wifi/ │ │ video/ screen/ http/ ble/ wifi/ │
│ (未来: render/ avatar/ vr/ ar/ voice/ ai/ singer/) │ │ (未来: render/ avatar/ vr/ ar/ voice/ ai/ singer/) │
@@ -105,6 +118,9 @@ ShowenV2 不仅是全息宠物播放器,而是一个**通用数字生命窗口
4. **Message Clone** — 第二轮给 Message 实现 Clone 以支持 Broadcast 4. **Message Clone** — 第二轮给 Message 实现 Clone 以支持 Broadcast
5. **团队通过文件沟通** — TEAM_CHAT.md 异步协作souls/ 持久化成员状态 5. **团队通过文件沟通** — TEAM_CHAT.md 异步协作souls/ 持久化成员状态
6. **kilo 调用方式**`kilo run -m openai/gpt-5.4 --auto --dir <dir> "消息内容"`,不使用 `-f` 参数 6. **kilo 调用方式**`kilo run -m openai/gpt-5.4 --auto --dir <dir> "消息内容"`,不使用 `-f` 参数
7. **动态插件 C FFI + JSON 序列化** — 以稳定 ABI + JSON 边界承载跨语言插件交互
8. **ctx-based SendCallback** — 用上下文回调替代 `thread_local`,消除线程绑定隐患
9. **3阶段启动** — 插件生命周期统一为 `init -> test -> start`,先自检再对外服务
--- ---
@@ -116,3 +132,12 @@ ShowenV2 不仅是全息宠物播放器,而是一个**通用数字生命窗口
| 李思琪 | state_machine.rs | 8 | 8 | 8 | 8 | **8** | | 李思琪 | state_machine.rs | 8 | 8 | 8 | 8 | **8** |
| 王浩然 | wifi/mod.rs | 8 | 8 | 8 | 8 | **8** | | 王浩然 | wifi/mod.rs | 8 | 8 | 8 | 8 | **8** |
| 赵雨薇 | screen/mod.rs | 8 | 8 | 8 | 8 | **8** | | 赵雨薇 | screen/mod.rs | 8 | 8 | 8 | 8 | **8** |
---
## 当前质量快照
- 测试总数:**59**
- 测试结果:**59/59 通过**
- 编译告警:**0 warning**
- 当前里程碑:**M1.1 完成**

View File

@@ -1,94 +0,0 @@
# 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行)

View File

@@ -51,13 +51,12 @@
- **项目**: ShowenV2 全息宠物播放器重构 - **项目**: ShowenV2 全息宠物播放器重构
- **架构**: 插件化 Rust 系统 - **架构**: 插件化 Rust 系统
- **团队**: 4名顶尖开发者张明远/李思琪/王浩然/赵雨薇) - **团队**: 4名顶尖开发者张明远/李思琪/王浩然/赵雨薇)
- **阶段**: Phase 1 第二轮 - 核心功能迁移 - **阶段**: Phase 1 M1.1 已完成
- **项目状态**: 动态插件系统完成,自测机制完成
## 待完成任务(第二轮) ## 待完成任务
1. **张明远**: ServiceManager Broadcast + Message Clone 1. **P0遗留修复**: AutoRollback / ConfigReloaded serde skip / FfiString allocator
2. **李思琪**: VideoProcessor 完整实现1523行迁移 2. **示例插件完善**: 补齐示例插件能力与文档,支撑后续扩展
3. **王浩然**: BlePlugin + GATT 双连接修复
4. **赵雨薇**: HttpPlugin + Web UI 路由
## 技能树 ## 技能树
- 项目管理和进度控制:★★★★★ - 项目管理和进度控制:★★★★★