arch-vscode

arch-vscode 是一个 VSCode 扩展 起步模板（基于 antfu/starter-vscode），使用 reactive-vscode 提供响应式 API 和组合式函数，使用 tsdown 打包为单一 CJS bundle，并使用 vscode-ext-gen 生成类型安全的 contributes 元数据。它提供了一套极简且有明确约定的配置：defineExtension 入口、defineConfig/defineLogger、Extension Host 调试，以及用于打包和发布的 vsce/vsxpub。

该技能基于 starter-vscode（arch-vscode 源），生成于 2026-01-30。

推荐实践：

• 通过 pnpm update（或 Run on Save）保持 contributes 与生成的 meta 同步
• 使用 reactive-vscode 组合式函数管理状态和 disposables；使用将 vscode 设为 external 的 CJS 构建
• 尽可能优先使用 onCommand 激活

核心参考

主题	描述	参考
概览	项目用途、结构、何时使用	core-overview
扩展入口	defineExtension、activate、deactivate	core-extension-entry
配置	defineConfig、生成的作用域配置	core-config
日志	defineLogger、displayName	core-logging
tsdown 构建	CJS、external vscode、build:prepare 钩子	core-tsdown-build
脚本	build、dev、update、release、ext:package、ext:publish	core-scripts
Contributes	commands、configuration、activationEvents	core-contributes
开发	launch.json、tasks.json、Extension Host	core-development
CI	GitHub Actions 工作流 — lint、typecheck、build、test	core-ci

最佳实践

主题	描述	参考
VSCode 扩展	入口、contributes、meta、激活、发布	best-practices-vscode-ext