mirror of
https://github.com/langbot-app/LangBot.git
synced 2026-11-04 14:52:12 +08:00
docs(certification): align sharing eligibility and dedicated fallback (#138)
Co-authored-by: Hermes Agent <[email protected]>
This commit is contained in:
co-authored by
Hermes Agent
parent
8da464933a
commit
a87f896a91
@@ -3,7 +3,7 @@ title: "认证插件与无状态组件"
|
||||
description: "认证插件为什么共享 Worker,以及 stateless-v1 组件规范。"
|
||||
---
|
||||
|
||||
**认证插件**不是普通安全徽章,而是平台对某个精确、不可变插件版本授予的跨租户共享执行资格。相同 artifact digest 的安装可以共享一个 Worker、一个 `BasePlugin` 实例和一组组件实例;每个安装只保留轻量的配置、权限与生命周期上下文。这里的“一组组件”指每个已声明组件 manifest 各一个实例,包括 EventListener、Tool、Command、KnowledgeEngine、Parser、Page 和 Runner。
|
||||
精确下载制品的有效可信签名才赋予 LangBot Cloud 跨工作区共享单个 Worker 的资格。市场上的**认证插件**标识本身不能证明下载的 ZIP 已通过验证,也不能证明线上 Worker 实际共享;认证不是普通安全徽章。相同 artifact digest 的安装可以共享一个 Worker、一个 `BasePlugin` 实例和一组组件实例;每个安装只保留轻量的配置、权限与生命周期上下文。这里的“一组组件”指每个已声明组件 manifest 各一个实例,包括 EventListener、Tool、Command、KnowledgeEngine、Parser、Page 和 Runner。
|
||||
|
||||
## 声明
|
||||
|
||||
@@ -16,7 +16,7 @@ execution:
|
||||
componentModel: stateless-v1
|
||||
```
|
||||
|
||||
两个字段必须同时出现。声明只是申请,不能代替辅助审查、人工批准和精确 artifact 签名。
|
||||
两个字段必须同时出现。声明只是申请,不能代替绑定精确制品的可信辅助审查、人工批准和有效签名。辅助审查只是内部前置证据,不是中间认证等级。
|
||||
|
||||
## 无状态组件规范
|
||||
|
||||
@@ -55,6 +55,6 @@ async def initialize(self):
|
||||
|
||||
## 兼容旧插件
|
||||
|
||||
旧源码和未签名插件包仍兼容 dedicated Worker。在 OSS 中,没有受信任 `stateless-v1` v2 证书的插件按准入策略保持 dedicated;Cloud 可能在安装前拒绝不满足证书策略的插件。已有安装不代表获得新共享资格。仅修改 manifest 而不迁移代码不会通过认证审查。
|
||||
旧源码和未签名插件包仍兼容专属 Worker,Cloud 也允许未签名专属安装。不存在专属运行认证或专属签名。Cloud 必须拒绝畸形、伪造、不可信或缺少 `stateless-v1` 声明的旧版签名证书,不能将其当作未签名制品。自托管 OSS 不内置认证签发方公钥,仅支持单工作区;不支持配置公钥获得认证共享运行。已有安装或市场标识不代表获得共享资格。仅修改 manifest 不会通过认证审查。
|
||||
|
||||
认证流程仍包括辅助代码审查和人工批准,并将插件身份、版本、digest、`shared-runtime-v1` 与 `stateless-v1` 一起签入证书。提交方式参阅[发布到插件市场](/zh/plugin/dev/publish/market)。
|
||||
|
||||
@@ -84,7 +84,7 @@ Plugin built successfully: dist/tmp/RockChinQ-HelloPlugin-0.1.0.lbpkg
|
||||
|
||||
LangBot Space 会检查本次提交的精确插件包,进行辅助代码审查,并在人工批准后才签发认证插件标识。认证绑定到已审核的插件版本与校验和。请让工作区配置、存储、凭据、日志和后台工作都与当前安装绑定,不要依赖可变的进程全局状态。
|
||||
|
||||
如果审核发现该版本无法满足要求,请先作为普通专属插件发布,并在后续不可变版本中修复问题。用户侧说明见[认证插件](/zh/plugin/certified-plugins)。
|
||||
如果审核发现该版本无法满足要求,请先作为未签名的普通专属插件提交,并在后续不可变版本中修复问题。不存在专属运行认证或中间认证等级。用户侧说明见[认证插件](/zh/plugin/certified-plugins)。
|
||||
|
||||
<img width="600" src="/images/zh/plugin/dev/plugin_submission.png" />
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@ title: "LangBot 插件"
|
||||
|
||||
LangBot 内部由多种组件组成,如大模型工具、命令、消息平台适配器、大模型请求器等。为了满足扩展性和灵活性的需求,我们实现了一套生产级的插件系统。
|
||||
|
||||
插件由 Plugin Runtime 统一管理。大多数插件使用专属运行时;通过审核的版本会显示为[认证插件](/zh/plugin/certified-plugins),并在 LangBot Cloud 中使用认证插件额度。
|
||||
插件由 Plugin Runtime 统一管理。大多数插件使用专属运行时;精确制品签名通过验证的版本才可能在 LangBot Cloud 获得[跨工作区共享资格](/zh/plugin/certified-plugins);审核本身不是认证。
|
||||
|
||||
<img width="600" src="/images/zh/plugin/dev/plugin_system_arch.png" />
|
||||
|
||||
|
||||
Reference in New Issue
Block a user