Question 1

如何在 Puter 应用中使用 Serverless Workers 在多个用户之间共享数据？

Accepted Answer

创建一个 Serverless Worker 作为集中式后端：不再将数据存储在每个用户各自的存储空间中，而是由 worker 代表所有用户对单一的共享存储进行读/写。请遵循官方教程：https://docs.puter.com/recipes/store-server-side-data/。

要点：
- 你无需在 worker 上设置 `sandbox: false`。沙箱只是将一个 worker 的数据与其他 worker 的数据隔离开来；请保持其启用状态。
- 无论沙箱设置如何，worker 写入的所有数据都存储在 worker 创建者的账户中——文件会进入你的 `fs`，键值数据会进入你的 `kv`，消耗的是你的存储配额，而不是最终用户的。
- 示例用例：共享家庭相册——通过 worker 将图片上传到创建者的 fs 中，并通过 worker 将这些图片提供给所有用户，这样每个用户就无需各自保存一份副本。

另请参阅 https://docs.puter.com/Workers/ 以及安全概览 https://docs.puter.com/security/。

Question 2

为什么 puter.ai.txt2speech() 在使用 Gemini 提供商时会把指令以及 "Say the following text aloud" 前缀朗读出来？

Accepted Answer

这是 Puter.js 中的一个 bug:当使用 `provider: "gemini"` 时,用户提供的 `instructions` 和内部注入的前缀("Say the following text aloud")都会被拼接到发送给 Gemini TTS 模型的文本负载中,因此这些内容会被朗读出来,而不是被当作风格指导。移除 `instructions` 参数也无法解决该问题,因为这个内部前缀是由 Puter.js 自身添加的。临时解决方案:改用其他 TTS 提供商,例如 `puter.ai.txt2speech("Hello, how are you today?", { provider: "elevenlabs", voice: "..." })`,即可完全避免该问题。

Question 3

如何在Windows上启动Puter时修复'ERR_UNSUPPORTED_ESM_URL_SCHEME'错误？

Accepted Answer

此错误出现在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新版本。

Question 4

如何修复在 Nuxt 3 中使用 @heyputer/puter.js 时出现的 'TypeError: s3.unref is not a function' 错误？

Accepted Answer

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

1. 创建 `plugins/puter.client.ts`：
```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 预构建中排除：
```ts
export default defineNuxtConfig({
  ssr: false, // 确保仅在客户端运行
  vite: {
    optimizeDeps: {
      exclude: ['@heyputer/puter.js']
    }
  }
});
```

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

Puter

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