VS Code API

一个 Event，当身份验证提供程序的身份验证会话被添加、移除或更改时触发。

获取用户已登录指定提供程序的所有账户。与 getSession 配合使用，以获取特定账户的身份验证会话。

目前，只有两个身份验证提供程序是由内置扩展提供给编辑器的，它们实现了 GitHub 和 Microsoft 身份验证：它们的 providerId 分别是 'github' 和 'microsoft'。

注意：获取账户并不意味着您的扩展可以访问该账户或其身份验证会话。您可以通过调用 getSession 来验证对账户的访问权限。

获取一个匹配所需作用域或满足 WWW-Authenticate 请求的身份验证会话。如果未注册具有 providerId 的提供程序，或者用户不同意与扩展共享身份验证信息，则会拒绝。如果存在多个具有相同作用域的会话，将向用户显示一个快速选择框，以选择他们想要使用的账户。

内置的身份验证提供程序包括

• 'github' - 用于 GitHub.com
• 'microsoft' - 用于个人和组织 Microsoft 账户
• （不常用）'github-enterprise' - 用于其他 GitHub 托管，GHE.com，GitHub Enterprise Server
• （不常用）'microsoft-sovereign-cloud' - 用于其他 Microsoft 云

获取一个匹配所需作用域或请求的身份验证会话。如果未注册具有 providerId 的提供程序，或者用户不同意与扩展共享身份验证信息，则会拒绝。如果存在多个具有相同作用域的会话，将向用户显示一个快速选择框，以选择他们想要使用的账户。

内置的身份验证提供程序包括

• 'github' - 用于 GitHub.com
• 'microsoft' - 用于个人和组织 Microsoft 账户
• （不常用）'github-enterprise' - 用于其他 GitHub 托管，GHE.com，GitHub Enterprise Server
• （不常用）'microsoft-sovereign-cloud' - 用于其他 Microsoft 云

获取一个匹配所需作用域或请求的身份验证会话。如果未注册具有 providerId 的提供程序，或者用户不同意与扩展共享身份验证信息，则会拒绝。如果存在多个具有相同作用域的会话，将向用户显示一个快速选择框，以选择他们想要使用的账户。

内置的身份验证提供程序包括

• 'github' - 用于 GitHub.com
• 'microsoft' - 用于个人和组织 Microsoft 账户
• （不常用）'github-enterprise' - 用于其他 GitHub 托管，GHE.com，GitHub Enterprise Server
• （不常用）'microsoft-sovereign-cloud' - 用于其他 Microsoft 云

注册一个身份验证提供程序。

每个 id 只能有一个提供程序，当一个 id 已被另一个提供程序使用时会抛出错误。Id 是区分大小写的。

创建一个新的 聊天参与者 实例。

执行由给定命令标识符表示的命令。

• 注意 1：执行编辑器命令时，并非所有类型都可以作为参数传递。允许的类型是基本类型 string、boolean、number、undefined 和 null，以及 Position、Range、Uri 和 Location。
• 注意 2：执行由扩展贡献的命令时没有限制。

检索所有可用命令的列表。以下划线开头的命令被视为内部命令。

注册一个可以通过键盘快捷键、菜单项、操作或直接调用的命令。

使用现有命令标识符注册命令两次将导致错误。

注册一个可以通过键盘快捷键、菜单项、操作或直接调用的文本编辑器命令。

文本编辑器命令与普通 命令 不同，因为它们只有在调用命令时有活动编辑器时才会执行。此外，编辑器命令的命令处理程序可以访问活动编辑器和一个 edit-builder。请注意，edit-builder 仅在回调执行期间有效。

创建一个新的 注释控制器 实例。

当前活动的 调试控制台。如果没有活动的调试会话，发送到调试控制台的输出将不会显示。

当前活动的 调试会话 或 undefined。活动调试会话是由调试操作浮动窗口表示的会话，或者是当前在调试操作浮动窗口的下拉菜单中显示的会话。如果没有活动的调试会话，值为 undefined。

当前聚焦的线程或堆栈帧，如果没有线程或堆栈被聚焦，则为 undefined。只要有活动的调试会话，线程就可以被聚焦，而堆栈帧只有在会话暂停并且已检索到调用堆栈时才能被聚焦。

断点列表。

当 活动调试会话 更改时触发的 事件。注意，当活动调试会话更改为 undefined 时，事件也会触发。

