Ruflo驱动上禾体检一体机接入：成果与价值报告
版本：V1.0
汇报日期：2026-08-26
一、成果结论
上禾SH-V20体检一体机软件对接已完成开发、开发库验证、旧设备兼容回归和发布分支合并。
Ruflo试点也完成了从“外部方法参考”到“康比特可复用Harness”的首次闭环：5个角色完成协议、代码、测试和评审协作，真实问题得到修复，通用脚本、Workflow和Skill已经沉淀。
当前可以确认“软件研发和开发环境闭环通过”；真实SH-V20现场上传、断网补传、最大波形、小票/屏幕/小程序对照仍属于硬件现场验收，不在本报告中虚报完成。
二、业务交付
会员与设备
- 设备通过手机号
userID关联康比特会员； - Token和无Token两种设备配置兼容；
- 设备与康比特门店/租户绑定；
- 未匹配手机号仅保存无效会话和原始报文，不污染会员数据；
- 已关联报告不得降级或改绑其他会员。
数据上传
datas[]单条、多条均可处理；recordNo识别同一份报告；- 网络恢复后整份报告合并，已有指标更新、缺失指标补齐；
- 完全相同报文幂等，不重复写入或触发业务副作用；
- 原始报文、测量会话和核心健康指标可追溯。
大字段与附件
wave/ecgImg严格Base64和真实图片校验；- 根据现有配置写阿里云OSS或本地存储；
- 数据库保存附件ID、链接、大小、MIME和SHA-256；
- 相同附件重复补传自动复用；
- raw不再保存大段Base64正文。
体重业务
- 每个有效测量日期新增或更新体重档案；
- 同一天较早补传不会覆盖较新记录；
- 全局最新测量更新员工身高和体重；
- 同日跨手工、宅客、上禾等来源只加一次积分；
- 历史补传不刷新今天推荐能量。
小程序展示
复用现有体重档案接口，无需新增上禾专用查询接口。已兼容：
- 日期、体重、身高、BMI；
- 体脂率、身体年龄、身体类型；
- 内脏脂肪、肥胖度、皮下脂肪率；
- 其他统一健康指标。
三、兼容成果
上禾改造没有停留在“新设备可用”，而是完成统一健康模型回归：
| 设备/功能 | 结果 |
|---|---|
| 沃莱体脂秤 | 通过 |
| 云康宝体脂秤 | 通过 |
| 宅客体测 | 通过，重复导入行为保持 |
| BC300 | 通过 |
| 沃莱跳绳 | 通过 |
| 英吉多运动设备 | 通过 |
| Activity运动数据读取 | 保持 |
| Meal膳食能量读取 | 保持 |
| 手工体重与积分 | 保持 |
最终取消了segment_key数据库触发器依赖。7个写入入口由代码显式维护字段，开发库在无触发器状态下完成上禾和旧设备回归，分段指标完整且不一致记录为0。
四、工程交付
代码与发布状态
| 仓库 | 内容 | 当前状态 |
|---|---|---|
| ai_api | 协议入口、鉴权、会员匹配、报告合并、附件、体重业务、旧设备代码维护 | 已合入develop_haerbin并合入release |
| store | 正式db/v2/v2.35.7.sql及SQL契约 |
已合入develop_haerbin并合入release |
| ai_app | 复用现有体重档案页面与接口 | 字段和产物契约通过，无业务代码改动 |
| zhctprompt | 方案、问题清单、计划、Harness、测试报告和管理材料 | 已沉淀 |
主要Codeup流程均通过冲突检查、评审和合并：ai_api功能及无触发器代码进入开发和release；store SQL及无触发器版本进入开发和release。
数据库结果
- raw容量升级为MEDIUMTEXT；
- 报告、raw快照、指标和附件具有明确唯一性；
- 新增设备配置和测量附件表；
- 10个V3.06指标种子完整；
- 开发库58项结构核验全部通过；
- 重复指标组为0；
- 两个segment_key触发器已删除；
- 历史同日体重2组重复保留为已知WARN，没有擅自清理历史数据。
五、测试与质量证据
软件测试
- ai_api使用PHP7.4完成协议、Mapper、Controller、附件、体重门禁、兼容契约和语法检查；
- store使用PHP7.3完成SQL契约测试；
- 数据库烟测覆盖未匹配、匹配、重复、补传合并和清理；
- 完整业务E2E覆盖单/多datas、两日体重、最新员工档案、积分、重复和小程序summary；
- HTTP覆盖Token/NONE、缺Token、错误JSON、错误码和请求体限制；
- 真实开发配置下完成阿里云附件上传、复用和删除清理；
- 无触发器状态下完成上禾和全部旧设备数据库回归；
- 合成设备、会员、会话、体重、积分和附件测试数据清理后残留为0。
关键缺陷前置发现
| 问题 | 如果未发现的影响 | 处理结果 |
|---|---|---|
| raw容量不足 | 大波形报文截断 | 升级MEDIUMTEXT并外置附件 |
| 回调缺门店上下文 | 体重/积分落错租户 | 设备绑定store_id |
| 补传被当重复 | 完整报告字段丢失 | 按recordNo合并 |
| 重复报文重复副作用 | 重复体重、积分和能量刷新 | 完全重复提前短路 |
| 历史补传覆盖最新 | 员工档案被旧数据回写 | 按实际时间门控 |
| 小程序字段不一致 | 身体类型、肥胖度不显示 | 对齐既有指标码 |
| SQL放错仓库 | 发布流程混乱 | 正式SQL归store/db/v2 |
| PHP版本不兼容 | store测试无法运行 | 按PHP7.3修复 |
| 数据库触发器隐蔽 | 运维难排查 | 改为代码显式维护并全回归 |
六、Ruflo带来的收益
效率
- 协议取证、测试设计和代码评审并行；
- 角色模板、任务包和脚本可直接复用；
- 问题在合并前暴露，减少后期返工；
- 中断后可通过任务包、ledger和测试证据恢复。
本次未设置同任务无Ruflo对照组，因此不宣称固定百分比提效。
质量
- 从成功路径扩展到异常、补传、幂等、历史数据和兼容回归；
- 独立Reviewer连续关闭关键问题；
- 代码、数据库、HTTP、小程序和旧设备形成端到端证据；
- 人工反馈能转化成代码、测试和发布结果。
安全
- Runtime与正式仓库隔离；
- 单Writer避免并发改码；
- Token、密码和真实个人信息不进入Git或memory；
- commit、push、merge、DDL和部署分别授权；
- 测试数据精确清理，不连接生产完成冒险验证。
组织能力
- 把“Agent聊天”升级为岗位化协作；
- 把完成口径从状态改为证据；
- 形成可复用Harness、Workflow、Skill和测试模板；
- 为后续复杂硬件和跨仓库任务提供标准方法。
七、当前剩余风险
以下不是已知软件缺陷，而是现场验收门禁：
- 真实SH-V20 Token/NONE各完成一轮上传；
- 最大真实
wave/ecgImg校准8MB请求和6MB附件阈值； - 现场断网恢复后验证整体补传、recordNo和measureTime；
- 设备屏幕、小票、数据库和小程序逐项数值对照；
- 微信开发者工具登录后的页面模拟器/真机截图；
- 生产部署、监控、日志脱敏和运维回滚。
八、管理建议
对本项目
- 软件代码可以作为联调基线；
- 下一步直接进入真实设备与现场验收；
- 在完成上述六项门禁前，不对外宣称设备正式上线。
对Ruflo
- 保持“复杂任务试行”，暂不设为所有研发默认；
- 再选择一个跨仓库中型任务复用；
- 量化准备时长、总周期、返工、缺陷、Token成本和memory命中；
- 每个后续Ruflo任务都提交统一
task-metrics.csv，不是只在第二个试点临时统计； - 两次试点均有正收益后，再升级为团队推荐Harness。
九、战略价值
本次不仅完成一个设备接口，也验证了一种新的研发组织方式：用Ruflo管理角色和过程，用Codex执行真实工作，用Git、测试和数据库证明结果，用人把住业务和发布边界。
这套方式适合硬件、支付、数据同步、跨仓库改造等高复杂度任务，能够把AI研发从“个人效率工具”进一步升级为“团队可治理的工程能力”。
十、一句话总结
上禾软件接入和兼容回归已完成并进入release；Ruflo试点证明了其在复杂研发任务中能提升并行协作、质量前置、安全边界和过程可追溯性，但真实设备验收与第二个量化试点仍是正式推广前的最后两道门槛。
证据边界
- Ruflo官方仓库当前定位为Agent Meta-Harness，npm当前试行版本为3.38.20、Node要求20以上。
- 上禾代码、MR、数据库与测试结论来自康比特本地、Codeup和开发库真实证据。
- 未将本地软件测试写成真实设备、客户或生产验收。