用途
本技能用于指导开发者在 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 代码示例、本地化实现细节、键位绑定具体写法以及命令注册的完整步骤说明,这些内容暂未提供。