当 debug.activeStackItem 更改时触发的事件。

当断点集被添加、移除或更改时发出的 事件。

当从 调试会话 接收到自定义 DAP 事件时触发的 事件。

当新的 调试会话 已启动时触发的 事件。

当 调试会话 已终止时触发的 事件。

添加断点。

将通过调试适配器协议接收到的“源”描述符对象转换为可用于加载其内容的 Uri。如果源描述符基于路径，则返回文件 Uri。如果源描述符使用引用号，则会构造一个特定的调试 Uri（协议为“debug”），该 Uri 需要相应的 ContentProvider 和正在运行的调试会话

如果“源”描述符的信息不足以创建 Uri，则会抛出错误。

为特定的调试类型注册一个 调试适配器描述符工厂。扩展只允许为其定义的调试类型注册 DebugAdapterDescriptorFactory。否则会抛出错误。为一个调试类型注册多个 DebugAdapterDescriptorFactory 会导致错误。

为给定的调试类型注册一个调试适配器跟踪器工厂。

为特定的调试类型注册一个 调试配置提供程序。可选的 triggerKind 可用于指定提供程序的 provideDebugConfigurations 方法何时触发。目前有两种可能的触发类型：值为 Initial（或如果未给出 trigger kind 参数）时，provideDebugConfigurations 方法用于提供要复制到新创建的 launch.json 中的初始调试配置。触发类型为 Dynamic 时，provideDebugConfigurations 方法用于动态确定要呈现给用户的调试配置（除了 launch.json 中的静态配置）。请注意，triggerKind 参数仅适用于 provideDebugConfigurations 方法：因此 resolveDebugConfiguration 方法完全不受影响。使用 resolve 方法为不同的触发类型注册单个提供程序，将导致相同的 resolve 方法被多次调用。可以为同一类型注册多个提供程序。

移除断点。

通过使用命名的启动配置或命名的复合配置，或直接传递 DebugConfiguration 来开始调试。命名的配置在给定文件夹中的 '.vscode/launch.json' 中查找。在调试开始之前，所有未保存的文件都会被保存，并且启动配置会被更新。配置中使用的特定于文件夹的变量（例如 '${workspaceFolder}'）将根据给定的文件夹进行解析。

停止给定的调试会话，如果省略 session，则停止所有调试会话。

应用程序的托管位置。在桌面上是 'desktop'。在 Web 上是指定的嵌入器，例如 'github.dev'、'codespaces'，或者如果嵌入器不提供该信息，则为 'web'

编辑器的应用程序名称，如 'VS Code'。

编辑器运行的应用程序根文件夹。

注意，在没有应用程序根文件夹表示的环境中运行时，该值为空字符串。

系统剪贴板。

指示这是应用程序的全新安装。在安装的第一天内为 true，否则为 false。

指示用户是否已启用遥测。可以观察此值以确定扩展是否应发送遥测数据。

表示首选的用户语言，如 de-CH、fr 或 en-US。

编辑器的当前日志级别。

计算机的唯一标识符。

远程的名称。由扩展定义，常见的例子是用于 Windows Subsystem for Linux 的 wsl 或用于使用安全 shell 的远程的 ssh-remote。

注意，当没有远程扩展主机时，该值为 undefined，但在存在远程扩展主机的情况下，在所有扩展主机（本地和远程）中都会定义该值。使用 Extension.extensionKind 来了解特定扩展是否在远程运行。

当前会话的唯一标识符。每次编辑器启动时都会更改。

为扩展主机检测到的默认 shell，这会被扩展主机平台的 terminal.integrated.defaultProfile 设置覆盖。注意，在不支持 shell 的环境中，该值为空字符串。

UI 类型属性指示扩展是从哪个 UI 访问的。例如，扩展可以从桌面应用程序或 Web 浏览器访问。

编辑器在操作系统中注册的自定义 uri 协议。

当编辑器的日志级别更改时触发的 事件。

当默认 shell 更改时触发的 事件。此事件将附带新的 shell 路径。

当用户启用或禁用遥测时触发的 事件。如果用户已启用遥测，则为 true；如果用户已禁用遥测，则为 false。

将 uri 解析为可从外部访问的形式。

http: 或 https: 协议

将扩展运行位置的外部 uri（例如 http: 或 https: 链接）解析为客户端计算机上相同资源的 uri。

