> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/rpicn/readme.md).

# Raspberry Pi 树莓派中文文档

本文档是 [Raspberry Pi Documentation](https://www.raspberrypi.com/documentation/) 的简体中文翻译版本。

[**点击此处浏览目录**](https://book.bsdcn.org/rpicn/mu-lu.md)

## PDF 文档

> **PDF 文档**
>
> * 使用由 [safreya](https://github.com/safreya) 提供的脚本：
>
> > <https://github.com/FreeBSD-Ask/gitbook-pdf-export>
> >
> > 可用于导出本书的 PDF 文档。该脚本使用 Python 3 编写，仅在 Windows 10、FreeBSD 14 上测试过。
> >
> > 具体使用方法见该项目的 README。

## 关于我们

本项目由 FreeBSD 中文社区发起。

如有问题请 PR 或 Issue。

## 版本说明

**2026-10-20 起全部页面同步至** [**树莓派官方文档**](https://raspberrypi.com/documentation) **当前版本**（英文原版 GitHub `master` 分支）。

翻译进度、校对标准与项目结构见 [AGENTS.md](https://github.com/taophilosophy/rpicn/tree/main/AGENTS.md)，编辑历史见[编辑日志](https://book.bsdcn.org/rpicn/qian-yan/changelog.md)。

## 参与贡献

本项目欢迎 PR 与 Issue。翻译规范、上游追踪方法与用词约定请见[贡献指南](https://github.com/taophilosophy/rpicn/tree/main/CONTRIBUTING.md)，行为准则见[行为准则](https://github.com/taophilosophy/rpicn/tree/main/CODE_OF_CONDUCT.md)。

有权限协作的译者请注意：开工前必读[仓库约定](https://github.com/taophilosophy/rpicn/tree/main/AGENTS.md)，其中包含当前进度快照、项目结构、术语规范与下次同步上游的完整流程。

## 版权说明

[树莓派官方文档](https://raspberrypi.com/documentation)使用 [Creative Commons Attribution-ShareAlike 4.0 International](http://creativecommons.org/licenses/by-sa/4.0/)（CC BY-SA 4.0，署名-相同方式共享 4.0 国际）授权。非常抱歉，根据协议要求，本项目也只能使用 [Creative Commons Attribution-ShareAlike 4.0 International](http://creativecommons.org/licenses/by-sa/4.0/)（CC BY-SA 4.0，署名-相同方式共享 4.0 国际）及兼容的协议（兼容协议要求与该协议基本相同）进行授权。该协议要求您：

* 您必须给出适当的署名 ，提供指向本许可协议的链接，同时标明是否（对原始作品）作了修改。树莓派官方英文文档项目位于 <https://github.com/raspberrypi/documentation>。**我们特别授予所有人免于对本项目进行署名及链接的权利。但是您仍然需要遵守**[**树莓派文档项目**](https://github.com/raspberrypi/documentation)**本身的许可协议。**
* 相同方式共享 — 如果您再混合、转换或者基于本作品进行创作，您必须基于与原先许可协议相同的许可协议分发您贡献的作品。

> Raspberry Pi documentation is copyright © 2012-2024 Raspberry Pi Ltd and is licensed under a Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA) licence.
>
> Some content originates from the eLinux wiki, and is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported licence.
>
> The terms HDMI, HDMI High-Definition Multimedia Interface, HDMI trade dress and the HDMI Logos are trademarks or registered trademarks of HDMI Licensing Administrator, Inc


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://book.bsdcn.org/rpicn/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
