将插件发布到插件市场

一个 JSON 文件，列出所有插件

在发布位置的根目录创建 marketplace.json：

{
  "name": "acme",
  "description": "Internal LingCode plugins for the Acme engineering team.",
  "plugins": [
    {
      "name": "tdd",
      "description": "Acme's TDD workflow: write the failing test first.",
      "source": "git+https://github.com/acme/lingcode-plugins.git",
      "subpath": "tdd"
    },
    {
      "name": "deploy-staging",
      "description": "Deploy the current branch to Acme's staging environment.",
      "source": "git+https://github.com/acme/lingcode-plugins.git",
      "subpath": "deploy-staging"
    }
  ]
}

结构很简洁：一个插件市场有名称、描述，以及一个插件列表。每个插件条目包含自己的名称、描述、source（从哪里克隆）和 subpath（source 中的子目录）。用户安装时，LingCode 根据 source+subpath 拉取实际的插件内容。

只要能被访问到即可

"托管"插件市场，本质上就是托管一个 JSON 文件，以及它所指向的插件文件夹。通常有两种选择：

• git 仓库。把 marketplace.json 放在根目录，插件放在子目录，推送到 GitHub。用户通过 git URL 添加插件市场；LingCode 从默认分支读取清单。
• 稳定 URL 上的静态文件。把 marketplace.json 部署到 CDN 或静态托管服务，将插件的 source URL 单独指向 git 仓库。适合需要将插件市场元数据与插件代码解耦的场景。

对大多数团队来说，git 仓库的方式更简单：一个仓库同时包含插件市场和所有插件，更新任意一方都是一次普通的 commit。如果插件引用了内部内容，将仓库设为私有即可。

一条命令，一个 URL

你的团队成员只需运行一次：

lingcode plugin marketplace add https://github.com/acme/lingcode-plugins

LingCode 读取该地址的 marketplace.json，将其快照保存到 ~/.claude/marketplaces/acme/，此后便知道这个插件市场所提供的所有插件。

这就是目标

注册插件市场后，安装插件变得如此简单：

lingcode plugin install tdd
lingcode plugin install deploy-staging

无需 URL，无需 subpath，无需任何复制操作。LingCode 在已注册的插件市场中查找 tdd，在 acme 中找到它，然后拉取并安装。lingcode plugin search 可以列出所有可用插件，方便用户浏览。

快照，而非订阅

用户添加插件市场后，他们的快照就固定了。你在清单中新增的插件不会出现在他们的 plugin search 结果中，直到他们重新添加插件市场为止。这是安全性的代价：从远程源自动拉取插件元数据，意味着永久信任那个远程来源。

有两种模式能很好地适应这一限制：

• 在聊天或文档中公告。新增插件时，发一条通知："有新插件可用，运行 marketplace remove acme && marketplace add <url> 来刷新。"大多数团队都会跟进。
• 对插件市场做版本管理。每个插件条目可以携带 version 字段；用户运行 lingcode plugin update <name> 可以获取已注册插件市场中该插件的最新版本。他们仍然无法在不重新添加的情况下看到新插件，但已有插件可以获取更新。

三个会持续复利的习惯

• 版本标签。每次对插件做出有意义的改动时，用 semver 风格的标签（如 v0.3.0）打标插件市场仓库。即使没有工具消费这些标签，未来的你也能一眼定位。
• 每个插件单独写 README。每个插件目录都有自己的 README，说明它做什么、改动了什么，以及（对于 hooks）会阻断什么。没有仔细阅读就安装的用户，至少有个地方可以回头查。
• CHANGELOG。在插件市场级别维护一份变更日志。每条改动一行记录，省去日后无数次的重新排查。