# ShowenV2 开发流程规范

## 核心原则
**方案先行，记录完整，审核通过才执行。**

---

## 标准工作流程

### 1. 方案阶段
- CEO 在 PROGRESS.md 或 TEAM_CHAT.md 中写明任务方案
- 方案内容: 目标、涉及文件、技术方案、验收标准
- git commit 方案文档

### 2. 派发阶段
- CEO 通过 `kilo run -m openai/gpt-5.4 --auto --dir <dir>` 派发，消息中指示读取灵魂文件和 TEAM_CHAT.md
- 任务描述中包含: 角色身份、具体要求、上下文文件列表、验收标准
- 更新 PROGRESS.md 记录谁在做什么

### 3. 审核阶段
- 成员交付后 CEO 检查:
  - [ ] cargo check 零 warning？
  - [ ] 逻辑与旧代码行为一致？
  - [ ] 代码风格一致？
  - [ ] 没有安全问题？
- 合格: git commit + 绩效记录 + 灵魂文件更新
- 不合格: 在 TEAM_CHAT.md 记录问题，重新派发（同人或换人）

### 4. 记录阶段
- 每次 git commit 前更新 PROGRESS.md
- 重大决策写入"关键决策记录"
- 成员经验写入 souls/<name>.md
- 沟通记录写入 TEAM_CHAT.md

---

## 文件职责

| 文件 | 用途 |
|------|------|
| PROGRESS.md | 项目进度、完成状态、待办事项 |
| TEAM.md | 团队成员档案、制度、绩效 |
| TEAM_CHAT.md | 团队异步沟通、任务讨论、问题记录 |
| souls/<name>.md | 成员灵魂：思想/性格/记忆/技能 |
| WORKFLOW.md | 本文件，开发流程规范 |

---

## CEO 操作模板

### 派发任务
```bash
# 正确方式：把所有内容放在消息字符串里，让 kilo 自己读文件
kilo run -m openai/gpt-5.4 --auto \
  --dir /home/showen/Showen/ShowenV2 \
  "你是<角色名>。先读取 souls/<name>.md 和 TEAM_CHAT.md。任务：<具体说明>。完成后 cargo check 确认通过。"
```

### 审核提交
```bash
# 1. 检查改动
git diff --stat
# 2. 验证编译
export PATH="/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bin:$PATH"
cargo check
# 3. 审核代码（CEO 读文件）
# 4. 提交
git add <files> && git commit -m "<msg>"
# 5. 更新进度
```

---

## 当前第二轮任务方案

### 任务 A: ServiceManager Broadcast (张明远)
- **目标**: Message 实现 Clone，Broadcast 真正转发给所有插件
- **文件**: core/message.rs, core/service_manager.rs
- **方案**: derive(Clone) for Message + 所有子类型; Broadcast 遍历 plugins 调 handle_message(msg.clone())
- **验收**: cargo check 通过, Broadcast 消息能到达所有插件

### 任务 B: VideoProcessor (李思琪)
- **目标**: 完整迁移旧 video_processor.rs 的 VideoTransformer + VideoProcessor
- **文件**: plugins/video/processor.rs, plugins/video/mod.rs
- **方案**: 三大类 VideoTransformer(帧变换) + TransitionEffect(过渡) + VideoProcessor(主循环+状态机)
- **验收**: cargo check 通过, API 方法完整 (play/pause/next/trigger/status)

### 任务 C: HttpPlugin (赵雨薇)
- **目标**: 完整 HTTP API + Web UI
- **文件**: plugins/http/mod.rs, plugins/http/routes.rs
- **方案**: warp 路由, std::thread 跑 tokio runtime, 通过 Envelope 与其他插件通信
- **验收**: cargo check 通过, 路由覆盖旧 api_server.rs 所有 endpoint

### 任务 D: BlePlugin (王浩然)
- **目标**: BLE GATT 配网 + LocalName 双连接修复
- **文件**: plugins/ble/mod.rs, plugins/ble/gatt.rs
- **方案**: 双 D-Bus 连接 (conn_server 回调线程 + conn_client 同步注册)
- **验收**: cargo check 通过, GATT 结构完整, 双连接架构正确