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

# แผ่นภาพรวม

ชีตภาพรวมเป็นรูปแบบหน้าของพื้นที่ที่อยู่ของ 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/th/the-primitive/the-navigation-loop.md)).

## เป็นชั้นการนำทาง ไม่ใช่ผลลัพธ์

ทำไมต้องใช้ชีตภาพรวมแทนคีย์เฟรมที่ดึงออกมาหรือสรุปเป็นข้อความ?

* **เทียบกับคีย์เฟรม:** การดึงคีย์เฟรมจะได้ภาพนิ่งแยกกันเป็นกอง; ลำดับและเวลาอาจหายไปถ้าไม่จดกำกับเอง และไฟล์สิบกว่าชิ้นก็เท่ากับเสียบริบทไปสิบกว่าภาพ ชีตภาพรวมรวมลำดับและเวลาไว้ในภาพเดียว — ครอบคลุมเท่าเดิม วางทีเดียว ทุกเฟรมยังคงมีที่อยู่ของตัวเอง
* **เทียบกับสรุป:** สรุปคือ *ผลลัพธ์* ของการให้เหตุผล — ผ่านการตีความแล้ว จึงอาจพลาดหรือแต่งเติมรายละเอียดได้ และไม่มีข้อมูลจริงให้ตรวจสอบ *ข้อมูลนำเข้า* สำหรับการให้เหตุผล: เฟรมจริงตามลำดับพร้อมรหัสเวลา คำตอบที่ได้จากชีตสามารถอ้างอิงเวลาและตรวจสอบกับพิกเซลได้ รูปแบบที่เชื่อถือได้คือใช้ชีตก่อน แล้วค่อยสรุป — เพื่อให้สรุปยึดโยงกับเฟรมที่ชี้กลับไปหาได้

ประเด็นที่ลึกกว่านั้น: **ชีตไม่ใช่งานส่ง**. มันเป็นชั้นการนำทางของพื้นที่ที่อยู่ที่อธิบายไว้ใน [วิดีโอในฐานะพื้นที่ที่อยู่](/squish/th/the-primitive/video-as-address-space.md). คำตอบของโมเดลคือผลลัพธ์; ชีตคือแผนที่ที่ใช้ในการนำทาง

## ข้อกำหนดมาตรฐาน

ทุกอย่างในหน้านี้เป็นแนวคิด รูปแบบที่แน่นอน — เรขาคณิตของเลย์เอาต์ กฎความละเอียดของรหัสเวลา การวางแผนหลายชีต และสัญญา JSON ที่มาพร้อมกับแต่ละรัน — ถูกกำหนดไว้ตามมาตรฐานใน [ข้อกำหนดรูปแบบชีต](/squish/th/reference/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/th/the-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.