用途:本 Skill 用于把 VSCode 扩展发布到官方 Marketplace,能力包含 vsce 工具使用、发布流程、平台特定扩展、预发布版本管理。触发条件是用户需要发布或分发 VSCode 扩展。
前置准备:需要 Node.js 18+ 与 npm;需要 Azure DevOps 账号和 Marketplace 发布者账号。安装工具:npm install -g @vscode/vsce
主要流程:一是准备 package.json 元数据(name、displayName、publisher、version、engines、description)。二是在 Azure DevOps 用户设置中创建 Personal Access Token,Organization 选 “All accessible organizations”,scopes 选 Marketplace > Manage。三是在 https://marketplace.visualstudio.com/manage 登录 Microsoft 账号创建 Publisher,并用 vsce login <publisher-id> 验证。四是打包:vsce package,或 vsce package --pre-release。五是发布:vsce publish;也可用 vsce publish minor 做次版本递增,或 vsce publish 2.0.0 指定版本。
可选分支:预发布版本用 vsce package --pre-release 与 vsce publish --pre-release。平台特定扩展用 vsce package --target win32-x64、linux-x64、darwin-arm64 等,发布多平台用 vsce publish --target win32-x64 win32-arm64 linux-x64。自动化发布可在 package.json 添加 "vscode:prepublish": "npm run compile" 脚本。
参考资源:references/vsce-cli.md 提供 vsce 子命令与选项;references/publisher-setup.md 说明 Publisher 创建、PAT 配置与账号验证;references/platform-extensions.md 说明平台支持、VSIX 构建与多平台发布。
限制与注意事项:扩展名称全局唯一;SVG 图片需转为 PNG/JPG,禁止使用不受信任的 SVG badge。版本遵循 SemVer,预发布用奇数 patch(如 1.0.1、1.0.3),正式发布用偶数 patch(如 1.0.0、1.0.2)。Marketplace 展示需 README.md、CHANGELOG.md,并设置 128x128 PNG 图标。