feat: Update project documentation and workflow to reflect changes in task dispatching and testing processes

- Changed references from "kilo" to "Agent 子代理" in various documentation files to align with the new task dispatching method.
- Updated CLAUDE.md to reflect the new agent-based execution model and modified task dispatch template.
- Revised PROGRESS.md to indicate successful testing and acceptance of M1.2 with detailed results.
- Enhanced communication and workflow documentation to clarify the use of Agent 子代理 for real-time collaboration and task management.
- Updated team member soul files with lessons learned from recent testing and integration experiences.
- Refactored test files to remove unused code and improve clarity, ensuring compliance with zero warning standards.
- Documented specific experiences and lessons learned during M1.2 testing, including handling of edge cases and configuration validation.
This commit is contained in:
2026-07-03 14:14:50 +08:00
parent 5770b7007c
commit 2a6e14b976
19 changed files with 280 additions and 147 deletions

View File

@@ -6,7 +6,7 @@
## 你的身份
你是**陈逸飞**ShowenV2 的 CEO 兼技术总监Claude Opus 4.6)。
你**不写代码、不跑测试、不改配置**。所有执行通过 kilo 派发团队完成。
你**不写代码、不跑测试、不改配置**。所有执行通过 Agent 子代理派发团队完成。
## 项目概要
@@ -77,12 +77,12 @@ export PATH="/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bi
| 成员 | 失败计数 | 等级 | 更新时间 |
|------|---------|------|---------|
| 刘建国(PM) | 0 | — | 2026-03-19 |
| 张明远 | 0 | — | 2026-03-19 |
| 张明远 | 1 | — | 2026-07-03 |
| 李思琪 | 0 | — | 2026-03-19 |
| 王浩然 | 0 | — | 2026-03-19 |
| 赵雨薇 | 0 | — | 2026-03-19 |
| 赵雨薇 | 1 | — | 2026-07-03 |
| 林晓峰(QA) | 0 | — | 2026-03-19 |
| 周雅婷 | 0 | — | 2026-03-19 |
| 周雅婷 | 0 | — | 2026-07-03两轮验收执行出色 |
> 计数累加:审核不合格+1 / 返工+1 / 违反铁律+1。重置连续2次成功→0 / Phase切换→全员0。
@@ -90,14 +90,14 @@ export PATH="/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bi
## 当前状态
- **质量**: 115/115 已在 Linux ARM64 验证107 核心 + 8 集成);+ 24 M1.2 集成测试已写入本地,**待目标机 `cargo test` 验收后方可计入**Flutter 15/15零 warning
- **里程碑**: M1.1 完成M1.2 进行中(集成测试全部编写完毕,待 Linux 验收后收尾)
- **质量**: **147/147 已在 Linux ARM64 目标机验证**2026-07-03 实跑lib 105 + example 7 + m1_2_dynamic 15 + m1_2_http 12 + m1_2_service_manager 8Flutter 15/15零 warning
- **里程碑**: M1.1 完成,**M1.2 测试验收已通过**(两轮:第一轮 1 失败 3 warning → 返工 → 第二轮全绿),收尾差 commit+tag待老板批准+ 风险3 核查
- **DevicePlugin 能力**: Display + SleepInhibit + Backlight + Cursor (Linux ARM64)
- **ScreenPlugin**: 已重构为 thin wrapper
- **Flutter App**: 完成度 ~98%, APK v0.3 (52.6MB) 已编译, cupertino_icons 已修复
- **API 文档**: 已校准(以 routes.rs 为唯一权威重写)
- **示例插件**: 已完善为开发者参考模板 (manifest.json + 请求/响应示范 + 7 个测试)
- **M1.2 进展**: 5 项完成 — 插件管理API闭环 + ServiceManager集成测试(8) + HTTP路由测试(9) + 动态插件测试(15) + 风险3消息链路确认**最终验收缺 Linux cargo test 证据 + git commit**
- **M1.2 进展**: 目标机两轮验收完成2026-07-03147/147 零 warning证据见 TEAM_CHAT.mdHTTP 路由测试实为 12 个(旧记录 9 有误、lib 单测实为 105旧记录 107 有误);剩余 commit+tag、风险3 补派核查
### 已修复(本轮)
@@ -130,25 +130,32 @@ export PATH="/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bi
25. ~~**P0**: 插件管理 API 闭环~~ ✅ 张明远修复 (handle_manager_message Custom 分支 + broadcast_plugin_states + 7 个新测试)
26. ~~**M1.2**: ServiceManager 集成测试~~ ✅ 周雅婷完成 (tests/m1_2_service_manager.rs, 8 个测试全通过)
27. **M1.2**: HTTP API 路由集成测试 赵雨薇编写完成 (tests/m1_2_http.rs, 9 个测试:播放控制/配置重载/播放列表快照/插件管理闭环/路径穿越防护)**待 Linux ARM64 cargo test 验证 + git commit**
28. **M1.2**: 动态插件集成测试 张明远编写完成 (tests/m1_2_dynamic_plugin.rs, 15 个测试manifest校验/生命周期/热替换回滚/版本GC/路径穿越)**待 Linux ARM64 cargo test 验证 + git commit**
29. **M1.2 风险3**: 消息链路分析 — 赵雨薇在 m1_2_http.rs 注释中给出旁证结论enable/disable 闭环已修plugin_rollback/switch/install/check_updates 为待实现项(非回归缺陷)。**WifiProvisioned/DeviceEvent 生产者确认尚未系统性核查(王浩然原任务 agent 失败,需补派)**
27. ~~**M1.2**: HTTP API 路由集成测试~~ 赵雨薇完成 (tests/m1_2_http.rs, 实为 12 个测试2026-07-03 目标机验证通过,含一次返工:空 playlist 测试前提错误重写为 test_empty_playlist_rejected + 删死代码 sender)
28. ~~**M1.2**: 动态插件集成测试~~ 张明远完成 (tests/m1_2_dynamic_plugin.rs, 15 个测试2026-07-03 目标机验证通过,含一次返工:删 2 处死代码 warning)
29. ~~**M1.2 风险3**: 消息链路核查~~ ✅ 王浩然完成 (2026-07-03 全量核查 17 个 Message 变体11 闭环 / WifiProvisioned、DeviceEvent 为 Phase 2 占位(有消费无生产,非回归) / 3 弱链Custom 六种 plugin_* 全闭环。修正赵雨薇旁证rollback/switch/install 在 #25 修复后已是完整实现。报告见 TEAM_CHAT.md**风险3 关闭**)
30. ~~**P0**: 设备端开机自启出现 3 个实例~~ ✅ 赵雨薇修复 (2026-07-02, 根因3 个自启动入口叠加;仅保留用户级 showen_v2.service其余移入 ~/autostart_backup_20260702/,重启验证进程==1)
31. ~~**P0**: 设备端窗口非全屏~~ ✅ 赵雨薇修复 (2026-07-02, 根因:应用先于 kwin 启动OpenCV 全屏调用空操作ExecStartPre 等待 kwin + kwinrulesrc 强制全屏规则,重启验证 800x800 无边框)
### 待处理
1. **[M1.2 收 — 阻塞]** 在 Linux ARM64 执行 `cargo test --workspace`,确认 24 个新集成测试全通过,输出贴到 TEAM_CHAT.md → 再 git commit 三个测试文件
2. **[M1.2 收尾]** 风险3 WifiProvisioned/DeviceEvent 生产者代码核查(补派王浩然)
3. **[M1.2 收尾]** 全部测试通过后更新 PROGRESS.md M1.2 章节 + 打 tag
1. **[M1.2 收待老板批准]** git commit 返工后的两个测试文件 + 本轮文档改动,打 M1.2 tag**commit 后必须重新同步设备**(设备 tests/ 下是 scp 的未提交版本HEAD 仍 5770b700
2. ~~**[M1.2 收尾]** tests/m1_2_http.rs 过时注释更新~~ ✅ 赵雨薇完成2026-07-03纯注释改动核实点位后订正为"六种 plugin_* 闭环,唯 check_updates 结果回传属 Phase 2"注意此改动在第二轮验收之后commit 前设备端补一次 cargo check 即可
3. **[M1.2 收尾]** sanitize_filename 集成测试测的是逻辑复制而非产品函数,转正需产品侧小改动(改 pub 或 routes.rs 内加单测)— 赵雨薇上报
4. DevicePlugin 阶段三framebuffer迁移/触摸/音频/多平台)— Phase 2 规划
5. **[设备遗留-代码]** 单实例保护(锁文件/socket 互斥)+ unclutter 僵尸子进程 reap — 派内核/视频工程师
6. **[设备遗留-系统]** 设备时钟慢约一年NTP 失效apt HTTPS 证书报 not yet valid+ 磁盘长期 9x% 满(两轮验收均被迫清 target/debug/incremental— 需排查
7. **[环境]** 设备 SSH 已打通:`ssh -p 2222 showen@192.168.31.105` 免密2026-07-02 配置),目标机验收可远程执行
8. **[代码质量-P2]** Shutdown 消息无生产触发者main.rs:117-120 Ctrl+C 只置 AtomicBool主循环阻塞在 rx.recv(),需等下一条任意消息才真正退出(王浩然发现)
9. **[Phase 2 清理]** SDK 文档教开发者监听永不触发的 WifiProvisioned (plugin-sdk/src/lib.rs:522)CursorVisibility 有消费无生产(实际链路已走 DeviceCommandcheck_updates 结果仅 println 不回传DeviceResponse 广播后核心无人读、Error 静默
---
## kilo 派发模板(唯一权威版本)
## 任务派发模板(唯一权威版本)
```bash
kilo run -m openai/gpt-5.4 --auto \
--dir /home/showen/Showen/ShowenV2 \
"你是<角色名>。
通过 Claude Code 的 **Agent 工具(子代理)** 派发,子代理提示词:
```text
你是<角色名>。
开工前必读:
1. souls/<name>.md你的灵魂文件
@@ -158,15 +165,15 @@ kilo run -m openai/gpt-5.4 --auto \
任务:<具体说明>
交付要求:
- 完成后执行 export PATH=\"/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bin:\$PATH\" && cargo check --workspace --all-targets && cargo test --workspace
- 完成后执行 cargo check --workspace --all-targets && cargo test --workspace
- 两项都绿灯后把输出贴在交付中
- 修完检查同文件是否有类似问题
- 更新你的 soul 文件
验收标准:<具体标准>"
验收标准:<具体标准>
```
**kilo 使用规则**: 不读大 diff / 令越简单越好 / 进程上限 12 个 / `--auto` 自动批准
**派发规则**: 不读大 diff / 令越简单越好 / 并行子代理上限 12 个,注意文件重叠冲突
---