文档附件
您可以将图片和文件直接附加到任意文档页面。把截图拖进编辑器，它会以内联方式嵌入；附加 PDF、规范文档或压缩包，它会显示为可下载的卡片。文件保存在对象存储中——绝不会让数据库膨胀——并且无论页面在哪里被查看或分享，附件都会随页面一起呈现。
添加附件
在编辑器中打开文档页面（新建文档 或 编辑），然后用最顺手的方式添加文件：
- 将一个或多个文件拖放到编辑器上
- 直接从剪贴板粘贴图片（例如截图）
- 点击编辑器工具栏中的 附件 并选择文件
您可以一次附加多个文件。新文档会在您第一次附加文件时自动保存，因此上传的内容永远不会丢失。
图片与文件
Archyl 会按您预期的方式处理这两种情况：
- 图片 会在您添加的位置以内联方式嵌入 Markdown，直接在页面中显示。
- 其他文件（PDF、文档、压缩包等）会作为可下载的卡片添加到 附件 面板中，而不是插入正文。
查看附件
阅读页面时，附件显示在文档顶部的附件面板中，就在标题下方——读者无需滚动就能看到有哪些文件可用。每个文件会显示：
- 按颜色区分的类型图标，或图片缩略图
- 文件名、类型和大小
- 一键下载操作
图片还会在您放置的位置以内联方式显示在正文中。
管理附件
在编辑器中，您可以通过附件面板：
- 下载 任意文件
- 删除 文件（带有快速的内联确认）——这也会将其从存储中移除
删除文档时，其附件也会一并删除。
支持的文件
您可以附加任意类型的文件。图片以内联方式嵌入，其他所有文件都显示为可下载的卡片。常见示例：
- 图片 —— PNG、JPEG、GIF、WebP、SVG、AVIF
- 文档 —— PDF、Word、Excel、PowerPoint、纯文本、Markdown、CSV
- 数据与压缩包 —— JSON、YAML、ZIP、日志
默认上限为每个文件 10 MB（自托管实例可配置）。
提示： 即使浏览器无法识别某种文件类型，该文件仍会被接受，并以下载形式提供。
存储与隐私
附件保存在对象存储中，而不是应用数据库中。在 Archyl Cloud 上，存储由 Google Cloud Storage 提供——由我们为您管理，无需任何配置。在自托管实例上，您可以选择自己的兼容 S3 的存储服务（见下文）。
无论哪种方式：
- 存储桶是私有的。文件通过按需生成的短期签名链接提供——底层对象永远无法被公开列出。
- 嵌入页面的链接保持稳定，因此分享的文档和公开文档可以正常使用，而不会暴露存储桶。
- 静态加密默认开启。Google Cloud Storage 会自动加密每个对象；在自托管实例上，您还可以使用自己的密钥（例如在 GCS 上使用 Cloud KMS CMEK）。
自托管实例
在 Archyl Cloud 上，附件功能开箱即用。如果您自托管，则需要自备对象存储——您可以让 Archyl 使用任何兼容 S3 的存储服务（Google Cloud Storage、Amazon S3、MinIO、Cloudflare R2 等）。
在配置存储之前，附件 操作不可用，上传会返回明确的 "File storage is not configured" 提示。在后端设置 STORAGE_* 环境变量（endpoint、bucket、access key、secret key）即可启用该功能；对于 Google Cloud Storage，请使用互操作性（HMAC）端点。完整的选项列表请参阅您的部署配置。