diff --git a/WORKFLOW.md b/WORKFLOW.md new file mode 100644 index 0000000..c2dd23f --- /dev/null +++ b/WORKFLOW.md @@ -0,0 +1,99 @@ +# ShowenV2 开发流程规范 + +## 核心原则 +**方案先行,记录完整,审核通过才执行。** + +--- + +## 标准工作流程 + +### 1. 方案阶段 +- CEO 在 PROGRESS.md 或 TEAM_CHAT.md 中写明任务方案 +- 方案内容: 目标、涉及文件、技术方案、验收标准 +- git commit 方案文档 + +### 2. 派发阶段 +- CEO 通过 `kilo run -m openai/gpt-5.4 --auto --dir -f <灵魂文件> -f TEAM_CHAT.md` 派发 +- 任务描述中包含: 角色身份、具体要求、上下文文件列表、验收标准 +- 更新 PROGRESS.md 记录谁在做什么 + +### 3. 审核阶段 +- 成员交付后 CEO 检查: + - [ ] cargo check 零 warning? + - [ ] 逻辑与旧代码行为一致? + - [ ] 代码风格一致? + - [ ] 没有安全问题? +- 合格: git commit + 绩效记录 + 灵魂文件更新 +- 不合格: 在 TEAM_CHAT.md 记录问题,重新派发(同人或换人) + +### 4. 记录阶段 +- 每次 git commit 前更新 PROGRESS.md +- 重大决策写入"关键决策记录" +- 成员经验写入 souls/.md +- 沟通记录写入 TEAM_CHAT.md + +--- + +## 文件职责 + +| 文件 | 用途 | +|------|------| +| PROGRESS.md | 项目进度、完成状态、待办事项 | +| TEAM.md | 团队成员档案、制度、绩效 | +| TEAM_CHAT.md | 团队异步沟通、任务讨论、问题记录 | +| souls/.md | 成员灵魂:思想/性格/记忆/技能 | +| WORKFLOW.md | 本文件,开发流程规范 | + +--- + +## CEO 操作模板 + +### 派发任务 +```bash +kilo run -m openai/gpt-5.4 --auto \ + --dir /home/showen/Showen/ShowenV2 \ + -f souls/<成员名>.md \ + -f TEAM_CHAT.md \ + "<任务描述>" +``` + +### 审核提交 +```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 && git commit -m "" +# 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 结构完整, 双连接架构正确