> 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/zh/primitive/the-contact-sheet.md).

# contact sheet

联系表是 Squish 地址空间的页面格式： **一张图像，其中包含一个按时间范围采样的帧网格，每个单元格都标注其绝对时间码**。它是视觉模型真正读取的产物——一眼看完整个范围，按事件发生的顺序呈现。

## 一张表的结构

* **帧会在请求的时间范围内均匀采样** ——默认是整个片段，或者一个 `开始`/`结束` 窗口。
* **单元格按时间顺序排列，从左到右、从上到下。** 相邻单元格看起来相似，说明那个间隔里几乎没有变化；如果单元格之间出现明显的视觉断裂，通常就是某个事件发生的地方。
* **每个单元格都会带一个时间码标记** ——也就是该帧来自的那个时刻（`0:14`, `1:07.3`）。时间码始终相对于源视频是绝对的，即使在窗口内也是如此，所以从表里读出的任何内容都可以被引用，或者作为新的 `开始`/`结束`.
* **长视频会生成多个文件**，命名为 `<basename>.sheet-N.jpg`。每张表覆盖片段中连续的一段窗口；请按顺序阅读。时长决定表的数量；密度决定每张表包含多少帧。
* **帧仍然是视觉证据。** CLI/本地 MCP 0.3+ 可能会添加一个对齐的音频活动带，但它只承载能量信息——没有语音、转录内容或声音身份。托管的表在单独发布前仍然只包含视觉内容。

## 密度就是时间分辨率

密度就是网格大小——一张表从其窗口中采样多少帧。它是时间分辨率的调节旋钮，不是图像质量：

| 密度         | 每张表的单元格数 |
| ---------- | -------: |
| `3x3` （默认） |        9 |
| `4x4`      |       16 |
| `5x5`      |       25 |
| `6x6`      |       36 |

默认设置 `3x3` 还原 **发生了什么** ——片段的故事。更高密度的 `4x4`–`6x6` 网格还原 **事情是怎么发生的** ——节拍之间的步骤。表是一个序列地图，不是动作的替代品：采样之间发生的事件是看不见的，而更密的网格只会缩小这些间隔，并不会把它们消除。如果某个特定间隔很重要，不要给整个片段提高密度——而是用一个 `开始`/`结束` 窗口来放大这个间隔（[导航循环](/squish/zh/primitive/the-navigation-loop.md)).

## 是一个导航层，而不是输出

为什么要用 contact sheet，而不是提取关键帧或文本摘要？

* **相比关键帧：** 关键帧提取会返回一堆彼此独立的静态图；除非手动记录，否则它们的顺序和时间戳都会丢失，而十几个文件就意味着十几张缺少上下文的图。contact sheet 把顺序和时间一次性编码进一张图里——相同覆盖范围，只需一页，每一帧都保留自己的地址。
* **相比摘要：** 摘要是 *输出* 推理的产物——已经被解释过，可能遗漏或编造细节，而且没有可对照的真实依据。contact sheet 是 *输入* 给推理的：真实帧，按顺序排列，并带有时间戳。基于表得到的答案可以引用时间戳，也可以用像素内容来核验。可靠的流程是先看表，再做摘要——这样摘要就建立在它能够指向的帧之上。

更深一层的重点： **表不是最终交付物**。它是 [视频作为地址空间](/squish/zh/primitive/video-as-address-space.md)中所描述地址空间的导航层。模型的回答才是输出；表只是它用来导航的地图。

## 规范性说明

本页上的所有内容都是概念性的。确切格式——布局几何、时间码精度规则、多表规划，以及每次运行所附带的 JSON 契约——都在 [表格式规范](/squish/zh/can-kao/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/zh/primitive/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.