不用装 Node,打开网页就能写组件:CompHub Studio 的浏览器运行时实践

7 阅读7分钟

把一个 Node.js 项目、一个 Vite dev server、一个 AI 助手,和一条「发布到组件库」的流水线,全塞进一个浏览器标签页。

写一个组件的启动成本,其实不低

前端日常里,「临时写一个组件」这件事的链路很长:

  • 装 Node、包管理器、脚手架,版本不对还要先修环境;
  • npm install,等依赖树解析完;
  • 起 dev server,打开浏览器调样式;
  • 写完之后截图、填名称标签描述、走上传流程,才能进组件库。

如果让 AI 帮忙写,切换成本更高:IDE 里对话、浏览器里看效果、组件库后台里传文件,三个地方来回跳。

CompHub Studio 想做的就是砍掉这一段:打开网页,就是一个能跑 Node 项目、能实时预览、能对话改代码、能直接发布的工作区。

地址是 studio.comphub.cn,不用安装任何东西。

先看效果:4 分钟从一句话到发布

演示视频(约 4 分钟):studio-demo-motion-v1.0.0.mp4

新建工作区 → 让 AI 改代码 → 确认预览 → 填写信息并发布。全程只用一个浏览器标签页。

工作区长什么样

界面是三列,加两处上下分栏:

  • 左列:文件树。分成「组件目录」和「环境目录」,前者就是最终会发布出去的组件本体;
  • 中列:源代码 / mini 预览 / full 预览三个页签,下面接着终端;
  • 右列:AI 对话。

两块预览的尺寸和组件库卡片一致:mini 用来核对组件在列表里的样子,full 用来看完整效果。改完代码保存,预览自动刷新;预览报错时可以直接把错误「喂给 AI」,让它接着改。

能做的事可以列成六条:

  1. 零环境启动:Node.js 运行时跑在浏览器里,没有 nvm、没有全局包、没有「先 npm install」;
  2. AI 对话式开发:描述想要的效果,助手直接改文件、装依赖、刷预览;
  3. 代码与预览同屏:文件树、编辑器、预览并排,Vue 3、React、Web Components 都能直接跑;
  4. 依赖开箱即用:在终端里装依赖,平台自动预编译,预览立刻可用;
  5. 工作区会记住:快照存在浏览器本地,刷新、关标签、第二天再来,都能从上次的位置继续;
  6. 一键发布:自动截图、补齐信息、预编译依赖,确认后发布到组件库并写入版本说明。

技术拆解:浏览器里怎么跑起一个 Node 项目

这部分是本文的重点。

运行时:almostnode

浏览器里没有 Node.js,所以我们用 almostnode 做运行时:它在浏览器中实现了一套虚拟文件系统(VFS)和 40 多个 Node API shim(fs、path、http、events 等),能安装真实的 npm 包、执行带 bin 的命令行工具,也内置了 Vite / Next.js 的开发服务器。

工作区里的文件全部放在 VFS 里,路径固定为 /。这一点很关键:虚拟 dev server 在解析静态资源时会再拼一次 root,如果项目放在 /app 下,所有资源都会 404。

Service Worker:虚拟 dev server 的「网卡」

预览 iframe 里写的是普通的 import "./App.vue",这些请求并不会发到真实网络,而是被 Service Worker 截住,转到页面里的虚拟 dev server:

iframe 里的 import "/src/App.vue"
        │
        ▼
Service Worker(拦截 /__virtual__/3100/ 前缀)
        │
        ▼
almostnode 虚拟 dev server ──► VFS(内存文件系统)
        │
        ▼
esbuild-wasm(在 Worker 中转译 / 预编译)

所以预览里跑的,是真实的模块解析、真实的依赖图,只是「服务器」和「磁盘」都在浏览器里。代价是预览必须依赖 Service Worker,需要 localhost 或 https 环境。

esbuild-wasm:转译和预编译全部离开主线程

