Files
navop/docs/extension-resource-plugins
胡飞 15b1e2505f chore(deps): 合入 gpui-kit 上游改动,gpui-shell 跟进到 0.6.4
- gpui-kit(feigeCode/gpui-kit port-ce-generic-to-main)升到 23c8e5b78:合入上游
  45 个提交(0.6.1 → 0.6.4)。其中 QuickJS JIT 升到 0.12.9,与本分支的 32 位改动
  重叠,冲突已在 gpui-kit 侧解决(保留按位宽拆分 + i686 补丁;上游把软换行的行换成
  `InputLine`、对话框 button props 改为合并语义,内联 widget 布局与 alert/confirm
  已相应适配)。Cargo.toml 的 8 处 pin 一起回填到新 rev,Cargo.lock 重新解析
  (gpui-wry 0.6.4、rquickjs 0.12.9,旧 rev 无残留)。
- 宿主 gpui-shell 版本 0.6.1 → 0.6.4:extension-runtime 的 GPUI_SHELL_VERSION 与
  各处测试清单、文档示例同步提升。该校验对 0.x 按 minor 精确匹配,旧值会被直接拒绝。

验证:cargo check -p remote_desktop_view(新 gpui-kit + quickjs-jit i686 分支)
→ Finished dev profile,0 error。
2026-09-20 19:20:21 +08:00
..

Universal Resource Plugins

当前底层机制保持 headless;MVP 已在其上接入一个最小 gpui-shell embedded UI

  • extension.json 声明 native IPC runtime
  • 宿主按 namespaced runtime id 惰性启动和监督 provider
  • provider 通过稳定 RPC 提供 resource、job、event stream、blob 能力;
  • 权限、进程生命周期、重启代数和 host blob 均由宿主管理;
  • shell view 由 gpui-shell 加载,所有脚本组件统一来自 gpui-component-shellgpui-component moduleprovider 仍不返回 UI tree。

扩展连接复用标准 StoredConnection、工作区、首页和侧边栏生命周期。 contributes.connections 声明宿主表单、IPC runtime 和可选 shellViewId:有 UI 时打开 connection-scoped shell tab,无 UI 时打开宿主 headless 状态 tab。job/event/blob、热更新 drain 和 permission facade 均复用同一 provider runtime。

后续 UI 统一由 gpui-shell 承载。gpui-shell 将复用本层的 runtime activation 和 typed client,不重新引入第三方 UI 协议。

Runtime 生命周期

  1. ExtensionRuntimeCatalog 解析 runtime.ipc
  2. ActivationManager::activate_runtime 启动或复用 runtime,并返回 activation lease。
  3. 调用方通过 ManagedUniversalPluginClient 使用 resource/job/event/blob 方法。
  4. 调用方释放 lease;最后一个 lease 释放后 provider 关闭。
  5. RuntimeMonitor 检查健康状态并按 manifest 策略执行有限重启。

当前边界

  • 不解析 contributes.declarativePanels
  • 不提供 ui/actionui/dialogui/window
  • 不提供 WASM open-viewhandle-view-action
  • DB tree extension action 仍可执行无 UI WASM action。
  • extension_view 继续作为 Navop 的扩展安装/管理页面,与插件 UI 无关。

gpui-shell 接入点

详细设计见 gpui-shell-extension-design.md

后续 ShellPluginHost 负责:

  • 根据 extension.json 中的新 shell contribution 定位脚本入口;
  • 先注册 navop.* HostModule,再实例化脚本视图;
  • 通过 UniversalPluginService::activate_runtime 获取 provider lease
  • 把 resource/job/event/blob/db capability 暴露给脚本;
  • unload 时释放 host module、脚本 view 和 activation lease。