arch-vscode

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

arch-vscode is a VSCode extension starter (based on antfu/starter-vscode) that uses reactive-vscode for reactive APIs and composables, tsdown for a single CJS bundle, and vscode-ext-gen for type-safe contributes metadata. It provides a minimal, opinionated setup: defineExtension entry, defineConfig/defineLogger, Extension Host debugging, and vsce/vsxpub for packaging and publishing.

The skill is based on starter-vscode (arch-vscode source), generated at 2026-01-30.

Recommended practices:

Keep contributes and generated meta in sync via
```
pnpm update
```
(or Run on Save)
Use reactive-vscode composables for state and disposables; use CJS build with external
```
vscode
```
Prefer
```
onCommand
```
activation when possible

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

本技能基于starter-vscode（arch-vscode源码）生成，生成时间为2026年1月30日。

推荐实践：

通过
```
pnpm update
```
（或保存时自动运行）保持contributes与生成的元数据同步
使用reactive-vscode组合式函数管理状态和可释放资源；使用带有外部
```
vscode
```
依赖的CJS构建
尽可能优先使用
```
onCommand
```
激活方式

Core References

核心参考资料

Topic	Description	Reference
Overview	Project purpose, structure, when to use	core-overview
Extension Entry	defineExtension, activate, deactivate	core-extension-entry
Config	defineConfig, generated scoped config	core-config
Logging	defineLogger, displayName	core-logging
tsdown Build	CJS, external vscode, build:prepare hook	core-tsdown-build
Scripts	build, dev, update, release, ext:package, ext:publish	core-scripts
Contributes	commands, configuration, activationEvents	core-contributes
Development	launch.json, tasks.json, Extension Host	core-development
CI	GitHub Actions workflow — lint, typecheck, build, test	core-ci

主题	描述	参考链接
概述	项目用途、结构、适用场景	core-overview
扩展入口	defineExtension、激活、停用	core-extension-entry
配置	defineConfig、生成的作用域配置	core-config
日志	defineLogger、显示名称	core-logging
tsdown构建	CJS、外部vscode依赖、build:prepare钩子	core-tsdown-build
脚本	build、dev、update、release、ext:package、ext:publish	core-scripts
Contributes	命令、配置、激活事件	core-contributes
开发	launch.json、tasks.json、扩展宿主	core-development
CI	GitHub Actions工作流 — 代码检查、类型校验、构建、测试	core-ci

Best Practices

最佳实践

Topic	Description	Reference
VSCode Extension	entry, contributes, meta, activation, publish	best-practices-vscode-ext

主题	描述	参考链接
VSCode扩展	入口、contributes、元数据、激活、发布	best-practices-vscode-ext