使用企业管理的设置管理插件市场和插件

使用 managed-settings.json 文件可使插件市场可用，并强制启用或阻止特定插件。 有关企业托管设置的概述，请参阅 企业管理设置入门。

托管设置始终优先于存储库默认值和成员首选项。

为企业成员添加市场平台

使用 extraKnownMarketplaces 按键使其他市场可用。 每个条目都有一个市场名称和一个 source 对象。 例如：

{
  "extraKnownMarketplaces": {
    "engineering-tools": {
      "source": {
        "source": "github",
        "repo": "ORG/REPOSITORY"
      }
    }
  }
}

{
  "extraKnownMarketplaces": {
    "engineering-tools": {
      "source": {
        "source": "github",
        "repo": "ORG/REPOSITORY"
      }
    }
  }
}

用包含市场的存储库替换 ORG/REPOSITORY。 此设置中的市场名称必须与其name文件中的marketplace.json匹配。

成员需要对每个市场存储库具有 GitHub 读取访问权限。 对于专用市场，将其托管在其用户所属的组织中。

（可选）配置其他属性：

• 若要控制客户端是否刷新市场并更新其已安装的插件，请配置可选 autoUpdate 属性。
• 若要将应用市场安装限制为列出的源，也可以使用 strictKnownMarketplaces。 这还会禁用内置应用商店。

有关支持的源行为、配置详细信息和客户端支持，请参阅 企业管理设置。

要求或阻止特定插件

使用 enabledPlugins 可要求或阻止特定插件。 每个键都使用格式 PLUGIN-NAME@MARKETPLACE-NAME。

• 将该值设置为 true，以要求启用该插件。
• 将值设置为 false 以要求禁用插件。

例如：

{
  "enabledPlugins": {
    "PLUGIN-NAME@MARKETPLACE-NAME": true,
    "ANOTHER-PLUGIN@MARKETPLACE-NAME": false
  }
}

{
  "enabledPlugins": {
    "PLUGIN-NAME@MARKETPLACE-NAME": true,
    "ANOTHER-PLUGIN@MARKETPLACE-NAME": false
  }
}

市场名称是市场的 marketplace.json 文件中的 name。 使用稳定的 kebab-case 名称，因为插件标识符使用它。

可以通过 team-mappings.json 为企业团队要求安装或阻止其他插件。 请参阅“覆盖企业团队的企业托管设置”。

将插件设为可选

企业管理的设置只能强制启用或禁用插件。 对于特定于项目的默认值，请使用存储库的 .github/copilot/settings.json 文件。 参与者可以在支持的情况下在本地覆盖这些默认设置，但须遵守受托管策略。 请参阅“GitHub Copilot CLI 配置目录”。

监控插件使用情况

使用情况指标 API 在企业和组织报表中提供有关 Copilot CLI 自定义活动的指标。 数组 totals_by_plugin 统计与插件关联的技能调用，而不是所有插件活动或安装它的用户数。

每个 totals_by_* 数组最多包含五个活动最多的条目。 客户定义的标识符可以归类到 custom 或 other 下。 这些事件计数不能准确衡量采用情况，不存在的条目并不意味着零使用。 不要一起添加插件和技能计数，因为插件交互已包含在技能总计中。

有关字段定义和访问要求，请参阅 Copilot CLI 自定义字段。