ioai-tech · joaner · Jun 4, 2026 · May 27, 2026 · May 27, 2026 · May 27, 2026
diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
@@ -55,7 +55,7 @@ ROS View is a **browser-native** playback and visualization tool for robotics re
 |--------|---------|---------------|-------|
 | **MCAP** | `@mcap/core` + `@foxglove/mcap-support` | Full (chunk index) | Preferred; efficient interval queries |
 | **ROS1 `.bag`** | `@foxglove/rosbag` | Full (chunk index) | via `CachedFilelike` + `BrowserHttpReader` |
-| **ROS2 `.db3`** | `@foxglove/rosbag2` + `sql.js` (WASM) | Local / remote requires full download | SQLite limitation; convert to MCAP for large remote files |
+| **ROS2 `.db3`** | `@foxglove/rosbag2` + `sql.js` (WASM) | Local / remote (remote auto-downloads in full) | SQLite limitation, no Range streaming; convert to MCAP for large remote files |
 
 **Supported message encodings:**
 

diff --git a/docs/ARCHITECTURE.zh.md b/docs/ARCHITECTURE.zh.md
@@ -47,7 +47,7 @@
 |------|--------|------------|------|
 | **MCAP** | `@mcap/core` + `@foxglove/mcap-support` | 完整支持（索引读取） | 首选格式，有 chunk 索引可做高效区间查询 |
 | **ROS1 .bag** | `@foxglove/rosbag` | 完整支持（chunk 索引） | 通过 `CachedFilelike` + `BrowserHttpReader` 实现 |
-| **ROS2 .db3** | `@foxglove/rosbag2` + `sql.js` (WASM) | 本地支持 / 远程需整文件下载 | SQLite 格式限制，远程大文件建议转 MCAP |
+| **ROS2 .db3** | `@foxglove/rosbag2` + `sql.js` (WASM) | 本地 / 远程（远程自动整文件下载） | SQLite 格式限制，无法 Range 流式；远程大文件建议转 MCAP |
 | **HDF5** | `@ioai/hdf5` (WASM) | 部分读取 | 科学数据；浏览器内解析 |
 | **BVH** | 内置解析 | 不适用（非 ROS bag 类流） | 骨骼动作捕捉动画回放 |
 
@@ -841,7 +841,7 @@ rosview/
     │   ├── layout/                     # Dockview、dockviewController、Tab 菜单
     │   ├── viewer/                     # 对外 `RosViewer`、内部实现与 `RosViewProvider` / Content
     │   ├── workspace/                  # navbar、sidebar、common、playback
-    │   └── panels/                     # 各面板目录 + framework + registry + image-core
+    │   └── panels/                     # 各面板目录 + framework + registry（面板内 core/ 子目录）
     │       └── PANEL_CONTRACT.md       # 面板契约
     │
     ├── shared/

diff --git a/docs/EMBEDDING.md b/docs/EMBEDDING.md
@@ -348,9 +348,9 @@ export async function GET(req: NextRequest) {
 }
 ```
 
-> **About `db3`:** ROSView does **not** support remote streaming of db3 (SQLite needs random access to the whole database). Download the db3 file in full as a `File` on the client and pass it via the `file` / `files` prop. mcap / bag can be streamed directly through the Range route above.
+> **About `db3`:** Like the other formats, db3 supports both a **local `File`** and a **remote URL** — just point `url` at the Range route above. However, because SQLite needs random access to the whole database, db3 **cannot be Range-streamed** the way mcap / bag are: when given a db3 URL, ROSView **downloads the file in full inside the Worker** (with download progress) before opening it. For very large db3 files, prefer converting to MCAP for true streaming. You no longer need to download the db3 as a `File` yourself on the host side.
 
-> **Version requirement:** Use **`@ioai/rosview` ≥ 1.3.5** (which depends on `@ioai/wasm-zstd` ≥ 1.1.2). 1.3.5 fixes the Turbopack inline-worker regression from 1.3.4 (`Failed to resolve module specifier './wasm-zstd-*.js'`, caused by the inline worker running from a `blob:` URL and unable to resolve the zstd glue's relative dynamic import). `@ioai/wasm-zstd` 1.1.2 statically inlines the glue into the worker, fixing this for good.
+> **Version requirement:** Use **`@ioai/rosview` ≥ 1.3.5** (which depends on `@ioai/wasm-zstd` ≥ 1.1.2). 1.3.5 adds remote-URL loading for db3 and fixes the Turbopack inline-worker regression from 1.3.4 (`Failed to resolve module specifier './wasm-zstd-*.js'`, caused by the inline worker running from a `blob:` URL and unable to resolve the zstd glue's relative dynamic import). `@ioai/wasm-zstd` 1.1.2 statically inlines the glue into the worker, fixing this for good.
 
 ---
 

diff --git a/docs/EMBEDDING.zh.md b/docs/EMBEDDING.zh.md
@@ -348,9 +348,9 @@ export async function GET(req: NextRequest) {
 }
 ```
 
-> **关于 `db3`**：ROSView **不支持远程流式** db3（SQLite 需随机读取整库）。请在前端先把 db3 整文件下载为 `File`，再通过 `file` / `files` prop 传入。mcap / bag 则可直接用上面的 Range 接口流式加载。
+> **关于 `db3`**：db3 与其他格式一样，**本地 `File`** 与**远程 URL** 两种方式都支持，直接把上面 Range 接口的地址传给 `url` 即可。但由于 SQLite 需要随机访问整库，db3 **无法像 mcap / bag 那样按 Range 流式加载**——传入 db3 的 URL 时，ROSView 会在 Worker 内**自动整文件下载**后再打开（带下载进度）。因此对超大 db3，建议优先转换为 MCAP 以获得真正的流式体验。你无需再在宿主侧手动下载为 `File`。
 
-> **版本要求**：请使用 **`@ioai/rosview` ≥ 1.3.5**（依赖 `@ioai/wasm-zstd` ≥ 1.1.2）。1.3.5 修复了 1.3.4 在 Turbopack 下因 inline worker 以 `blob:` URL 运行、无法解析 zstd glue 相对动态 import 而抛出的 `Failed to resolve module specifier './wasm-zstd-*.js'`；`@ioai/wasm-zstd` 1.1.2 将 glue 静态内联进 worker，彻底解决该问题。
+> **版本要求**：请使用 **`@ioai/rosview` ≥ 1.3.5**（依赖 `@ioai/wasm-zstd` ≥ 1.1.2）。1.3.5 新增了 db3 的远程 URL 加载，并修复了 1.3.4 在 Turbopack 下因 inline worker 以 `blob:` URL 运行、无法解析 zstd glue 相对动态 import 而抛出的 `Failed to resolve module specifier './wasm-zstd-*.js'`；`@ioai/wasm-zstd` 1.1.2 将 glue 静态内联进 worker，彻底解决该问题。
 
 ---