Puter

此错误出现在Windows系统上的puter.com v2.5.1中，原因是扩展加载器使用了Windows绝对路径（例如'c:\\\\...'）但缺少必需的file://前缀，导致Node.js ESM加载器拒绝该路径。临时解决方案：使用--experimental-specifier-resolution=node标志运行Node.js。修改package.json中的启动脚本，或直接运行：node --enable-source-maps --experimental-specifier-resolution=node -r ./dist/src/backend/telemetry.js ./dist/src/backend/index.js。另一种方法是修补扩展加载代码，将绝对路径转换为file:// URL。长期修复：更新到正确处理Windows路径的puter.com新版本。

错误发生的原因是 Node 兼容的 @heyputer/puter.js 包（使用了 socket.io‑client 的 .unref()）在客户端被加载。通过客户端专用插件强制 Nuxt 使用浏览器构建版本：

1. 创建 plugins/puter.client.ts：

export default defineNuxtPlugin(async (nuxtApp) => {
  const mod = await import('@heyputer/puter.js/dist/puter.js'); // 浏览器构建版本
  const puter = mod.puter ?? mod.default ?? mod;
  nuxtApp.provide('puter', puter);
});

2. 在 nuxt.config.ts 中，将该模块从 Vite 预构建中排除：

export default defineNuxtConfig({
  ssr: false, // 确保仅在客户端运行
  vite: {
    optimizeDeps: {
      exclude: ['@heyputer/puter.js']
    }
  }
});

3. 在组合式函数中通过 useNuxtApp().$puter 访问 puter，而非顶层导入。