@doany-ai/vite-plugin

中文文档
0.1.8发布于 2026/11/02MITES Module近 30 天下载 4651

Doany 用于沙盒网站构建器预览的 Vite 集成

中文使用文档
文档目录8 节
  1. 安装
  2. 使用量
  3. 选项
  4. 沙盒依赖缓存
  5. 环境
  6. 安全状况
  7. 发展
  8. 许可证

@doany-ai/vite-plugin

Doany的Vite集成,用于在沙盒中运行的网站-构建器应用程序 iframes (英语). 它提供JSX源仪器、高频和导航 通知、 错误转发、 视觉选择/ 编辑、 循环构建 状态终点, 和分析注射。 它是独立的后端 SDK .

这是多尼拥有的网站建设者脚手架的早期等分叉.

安装

出版后:

npm install @doany-ai/vite-plugin

对于本地包装的建筑,请使用 .tgz 发射者 npm pack。 。 。 .

使用量

import doany from "@doany-ai/vite-plugin";

export default {
  plugins: [
    doany({
      hmrNotifier: true,
      navigationNotifier: true,
      analyticsTracker: true,
      visualEditAgent: true,
    }),
  ],
};

选项

选项默认目的
hmrNotifierfalse向嵌入式编辑器转发 HMR 生命周期事件 .
navigationNotifierfalse当 iframe 路由改变时通知编辑器 .
visualEditAgentfalse启用 DOM 对源选择和内置视觉编辑 .
analyticsTrackerfalse注入制作页面视图跟踪器 .
sandbox自动强制沙盒行为 或关闭。 自动检测检查多尼和代托纳标记.

沙盒依赖缓存

在沙盒开发过程中,插件默认 Vite 的依赖缓存为 a 新设 .vite/runtime-* 工程中的目录。 每个 dev- server 进程拥有 它的缓存; 不同配置端口的服务器也会得到单独的缓存. 这样可以避免重用已恢复的优化目录或与一个 第二预览服务器。 Vite 在同一过程中重新启动该目录的再使用 . 普通进程退出只删除进程创建的目录 .

一个明确的Vite cacheDir 仍由打电话者尊重和拥有。 当地 开发和生产建设保持了Vite的普通缓存行为.

重复优化-依赖504响应可引发强制再优化. 一分钟的冷却和三重启动预算 幸存Vite配置重载, 并应用到每个工程、配置的端口和解析的缓存目录 过程的寿命。 其他504个答复没有引发复苏.

环境

变量目的
VITE_DOANY_APP_ID识别用于生产分析的应用程序.
VITE_DOANY_APP_BASE_URL代理服务器 /api 在本地前端开发期间.
DOANY_HMR_HOST覆盖沙盒 HMR WebSocket主机.
DOANY_BUILD_STATUS_ENABLED启用仅回放的构建状态终点 .
DOANY_SANDBOX_ID 或者说 DAYTONA_SANDBOX_ID探测沙盒执行.

安全状况

当前 iframe 协议使用通配符 postMessage 目标,不 持续验证导入的父源, 打开 sandbox iframe/ dev- host 头部,并在可视化编辑开发过程中注入"Tailwind CDN". 来,吃吧 作为内部对等建设,而不是生产坚固的信任界限.

下一个更硬化的里程碑是控制器提供的父源许可列表 或能力握手。 必须采用编辑侧协议 测试,所以安全变化不会默默地打破视觉编辑或HMR.

发展

npm install
npm test
npm pack

npm test 在运行前重建 Vite 插件和浏览器桥 公共合同测试.

许可证

麻省理工学院.

版本与发布记录

@doany-ai/vite-plugin 共发布 9 个版本,首次发布于 2026/07/29;过去 12 个月发布了 9 个版本。

版本发布日期距今
0.1.8latest2026/11/0211 天前
0.1.72026/10/2222 天前
0.1.62026/09/181 个月前
0.1.52026/09/171 个月前
0.1.42026/08/053 个月前
0.1.32026/08/023 个月前

关于 @doany-ai/vite-plugin 的常见问题

@doany-ai/vite-plugin 是什么?

Doany 用于沙盒网站构建器预览的 Vite 集成

如何安装 @doany-ai/vite-plugin?

在项目目录运行 npm install @doany-ai/vite-plugin,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vite(>=6 <8)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@doany-ai/vite-plugin 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/doany-ai__vite-plugin 是否存在。

@doany-ai/vite-plugin 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@doany-ai/vite-plugin 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@doany-ai/vite-plugin 可以商用吗?

@doany-ai/vite-plugin 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@doany-ai/vite-plugin 的下载量有多少?

根据 npm 官方下载统计,@doany-ai/vite-plugin 在 2026/10/13 – 2026/11/11 这 30 天内被下载 4,651 次,日均约 155 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@doany-ai/vite-plugin 还在维护吗?

最新版本 0.1.8 发布于 2026/11/02(11 天前);至今共发布 9 个版本,其中过去 12 个月发布了 9 个;首次发布于 2026/07/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。