> For the complete documentation index, see [llms.txt](https://getsquish.gitbook.io/squish/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://getsquish.gitbook.io/squish/ja/purimitibu/the-contact-sheet.md).

# Contact Sheet

コンタクトシートは、Squish のアドレス空間におけるページ形式です： **ある時間範囲にわたってサンプリングされたフレームのグリッドを含む1枚の画像で、各セルには絶対タイムコードが付与されます**. これは、ビジョンモデルが実際に読むアーティファクトです — その全範囲を、一目で、発生順に確認できます。

## シートの構成

* **フレームは、要求された時間範囲全体にわたって均等にサンプリングされます** — デフォルトではクリップ全体、または `開始`/`終了` のウィンドウです。
* **セルは時間順に、左→右、上→下へ並びます。** 隣接するセルが似て見える場合、その間隔では変化が少なかったことを意味します。セル間に明確な視覚的断絶がある箇所でイベントが発生しています。
* **各セルにはタイムコードのピルが付きます** — そのフレームの元となった時点（`0:14`, `1:07.3`）。タイムコードは、ウィンドウ内であっても常に元動画に対する絶対値です。そのため、シートから読み取った内容は引用したり、新しい `開始`/`終了`.
* **長い動画では複数のファイルが生成されます**、名前は `<basename>.sheet-N.jpg`です。各シートはクリップの連続したウィンドウをカバーします。順番に読み取ってください。長さによってシート数が決まり、密度によって各シートに含まれるフレーム数が決まります。
* **フレームは引き続き視覚的な証拠です。** CLI/ローカル MCP 0.3+ では、整列した音声アクティビティ帯が追加される場合がありますが、含まれるのはエネルギー情報のみです — 音声、文字起こし、音源識別情報はありません。ホスト型シートは、別途公開されるまでは視覚情報のみのままです。

## 密度は時間解像度です

密度はグリッドサイズ、つまり1枚のシートがそのウィンドウから何フレームをサンプリングするかを表します。これは画像品質ではなく、時間解像度を調整するための指標です：

| 密度            | シートあたりのセル数 |
| ------------- | ---------: |
| `3x3` （デフォルト） |          9 |
| `4x4`         |         16 |
| `5x5`         |         25 |
| `6x6`         |         36 |

デフォルト設定では `3x3` 再現します **何が起きたか** — クリップの物語です。より密な `4x4`–`6x6` グリッドは再現します **どのように行われたか** — 山場の間の手順です。シートはシーケンスの地図であり、動きの代替ではありません。サンプル間のイベントは見えず、より密なグリッドでもその隙間は小さくなるだけで、なくなりはしません。特定の隙間が重要な場合は、クリップ全体の密度を上げるのではなく、そこで `開始`/`終了` ウィンドウで拡大してください（[ナビゲーションのループ](/squish/ja/purimitibu/the-navigation-loop.md)).

## 出力ではなく、ナビゲーション層

なぜ抽出したキーフレームやテキスト要約ではなく、コンタクトシートなのですか？

* **キーフレームと比べると：** キーフレーム抽出では、ばらばらの静止画が大量に返ります。手動で追跡しない限り順序やタイムスタンプは失われ、12個のファイルは12枚分の文脈コストになります。コンタクトシートは順序と時間を1枚の画像に埋め込みます — 同じ範囲を、1回の貼り付けで、各フレームのアドレスを保ったまま扱えます。
* **要約と比べると：** 要約は *出力* 推論の結果です — すでに解釈されており、詳細を見落としたり作り出したりする可能性があり、照合できる正解データもありません。コンタクトシートは *入力* 推論への入力です。実際のフレームが、順序どおりに、タイムスタンプ付きで並んでいます。シートから導かれた回答はタイムスタンプを引用でき、ピクセルと照合して検証できます。信頼できる流れは、まずシート、次に要約です — こうすることで、要約は参照可能なフレームに根ざします。

さらに重要なのは： **シート自体は納品物ではありません**。これは、で説明されるアドレス空間のナビゲーション層です [アドレス空間としての動画](/squish/ja/purimitibu/video-as-address-space.md)。モデルの回答が出力であり、シートはその際に使った地図です。

## 規範仕様

このページの内容はすべて概念的なものです。正確な形式 — レイアウト幾何、タイムコード精度のルール、複数シートの計画、および各実行に付随する JSON 契約 — は、以下で規範的に定義されています： [シート形式仕様](/squish/ja/rifarensu/sheet-format.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://getsquish.gitbook.io/squish/ja/purimitibu/the-contact-sheet.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.