如果扩展在客户端计算机上运行，则此操作为空操作。

如果扩展在远程运行，此函数会自动建立从本地计算机到远程 target 的端口转发隧道，并返回隧道的本地 uri。端口转发隧道的生命周期由编辑器管理，用户可以关闭隧道。

注意，通过 openExternal 传递的 uri 会自动解析，您不应对它们调用 asExternalUri。

vscode.env.uriScheme

创建一个 uri，如果在浏览器中打开（例如通过 openExternal），将导致注册的 UriHandler 触发。

扩展不应对结果 uri 做任何假设，也不应以任何方式更改它。相反，扩展可以在身份验证流程中使用此 uri，例如通过将 uri 作为回调查询参数添加到要进行身份验证的服务器。

注意，如果服务器决定向 uri 添加额外的查询参数（例如令牌或密钥），它将出现在传递给 UriHandler 的 uri 中。

身份验证流程示例

vscode.window.registerUriHandler({
  handleUri(uri: vscode.Uri): vscode.ProviderResult<void> {
    if (uri.path === '/did-authenticate') {
      console.log(uri.toString());
    }
  }
});

const callableUri = await vscode.env.asExternalUri(
  vscode.Uri.parse(vscode.env.uriScheme + '://my.extension/did-authenticate')
);
await vscode.env.openExternal(callableUri);

注意，扩展不应缓存 asExternalUri 的结果，因为解析的 uri 可能会因系统或用户操作而失效——例如，在远程情况下，用户可能会关闭由 asExternalUri 打开的端口转发隧道。

任何其他协议

任何其他协议将被视为提供的是工作区 URI。在这种情况下，该方法将返回一个 URI，处理该 URI 时将使编辑器打开工作区。

创建一个新的 遥测记录器。

使用默认应用程序在外部打开链接。根据使用的协议，这可以是

• 浏览器 (http:, https:)
• 邮件客户端 (mailto:)
• VSCode 本身 (来自 vscode.env.uriScheme 的 vscode:)

注意，showTextDocument 是在编辑器内打开文本文档的正确方法，而不是此函数。

系统当前已知的所有扩展。

当 extensions.all 更改时触发的事件。这可能在安装、卸载、启用或禁用扩展时发生。

通过其完整标识符（格式为：publisher.name）获取扩展。

为扩展加载的本地化字符串包。如果未加载任何包，则为 undefined。通常在未找到包或使用默认语言运行时不会加载包。

为扩展加载的本地化包的 URI。如果未加载任何包，则为 undefined。通常在未找到包或使用默认语言运行时不会加载包。

标记一个字符串用于本地化。如果 env.language 指定的语言有可用的本地化包，并且该包对此消息有本地化值，则将返回该本地化值（并为任何模板化值注入 args 值）。

示例

l10n.t('Hello {0}!', 'World');

标记一个字符串用于本地化。如果 env.language 指定的语言有可用的本地化包，并且该包对此消息有本地化值，则将返回该本地化值（并为任何模板化值注入 args 值）。

示例

l10n.t('Hello {name}', { name: 'Erich' });

标记一个字符串用于本地化。如果 env.language 指定的语言有可用的本地化包，并且该包对此消息有本地化值，则将返回该本地化值（并为任何模板化值注入 args 值）。

当全局诊断集更改时触发的 事件。这是新增和移除的诊断。

创建一个诊断集合。

创建一个新的 语言状态项。

获取给定资源的所有诊断。

获取所有诊断。

返回所有已知语言的标识符。

计算文档选择器和文档之间的匹配度。大于零的值表示选择器匹配文档。

匹配是根据以下规则计算的

1. 当 DocumentSelector 是一个数组时，计算其中每个 DocumentFilter 或语言标识符的匹配度，并取最大值。
2. 一个字符串将被脱糖成为 DocumentFilter 的 language 部分，所以 "fooLang" 就像 { language: "fooLang" }。
3. 一个 DocumentFilter 将通过比较其各部分与文档来与文档进行匹配。适用以下规则
   1. 当 DocumentFilter 为空 ({}) 时，结果为 0
   2. 当定义了 scheme、language、pattern 或 notebook 但其中之一不匹配时，结果为 0
   3. 与 * 匹配得分为 5，通过相等或 glob 模式匹配得分为 10
   4. 结果是每个匹配的最大值

