远程插件

从 Coskey 远端索引检查、下载和更新插件,再在 ChatGPT.app 中安装或升级。

远程插件来自 Coskey 维护的插件发布索引。Coskey 负责发现新版本、下载并校验插件包;下载成功后, 插件才进入本地插件市场,安装和启用仍由 ChatGPT.app 完成。

← 返回插件手册

1. 检查远程索引

打开 Coskey → 插件 时会自动检查远端版本,不需要单独的「检查更新」按钮。远端插件与已有 本地插件合并显示:远端独有条目会带「远程」标签和「尚未下载」;本地已有旧版本时,则保留插件 自己的 logo,并同时显示「远端 vX」和下载图标。

远程示例:本地 v0.9.9,远端提供 v1.0.0

以图中的「远程示例」为例:

标记 含义
版本 v0.9.9 本地市场当前可用的版本
「远程」 来源是 Coskey 远端索引
「远端 v1.0.0」 远端索引提供的版本
「未安装」 本地副本还没有在 ChatGPT.app 中安装
下载图标 只下载当前插件,不会安装它

页面右上出现的「N 个插件可下载更新」是整张列表的汇总提示。网络不可用时会使用最近一次成功的 索引缓存,仍可浏览和安装已有的本地版本。

2. 下载到本地市场

  1. 点击远端插件卡右侧的下载图标;
  2. 阅读确认框中的版本与本地 MCP 权限提示;
  3. 点击 「下载插件」。

Coskey 会下载 ZIP,核对索引中的大小与 SHA-256,受限解压并原子切换到本地市场。校验或解压失败 时保留当前清单与旧版本,不会留下半安装状态。

下载完成后,卡片仍标「远程」,版本会切换到本地市场的新版本;远端独有条目会从「尚未下载」 变成「未安装」。这一步只准备好了本地副本:

远程插件下载完成,等待在 ChatGPT.app 中安装

3. 在 ChatGPT.app 安装或升级

  1. 点击 Coskey 右上角的 「打开 ChatGPT.app」;
  2. 进入 ChatGPT.app 的 插件(Plugins);
  3. 选择 Coskey 插件市场;
  4. 找到插件并安装;已有旧版本时重新安装或升级;
  5. 回到 Coskey,点 「刷新集市」 更新安装状态。

与本地导入相同,看到「已安装已启用」后插件才可用。插件升级不会自动替换 ChatGPT.app 中的旧 缓存,必须在应用插件页重新安装新版本。完整安装界面见 本地导入:在 ChatGPT.app 安装或启用。

4. 刷新与离线使用

  • 刷新集市:重新生成本地市场,并再次检查远端索引;不会自动下载或安装插件;
  • 离线使用索引缓存:联网失败时保留最近一次索引结果,可继续使用已经下载的版本;
  • 远端可更新:卡片出现「远端 vX」和下载图标时,按第 2 节下载后再去应用升级;
  • 只下载单个插件:列表卡上的下载图标只更新对应插件,不会同步整张远端索引。

5. 回滚

如果详情页显示可用的上一代版本,可以先在 Coskey 中回滚本地市场版本。回滚离线完成,不会访问 远端索引;随后仍需到 ChatGPT.app 重新安装,应用才会切换到那份副本。

6. 常见问题

现象 处理
列表里没有远端插件 保持网络可用后重新打开插件页或点「刷新集市」;仍失败时运行「诊断」,确认索引缓存与集市结构
下载按钮没有出现 当前版本与本地市场相同,或远端索引中的平台与当前系统不匹配
下载失败 检查网络和远端归档;Coskey 会保留原清单与旧版本,可修正索引或网络后重试
下载完成但 ChatGPT.app 里没有 正常;下载只进入本地市场,还需在应用插件页安装
应用仍使用旧版本 在 ChatGPT.app 插件页重新安装或升级,再回 Coskey 刷新状态
首次下载提示本地 MCP 这是执行权限提醒;先在插件详情核对 MCP 名称与来源,确认可信后再继续

7. 安全边界

远端下载同时校验包结构、大小与 SHA-256,但不代表对插件代码做了安全审计。远端索引只提供 Coskey 发布的插件,不代理 ChatGPT 官方插件目录;非回环地址的下载必须使用 HTTPS。

相关:本地导入、Coskey Tools。