> For the complete documentation index, see [llms.txt](https://tinyhumans.gitbook.io/openhuman/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/documents.md).

# 文档

可写入 .docx 和 .pptx 文件，也可读回 PDF、Word、PowerPoint 和 Excel 文件，并明确列出所有限制。

两种工具会写出人可以打开的文件，而摄取路径会把常见的办公格式再读入。两者都运行在一个单独的可加载模块中，而不是在应用本身里。

## 写入

| 工具                      | 生成                                     |
| ----------------------- | -------------------------------------- |
| `generate_document`     | A `.docx` 基于结构化规范：标题、作者、标题级、段落和项目符号列表。 |
| `generate_presentation` | A `.pptx` 基于幻灯片：标题、项目符号和图片。            |

在写入任何内容之前都会检查规范。限制是契约的一部分：

| `.docx`         | 限制        |
| --------------- | --------- |
| 节               | 128       |
| 每节段落数           | 200       |
| 每节项目符号数         | 200       |
| 每个标题、作者或标题级的字符数 | 2,000     |
| 每个段落的字符数        | 20,000    |
| 总字符数            | 2,000,000 |

| `.pptx`     | 限制    |
| ----------- | ----- |
| 幻灯片         | 64    |
| 每张幻灯片的项目符号数 | 32    |
| 每个文本字段的字符数  | 2,000 |
| 每张幻灯片的图片数   | 6     |
| 每个演示文稿的图片数  | 8     |
| 每张图片的字节数    | 5 MiB |

总字符上限是最重要的。如果没有它，节数乘以段落数再乘以每段字符数，会允许生成一个没有任何读者能打开的规范。

完成的文件会作为 [产物](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/chat.md)送达。它会出现在线程的文件面板中，可下载并可在文件夹中显示。

## 读取

附加一个文件，或者指向一个 [内存来源](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/memory.md) ，摄取路径就会提取其中的文本。每一段文本都会保留其来源：PDF 的页码，或 Office 文件的部分路径。

| 格式             | 说明                                                                                  |
| -------------- | ----------------------------------------------------------------------------------- |
| PDF            | 最多 4,096 个源页面。没有文本层的页面会保留并标记为扫描候选。该标记表示建议使用视觉识别，并不表示一定需要 OCR。                       |
| DOCX、PPTX、XLSX | 幻灯片和工作表的顺序来自文件自身的清单，因此未被引用的幻灯片会被排除，不会根据文件名去猜测。电子表格会读取共享字符串和内联字符串，并使用缓存的单元格值。公式绝不执行。 |

限制为输入 64 MiB、256 个结果节，以及输出 200,000 字节文本。结果会说明是否被截断。文本绝不会在字符中间被切断。将 PDF 页面渲染为图像是按每页可选启用的，每次调用最多 8 页，最长边最多 2,048 像素。

提取过程中不会将任何内容写入磁盘，不会启动任何 Office 应用程序，也没有网络 OCR。

## 运行位置

文档处理发生在 `tinydocs` 模块中。它是一个已签名的原生库，首次使用时下载，并会与 OpenHuman 中固定的 SHA-256 进行校验。文档写入器、PDF 和 Office 阅读器，以及图像检查，都不属于任何构建中的应用自身代码。关闭 `文档` 功能后，生成工具将不存在，PDF/Office 提取和图像检查也将不可用。

## 另请参见

* [图像和视频生成](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/media-generation.md)：生成文件的其他工具。
* [内存](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/memory.md)：如果你把文档作为来源添加，它最终会落在这里。
* [可加载模块](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/loadable-modules.md)：模块如何被固定并加载。
