web-sdk-pp-rotated-detection
v0.1.0
Published
基于 PP-YOLOE-R 的浏览器旋转框检测 SDK
Readme
PP-RotatedDetection
浏览器端单帧旋转框检测 SDK,基于 PP-YOLOE-R-s FP32,识别 DOTA 15 类遥感目标。返回原图坐标系的四点框;CPU/WASM、GPU/WebGPU 和 main/Worker 均调用同一框架无关公共 API。
版本 0.1.0。 npm、GitHub Release 与 HTTPS Demo 的状态见 发布与验收回执。模型使用 固定来源清单:默认 ModelScope,可显式选择 Hugging Face,失败不会静默换源。
安装与集成
pnpm --config.verify-deps-before-run=false --config.manage-package-manager-versions=false add [email protected]按 快速开始 复制 Worker/ORT 静态资源并传入固定模型对象,即可在浏览器使用公共 API;也可按下方步骤从源码构建。
源码运行
pnpm --config.verify-deps-before-run=false --config.manage-package-manager-versions=false install --frozen-lockfile
pnpm --config.verify-deps-before-run=false --config.manage-package-manager-versions=false build
pnpm --config.verify-deps-before-run=false --config.manage-package-manager-versions=false dev打开 http://127.0.0.1:4192。普通 dev 和 build:demo 使用清单中的 Hub 来源;dev:local 是可选的离线开发方式,需自行准备校验通过的 .tmp/model.onnx,不会进入正式构建。
项目入口
Demo 默认中文,可切英文;上传/拖放、阈值、旋转框选中、JSON/叠加 PNG 导出、缓存和折叠耗时信息均在同一页面。
文档
快速开始 · API · 兼容性 · 排错 · 隐私与部署 · 性能 · 发布 · 模型卡
验证
2026-09-18,Windows 11 10.0.26200 / Chromium 153.0.8010.12 / i5-10400F / RTX 5060 Ti:CPU/GPU × main/Worker 的 40 项公共 API 数值对照通过。最差旋转 IoU 0.9993547、最大角点误差 0.01901px;这不是完整 DOTA mAP,也不代表手机或 NPU 验证。
pnpm --config.verify-deps-before-run=false --config.manage-package-manager-versions=false test
pnpm --config.verify-deps-before-run=false --config.manage-package-manager-versions=false typecheck
pnpm --config.verify-deps-before-run=false --config.manage-package-manager-versions=false typecheck:demo
pnpm --config.verify-deps-before-run=false --config.manage-package-manager-versions=false build
pnpm --config.verify-deps-before-run=false --config.manage-package-manager-versions=false build:demo
pnpm --config.verify-deps-before-run=false --config.manage-package-manager-versions=false check:package
pnpm --config.verify-deps-before-run=false --config.manage-package-manager-versions=false test:browser浏览器测试还需本地模型和 .tmp/evaluation/images/P0861.png(不分发评估图),并先用 pnpm --config.verify-deps-before-run=false --config.manage-package-manager-versions=false exec playwright install chromium 安装 Chromium;已有浏览器可设 PLAYWRIGHT_BROWSERS_PATH 复用。模型大小、许可证及 SHA-256 见 清单。CI、Pages 和 Release 均运行 node scripts/check-release-ready.mjs,检查双源与真实生产浏览器回执;离线标准检查不证明远程治理或部署已完成。