示例

// default document from disk (file-scheme)
doc.uri; //'file:///my/file.js'
doc.languageId; // 'javascript'
match('javascript', doc); // 10;
match({ language: 'javascript' }, doc); // 10;
match({ language: 'javascript', scheme: 'file' }, doc); // 10;
match('*', doc); // 5
match('fooLang', doc); // 0
match(['fooLang', '*'], doc); // 5

// virtual document, e.g. from git-index
doc.uri; // 'git:/my/file.js'
doc.languageId; // 'javascript'
match('javascript', doc); // 10;
match({ language: 'javascript', scheme: 'git' }, doc); // 10;
match('*', doc); // 5

// notebook cell document
doc.uri; // `vscode-notebook-cell:///my/notebook.ipynb#gl65s2pmha`;
doc.languageId; // 'python'
match({ notebookType: 'jupyter-notebook' }, doc); // 10
match({ notebookType: 'fooNotebook', language: 'python' }, doc); // 0
match({ language: 'python' }, doc); // 10
match({ notebookType: '*' }, doc); // 5

注册一个调用层级提供程序。

注册一个代码操作提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个 code lens 提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个颜色提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个补全提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序按其 分数 排序，并且分数相同的组会按顺序被请求补全项。当一个或多个提供程序组返回结果时，该过程停止。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

一个补全项提供程序可以与一组 triggerCharacters 相关联。当键入触发字符时，会请求补全，但仅从注册了该键入字符的提供程序请求。因此，触发字符应与 单词字符 不同，一个常见的触发字符是 . 以触成员发补全。

注册一个声明提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个定义提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个新的 DocumentDropEditProvider。

可以为一种语言注册多个拖放提供程序。将内容拖放到编辑器中时，所有注册的编辑器语言的提供程序将根据其 DocumentDropEditProviderMetadata 中指定的 mimetype 被调用。

每个提供程序可以返回一个或多个 DocumentDropEdits。这些编辑使用 DocumentDropEdit.yieldTo 属性进行排序。默认情况下，将应用第一个编辑。如果还有其他编辑，这些将作为可选的拖放选项显示在拖放小部件中。

为文档注册一个格式化提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将根据其分数进行排序，并使用匹配度最高的提供程序。所选提供程序的失败将导致整个操作失败。

注册一个文档高亮提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将根据其分数进行排序，并按顺序向各个组请求文档高亮。当一个提供程序返回一个非假值或非失败结果时，该过程将停止。

注册一个文档链接提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个新的DocumentPasteEditProvider。

可以为一种语言注册多个提供程序。该语言的所有已注册提供程序将根据其在DocumentPasteProviderMetadata中指定的已处理的mimetype被调用以进行复制和粘贴操作。

对于复制操作，每个提供程序对DataTransfer所做的更改将被合并到一个DataTransfer中，用于填充剪贴板。

