v56

latestSwagger 2.0Apache 2.0raw.githubusercontent.com2026-08-0616186383.8 KB
JS插件管理

从注册表安装插件

从注册表中的 download_url 下载 ZIP 并安装插件。如果 entry_path 已存在且属于同一作者,则自动走更新路径。支持 GitHub 代理(含 api.github.com 私有仓库 Release 资源的下载,代理端需开启 FORWARD_AUTHORIZATION_API 才会转发 token)。可选传入 token 字段用于从需要认证的私有源下载;若未提供 token 但提供了 source_url(「全部」聚合模式),后端会自动从 plugin_registries 配置解析该源存储的 token。 若 entry_path 已被本地一个不同作者的插件占用,返回 409 且不做任何写入(不落盘、不动 static 目录、不改数据库)。前端应向用户说明会替换原插件后,带 overwrite=true 重发本请求。

post/jsplugins/registry/install

Request body

download_urlstring
github_proxystring
overwriteboolean

Overwrite 为 true 时允许覆盖掉本地已装的同 entry_path 但不同作者的插件。 默认 false:这种情况返回 409,由前端二次确认后带该字段重发。

source_urlstring

SourceURL 插件所属订阅源 URL。「全部」聚合模式安装时回传: 当未显式提供 token 时,后端据此从 plugin_registries 配置解析该源的 token。

tokenstring

Response

安装结果(更新已有插件)

failedinteger
messagestring
successinteger
totalinteger