> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 扩展与市场

<Info>
  仅适用 Enterprise
</Info>

扩展与市场用于管理组织认可的插件和技能。管理员可以通过专属市场按集合组织能力，控制成员可见范围，并按需下发给 Qoder 或 QoderWork 成员。

适用于需要沉淀团队实践、接入企业工具、复用专业工作流或统一分发能力的场景。

## **基本概念**

| **概念**     | **说明**                                                |
| :--------- | :---------------------------------------------------- |
| 技能（Skill）  | 面向特定任务的可复用能力，例如代码审查、测试生成、API 文档生成                     |
| 插件（Plugin） | 可安装的能力包，可包含技能、命令、MCP 服务器等能力；在 QoderWork 客户端市场中展示为专家套件 |
| 专属市场       | 组织成员发现和安装企业认可能力的入口，英文名称为 Private Marketplace          |
| 集合         | 专属市场中的管理单元，用于组织同一类插件或技能                               |
| 下发         | 管理员将集合中的单个插件或技能推送给成员                                  |

如需了解插件的目录结构、`plugin.json`、MCP 服务器配置、Hooks、打包与分发，请参阅 [插件（Plugins）](https://docs.qoder.com/zh/qoder-plugins)。

## **专属市场**

专属市场以集合为单位进行管理。集合可以适用于 Qoder、QoderWork，或同时适用于两者。

对接专属市场时，目前仅 QoderWork 支持在客户端市场中展示；Qoder 和 QoderWork 都支持管理员下发。当前专属市场支持 QoderWork 的技能市场和专家套件市场，其中专家套件市场展示的是插件内容。

集合的内容类型决定它在 QoderWork 中进入哪个市场：

| **内容类型** | **QoderWork 中的展示位置** |
| :------- | :------------------- |
| 技能       | 技能市场                 |
| 插件       | 专家套件市场               |

## **集合**

集合用于组织专属市场中的插件和技能。创建集合时，需要确认以下信息：

| **信息** | **说明**                         |
| :----- | :----------------------------- |
| 集合名称   | 成员或管理员看到的名称                    |
| 描述     | 说明集合面向的团队、场景或内容边界              |
| 产品     | 集合适用于 Qoder、QoderWork，或同时适用于两者 |
| 内容类型   | 集合内包含插件或技能                     |
| 市场可见范围 | 控制哪些成员可在 QoderWork 客户端市场中发现该集合 |

> 提示：一个集合只管理一种内容类型。插件和技能需要分别管理时，请创建不同集合。

## **上传插件或技能**

管理员可以将企业自有的插件或技能上传到当前集合。上传内容的类型必须与集合的内容类型一致。

| **内容类型** | **ZIP 包要求**                     |
| :------- | :------------------------------ |
| 插件       | ZIP 根目录需要包含 `.qoder-plugin/` 目录 |
| 技能       | ZIP 根目录需要包含 `SKILL.md` 文件       |

上传后，内容会出现在当前集合中。管理员可以继续配置分类、查看版本信息，或设置下发。

## **管理内容**

集合中的内容可以配置分类、下发范围和下发策略。

分类用于帮助成员在专属市场中理解和查找内容。建议使用稳定、容易理解的分类名称，例如 `Code Review`、`Testing`、`Documentation`、`Data`。

将内容从集合中移出时，只会移除它与当前集合的关系，不会删除原始插件或技能包。

## **配置下发**

下发配置作用于集合中的单个内容。Qoder 和 QoderWork 都支持管理员下发。

| **下发范围** | **说明**                      |
| :------- | :-------------------------- |
| 未下发      | 不通过管理员下发；如果集合对成员可见，成员仍可自助安装 |
| 全员下发     | 下发给组织内所有成员                  |
| 分组下发     | 下发给指定成员分组                   |

| **下发策略** | **说明**            |
| :------- | :---------------- |
| 客户端可配置   | 成员可在客户端中查看并配置该内容  |
| 强制开启     | 内容在客户端中展示，并保持启用   |
| 静默启用     | 内容在客户端中不展示，但由后台启用 |

市场可见范围和下发范围是两个不同概念：

| **范围** | **控制对象** | **影响**                       |
| :----- | :------- | :--------------------------- |
| 市场可见范围 | 集合       | 成员是否能在 QoderWork 客户端市场中发现该集合 |
| 下发范围   | 单个内容     | 成员是否会收到管理员下发的内容              |

如果下发范围大于市场可见范围，部分成员可能会收到客户端内容，但无法在 QoderWork 客户端市场中搜索到它。

## **常见问题**

### **插件和技能有什么区别？**

技能通常用于完成一个明确任务。插件是可安装能力包，可以包含一个或多个技能，也可以包含命令、MCP 服务器等其他能力。在 QoderWork 客户端市场中，插件会展示为专家套件。

### **专属市场中的内容一定会下发给成员吗？**

不会。专属市场可见表示成员可以在 QoderWork 客户端市场中发现内容；是否下发由内容的下发范围和下发策略决定。

### **移出集合会删除插件或技能吗？**

不会。移出集合只会移除内容与当前集合的关系，不会删除原始插件或技能包。
