跳转到内容

插件

OxideTerm 的原生插件宿主会从当前配置目录发现插件包。插件在 plugin.json 中声明身份和贡献项;原生应用不会把 JavaScript 加载到浏览器界面中执行。

支持三种运行时:

  • process:由宿主管理可执行文件,通过带版本的 JSON Lines 通信。
  • wasm:由集成运行时管理 Wasm 模块。
  • manifest-only:只声明贡献项,不需要可执行运行时。

原生应用不会执行旧的 JavaScript 入口。

使用桌面端“插件管理器”浏览、安装、启用、禁用、更新和配置插件。本地开发时,将插件包放入当前配置目录:

<config-dir>/plugins/<plugin-id>/
├── plugin.json
└── plugin.wasm 或 bin/<executable>

运行 oxideterm paths --json 可查看当前配置目录。CLI 可以列出、启用、禁用插件并检查插件设置;安装和更新由桌面端管理器负责。

插件可以声明标签页、侧栏面板、设置、命令、快捷键、上下文菜单、状态项、终端钩子、事件订阅、AI 工具和受支持的传输方式。标签页和面板提供声明式 schema,由 GPUI 负责渲染和交互。

宿主会校验清单和路径,在激活时传入生效的能力与允许调用的宿主 API,并将插件诊断与协议输出分离。启用插件前,应检查其身份、权限、设置和声明的界面能力。

继续阅读插件开发指南,了解原生清单和运行时流程。