Perplexity ローカル開発ループ

概要

Perplexity の高速で再現可能なローカル開発ワークフローを構築します。

前提条件

• perplexity-install-auth セットアップの完了
• Node.js 18 以上（npm/pnpm）
• TypeScript サポート対応のコードエディタ
• バージョン管理用の Git

手順

ステップ 1: プロジェクト構造の作成

my-perplexity-project/
├── src/
│   ├── perplexity/
│   │   ├── client.ts       # Perplexity クライアントラッパー
│   │   ├── config.ts       # 設定管理
│   │   └── utils.ts        # ヘルパー関数
│   └── index.ts
├── tests/
│   └── perplexity.test.ts
├── .env.local              # ローカルシークレット（git-ignored）
├── .env.example            # チーム向けテンプレート
└── package.json

ステップ 2: 環境設定

# 環境テンプレートをコピー
cp .env.example .env.local

# 依存パッケージのインストール
npm install

# 開発サーバーを起動
npm run dev

ステップ 3: ホットリロードのセットアップ

{
  "scripts": {
    "dev": "tsx watch src/index.ts",
    "test": "vitest",
    "test:watch": "vitest --watch"
  }
}

ステップ 4: テストの設定

import { describe, it, expect, vi } from 'vitest';
import { PerplexityClient } from '../src/perplexity/client';

describe('Perplexity Client', () => {
  it('should initialize with API key', () => {
    const client = new PerplexityClient({ apiKey: 'test-key' });
    expect(client).toBeDefined();
  });
});

アウトプット

• ホットリロード対応の開発環境
• モッキング機能付きの設定済みテストスイート
• 環境変数の管理
• Perplexity 開発向けの高速イテレーションサイクル

エラーハンドリング

エラー	原因	解決方法
Module not found	依存パッケージがない	npm install を実行
Port in use	別のプロセスが使用中	プロセスを終了またはポート変更
Env not loaded	.env.local がない	.env.example からコピー
Test timeout	ネットワークが遅い	テストタイムアウトを延長

例

Perplexity レスポンスのモック

vi.mock('@perplexity/sdk', () => ({
  PerplexityClient: vi.fn().mockImplementation(() => ({
    // Mock methods here
  })),
}));

デバッグモード

# 詳細なログを有効化
DEBUG=PERPLEXITY=* npm run dev

リソース

• Perplexity SDK リファレンス
• Vitest ドキュメント
• tsx ドキュメント

次のステップ

本番環境対応のコードパターンについては perplexity-sdk-patterns を参照してください。