> 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/privacy-and-data-flow.md).

# 隐私与数据流

Squish 在三个不同的位置处理视频，而且不同路径下的隐私说明也不同。不要把它们混为一谈：“什么都不会上传”只对本地路径成立。

## 三种处理路径

| 路径                                                  | 视频在哪里处理               | 上传？                  | 成本与账户                                          |
| --------------------------------------------------- | --------------------- | -------------------- | ---------------------------------------------- |
| **Web 应用** — [getsquish.app](https://getsquish.app) | 在你的浏览器中，客户端侧          | 不上传媒体                | 免费 `3x3` 表页，无需账户；更高密度 `4x4`–`6x6` 是一次性的 Pro 升级 |
| **CLI + MCP** — `@getsquish/squish`                 | 在你的机器上（Node + ffmpeg） | 绝不会上传任何内容            | 所有密度都免费，无需账户，永远不设限制                            |
| **托管 API** — `api.getsquish.app`                    | 在 Squish 的服务器上        | **一次有意的上传**，通过已认证的请求 | 预付积分，按每个输出表页计费                                 |

## 本地处理：没有任何内容离开你的机器

CLI 和 MCP server 使用的是同一个开源引擎（Apache-2.0），完全运行在你的机器上：帧会用你自己的 ffmpeg 提取，sheet 会写到输入文件旁边（或者放在 `--out` 指向的位置）。绝不会将任何视频、帧或 sheet 上传到 Squish。没有账户，也不会对任何密度做限制。由于引擎是开源的，这一点是可验证的，不只是承诺。先从 [CLI 快速入门](/squish/zh/ru-men/quickstart-cli.md) 或者 [MCP 快速入门](/squish/zh/ru-men/quickstart-mcp.md).

位于 [getsquish.app](https://getsquish.app) 的网页应用遵循同样的原则，但运行环境不同：视频会在你的浏览器中解码，sheet 也会在客户端侧渲染。不上传媒体。

## 托管路径：你的字节会发生什么

托管 API 是为那些无法运行本地工具的工作流准备的——CI、无服务器环境、托管代理、需要请求/响应通道的产品。把一个剪辑发送到那里是一种 **有意的上传** ，通过已认证的请求——发往一个 **计算服务，而不是存储服务**。一次同步请求就是整个任务（上传、处理、响应），它涉及的两类数据分别走不同的轨道：

```
已上传的视频 ──► 处理中 ──► 任务结束时立即删除
                       │           （成功或失败）
                       ▼
              生成的 sheets ──► 临时缓存（约 24 小时） ──► 自动过期
```

* **已上传的视频** 只为承载它的那次请求而存在：任务结束时立即删除，无论成功还是失败。绝不保留，绝不用来训练，也没有媒体库。
* **生成的 sheets** 在能力 URL 上作为临时缓存存在——大约保留 24 小时，方便你下载或重新获取这些 URL，然后它们就会过期并自动删除。缓存不是存储：想保留的内容请自己下载。
* 认证使用 bearer key；只会存储该 key 的 SHA-256 哈希值——明文只显示一次，之后无法找回，只能替换。

需要更强的保障？在本地运行 Squish——CLI 和 MCP server 永远不会上传你的视频（见 [本地处理](#local-processing-nothing-leaves-your-machine)).

完整的请求/响应细节在 [托管 API 参考](/squish/zh/can-kao/http-api.md) 以及 [API 快速入门](/squish/zh/ru-men/quickstart-api.md).

## 付费边界

以本地优先是一个设计决定，而不是一个定价层级。本地工具并不是托管 API 的试用版——它们就是完整引擎，所有密度都具备，永远不设限制。在引擎的各个界面中，付费边界只有一件事： **你的字节是否会离开你的机器**。在你自己的硬件上处理是免费的；在 Squish 的硬件上处理则需要预付积分（从未购买过的账户会获得少量免费的每日额度）。如果隐私是限制条件，答案始终一样：留在本地，整个引擎都能提供给你。


---

# 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/privacy-and-data-flow.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.