插件市场

查找插件，核对权限，按固定版本安装。插件安装后保持停止状态，权限需要单独授予。

搜索名称、插件 ID、版本或平台

9 个版本

• Go 状态与事件服务 (darwin/amd64)

  example.go-state-darwin-amd64 · 1.0.0

  go darwin/amd64

  查看详情与权限

• Go 状态与事件服务 (darwin/arm64)

  example.go-state-darwin-arm64 · 1.0.0

  go darwin/arm64

  查看详情与权限

• Go 状态与事件服务 (linux/amd64)

  example.go-state-linux-amd64 · 1.0.0

  go linux/amd64

  查看详情与权限

• Go 状态与事件服务 (linux/arm64)

  example.go-state-linux-arm64 · 1.0.0

  go linux/arm64

  查看详情与权限

• Go 状态与事件服务 (windows/amd64)

  example.go-state-windows-amd64 · 1.0.0

  go windows/amd64

  查看详情与权限

• 原生 Bus 发货服务

  example.nativebusshop · 1.0.0

  python

  查看详情与权限

• 入门服务（欢迎 / 帮助 / 公告）

  example.starter-service · 1.0.0

  python

  查看详情与权限

• Fatalder 云导入

  fatalder.cloud-import · 1.0.1

  查看详情与权限

• Fatalder 云导入

  fatalder.cloud-import · 1.0.4

  查看详情与权限

所有版本

• Go 状态与事件服务 (darwin/amd64) 1.0.0 — example.go-state-darwin-amd64
• Go 状态与事件服务 (darwin/arm64) 1.0.0 — example.go-state-darwin-arm64
• Go 状态与事件服务 (linux/amd64) 1.0.0 — example.go-state-linux-amd64
• Go 状态与事件服务 (linux/arm64) 1.0.0 — example.go-state-linux-arm64
• Go 状态与事件服务 (windows/amd64) 1.0.0 — example.go-state-windows-amd64
• 原生 Bus 发货服务 1.0.0 — example.nativebusshop
• 入门服务（欢迎 / 帮助 / 公告） 1.0.0 — example.starter-service
• Fatalder 云导入 1.0.1 — fatalder.cloud-import
• Fatalder 云导入 1.0.4 — fatalder.cloud-import

使用官方目录

工具包 CLI 与本站使用同一个官方目录。每次查询重新读取官方目录，可按名称、插件 ID 或描述筛选；查询不需要管理令牌。

python3 runtime-admin.py catalog-sync
python3 runtime-admin.py catalog-list --query shop

查看某个固定版本的完整目录声明，无需管理令牌：

python3 runtime-admin.py catalog-show --plugin fatalder.cloud-import --version 1.0.4

详情页提供固定版本安装命令、目录声明的兼容要求与请求权限。安装前请确认你的 Host 版本及运行平台符合要求。安装完成后，按管理插件配置参数、单独授权、运行 doctor，再启动。

更新已安装插件

以下以安装名 cloud-import、插件 ID fatalder.cloud-import 和目标版本 1.0.4 为例，适用于已安装较旧版本且可以安排停用维护的情况。将安装名、目标版本和令牌文件路径换成实际值。默认连接本机 http://127.0.0.1:18793；实例地址不同则补充 --url。

1. 查询可用稳定版本。此命令读取实例当前安装和官方目录，需要管理令牌；它不会自动更新。

   python3 runtime-admin.py --token-file ./admin.token catalog-updates cloud-import

2. 确认没有未完成或结果不明的业务后，关闭自动启动并停止插件。

   python3 runtime-admin.py --token-file ./admin.token disable cloud-import
   python3 runtime-admin.py --token-file ./admin.token plugins

3. 预览固定版本更新，核对 Host/Worker 兼容要求、来源、权限变化及准备状态。

   python3 runtime-admin.py --token-file ./admin.token catalog-update-plan cloud-import --plugin fatalder.cloud-import --version 1.0.4 --maintenance-mode stopped --json

   预览未就绪时先处理原因。目录没有声明的要求应查阅插件发布说明；目录声明不代替 Host 对安装包的检查。

4. 使用相同版本和维护模式提交。交互界面会再次展示预览；确认版本与权限后输入“更新”。不要把自动授权或跳过确认加入脚本。

   python3 runtime-admin.py --token-file ./admin.token catalog-update cloud-import --plugin fatalder.cloud-import --version 1.0.4 --maintenance-mode stopped

   更新会校验目录来源与安装包摘要；来源需要绑定或切换时还会单独询问。不要为了绕过来源不符而换源或卸载重装。

5. 查询当前安装和日志，核对更新结果。

   python3 runtime-admin.py --token-file ./admin.token plugins
   python3 runtime-admin.py --token-file ./admin.token logs cloud-import

停用维护的更新流程会启动候选版本进行激活检查，成功后仍保留自动启动关闭状态。需要自动启动时按管理插件单独开启。

更新失败或请求结果不明时，先保留旧安装、更新前备份及现有恢复记录，核对 maintenance_pending、recovery_required 等状态，按排查问题处理。不要重复提交、删除安装目录或用卸载重装绕过恢复；unknown 不得自动重放。