From 28f1fff1a719a885ff96d4eda7b95c2073f9760b Mon Sep 17 00:00:00 2001 From: herry Date: Sat, 14 Nov 2026 18:32:35 +0800 Subject: [PATCH] =?UTF-8?q?docs(rtos):=20=E8=AE=B0=E5=BD=950.3.0=E8=BF=BD?= =?UTF-8?q?=E5=8A=A0=E9=AA=8C=E6=94=B6=E5=8F=8A=E4=BA=92=E8=81=94=E6=8E=88?= =?UTF-8?q?=E6=9D=83=E8=BE=B9=E7=95=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CHANGELOG.md | 2 + PUBLIC_SOURCE_MANIFEST.json | 12 +++--- README.md | 6 ++- phone-debug-bridge/ACCEPTANCE_2026-11-14.md | 40 +++++++++++++++++++ .../ICON_VALIDATION_2026-11-14.md | 2 + phone-debug-bridge/README.md | 2 + 6 files changed, 57 insertions(+), 7 deletions(-) create mode 100644 phone-debug-bridge/ACCEPTANCE_2026-11-14.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 3af83cd..f0961f3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,7 @@ # 0.3.0（图标先传、回调确认后安装） +2026-11-14 追加[验收记录](phone-debug-bridge/ACCEPTANCE_2026-11-14.md)：已安装APK哈希、S2在线和信息查询、22项PC测试、15项网页检查、匿名源码及5个COS附件冷下载通过。缺少匹配互联授权的安装被拦截，真实图标送达与桌面显示暂未验收。本次仅更新main文档，v0.3.0标签及发行附件不变。 + 手机 APK 升级为 0.3.0 / 4，探针保持 1.0.4。从 CR 包与 JSON/编译清单识别包名、图标，重新编码最长边 192 的标准 PNG。PNG 先发送至 `/user/jsapps/<包名>.png`，仅终态成功且数字 code=200 后发送 PKG。PGF 使用同 dist 的 PNG 或显式选择；授权不足、图标失败、重复/旧回调及超时均有拦截。 Git2 项目入口先显示可操作页面，再后台读取并进入完整源码页；失败保留重试与项目导航。原生 Git、发行版和权限路由保留。图标桌面呈现需单独真机验收，当前验证范围见图标安装文档。 diff --git a/PUBLIC_SOURCE_MANIFEST.json b/PUBLIC_SOURCE_MANIFEST.json index 4de1501..35c6d20 100644 --- a/PUBLIC_SOURCE_MANIFEST.json +++ b/PUBLIC_SOURCE_MANIFEST.json @@ -8,10 +8,10 @@ "files": { ".gitattributes": "b417160239022500ff4070f251d4701b745c5c545996c82dfdfc2b46d001df5b", ".gitignore": "4cbafe661a8261c06b3a7bc95405c574f07c0090697176ec04f8fb0d7bb14e7f", - "CHANGELOG.md": "5057421807a70e1e1f4e735744cfcdeff457a9c0280c9b00a195e3e38f88b1cc", + "CHANGELOG.md": "e41a08bc7296678b0e313705d45bbbf9f5a5db7c715452fbb06a4801710c2d22", "LICENSE": "ffcca38841adb694b6f380647e15f17c446a4d1656fed51a1e2041d064c94cc8", "NOTICE.md": "0eaa82a4eb8e84b7d89e1e0279815c98dc232565a914ed2f29bab6fc424bbf54", - "README.md": "28a36b9cb5c6cd42ac105f3062e15394b3148fecc137e924b6fb21ece23537d0", + "README.md": "7c4fe4056ba1695d78380845e1caecf8e4d18533f61d39645a31a593c9922383", "build-rtos-game.ps1": "207ff9875af96221559f314364c932fe37bfc22c698ad1afabb9aeec40a8679e", "com.sydxky.rtos.deviceprobe/.gitignore": "3fc9fbb6fa7795f07ed0f60fe5e3f900e17ea77a793493ef2a3ef582de5fe572", "com.sydxky.rtos.deviceprobe/LICENSE": "ffcca38841adb694b6f380647e15f17c446a4d1656fed51a1e2041d064c94cc8", @@ -32,11 +32,12 @@ "docs/images/S2-1.0.4-manual-tap.jpg": "4e0eacffaefef868382d8d92db2f07864090306f9b3d61114d3cbc9630783aab", "docs/validation.json": "e57b88b1fed602f4f4e7db9fe52f61ad5c209d53ec7c9646f2356b9d557cd819", "phone-debug-bridge/.gitignore": "0a8d360b9b497252e065ab7e2fdceb94d2735549d264a3edf112897542b5fddd", + "phone-debug-bridge/ACCEPTANCE_2026-11-14.md": "cf0f7489f0cb0aa49e8d464b7d9f8aae6f64263e4a96095bcdc5e4e77a1ded1c", "phone-debug-bridge/ICON_INSTALL.md": "1bc0f4fe7cc5a9d846f483d03425d29ec46be187de1344bc50064f05c91fd0cd", - "phone-debug-bridge/ICON_VALIDATION_2026-11-14.md": "a7b0952038bc6f373fa663fae849bd151bbc9a5643741e41580336d05930cfb5", + "phone-debug-bridge/ICON_VALIDATION_2026-11-14.md": "225889759a5794eb56b3c2e2160d3a26be652f9318d19ae531c8435ad4a6218a", "phone-debug-bridge/LICENSE": "ffcca38841adb694b6f380647e15f17c446a4d1656fed51a1e2041d064c94cc8", "phone-debug-bridge/NOTICE.md": "0eaa82a4eb8e84b7d89e1e0279815c98dc232565a914ed2f29bab6fc424bbf54", - "phone-debug-bridge/README.md": "e0ec67679529b890ce8febec66e043494a3adb166612185581d3e6dff800f5ec", + "phone-debug-bridge/README.md": "d41404ee4aca8f8d21b0c4019e2effd595e3a3637eefbca8bc2f17f5b38f897a", "phone-debug-bridge/app/build.gradle": "ac6a544ea4c72838574d6e528142714ed3a15567cb7961c02adf732dd7362956", "phone-debug-bridge/app/src/androidTest/AndroidManifest.xml": "8fbbadb1fc7735b24b68479cd116cfcd2ed1ac055b6ae9534252f58186629e86", "phone-debug-bridge/app/src/androidTest/java/com/sydxky/rtos/bridge/IconInstallTest.java": "25da64c9542e5d1abe68dff42d68d5b7097944678082180e7869a5704ee275c1", @@ -75,5 +76,6 @@ "watch_scope": [ "OPPO Watch S / OWW262 (not device accepted)", "OPPO Watch S2 / OWW265 (device accepted)" - ] + ], + "documentation_acceptance": "2026-11-14" } diff --git a/README.md b/README.md index c3e02de..adeaf1f 100644 --- a/README.md +++ b/README.md @@ -14,10 +14,12 @@ 读取包名与图标 → 生成标准 PNG → 传入 `/user/jsapps/<包名>.png` → 等待终态成功且数字 `code=200` → 发送并安装 `.pkg`。包内 PGF 使用同一次构建的 `dist/icon.png`，或 `install <包> --icon <对应PNG>`；手机选包时会提示选择对应 PNG。失败、授权不足、超时或断开时停止安装，重复回调不会重复安装。 -[图标补传说明](phone-debug-bridge/ICON_INSTALL.md) · [0.3.0 验证与复现](phone-debug-bridge/ICON_VALIDATION_2026-11-14.md) +[图标补传说明](phone-debug-bridge/ICON_INSTALL.md) · [0.3.0 验证与复现](phone-debug-bridge/ICON_VALIDATION_2026-11-14.md) · [追加验收结果](phone-debug-bridge/ACCEPTANCE_2026-11-14.md) API27 原生 Android 模拟器13项、PC工具22项通过。图标顺序测试使用模拟手表端点；**本版 S2 图标实际送达及桌面呈现仍待真机确认**，不将旧版 S2 应用安装或官方截图证据当作新图标通道验收。263 文件通道需要目标应用匹配的 appId/license，默认演示值不保证授权。调试桥不修改手机认证状态或自动重启手表。 +2026-11-14 追加验收：手机已安装0.3.0原包hash一致，真实S2在线并返回型号/版本；PC工具22项、网页15项、匿名源码克隆及5个发行附件的COS冷下载与Range读取均通过。未授权安装被正确拦截；本次先搁置互联授权，真实图标回调、后续安装和桌面显示仍记为未验收。 + Git2 的项目入口先显示项目导航，再后台读取并进入完整源码页；读取失败可重试。克隆、源码历史、发行版与 Issue 仍使用原生 Git/Gitea。 ## 下载和反馈 @@ -53,7 +55,7 @@ RTOS 手表不需要 Android ADB。手机必须先在受支持的官方配套应 | Watch S（OWW262） | 参考项目提供接口依据，本项目待单独真机验收 | | 手机 APK 安装、回读 hash、Binder 绑定 | P30PRO 已通过 | | 等待手表上线、查询型号及运行时版本 | S2 已通过；OWW265 / runtime 0.8.0-5 | -| Glyphix 应用检查、安装 | S2 探针 1.0.4 已实装，回调成功并显示实际页面 | +| Glyphix 应用检查、安装 | 此前 S2 探针1.0.4已实装并显示页面；0.3.0新增图标路径的真实发送与安装尚未验收 | | 官方手表截屏 | 电脑导航健康界面并导出 480×464 JPEG，已通过 | | 图片导入、原比例预览、安全区辅助线、PNG 导出校验 | 手机已通过 | | 手表探针手动触摸 | 官方截图确认计数 0→1，已通过 | diff --git a/phone-debug-bridge/ACCEPTANCE_2026-11-14.md b/phone-debug-bridge/ACCEPTANCE_2026-11-14.md new file mode 100644 index 0000000..0b0a073 --- /dev/null +++ b/phone-debug-bridge/ACCEPTANCE_2026-11-14.md @@ -0,0 +1,40 @@ +# 0.3.0 追加验收（2026-11-14） + +结论：本轮手机安装包核验、S2 连接与信息查询、未授权安装拦截、PC 工具、公开源码、网页与 COS 下载检查通过。**真实 PNG 图标送达、随后 PKG 安装与桌面图标显示仍未验收**。本次先搁置文件互联授权，不继续尝试发送；保留授权检查，不更改手机认证、手表配对或固件。 + +## 本轮结果 + +| 检查 | 结果与证据范围 | +| --- | --- | +| 手机已安装 APK | P30PRO / VOG-AL00，0.3.0 / 4，minSdk 27、targetSdk 34；拉回原包的 SHA-256 与发行附件一致，无需重装 | +| 手机运动健康 | 6.10.15_9e2a81e_261107 / 6101500；真实 Wear Engine MAS2006006 / 协议 263，状态 bound | +| 真实 S2 连接 | link.connected=true；型号 OWW265，nucleus 0.8.0-229，runtime 0.8.0-5，手表 MAS2006005 | +| 回环 API 访问限制 | 无 Bearer 令牌请求、带浏览器 Origin 的请求均返回 HTTP 401 | +| 未授权安装拦截 | 默认演示配置的 messageAuthorized=false；探针安装停在 prepare_icon，返回匹配 appId/license 授权错误；未进入 send_icon 或 install_package | +| PC 工具 | 本轮重新执行标准库测试，22/22 通过 | +| Git2 真实浏览器 | 15/15 通过；项目首屏本次约 182ms，后台就绪后进入完整 Gitea 页面；390px 页面无横向溢出，失败可重试 | +| 匿名源码克隆 | 原生 Git 克隆与完整严格 fsck 通过；v0.3.0 对应 17b51d98ae8c97088b2d40e862108fbd84b52381，3 个独立公开提交；64 个载荷文件逐项匹配清单，含清单自身共 65 文件 | +| 发行附件真实 COS 冷读取 | 5/5 通过：仅定向移除对应非活跃缓存，再从原生下载地址读取；每项长度、SHA-256、缓存重新生成与 Range 206 均正确 | +| COS 访问控制 | 公开项目存储仍为私有 COS；未签名的对象直读返回 403，COSCMD catalog 回读一致；经 Git2 授权的匿名下载正常 | + +网页慢请求和 503 场景由浏览器拦截后台请求模拟；初始页面和完整项目页面来自实际生产站点。这部分不作为真实 COS 冷读取性能证据，182ms 是一次测量而非时延保证。COS 附件冷下载另以实际服务器缓存和对象读取复验。 + +本轮源码核验发生在追加本文之前，针对不可变的 v0.3.0 标签；后续 main 文档提交不修改此标签、发行附件或已核验 APK。 + +## 未完成的真机步骤 + +安装尝试使用探针 1.0.4 圆屏 PKG（7234 字节），SHA-256 为 `7e4a2f507ce20290ae05de32a1aeaf6423e8145a165da52d658e0e8fcb44e5f3`。包及对应 PNG 上传到手机缓存后，263 文件通道因缺少匹配授权而被拦截： + +```text +java.io.IOException: Icon transfer needs matching appId/license interconnect authorization; package was not sent +``` + +因此本轮没有真实图标文件成功回调，未开始 PKG 发送，也没有新增桌面截图。此前探针页面、手动点击和亮屏证据不能证明 0.3.0 新图标路径已通过。待具备合法匹配的互联配置后，仍需依次验收 PNG 终态数字 code=200、PKG 安装回调和实际桌面显示。 + +API27 模拟器与 P30PRO 各 13 项原生 Android 测试是此前本版的结果，详情见 [原生测试与复现](ICON_VALIDATION_2026-11-14.md)；本轮以手机原包哈希确认仍为同一发行 APK，没有重装测试包。这些原生测试使用模拟手表 Binder，不是实体 S2 文件送达证据。 + +## 交付版本 + +手机 APK SHA-256：`8e4f933fa500e56b9742891c32bd7bee18004a798993e67b08fd11dd770f8d21`。 + +[v0.3.0 下载](https://git2.sydxky.cn/sydxky/rtos-watch-debug-bridge/releases/tag/v0.3.0) 保持开发测试版状态。自研部分仍使用 PolyForm Noncommercial 1.0.0，商业用途须另获许可；本次仅追加验收文档。 diff --git a/phone-debug-bridge/ICON_VALIDATION_2026-11-14.md b/phone-debug-bridge/ICON_VALIDATION_2026-11-14.md index 6642c98..6f18805 100644 --- a/phone-debug-bridge/ICON_VALIDATION_2026-11-14.md +++ b/phone-debug-bridge/ICON_VALIDATION_2026-11-14.md @@ -1,5 +1,7 @@ # 0.3.0 图标安装验收（2026-11-14） +后续“开始验收”的独立复验见 [追加验收记录](ACCEPTANCE_2026-11-14.md)：本轮重新读取手机 APK 并核对哈希、查询真实 S2、执行22项PC测试和15项网页检查、复验5个COS附件冷下载。以下13项Android原生测试为此前本版结果；本轮未重复安装测试包。真实文件互联授权仍未补齐，图标与后续PKG未发出，桌面显示仍未验收。 + | 检查 | 结果与范围 | | --- | --- | | Android 构建、测试 APK、lint | 成功；0 errors / 9 warnings | diff --git a/phone-debug-bridge/README.md b/phone-debug-bridge/README.md index 8212b37..f309e3d 100644 --- a/phone-debug-bridge/README.md +++ b/phone-debug-bridge/README.md @@ -2,6 +2,8 @@ 自研部分按 [PolyForm Noncommercial 1.0.0](LICENSE) 公开，仅限许可允许的非商业用途；商业用途须另获许可。版权和第三方条款见 [NOTICE.md](NOTICE.md)。独立公开项目：[rtos-watch-debug-bridge](https://git2.sydxky.cn/sydxky/rtos-watch-debug-bridge)。 +[0.3.0 追加验收](ACCEPTANCE_2026-11-14.md)：本轮手机原包哈希、S2 在线与信息查询、PC 工具22项、网页15项、匿名源码及5个COS附件冷下载通过。文件互联仍缺匹配授权，图标发送在准备阶段被拦截；真实图标送达、后续安装及桌面显示暂未验收。 + 适用机型为 OPPO Watch S / OWW262 与 Watch S2 / OWW265；本项目仅在 S2 完成下述真机验收，Watch S 待单独验收。Android/Wear OS 与 HarmonyOS 手表不在兼容声明内。 独立 Android 手机工程，包名 `com.sydxky.rtos.bridge`。供 Windows 电脑通过 USB ADB 操作手机上已配对的 OPPO Watch S / S2（RTOS / Glyphix）。APK 安装到手机，Glyphix `bundle.pkg` 安装到手表。