logo
0
0
WeChat Login
📝 docs(readme): 项目结构章节同步实际目录,反映 Phase 1/2 增删

CNB Welcome

Open VSX Made with reactive-vscode shadcn-vue Vite Vitest Open VSX Downloads License: Apache-2.0

CNB 云原生开发环境的 VS Code 欢迎页扩展,提供环境信息展示、倒计时、文件漫游、仓库模版等功能。

官方版本: https://cnb.cool/cnb/cool/cnb-welcome

功能

  • Welcome 页面 — 首次进入自动打开,展示环境配置、仓库信息、一键迁移和模版列表
  • Sidebar 面板 — 环境资源、运行倒计时、关闭环境、文件漫游、文档链接
  • 状态栏 — 显示当前仓库 slug,点击跳转仓库页面
  • 终端 — 首次激活自动打开终端并执行欢迎命令

Commands

CommandTitle
cnb.welcomeCNB Welcome
cnb.openTerminalCNB: Open Terminal
cnb.resetFirstRunCNB: Reset First Run
cnb.shutdownEnvironmentCNB: Shutdown Environment
cnb.openRepoPageCNB: Open Repo Page
cnb.openVscodeCNB: Open VS Code Client

技术栈

技术
Extension HostTypeScript + reactive-vscode
Webview UIVue 3 + Vite 8 + Tailwind CSS v4 + shadcn-vue + Reka UI
构建tsdown (ext host) + Vite (webview)
测试Vitest

项目结构

├── src/                  # Extension Host 源码
│   ├── commands/         # 命令注册
│   ├── shared/           # 与 webview 共享的类型与纯逻辑(messages / countdown / resourceFormat)
│   ├── statusbar/        # 状态栏:仓库标识与环境倒计时
│   ├── utils/            # 工具函数(env / api / webview / roaming / gitSafety / shutdownFlow 等)
│   └── views/            # Webview 面板(sidebar / welcome)
├── webview-ui/           # Webview 前端 (Vue 3 SPA)
│   └── src/
│       ├── assets/       # Tailwind v4 + shadcn 主题变量
│       ├── components/   # UI 组件(ui / welcome / sidebar)
│       ├── composables/  # 组合式函数(与 ext-host 消息桥接)
│       ├── dev/          # 浏览器开发态 mock 数据
│       ├── lib/          # 前端工具(cn / gitUrl / fileDisplay)
│       ├── types/        # 消息类型再导出(保留 @shared 别名屏蔽相对路径)
│       └── views/        # 顶层视图(WelcomeView / SidebarView)
├── test/                 # Extension Host 单元测试
└── docs/                 # 设计文档

开发

# 安装依赖
pnpm install

# 开发 webview UI (HMR)
pnpm --filter webview-ui dev

# 构建
pnpm build

# 运行测试
pnpm test

# 打包 VSIX
pnpm pack

License

Apache-2.0 License © 2026-PRESENT wwvo