业务插件 ​

业务插件扩展业务页面、服务和数字员工工具，并维护自身的业务授权模型。插件市场发布、宿主安装与插件内业务操作分别控制分发、可用范围和数据访问。

插件组成 ​

一个插件包可以只包含其中部分内容。

对话选择与插件安装 ​

输入框“添加 → 插件”列出当前数字员工提供的内置插件。使用者的选择随本次请求发送；系统受理消息后清空选择，不写入安装或启用配置。

员工“配置 → 插件”维护当前数字员工的运行时插件，后台“插件生态”维护发布目录、安装与版本。安装与配置持续作用于其指定范围，不能用输入框的选中状态判断是否已安装或启用。

各入口的用途见插件入口的区别。

安装范围 ​

插件可按租户或数字员工范围安装，作用范围和工具内容由插件声明决定；数字员工切换会改变适用插件。

作用域由插件决定。数字员工级插件的安装向导提供“选择员工”；租户级插件直接进入“确认影响”，不提供员工选择。

租户级插件包含数字员工运行部分时，对本租户全部数字员工生效，包括以后新建的数字员工。只有前端或后端的插件不因此获得数字员工运行工具。

扩展导航只显示当前适用且有权访问的前端页面。没有匹配项时，扩展导航可以不显示。

权限模型 ​

三者分别判定，平台管理员不自动成为插件业务管理员。数字员工调用插件工具还受实际执行身份、声明权限与目标数据范围控制。

版本与发布 ​

插件包需要包含可运行内容及依赖，并声明版本和兼容范围。插件生态支持搜索、显示已归档项及查看安装内容与配置；停用、回退、卸载和归档下架受到相应权限控制。

后端必填配置未填齐时，后端不会启动；数字员工运行部分（claw）的配置写入后需要重启才能生效。

安装与分项配置按顺序提交，安装报错时可能已经形成安装记录。管理员应先查看已安装版本与配置状态，再补齐失败项。

数字员工运行时插件的打包要求如下：

• 上传格式支持 .zip、.tgz、.tar.gz。
• 包需自包含，入口为编译后的 JavaScript。
• 包声明依赖时需同时打包 node_modules，运行时不会在线安装依赖。

这些要求仅适用于运行时插件，不是所有前端/后端插件的通用发布格式。

配置与安全 ​

端点由受控部署配置提供，秘密从专门配置或环境读取，不写进源码、安装包说明或截图。插件页面样式与权限范围应受宿主管理，不越权读取无关用户内容。

操作见业务插件。