SuperAPI AI 工具集

vscode-ext-commands

编程与开发

查看项目

更新于 10-16 06:00

技能介绍

用途

本技能用于指导开发者在 VS Code 扩展中贡献(contribute)命令,帮助你在为扩展添加或更新命令时遵循统一的命名、可见性、本地化、键位绑定与注册规范。当需要为 VS Code 扩展新增或修改命令时,可使用本技能。

主要能力

技能给出的核心规则如下:

  • VS Code 命令必须始终定义标题(title),与其分类(category)、可见性或位置无关。
  • 针对每一“类”命令,技能采用若干命名与配置模式,并描述其特征。

常规命令(Regular commands)

  • 默认情况下,所有命令都应可在命令面板(Command Palette)中访问。
  • 必须定义分类(category)。
  • 不需要图标,除非该命令将在侧边栏(Side Bar)中使用。

侧边栏命令(Side Bar commands)

  • 名称遵循特殊模式:以下划线(_)开头,并以 #sideBar 结尾,例如 _extensionId.someCommand#sideBar。
  • 必须定义图标。
  • 可能定义、也可能不定义启用(enablement)规则。
  • 侧边栏专用命令不应在命令面板中可见。
  • 将其贡献到 view/title 或 view/item/context 时,必须说明其显示的顺序/位置;可使用“相对于其他命令/按钮”的表述来帮助识别应使用的正确分组。
  • 为新命令定义可见性条件(when)是一种良好实践。

使用方式

在为 VS Code 扩展添加或更新命令时,依据上述规则选择对应的命令类型(常规命令或侧边栏命令),遵循其命名、图标、分类、可见性与启用条件的约定进行配置。

适用场景

适用于 VS Code 扩展开发过程中需要贡献命令的场景,包括命令面板中的常规命令,以及侧边栏、视图标题、视图项上下文中的命令。

限制

技能资料未提供关于具体 API 代码示例、本地化实现细节、键位绑定具体写法以及命令注册的完整步骤说明,这些内容暂未提供。