> 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/shi-pu/build-week-audio-navigation.md).

# Build Week：音频引导的候选人筛选

Build Week 扩展给本地 CLI 和 MCP 服务器增加了第二个机械信号：一个归一化的音频活动带，它与视觉单元处于同一绝对源时间线。它只回答一个问题——**什么时候需要更仔细地查看？**——但并不声称能理解声音。

## 在事件之前已经存在的内容

Squish 已经生成了带时间戳的联系表，并支持迭代 `开始`/`结束` 缩放。这些绝对时间码以及总览 → 缩放循环是基础，不是 Build Week 的工作。

## Build Week 新增了什么

* 一个跨整段 clip 的 `clip_peak` 音频活动带，位于本地 CLI/MCP 表格上；
* 附加的绝对时间 `audio.samples[]` 元数据；
* 保留短时和高频活动；
* 测试、文档，以及一个音频引导的候选项选择工作流。

这表示的是能量，不是含义。没有转录、声音事件标签、说话人分离，也没有情绪推断。公开版本在完整源片段上使用同一参考尺度；不会在共享尺度下比较不同文件。

## 两层证明

**叙述性证明。** 公开演示使用经所有者授权的摄像头录像：22 个视觉上重复的一分钟片段、一个音频引导的候选范围，以及一张高密度视觉缩放图，确认有人短暂出现在门口边缘。这段录像是私密的，不对外分发。

**可复现证明。** 公共仓库中包含一个生成的 24 秒 fixture，位于 `examples/audio-navigation/`。它在普通总览中视觉上保持静止，包含一个短暂的音频瞬变，并在紧接着短暂显示一个粉色标记。

```bash
git clone https://github.com/getsquish/squish.git
cd squish
./examples/audio-navigation/generate-sample.sh

npx -y @getsquish/squish@0.3.1 \\
  examples/audio-navigation/sample.mp4 \\
  --json \\
  --out /tmp/squish-audio-overview

npx -y @getsquish/squish@0.3.1 \\
  examples/audio-navigation/sample.mp4 \\
  --density 6x6 \\
  --start 11.5 \\
  --end 13.5 \\
  --json \\
  --out /tmp/squish-audio-zoom
```

先读总览。只用音频活动来提出 `11.5–13.5 秒` 邻域，然后检查密集视觉表以确认标记何时出现。索引只是提出建议；放大的图像才是证明。


---

# 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/shi-pu/build-week-audio-navigation.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.