Loom Studio
正在准备画面 0%
例如 in:文档
↑ ↓ 移动 ↵ 打开esc 关闭
Loom Studio
文档/插件与扩展体系

Loom Studio Manual

插件与扩展体系

Package、Module 与 Instance 三层模型,让能力扩展、界面渲染与生命周期保持清晰可控

三层生命周期模型

Loom Studio 不采用“单个脚本即插件”的简陋模式,而是将扩展拆解为三层清晰的生命周期:

Extension Package
  安装分发、版本管理与持久数据归属
  ↓
Extension Module
  运行环境、代码入口、启用状态与能力授权
  ↓
Extension Instance
  单次激活、事件注册与生命周期上下文
  • Package(扩展包):分发与分享的最小单元,一个包可以纯粹包含角色卡设定、世界书与提示词模板,也可以同时携带服务端或前端可执行模块
  • Module(功能模块):运行时的边界划分,后端模块提供数据工具与扩展能力,前端模块负责界面挂载与交互组件
  • Instance(运行实例):实际执行的生命周期实体,当插件热重载或停用时,对应的所有事件监听与资源占用会被确定性回收,根绝内存泄漏与幽灵监听

服务端与前端隔离

服务端与客户端拥有完全不同的环境与安全边界:

  • Server Host:管理后台模块的生命周期、事件订阅与存储,负责数据校验与模型工具对接
  • Client Host:管理前端渲染模块,通过规范的界面协议,让插件能够优雅地向工作区注入自定义面板与交互卡片

声明式 Manifest

扩展通过 manifest.json 显式声明其所需能力与交互范围,未经声明的操作在运行时将无法执行

多个插件共存时的优先级与依赖关系完全透明,杜绝隐蔽的全局状态污染与未知冲突,让生态扩展真正做到即插即用、安全可靠

继续向下阅读