Question 1

Serverless Workers를 사용하여 Puter 앱에서 여러 사용자 간에 데이터를 공유하는 방법

Accepted Answer

중앙 집중식 백엔드 역할을 하는 Serverless Worker를 생성하세요. 각 개별 사용자의 스토리지에 데이터를 저장하는 대신, 워커가 모든 사용자를 대신하여 하나의 공유 스토어에 읽기/쓰기를 수행합니다. https://docs.puter.com/recipes/store-server-side-data/ 에 있는 공식 레시피를 따르세요.

주요 사항:
- 워커에 `sandbox: false`를 설정할 필요가 없습니다. 샌드박스는 한 워커의 데이터를 다른 워커로부터 격리할 뿐이므로, 활성화된 상태로 유지하세요.
- 샌드박스 설정과 관계없이, 워커가 쓰는 모든 데이터는 워커 생성자의 계정에 저장됩니다. 파일은 `fs`로, 키-값 데이터는 `kv`로 저장되며, 최종 사용자가 아닌 생성자 본인의 스토리지 할당량을 소비합니다.
- 사용 예시: 공유 가족 사진 갤러리 — 워커를 통해 이미지를 생성자의 fs에 업로드하고 워커를 통해 모든 사용자에게 제공하면, 각 사용자가 사본을 보관하지 않아도 됩니다.

https://docs.puter.com/Workers/ 와 https://docs.puter.com/security/ 의 보안 개요도 참조하세요.

Question 2

Gemini provider로 puter.ai.txt2speech()를 사용할 때 왜 instructions와 "Say the following text aloud" 접두사까지 소리 내어 읽는 건가요?

Accepted Answer

이것은 Puter.js의 버그입니다: `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을 사용할 때 발생합니다. 확장 로더가 필수 file:// 접두사 없이 절대 Windows 경로(예: 'c:\...')를 사용하기 때문이며, 이는 Node.js ESM 로더가 거부합니다. 해결 방법: Node.js를 --experimental-specifier-resolution=node 플래그와 함께 실행합니다. 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

@heyputer/puter.js의 Node 호환 번들(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'); // browser bundle
  const puter = mod.puter ?? mod.default ?? mod;
  nuxtApp.provide('puter', puter);
});
```
2. `nuxt.config.ts`에서 Vite 사전 번들링에서 모듈을 제외하세요:
```ts
export default defineNuxtConfig({
  ssr: false, // ensure client‑side only
  vite: {
    optimizeDeps: {
      exclude: ['@heyputer/puter.js']
    }
  }
});
```
3. 최상위 import 대신 `useNuxtApp().$puter`를 통해 컴포저블에서 puter에 접근하세요.

Puter

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트