用途:为 VS Code 扩展开发提供可复用的实现模式,覆盖界面、配置、安全与智能体集成等常见场景。
主要能力:Webview 仪表盘(并行取数、异步构建 HTML);WebviewViewProvider 侧边栏视图与消息处理;CSP 合规的事件委托(用 data-cmd 替代内联 onclick);分层安全配置(仅新增、先 inspect 检查、预览后应用、保留用户更高值);复杂设置生态的文档优先管理流程(研究、文档、实现、集成、验证五阶段);带置信度的自动检测与重复检测;可移植路径规则(workspaceFolders、os.homedir()、path.join());发布流程(从 .env 读取 VSCE_PAT 后执行 vsce publish);目标与连续打卡;用 SecretStorage 存储敏感令牌并迁移旧设置;Webview CSP 与 nonce;沙箱中通过 postMessage 调用 openExternal;遥测退出合规;配置变更监听;以及 VS Code 1.109+ 的智能体平台能力(AGENTS.md、技能加载、Chat Participant API、工具注册、扩展思考、MCP 集成)。
使用方式:按需参考对应模式,将代码片段适配到自己的扩展;配置类操作建议先备份 settings.json,再以脚本方式应用并记录变更。
适用场景:开发或维护 VS Code 扩展,尤其是涉及 Webview、复杂设置、密钥与 AI 智能体集成的项目。
限制:资料明确提示 VS Code API 随月度版本演进,模式可能过时;最后验证时间为 2026 年 2 月(VS Code 1.109+),需对照官方 API 与发行说明确认现状。部分功能(如 hooks)标注为实验性、尚不稳定。未提供具体安装命令、收费与平台信息。