dsh-tauri 连接原生桌面壳、Harness 宿主与内嵌客户端。桌面导航、账号授权浏览器和其他插件的原生调用都依赖这层桥接。
从桌面入口使用 Harness
给插件提供的接口
面板通过
definePanel(ctx, entry) 注册。PanelEntry 包含 id、label、icon、render,可选 order 与 locale;入口注册到 sidebar.panellist,内容注册到 main。返回的 PanelHandle 提供 select()、close() 和 dispose()。
当前的 dsh-tauri-extension 与 dsh-tauri-scheduler 使用这一入口。已移除的 dsh-tauri-panel 的 panel.protocol 与 sidebar.panel.action 不提供兼容路径。
兼容与安全边界
- 当前桌面推荐 Harness 0.2.0-rc.2,接受的最低版本为 0.1.5-rc.1。最低版本不保证每项 API 都存在;适配取决于实际服务与能力探测。
- 宿主仅在桌面注入
DSH_TAURI_EMBEDDED=1时启用内嵌载体鉴权适配。独立启动的dsh web继续使用 browser-session 鉴权。 - Tauri 调用经父窗口消息转发。桌面壳核对 iframe 来源与 origin,只执行白名单命令;缺少宿主桥时调用会失败,不会自动获得其他原生权限。
- 客户端桥只在嵌入环境启用。插件缺失或初始化失败时,依赖它的桌面导航与原生调用没有通用替代路径。