becd200150
- 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 当前状态
99 lines
3.4 KiB
Markdown
99 lines
3.4 KiB
Markdown
# 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 结构完整, 双连接架构正确
|