对于[粘贴操作](#_DocumentPasteEditProvider.providerDocumentPasteEdits paste operations)，每个提供程序都将被调用，并可以返回一个或多个DocumentPasteEdits。这些编辑将使用DocumentPasteEdit.yieldTo属性进行排序。默认情况下，将应用第一个编辑，其余的编辑将作为可选的粘贴选项显示在粘贴小部件中供用户选择。

为文档范围注册一个格式化提供程序。

注意：文档范围提供程序也是一个文档格式化程序，这意味着在注册范围提供程序时，无需再注册文档格式化程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将根据其分数进行排序，并使用匹配度最高的提供程序。所选提供程序的失败将导致整个操作失败。

为文档范围注册一个语义标记提供程序。

注意：如果一个文档同时具有DocumentSemanticTokensProvider和DocumentRangeSemanticTokensProvider，则范围提供程序将仅在初始时被调用，即在完整文档提供程序解析第一个请求所需的时间内。一旦完整文档提供程序解析了第一个请求，通过范围提供程序提供的语义标记将被丢弃，从那时起，将只使用文档提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将根据其分数进行排序，并使用匹配度最高的提供程序。所选提供程序的失败将导致整个操作失败。

为整个文档注册一个语义标记提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将根据其分数进行排序，并使用匹配度最高的提供程序。所选提供程序的失败将导致整个操作失败。

注册一个文档符号提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个在文本文档中定位可评估表达式的提供程序。编辑器将在活动的调试会话中评估该表达式，并在调试悬停中显示结果。

如果为一种语言注册了多个提供程序，将使用任意一个提供程序。

注册一个折叠范围提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行请求，并且结果将被合并。如果多个折叠范围从相同的位置开始，则只使用第一个注册的提供程序的范围。如果一个折叠范围与另一个位置更小的范围重叠，它也将被忽略。

失败的提供程序（被拒绝的promise或异常）不会导致整个操作失败。

注册一个悬停提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个实现提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个嵌入提示提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个行内补全提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个为调试器的“行内值”功能返回数据的提供程序。每当通用调试器在源文件中停止时，将调用为该文件语言注册的提供程序，以返回将在编辑器中行尾显示的文本数据。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个链接编辑范围提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将根据其分数进行排序，并使用有结果的最佳匹配提供程序。所选提供程序的失败将导致整个操作失败。

注册一个在键入时工作的格式化提供程序。当用户启用 `editor.formatOnType` 设置时，该提供程序将处于活动状态。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将根据其分数进行排序，并使用匹配度最高的提供程序。所选提供程序的失败将导致整个操作失败。

注册一个引用提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个重命名提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将根据其分数进行排序并按顺序询问。第一个产生结果的提供程序将定义整个操作的结果。

注册一个选择范围提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个签名帮助提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将根据其分数进行排序并按顺序调用，直到一个提供程序返回有效结果为止。

另请参阅 languages.registerSignatureHelpProvider

注册一个类型定义提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序将被并行询问，结果将被合并。失败的提供程序（被拒绝的 promise 或异常）不会导致整个操作失败。

注册一个类型层次结构提供程序。

注册一个工作区符号提供程序。

可以注册多个提供程序。在这种情况下，提供程序将被并行请求，并且结果将被合并。失败的提供程序（被拒绝的promise或异常）不会导致整个操作失败。

为一种语言设置语言配置。

设置（并更改）与给定文档关联的语言。

注意，调用此函数将触发onDidCloseTextDocument事件，然后是onDidOpenTextDocument事件。

所有扩展使用lm.registerTool注册的所有可用工具的列表。可以使用与其声明的inputSchema匹配的输入通过lm.invokeTool调用它们。

当可用聊天模型集发生变化时触发的事件。

使用给定的输入按名称调用lm.tools中列出的工具。输入将根据工具声明的模式进行验证。

工具可以由聊天参与者在处理聊天请求的上下文中调用，也可以由任何扩展在任何自定义流程中全局调用。

在前一种情况下，调用者应传递toolInvocationToken，该令牌来自聊天请求。这确保聊天UI显示正确对话的工具调用。

工具结果是文本和prompt-tsx部分的数组。如果工具调用者使用vscode/prompt-tsx，它可以使用ToolResult将响应部分合并到其提示中。如果不是，这些部分可以通过带有LanguageModelToolResultPart的用户消息传递给LanguageModelChat。

如果聊天参与者希望在多轮请求中保留工具结果，它可以将工具结果存储在处理程序返回的ChatResult.metadata中，并在下一轮从ChatResponseTurn.result中检索它们。

注册一个LanguageModelChatProvider。注意：您还必须通过package.json中的languageModelChatProviders贡献点定义语言模型聊天提供程序。

注册一个为编辑器提供模型上下文协议（MCP）服务器的提供程序。这允许动态地向编辑器提供MCP服务器，此外还有用户在配置文件中创建的服务器。

在调用此方法之前，扩展必须使用相应的id注册contributes.mcpServerDefinitionProviders扩展点，例如

    "contributes": {
        "mcpServerDefinitionProviders": [
            {
                "id": "cool-cloud-registry.mcp-servers",
                "label": "Cool Cloud Registry",
            }
        ]
    }

当有新的McpServerDefinitionProvider可用时，编辑器默认会在提交聊天消息时自动调用它来发现新的服务器和工具。要启用此流程，扩展应在激活期间调用registerMcpServerDefinitionProvider。

注册一个LanguageModelTool。该工具也必须在package.json的languageModelTools贡献点中注册。注册的工具在lm.tools列表中对任何扩展都可见。但为了让语言模型看到它，它必须在LanguageModelChatRequestOptions.tools的可用工具列表中传递。

通过选择器选择聊天模型。这可能会产生多个或没有聊天模型，扩展必须优雅地处理这些情况，尤其是在没有聊天模型存在时。

const models = await vscode.lm.selectChatModels({ family: 'gpt-3.5-turbo' });
if (models.length > 0) {
    const [first] = models;
    const response = await first.sendRequest(...)
    // ...
} else {
    // NO chat models available
}

选择器可以编写为广泛匹配给定供应商或系列的所有模型，也可以狭窄地通过ID选择一个模型。请记住，可用的模型集会随时间变化，但提示在不同模型中的表现也可能不同。

注意，扩展可以保留此函数返回的结果并在以后使用它们。但是，当onDidChangeChatModels事件触发时，聊天模型列表可能已更改，扩展应重新查询。

创建一个新的笔记本控制器。

创建一个新的消息传递实例，用于与特定的渲染器通信。

• 注意 1：扩展只能创建它们在package.json文件中定义的渲染器。
• 注意 2：只有在其notebookRenderer贡献中将requiresMessaging设置为always或optional时，渲染器才能访问消息传递。

为给定的笔记本类型注册一个单元格状态栏项提供程序。

扩展创建的最后一个源代码控制的输入框。

• 已弃用 - 请改用 SourceControl.inputBox

创建一个新的源代码控制实例。

当前活动的任务执行，或一个空数组。

当任务结束时触发。

当底层进程结束时触发。对于不执行底层进程的任务，此事件不会触发。

当任务开始时触发。

当底层进程已启动时触发。对于不执行底层进程的任务，此事件不会触发。

执行由编辑器管理的任务。返回的任务执行可用于终止该任务。

• 抛出异常 - 当在无法启动新进程的环境中运行ShellExecution或ProcessExecution任务时。在这种环境中，只能运行CustomExecution任务。

获取系统中所有可用的任务。这包括来自tasks.json文件的任务以及通过扩展贡献的任务提供程序的任务。

注册一个任务提供程序。

创建一个新的测试控制器。

当前在设置中配置的活动颜色主题。可以通过workbench.colorTheme设置更改活动主题。

当前活动的笔记本编辑器或undefined。活动编辑器是当前具有焦点的编辑器，或者当没有编辑器具有焦点时，是最近更改过输入的编辑器。

当前活动的终端或undefined。活动终端是当前具有焦点或最近具有焦点的终端。

当前活动的编辑器或undefined。活动编辑器是当前具有焦点的编辑器，或者当没有编辑器具有焦点时，是最近更改过输入的编辑器。

表示当前窗口的状态。

表示主编辑器区域内的网格小部件

当前打开的终端，或一个空数组。

当前可见的笔记本编辑器，或一个空数组。

当前可见的编辑器，或一个空数组。

一个事件，当活动颜色主题被更改或有更改时触发。

一个事件，当活动笔记本编辑器更改时触发。注意，当活动编辑器更改为undefined时，该事件也会触发。

一个事件，当活动终端更改时触发。注意，当活动终端更改为undefined时，该事件也会触发。

一个事件，当活动编辑器更改时触发。注意，当活动编辑器更改为undefined时，该事件也会触发。

一个事件，当笔记本编辑器选择更改时触发。

一个事件，当笔记本编辑器可见范围更改时触发。

当终端中shell集成激活或其某个属性更改时触发。

一个事件，当终端的状态更改时触发。

一个事件，当编辑器的选项更改时触发。

一个事件，当编辑器中的选择更改时触发。

一个事件，当编辑器的视图列更改时触发。

一个事件，当编辑器的可见范围更改时触发。

一个事件，当可见笔记本编辑器更改时触发。

一个事件，当可见编辑器数组更改时触发。

一个事件，当当前窗口的焦点或活动状态更改时触发。事件的值表示窗口是否具有焦点。

一个事件，当终端被释放时触发。

当终端命令结束时将触发此事件。此事件仅在终端的shell集成被激活时才会触发。

一个事件，当终端被创建时触发，无论是通过createTerminal API还是命令。

当终端命令开始时将触发此事件。此事件仅在终端的shell集成被激活时才会触发。

创建一个输入框，让用户输入一些文本。

请注意，在许多情况下，更方便的window.showInputBox更容易使用。当window.showInputBox不提供所需灵活性时，应使用window.createInputBox。

使用给定的名称和语言ID创建一个新的输出通道。如果未提供语言ID，则使用Log作为默认语言ID。

您可以从可见编辑器或活动编辑器中将可见或活动的输出通道作为文本文档访问，并使用语言ID来贡献语言功能，如语法着色、代码镜头等。

使用给定的名称创建一个新的日志输出通道。

创建一个快速选择，让用户从T类型的项目列表中选择一个项目。

请注意，在许多情况下，更方便的window.showQuickPick更容易使用。当window.showQuickPick不提供所需灵活性时，应使用window.createQuickPick。

创建一个状态栏项目。

创建一个状态栏项目。

另请参阅 createStatusBarItem，用于创建带标识符的状态栏项目。

创建一个带有后台shell进程的终端。如果存在工作区目录，终端的当前工作目录将是该目录。

• 抛出异常 - 当在无法启动新进程的环境中运行时。

创建一个带有后台shell进程的终端。

• 抛出异常 - 当在无法启动新进程的环境中运行时。

创建一个由扩展控制其输入和输出的终端。

创建一个TextEditorDecorationType，可用于向文本编辑器添加装饰。

为使用扩展点views贡献的视图创建一个TreeView。

创建并显示一个新的Webview面板。

为由customEditors扩展点贡献的viewType注册一个自定义编辑器提供程序。

当自定义编辑器打开时，会触发一个onCustomEditor:viewType激活事件。您的扩展必须在激活时为viewType注册一个CustomTextEditorProvider、CustomReadonlyEditorProvider或CustomEditorProvider。

注册文件装饰提供程序。

注册提供程序，以支持在终端中检测和处理链接。

为贡献的终端配置文件注册一个提供程序。

为使用扩展点 views 贡献的视图注册一个 TreeDataProvider。这将允许您为 TreeView 贡献数据，并在数据更改时进行更新。

注意：要访问 TreeView 并对其执行操作，请使用 createTreeView。

注册一个能够处理全系统 uri 的 uri 处理程序。如果打开了多个窗口，最顶层的窗口将处理该 uri。uri 处理程序的作用域限定于其贡献的扩展；它将只能处理指向该扩展本身的 uri。uri 必须遵守以下规则：

• uri-scheme 必须是 vscode.env.uriScheme；
• uri-authority 必须是扩展 ID（例如 my.extension）；
• uri-path、-query 和 -fragment 部分是任意的。

例如，如果 my.extension 扩展注册了一个 uri 处理程序，它将只被允许处理前缀为 product-name://my.extension 的 uri。

一个扩展在其整个激活生命周期中只能注册一个 uri 处理程序。

• 注意：当一个指向当前扩展的 uri 即将被处理时，会触发一个激活事件 onUri。

注册一个 webview 面板序列化器。

支持恢复的扩展应该有一个 "onWebviewPanel:viewType" 激活事件，并确保在激活期间调用 registerWebviewPanelSerializer。

对于给定的 viewType，一次只能注册一个序列化器。

为 webview 视图注册一个新的提供程序。

在状态栏设置一条消息。这是更强大的状态栏 项 的简写形式。

在状态栏设置一条消息。这是更强大的状态栏 项 的简写形式。

在状态栏设置一条消息。这是更强大的状态栏 项 的简写形式。

注意，状态栏消息会堆叠，并且在不再使用时必须被释放。

显示一条错误消息。

另请参阅 showInformationMessage

显示一条错误消息。

另请参阅 showInformationMessage

显示一条错误消息。

另请参阅 showInformationMessage

显示一条错误消息。

另请参阅 showInformationMessage

向用户显示一条信息消息。可选择提供一个项目数组，这些项目将显示为可点击的按钮。

向用户显示一条信息消息。可选择提供一个项目数组，这些项目将显示为可点击的按钮。

显示一条信息消息。

另请参阅 showInformationMessage

显示一条信息消息。

另请参阅 showInformationMessage

打开一个输入框以向用户请求输入。

如果输入框被取消（例如按下 ESC），返回值为 undefined。否则，返回值将是用户输入的字符串，或者如果用户没有输入任何内容但通过“确定”关闭了输入框，则返回一个空字符串。

在 笔记本编辑器 中显示给定的 NotebookDocument。

向用户显示一个文件打开对话框，允许用户选择一个文件用于打开。

显示一个允许进行多选的选择列表。

显示一个选择列表。

显示一个允许进行多选的选择列表。

显示一个选择列表。