JS插件管理

从注册表安装插件

Changed on

从注册表中的 download_url 下载 ZIP 并安装插件。如果 entry_path 已存在且属于同一作者,则自动走更新路径。匿名下载支持 GitHub 加速代理;携带 Token 的下载始终绕过加速代理,避免凭据泄漏。可选传入 token 字段用于从需要认证的私有源下载;若未提供 token 但提供了 source_url,后端会自动从 plugin_registries 配置解析该源存储的 token。 若 entry_path 已被本地一个不同作者的插件占用,返回 409 且不做任何写入(不落盘、不动 static 目录、不改数据库)。前端应向用户说明会替换原插件后,带 overwrite=true 重发本请求。

post/jsplugins/registry/install

Request

  • Base URL: https://localhost:58091/api/v1
  • URL: https://localhost:58091/api/v1/jsplugins/registry/install
  • Auth: API key in header Authorization

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

Changes