BeeCount App 与 Cloud 隔离验收
保护现用设备与 Cloud 数据,用真实应用流程证明功能和同步结果。先确定项目的隔离入口,再执行;不能把 fake provider、HTTP 200 或预期结果写成实服验收通过。
先选择验收范围
- 仅 App:纯 App 改动默认只做独立设备、本地合成数据和相关真实 UI 验收,例如通知角标、页面交互、本地计算及展示。无需启动 Cloud 测试环境,不准备 Cloud 数据库、账号、鉴权或网页,也不因使用本技能而附带执行双向同步。
- App 与 Cloud 联调:修改 Cloud,或验收目标明确需要证明真实接口、同步链路、跨端数据往返时,才建立隔离 Cloud 并执行对应联调。记录需要 Cloud 的具体原因;不能仅因 App 本身支持云同步就扩大验收范围。
- 身份保护、正常入口重启、独立报告及清理规则适用于两种范围。Cloud 身份、数据对照和服务恢复等要求仅适用于联调;仅 App 报告标记为“不适用(仅 App)”。
项目入口
- 读取 references/beecount.md,先按验收范围选择 App 独立入口或同仓联调 runner。skill 源码位于
.agents/skills/isolated-app-cloud-qa,Codex 与 Claude Code 项目入口读取同一目录。 - Flutter iOS 与 Python/FastAPI:需要创建或排查适配时读取 references/flutter-ios-fastapi.md。
- 验收结束或关联 PR 全部合并后,读取 references/cleanup.md,完整删除本轮临时环境,包括失败、重试和已被替代的 run。
- 相关 checkout 按本次实际路径定位并核对 remote;不假定用户主目录。项目级安装见 安装说明。不要将本项目 skill 安装到用户全局,也不在本次迁移中扩展其他项目适配。
运行前必须确定的身份
| 对象 | 必须记录与核对 |
|---|---|
| 源码 | App 的提交 SHA、内容 hash 和 skill 版本;联调时另记录 Cloud SHA |
| 设备 | 已有设备保护名单;本次新设备的名称、UDID/serial、runtime、run ID |
| 产物 | 构建后的主包和扩展实际 ID、签名权限、共享容器、二进制 hash |
| Cloud(仅联调) | 独立 cwd、配置来源、实际数据库与全部写入路径、新凭证、服务 origin、PID 与启动时间 |
使用仅本次 run 拥有的资源。创建标记、manifest 与私有目录权限;设备操作指定确切设备 ID。应用包、扩展和 App Group 必须独立,不能保留正式 iCloud/共享容器权限。安装前从产物验证,不能只检查工程配置。
仅 App 使用新的本地数据库、偏好与合成 fixture,不导入现用 Cloud 配置。联调时 Cloud 使用新数据库和新存储目录;排除现用 .env、compose volume、默认备份/restore/RAG/rclone 路径与外部服务密钥。读取实际生效配置,在服务 import/初始化写入前拒绝越界路径。使用 loopback 或明确隔离的测试网络。
任何可能重装、替换、清空 App 的操作前,私密备份已存在的数据库、偏好、附件及共享容器。首次安装无数据时也要明确确认应用不存在。Flutter 集成测试可能卸载 App,不得对用户安装的正式包执行。
执行闭环
- 将需求转换成可断言的结果:新增/修改对象的身份、笔数、字段、原数据是否改变;明确未覆盖的平台和场景。
- 执行与改动相关的单元/widget 测试,并验证所用隔离脚本的拒绝路径;涉及同步时补充同步快速回归。快速回归与真实设备、实服结果分别报告。
- 新建环境,核对运行时身份;源码有变化时重新生成源码副本和产物,不能沿用旧成功报告。
- 通过生产 UI 操作被测功能。合成数据可经 fixture 准备;不可直接调用 UI 回调或 Repository 写入来替代被测用户动作。
- 仅 App 核对本地对象、字段、笔数及原数据是否改变。联调时用实际鉴权、生产同步引擎上传,核对 Cloud snapshot 和实际数据库中的身份、业务字段、关系、标记、币种及笔数。
- 仅联调:经真实 Cloud 写接口或实际 web UI 修改,再从 App 拉回并核对。区分“web 写 API 已测”与“web 前端已测”。
- 按功能风险选择取消、重复操作、权限、附件等场景,不附带无关的同步或共享角色验收。联调涉及故障恢复时仅影响 QA 服务,明确是服务 503 模拟还是实际设备断网。
- 切回正常应用入口并重启,确认仍在运行、页面可见、数据持久化。集成入口通过不能替代正常入口验证。
- 整理脱敏证据,切回正常 App,保持本次隔离设备运行,记录运行身份与版本并交给用户人工验收;联调时同时保留实际使用的隔离服务。再次打开时复用同一环境和数据,不重装或重新准备 fixture。 仅联调且 Cloud 有 web 前端时,交接同一源码版本的网页与实际 QA API;打开浏览器,用本次私有账号登录,选中与 App 一致的账本并展示被测对象。登录凭证不打印或进入公开包,保留页面供用户继续操作。
- 关联 PR 全部确认已合并后,默认视为本轮验收结束,立即停止并删除本轮拥有的测试环境,无需再等待用户确认关闭。用户提前确认验收结束或要求完整清理时也执行;用户明确要求继续保留环境时遵从该要求。仅创建 PR、输出报告或结束聊天仍需保留人工验收环境。按清理参考核对身份,删除临时数据库、附件、备份、源码副本、构建产物、专用浏览器 profile 和模拟器本身,只保留 run 外的独立报告、ZIP 与最小清理回执;不能只执行保留数据的
stop。
失败与报告
隔离身份不匹配、无法备份或路径指向现用资源时,停止该操作并报告具体阻碍。业务断言失败时,在验收结束前保留失败截图和私有日志,修正后用新源码/环境重跑;不绕过断言,也不将失败标成未执行。结束时将必要的脱敏失败证据纳入独立报告,再随其他 run 一并删除临时原始数据。
逐项记录 PASS / FAIL / 未执行 / 不适用、实际命令与退出码、版本和产物身份、本地结果、正常入口结果及已知限制;联调另附 App→Cloud→App 对照。仅 App 无需 Cloud 对照,不能将范围外联调记为通过或失败。报告只包含合成数据和可公开证据,不提交原始日志、凭证、token、数据库、备份或 App 二进制。
执行报告、截图和 JSON 留在忽略目录或仓库外,不提交到功能分支。制作离线 HTML 与独立 ZIP:优先展示界面、操作闭环、实际适用的数据对照、按场景分组的结果及范围限制;技术身份、命令和完整证据放在折叠附录。加入打开说明、文件 manifest 与 SHA256 校验表,打包前脱敏,解压核验并检查桌面和手机宽度的可读性。
报告记录自动验收时的证据快照,另外注明当前人工验收环境是否运行。生成报告或 ZIP 不要求停止环境;人工验收产生的新数据不能被复跑 fixture 或旧报告覆盖。
清理前确认独立报告和 ZIP 已保存在 run 外并通过校验。已发布的包保持原内容与 SHA256;清理状态另写最小回执,记录关联 PR 合并状态、已删除资源与结果。交付时明确环境已删除,不能继续将旧地址作为可用验收入口。
用户授权开 PR 时,PR 保留简短验收摘要、限制、关联仓依赖和独立报告链接。已获授权上传验收包时,优先通过网页文件选择器上传独立 ZIP,将下载链接放进 PR 描述并回下载核对 SHA256;读取 GitHub PR 附件交付。已有授权覆盖本次包与目标 PR 时沿用该授权。附件失败时交付本地完整包并说明限制。
此 skill 不扩展合并、发版、部署或回复他人的权限;不为报告创建应用发版,按当前用户指令结束工作。
