{"id":41107026,"url":"https://github.com/enslo/sd-metadata","last_synced_at":"2026-02-27T11:46:48.312Z","repository":{"id":332132563,"uuid":"1129647142","full_name":"enslo/sd-metadata","owner":"enslo","description":"Read and write generation parameters from AI images (PNG/JPEG/WebP). Supports AUTOMATIC1111, ComfyUI, NovelAI, and 10+ more tools. TypeScript + zero dependencies.","archived":false,"fork":false,"pushed_at":"2026-02-01T05:58:38.000Z","size":93822,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-01T16:37:11.798Z","etag":null,"topics":["ai-image","comfyui","exif","forge","image-metadata","jpeg","metadata-parser","novelai","png","prompt","stable-diffusion","webp"],"latest_commit_sha":null,"homepage":"https://sd-metadata.pages.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/enslo.png","metadata":{"files":{"readme":"README.ja.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-07T11:35:40.000Z","updated_at":"2026-02-01T05:58:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/enslo/sd-metadata","commit_stats":null,"previous_names":["enslo/sd-metadata"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/enslo/sd-metadata","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enslo%2Fsd-metadata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enslo%2Fsd-metadata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enslo%2Fsd-metadata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enslo%2Fsd-metadata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/enslo","download_url":"https://codeload.github.com/enslo/sd-metadata/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/enslo%2Fsd-metadata/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29447768,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T14:10:32.461Z","status":"ssl_error","status_checked_at":"2026-02-14T14:09:49.945Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-image","comfyui","exif","forge","image-metadata","jpeg","metadata-parser","novelai","png","prompt","stable-diffusion","webp"],"created_at":"2026-01-22T15:21:00.994Z","updated_at":"2026-02-14T15:04:49.867Z","avatar_url":"https://github.com/enslo.png","language":"TypeScript","readme":"# sd-metadata\n\n[![npm version](https://img.shields.io/npm/v/@enslo/sd-metadata.svg)](https://www.npmjs.com/package/@enslo/sd-metadata)\n[![npm downloads](https://img.shields.io/npm/dm/@enslo/sd-metadata.svg)](https://www.npmjs.com/package/@enslo/sd-metadata)\n[![license](https://img.shields.io/npm/l/@enslo/sd-metadata.svg)](https://github.com/enslo/sd-metadata/blob/main/LICENSE)\n\n🌐 **[English version](./README.md)**\n\nAI生成画像に埋め込まれたメタデータを読み書きするためのTypeScriptライブラリです。\n\n## 特徴\n\n- **マルチフォーマット対応**: PNG (tEXt / iTXt)、JPEG (COM / Exif)、WebP (Exif)\n- **統一API**: シンプルな `read()` と `write()` 関数で全フォーマットに対応\n- **TypeScriptネイティブ**: TypeScriptで書かれており、型定義を完全同梱\n- **ゼロ依存**: Node.jsとブラウザで外部依存なしで動作\n- **フォーマット変換**: PNG、JPEG、WebP間でメタデータをシームレスに変換\n- **メタデータ保持**: フォーマット変換時に元のメタデータ構造を保持（例：PNG → JPEG → PNG で全データを維持）\n\n## インストール\n\n```bash\nnpm install @enslo/sd-metadata\n```\n\n## ツールサポート\n\n| ツール | PNG | JPEG | WebP |\n| ------ | :---: | :----: | :----: |\n| [NovelAI](https://novelai.net/) * | ✅ | 🔄️ | ✅ |\n| [ComfyUI](https://github.com/comfyanonymous/ComfyUI) * | ✅ | 🔄️ | 🔄️ |\n| [AUTOMATIC1111](https://github.com/AUTOMATIC1111/stable-diffusion-webui) | ⚠️ | ⚠️ | ⚠️ |\n| [Forge](https://github.com/lllyasviel/stable-diffusion-webui-forge) / [Forge Neo](https://github.com/neggles/sd-webui-forge-neoforge) | ✅ | ✅ | ✅ |\n| [InvokeAI](https://github.com/invoke-ai/InvokeAI) | ✅ | 🔄️ | 🔄️ |\n| [SwarmUI](https://github.com/Stability-AI/StableSwarmUI) * | ✅ | ✅ | ✅ |\n| [Civitai](https://civitai.com/) | ⚠️ | ✅ | ⚠️ |\n| [TensorArt](https://tensor.art/) | ✅ | 🔄️ | 🔄️ |\n| [Stability Matrix](https://github.com/LykosAI/StabilityMatrix) | ✅ | 🔄️ | 🔄️ |\n| [HuggingFace Space](https://huggingface.co/spaces) | ✅ | 🔄️ | 🔄️ |\n| [Ruined Fooocus](https://github.com/runew0lf/RuinedFooocus) | ✅ | 🔄️ | 🔄️ |\n| [Easy Diffusion](https://github.com/easydiffusion/easydiffusion) | ⚠️ | ⚠️ | ⚠️ |\n| [Fooocus](https://github.com/lllyasviel/Fooocus) | ⚠️ | ⚠️ | ⚠️ |\n\n**凡例:**\n\n- ✅ **完全対応** - ツールがネイティブでサポートするフォーマット。サンプルファイルで検証済み\n- 🔄️ **拡張対応** - ツールがネイティブでサポートしないフォーマット。sd-metadataがカスタムフォーマット変換により読み書きを可能に。ネイティブフォーマットへのラウンドトリップ変換に対応\n- ⚠️ **実験的** - リファレンスコードやドキュメントの分析により実装。サンプルファイルでの検証は未実施。全てのメタデータフィールドを正しく抽出できない可能性あり\n\n**拡張対応の例:**\n\n- **Stability Matrix**（ネイティブ: PNGのみ）→ sd-metadataがJPEG/WebPをサポート\n- **NovelAI**（ネイティブ: PNG、WebP）→ sd-metadataがJPEGをサポート\n\nネイティブフォーマットから拡張フォーマットに変換し、再度戻す場合（例：PNG → JPEG → PNG）、全てのメタデータが保持されます。\n\n\u003e [!NOTE]\n\u003e \\* フォーマット固有の動作があるツール。詳細は[フォーマット固有の動作](#フォーマット固有の動作)を参照してください。\n\n\u003e [!TIP]\n\u003e **ツールサポートの拡大にご協力ください！** 実験的なツール（Easy Diffusion、Fooocus）やサポートされていないツールのサンプル画像を募集しています。これらのAIツールで生成したサンプル画像をお持ちの方は、ぜひご提供ください！詳細は[CONTRIBUTING.md](CONTRIBUTING.md)を参照してください。\n\n## フォーマット固有の動作\n\n一部のツールはフォーマット変換時に特定の動作をします：\n\n- **ComfyUI JPEG/WebP**: 読み込みは複数のカスタムノードフォーマット（例：`save-image-extended`）に対応していますが、書き込みは情報保持とComfyUIネイティブのドラッグ＆ドロップワークフロー読み込みとの互換性のため、常に `comfyui-saveimage-plus` フォーマットを使用します。\n- **NovelAI WebP**: Descriptionフィールドの破損したUTF-8を自動修正します。WebP → PNG → WebP のラウンドトリップは有効で読み取り可能なメタデータを生成しますが、軽微なテキスト修正が含まれます。\n- **SwarmUI PNG→JPEG/WebP**: ネイティブのSwarmUI JPEG/WebPファイルにはノード情報が含まれません。PNGから変換する際、このライブラリは完全なメタデータ保持のためにComfyUIワークフローを `Make` フィールドに保存します（拡張対応）。\n\n## インポート\n\n**ESM (TypeScript / Modern JavaScript):**\n\n```typescript\nimport { read } from '@enslo/sd-metadata';\n```\n\n**CommonJS (Node.js):**\n\n```javascript\nconst { read } = require('@enslo/sd-metadata');\n```\n\n\u003e [!NOTE]\n\u003e 以下の例は全てESM構文を使用しています。CommonJSユーザーは `import` を `require` に置き換えてください。\n\n## 使い方\n\n### Node.jsでの使用\n\n```typescript\nimport { read, write } from '@enslo/sd-metadata';\nimport { readFileSync, writeFileSync } from 'fs';\n\n// サポートされている任意のフォーマットからメタデータを読み込み\nconst imageData = readFileSync('image.png');\nconst result = read(imageData);\n\nif (result.status === 'success') {\n  console.log('Tool:', result.metadata.software);       // 'novelai', 'comfyui', etc.\n  console.log('Prompt:', result.metadata.prompt);\n  console.log('Model:', result.metadata.model?.name);\n  console.log('Size:', result.metadata.width, 'x', result.metadata.height);\n}\n```\n\n### ブラウザでの使用\n\n```typescript\nimport { read } from '@enslo/sd-metadata';\n\n// ファイル入力を処理\nconst fileInput = document.querySelector('input[type=\"file\"]');\nfileInput.addEventListener('change', async (e) =\u003e {\n  const file = e.target.files[0];\n  if (!file) return;\n  \n  const arrayBuffer = await file.arrayBuffer();\n  const result = read(arrayBuffer);\n  \n  if (result.status === 'success') {\n    document.getElementById('tool').textContent = result.metadata.software;\n    document.getElementById('prompt').textContent = result.metadata.prompt;\n    document.getElementById('model').textContent = result.metadata.model?.name || 'N/A';\n  }\n});\n```\n\n### CDN使用（ユーザースクリプト）\n\nユーザースクリプト（Tampermonkey、Violentmonkeyなど）では、jsDelivr CDNから読み込みます：\n\n```javascript\n// CDNからインポート\nimport { read } from 'https://cdn.jsdelivr.net/npm/@enslo/sd-metadata@latest/dist/index.js';\n\nconst response = await fetch(imageUrl);\nconst arrayBuffer = await response.arrayBuffer();\nconst result = read(arrayBuffer);\n\nif (result.status === 'success') {\n  console.log('Tool:', result.metadata.software);\n  console.log('Prompt:', result.metadata.prompt);\n}\n```\n\n\u003e [!TIP]\n\u003e 本番環境では `@latest` の代わりに特定のバージョンを指定してください：\n\u003e\n\u003e ```text\n\u003e https://cdn.jsdelivr.net/npm/@enslo/sd-metadata@1.8.0/dist/index.js\n\u003e ```\n\n### 応用例\n\n\u003cdetails\u003e\n\u003csummary\u003eフォーマット変換\u003c/summary\u003e\n\n異なる画像フォーマット間でメタデータを変換：\n\n```typescript\nimport { read, write } from '@enslo/sd-metadata';\n\n// PNGからメタデータを読み込み\nconst pngData = readFileSync('comfyui-output.png');\nconst parseResult = read(pngData);\n\nif (parseResult.status === 'success') {\n  // PNGをJPEGに変換（お好みの画像処理ライブラリを使用）\n  const jpegImageData = convertToJpeg(pngData); // 疑似コード：sharp、canvasなどを使用\n  \n  // メタデータをJPEGに埋め込み\n  const result = write(jpegImageData, parseResult);\n  \n  if (result.ok) {\n    writeFileSync('output.jpg', result.value);\n    console.log('画像をメタデータ付きでJPEGに変換しました');\n  }\n}\n```\n\n\u003e [!TIP]\n\u003e このライブラリはメタデータの読み書きのみを扱います。実際の画像フォーマット変換（ピクセルのデコード/エンコード）には、[sharp](https://www.npmjs.com/package/sharp)、[jimp](https://www.npmjs.com/package/jimp)、ブラウザCanvas APIなどの画像処理ライブラリを使用してください。\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e読み込み結果のタイプごとの処理\u003c/summary\u003e\n\n```typescript\nimport { read } from '@enslo/sd-metadata';\n\nconst result = read(imageData);\n\nswitch (result.status) {\n  case 'success':\n    // メタデータのパース成功\n    console.log(`Generated by ${result.metadata.software}`);\n    console.log(`Prompt: ${result.metadata.prompt}`);\n    break;\n\n  case 'unrecognized':\n    // メタデータは存在するがフォーマットが認識できない\n    console.log('不明なメタデータフォーマット');\n    // デバッグ用に生のメタデータにアクセス可能：\n    console.log('Raw chunks:', result.raw);\n    break;\n\n  case 'empty':\n    // メタデータが見つからない\n    console.log('この画像にはメタデータがありません');\n    break;\n\n  case 'invalid':\n    // 破損または無効な画像データ\n    console.log('Error:', result.message);\n    break;\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e未対応メタデータの扱い\u003c/summary\u003e\n\n未対応ツールのメタデータを含む画像を扱う場合：\n\n```typescript\nimport { read, write } from '@enslo/sd-metadata';\n\nconst source = read(unknownImage);\n// source.status === 'unrecognized'\n\n// ターゲット画像に書き込み\n// - 同じフォーマット（例：PNG → PNG）：メタデータそのまま保持\n// - 異なるフォーマット（例：PNG → JPEG）：warning付きでメタデータ削除\nconst result = write(targetImage, source);\nif (result.ok) {\n  saveFile('output.png', result.value);\n  if (result.warning) {\n    // クロスフォーマット変換によりメタデータが削除された場合\n    console.warn('メタデータが削除されました:', result.warning.reason);\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eメタデータの削除\u003c/summary\u003e\n\n画像から全てのメタデータを削除：\n\n```typescript\nimport { write } from '@enslo/sd-metadata';\n\nconst result = write(imageData, { status: 'empty' });\nif (result.ok) {\n  writeFileSync('clean-image.png', result.value);\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eWebUIフォーマットでメタデータを書き込む\u003c/summary\u003e\n\nSD WebUI (A1111) フォーマットでカスタムメタデータを作成して埋め込み：\n\n```typescript\nimport { writeAsWebUI } from '@enslo/sd-metadata';\n\n// カスタムメタデータをゼロから作成\nconst metadata = {\n  software: 'sd-webui',\n  prompt: 'masterpiece, best quality, 1girl',\n  negativePrompt: 'lowres, bad quality',\n  width: 512,\n  height: 768,\n  sampling: {\n    steps: 20,\n    sampler: 'Euler a',\n    cfg: 7,\n    seed: 12345,\n  },\n  model: { name: 'model.safetensors' },\n};\n\n// 任意の画像フォーマット（PNG、JPEG、WebP）に書き込み\nconst result = writeAsWebUI(imageData, metadata);\nif (result.ok) {\n  writeFileSync('output.png', result.value);\n}\n```\n\n\u003e [!TIP]\n\u003e `writeAsWebUI` は以下の場合に特に便利です：\n\u003e\n\u003e - プログラムで生成した画像に生成パラメータを埋め込みたい場合\n\u003e - ツール固有フォーマットからWebUI互換フォーマットにメタデータを変換する場合\n\u003e - WebUIで読み取り可能なメタデータを出力するツールを構築する場合\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e表示用にメタデータをフォーマット\u003c/summary\u003e\n\n**どのツールのメタデータであっても**、統一されたWebUIフォーマットのテキストに変換できます。ツール間の差異（NovelAI、ComfyUI、Forgeなど）を吸収し、一貫したテキスト形式に正規化します：\n\n```typescript\nimport { read, formatAsWebUI } from '@enslo/sd-metadata';\n\nconst result = read(imageData);\nif (result.status === 'success') {\n  // どのツールでもOK: NovelAI, ComfyUI, Forge, InvokeAI, etc.\n  const text = formatAsWebUI(result.metadata);\n  console.log(text);\n  \n  // 常に統一されたWebUIフォーマットで出力:\n  // masterpiece, best quality, 1girl\n  // Negative prompt: lowres, bad quality\n  // Steps: 20, Sampler: Euler a, CFG scale: 7, Seed: 12345, Size: 512x768, Model: model.safetensors\n}\n```\n\n\u003e [!NOTE]\n\u003e どのツールで生成された画像であっても、`formatAsWebUI` は共通の生成パラメータを抽出し、標準化された形式に整形します。ツール固有のフォーマットを意識することなく、ユーザーにメタデータを表示するのに最適です。\n\n\u003c/details\u003e\n\n## APIリファレンス\n\n### `read(input: Uint8Array | ArrayBuffer): ParseResult`\n\n画像ファイルからメタデータを読み込み、パースします。\n\n**戻り値:**\n\n- `{ status: 'success', metadata, raw }` - パース成功\n  - `metadata`: 統一されたメタデータオブジェクト（`GenerationMetadata`を参照）\n  - `raw`: 元のフォーマット固有のデータ（chunks/segments）\n- `{ status: 'unrecognized', raw }` - 画像にメタデータがあるが既知のAIツールからではない\n  - `raw`: 変換用に保持された元のメタデータ\n- `{ status: 'empty' }` - 画像にメタデータが見つからない\n- `{ status: 'invalid', message? }` - 破損または非対応の画像フォーマット\n  - `message`: オプションのエラー説明\n\n### `write(input: Uint8Array | ArrayBuffer, metadata: ParseResult): WriteResult`\n\n画像ファイルにメタデータを書き込みます。\n\n**パラメータ:**\n\n- `input` - ターゲット画像ファイルデータ（PNG、JPEG、またはWebP）\n- `metadata` - `read()` から得られた `ParseResult`\n  - `status: 'success'` または `'empty'` - 直接書き込み可能\n  - `status: 'unrecognized'` - 同じフォーマット：そのまま書き込み、異なるフォーマット：warning付きでメタデータ削除\n\n**戻り値:**\n\n- `{ ok: true, value: Uint8Array, warning?: WriteWarning }` - 書き込み成功\n  - `warning` はメタデータが意図的に削除された場合に設定される（例：未対応のクロスフォーマット変換）\n- `{ ok: false, error: { type, message? } }` - 失敗。`type` は以下のいずれか：\n  - `'unsupportedFormat'`: 対象画像がPNG、JPEG、WebP以外の場合\n  - `'conversionFailed'`: メタデータ変換に失敗（例：互換性のないフォーマット）\n  - `'writeFailed'`: 画像へのメタデータ埋め込みに失敗\n\n### `writeAsWebUI(input: Uint8Array | ArrayBuffer, metadata: GenerationMetadata): WriteResult`\n\nSD WebUI (A1111) フォーマットで画像にメタデータを書き込みます。\n\n**パラメータ:**\n\n- `input` - ターゲット画像ファイルデータ（PNG、JPEG、またはWebP）\n- `metadata` - 埋め込む生成メタデータ\n  - 任意のツールからでも、カスタム作成でも可能\n  - 自動的にWebUIフォーマットに変換される\n\n**戻り値:**\n\n- `{ ok: true, value: Uint8Array }` - 書き込み成功（新しい画像データを返す）\n- `{ ok: false, error: { type, message? } }` - 失敗。`type` は以下のいずれか：\n  - `'unsupportedFormat'`: 対象画像がPNG、JPEG、WebP以外の場合\n  - `'writeFailed'`: 画像へのメタデータ埋め込みに失敗\n\n**ユースケース:**\n\n- プログラムで生成した画像にカスタムメタデータを作成\n- 他のツールからWebUI互換フォーマットにメタデータを変換\n- WebUIで読み取り可能なメタデータを出力するアプリケーションの構築\n\n### `formatAsWebUI(metadata: GenerationMetadata): string`\n\nメタデータをSD WebUI (A1111) フォーマットのテキストにフォーマットします。\n\n**パラメータ:**\n\n- `metadata` - 任意のツールからの生成メタデータ\n\n**戻り値:**\n\n- WebUIフォーマットの文字列（プレーンテキスト）\n\n**出力フォーマット:**\n\n```text\npositive prompt\n[NovelAIのキャラクタープロンプト]\nNegative prompt: negative prompt\nSteps: 20, Sampler: Euler a, CFG scale: 7, Seed: 12345, Size: 512x768, ...\n```\n\n**ユースケース:**\n\n- ユーザーに一貫したフォーマットでメタデータを表示\n- 生成パラメータをテキストとしてコピー\n- 生成設定のログ出力やデバッグ\n\n### `formatRaw(raw: RawMetadata): string`\n\n生のメタデータをプレーンテキストとしてフォーマットします。\n\n**パラメータ:**\n\n- `raw` - `ParseResult` から得られた生のメタデータ（`result.raw`）\n\n**戻り値:**\n\n- メタデータのプレーンテキスト内容（複数エントリは空行で区切られる）\n\n**ユースケース:**\n\n- 認識できないメタデータをユーザーに表示\n- 生のメタデータ内容の素早い確認\n- パース失敗時のフォールバック表示\n\n**例:**\n\n```typescript\nimport { read, formatAsWebUI, formatRaw } from '@enslo/sd-metadata';\n\nconst result = read(imageData);\n\nswitch (result.status) {\n  case 'success':\n    console.log(formatAsWebUI(result.metadata));\n    break;\n  case 'unrecognized':\n    console.log(formatRaw(result.raw));\n    break;\n}\n```\n\n## 型リファレンス\n\nこのセクションでは主要な型の概要を説明します。完全な型定義については[型ドキュメント](./docs/types.ja.md)を参照してください。\n\n### `ParseResult`\n\n`read()` 関数の結果。`status` フィールドで分岐するユニオン型です。\n\n```typescript\ntype ParseResult =\n  | { status: 'success'; metadata: GenerationMetadata; raw: RawMetadata }\n  | { status: 'unrecognized'; raw: RawMetadata }\n  | { status: 'empty' }\n  | { status: 'invalid'; message?: string };\n```\n\n### `GenerationMetadata`\n\n`read()` 関数が返す統一されたメタデータ構造。`software` フィールドで区別される3つのメタデータ型のユニオン型です。\n\n**共通フィールド（全タイプで利用可能）:**\n\n全てのメタデータ型にはこれらの基本フィールドが含まれます：\n\n- `prompt: string` - ポジティブプロンプトテキスト\n- `negativePrompt: string` - ネガティブプロンプトテキスト\n- `width: number` - 画像の幅（ピクセル）\n- `height: number` - 画像の高さ（ピクセル）\n- `model?: ModelSettings` - モデル情報（name、hash、VAE）\n- `sampling?: SamplingSettings` - サンプリングパラメータ（seed、steps、CFG、sampler、scheduler、clipSkip）\n- `hires?: HiresSettings` - Hires.fix設定（適用されている場合）\n- `upscale?: UpscaleSettings` - アップスケール設定（適用されている場合）\n\n**メタデータ型のバリアント:**\n\n- **`NovelAIMetadata`** (`software: 'novelai'`)  \n  V4キャラクター配置用のNovelAI固有フィールドを含む：\n  - `characterPrompts?: CharacterPrompt[]` - キャラクターごとのプロンプトと位置\n  - `useCoords?: boolean` - 配置にキャラクター座標を使用\n  - `useOrder?: boolean` - キャラクターの順序を使用\n\n- **`ComfyUIMetadata`** (`software: 'comfyui' | 'tensorart' | 'stability-matrix' | 'swarmui'`)  \n  ComfyUIワークフローグラフを含む：\n  - `nodes: ComfyNodeGraph`（comfyui/tensorart/stability-matrixでは必須）\n  - `nodes?: ComfyNodeGraph`（swarmuiではオプション - PNGフォーマットのみ）\n\n- **`StandardMetadata`** (`software: 'sd-webui' | 'forge' | 'invokeai' | 'civitai' | ...`)  \n  ツール固有の拡張なしのベースラインメタデータ。ほとんどのSD WebUIベースのツールで使用。\n\n**型定義:**\n\n```typescript\ntype GenerationMetadata =\n  | NovelAIMetadata\n  | ComfyUIMetadata\n  | StandardMetadata;\n```\n\n**使用例:**\n\n```typescript\nconst result = read(imageData);\n\nif (result.status === 'success') {\n  const metadata = result.metadata;\n  \n  // 共通フィールドにアクセス\n  console.log('Prompt:', metadata.prompt);\n  console.log('Model:', metadata.model?.name);\n  console.log('Seed:', metadata.sampling?.seed);\n  \n  // ユニオン型を使用したタイプ固有の処理\n  if (metadata.software === 'novelai') {\n    // TypeScriptはこれがNovelAIMetadataであることを認識\n    console.log('Character prompts:', metadata.characterPrompts);\n  } else if (\n    metadata.software === 'comfyui' ||\n    metadata.software === 'tensorart' ||\n    metadata.software === 'stability-matrix'\n  ) {\n    // TypeScriptはこれがBasicComfyUIMetadata（nodesは常に存在）であることを認識\n    console.log('Node count:', Object.keys(metadata.nodes).length);\n  } else if (metadata.software === 'swarmui') {\n    // TypeScriptはこれがSwarmUIMetadata（nodesはオプション）であることを認識\n    if (metadata.nodes) {\n      console.log('Workflow included');\n    }\n  }\n}\n```\n\n各メタデータ型の詳細なインターフェース定義については[型ドキュメント](./docs/types.ja.md)を参照してください。\n\n### `RawMetadata`\n\nラウンドトリップ変換のために元のメタデータ構造を保持します。\n\n```typescript\ntype RawMetadata =\n  | { format: 'png'; chunks: PngTextChunk[] }\n  | { format: 'jpeg'; segments: MetadataSegment[] }\n  | { format: 'webp'; segments: MetadataSegment[] };\n```\n\n\u003e [!TIP]\n\u003e TypeScriptユーザー向け：全ての型はエクスポートされており、インポートして使用できます。\n\u003e\n\u003e ```typescript\n\u003e import type { \n\u003e   ParseResult, \n\u003e   GenerationMetadata, \n\u003e   ModelSettings, \n\u003e   SamplingSettings \n\u003e } from '@enslo/sd-metadata';\n\u003e ```\n\u003e\n\u003e IDEのIntelliSenseを使用して自動補完とインラインドキュメントを活用してください。\n\n`ModelSettings`、`SamplingSettings`、フォーマット固有の型を含む全てのエクスポート型の詳細なドキュメントについては、[型ドキュメント](./docs/types.ja.md)を参照してください。\n\n## 開発\n\n```bash\n# 依存関係をインストール\nnpm install\n\n# テストを実行\nnpm test\n\n# ウォッチモード\nnpm run test:watch\n\n# テストカバレッジ\nnpm run test:coverage\n\n# ビルド\nnpm run build\n\n# リント\nnpm run lint\n```\n\n## ライセンス\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fenslo%2Fsd-metadata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fenslo%2Fsd-metadata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fenslo%2Fsd-metadata/lists"}