TypeScript / JSX 的转译,以及安装依赖后的预编译,都交给 esbuild-wasm。它不是跑在主线程,而是在 Web Worker 里执行:依赖一多,预编译是重活,留在主线程会把编辑器和预览一起卡住。

预编译产物统一放在 VFS 的 /vendor/prebundle 下,装完包在 Worker 里编译,预览直接读产物。第三方 UI 库不需要额外配置,装完就能用。

三种框架的预览宿主

  • Vue 3:用 vue3-sfc-loader 在运行时编译 SFC,Vue 运行时本地化,不依赖外部 CDN;
  • React:运行时走 esm.sh;
  • Web Components:纯 JavaScript + module script,浏览器原生支持。

预览页的 HTML 里,脚本必须用相对路径引用(./host.js 而不是 /host.js),因为预览挂在 /__virtual__/3100/ 下,绝对路径会解析回站点真实根目录,直接 404。这类细节不写对,表现就是一块白屏。

AI:工具调用是工作台的一等公民

右侧对话基于 assistant-ui 和 AI SDK,但重点不是「有个聊天框」,而是对话能真的动手。

助手能调用的是一组工具:写文件、删文件、装依赖、提问等等。每一次工具调用都会渲染成一张可展开的卡片——改了什么文件、改了几行,点开就能看。删除会弹确认卡,提问会渲染成可点选的选项,而不是让用户回一段自然语言。

模型接入有两种方式:

  • 平台内置(免费):登录用户免限额,匿名按设备 + IP 限额。请求统一走服务端代理,API Key 不会下发到浏览器;
  • 自填 Key:支持 DeepSeek、Kimi、通义千问(百炼)、SiliconFlow、OpenRouter、MiniMax 等兼容 OpenAI 协议的服务商。Key 只存在本机 localStorage,请求由浏览器直连服务商;模型清单从服务商的 /models 接口拉取,不做静态兜底。

发布:截图、表单、上传

发布前会先校验预览入口:mini 和 full 两个预览页签都要能正常渲染。确认后自动截图,填名称、版本号、标签、描述和更新说明,选择发布到个人组件库或团队空间,提交即可在主站看到。

组件目录里的 demo/、README、comp.json 会按平台规范一起带上去——这也是为什么「创建组件」走的是内置脚手架,而不是从空白文件夹开始。

几个刻意的取舍

做这类「浏览器 IDE」,功能清单可以列很长,真正难的是决定不做什么。我们目前的选择是:

  • 终端只放行装依赖命令:npm install / npm i / npm add 之外的行不会执行,只回显一行说明。工作区的终端是给你装包用的,不是通用 shell;
  • .vue 没有模块级 HMR:JS / TS / JSX 有热更新,.vue 走「保存后整页刷新」,300ms 防抖。这是运行时编译的代价,换来的是不用预构建;
  • 代码存本地,发布才上传:工作区快照写在 IndexedDB,只有主动点发布时,组件源码才会上传到 Comp-Hub。清空浏览器数据会一并清掉本地快照;
  • Vue 2 不新建:组件库里的 Vue 2 组件仍可浏览和下载,但 Studio 新建工作区默认是 Vue 3;React 是 19;Web Components 可以跑在任何宿主里。

它不替代你的日常 IDE。Studio 解决的是「临时写个组件、马上看效果、顺手发布」这类场景,长期复杂工程还是交给本地环境。

上手三步

  1. 打开 studio.comphub.cn,登录或先匿名试用;
  2. 新建工作区,选 Vue 3 / React / Web Components,也可以把本地文件夹或 zip 直接拖进文件树;从组件库点「在 Studio 中打开」也可以导入已有组件;
  3. 向右侧 AI 描述需求,或者直接在编辑器里改。确认预览后点发布。

链接

如果试用过程中遇到问题,或者想要「私有 npm 源」「更多框架模板」这类能力,欢迎在评论区留言,也可以到主站的联系页找我们。