Plugin Marketplaces — 创建和分发插件目录

是什么

Plugin Marketplace 是一个 Plugin 目录，通过 marketplace.json 文件定义，托管在 git 仓库中。用户添加 Marketplace 后可以浏览和安装其中的 Plugin，支持版本追踪和自动更新。适合团队内部分发工具或向社区发布扩展。

核心机制

Marketplace 结构：

my-marketplace/
├── .claude-plugin/
│   └── marketplace.json    # Marketplace 元数据和 Plugin 列表
└── plugins/
    └── my-plugin/          # Plugin 目录
        ├── .claude-plugin/
        │   └── plugin.json
        └── skills/

marketplace.json 关键字段：name（Marketplace 标识符）、owner、plugins（Plugin 列表，每项含 name 和 source）。

版本解析：

• Plugin 设置了 version：只在版本号变更时更新
• Plugin 未设置 version：每次 git commit 都视为新版本（适合快速迭代）

发布流程：

1. 创建 Plugin 和 marketplace.json
2. 推送到 GitHub/GitLab 等 git 托管
3. 用户通过 /plugin marketplace add <owner/repo> 添加
4. 更新时推送新 commit，用户运行 /plugin marketplace update

跨 Marketplace 依赖：需要在根 Marketplace 的 marketplace.json 中配置 allowCrossMarketplaceDependenciesOn。

关键细节

• 添加 Marketplace：/plugin marketplace add anthropics/claude-plugins-official
• 添加 GHES Marketplace：/plugin marketplace add git@github.example.com:org/plugins.git
• 更新 Marketplace：/plugin marketplace update <name>
• 企业预注册：extraKnownMarketplaces 配置
• 企业限制来源：strictKnownMarketplaces 配置

关联

• plugins — Plugin 创建指南
• discover-plugins — 用户侧安装 Plugin
• plugin-dependencies — Plugin 依赖版本约束
• github-enterprise-server — GHES 上的 Marketplace 配置

实践要点

• owner/repo 简写只解析到 github.com，GHES 需要完整 git URL
• 设置 version 字段可以控制更新节奏，避免每次 commit 都触发用户更新
• 企业可通过 extraKnownMarketplaces 预注册内部 Marketplace，用户无需手动添加
• Marketplace 更新后用户需手动运行 /plugin marketplace update 或等待自动更新