上传与关联
通过编辑器添加附件，或在附件页面管理文件。离开流程前先确认上传完成。文件大小受实例设置限制，也可能受反向代理限制。大文件失败时，先检查这两层配置，不要反复盲目重试。
关联是明确的操作
API 可以创建文件，并设置笔记的附件列表。SetMemoAttachments 替换整个列表，而不是追加一项，调用时应提交期望的完整集合。省略已有附件会删除元数据并执行存储文件清理；空集合会移除全部附件。替换前请保留备份。文件读取仍要求对应笔记或文件的访问授权，知道附件 URL 并不等于拥有通用访问权限。
保留可恢复副本
数据库记录与本地或 S3 文件字节可能分开保存。即使元数据还在，底层文件缺失也会导致不可用。备份应覆盖两者，恢复后下载样本进行验证。从笔记中移除附件可能删除附件本身，不应视作可逆的解除关联。
从上传到下载验证一个附件
准备一个包含唯一文本行的小文件，新建私人笔记，通过编辑器附件控件加入文件，等待上传结束后保存笔记。刷新后从已保存笔记打开并下载附件，比较那行文本。往返验证成功前保留本地原文件。文件上传成功不等于关联到笔记及保存步骤也成功。
安全处理上传中断
标签页关闭或网络中断后，先重新打开笔记检查已有附件列表，再决定是否重传。413 通常与应用或代理大小限制有关。笔记可读而文件不可用，应检查存储对象或连接；另一个账号被拒则应另查权限。不要为了重试下载而移除已有附件，因为移除可能删除元数据及实际文件。
完整保留 Live Photo 的两个成员
通过 API 替换笔记附件列表时，先检查附件分组，再构建目标集合。已有 APPLE_LIVE_PHOTO 配对应当完整保留，或明确完整移除。如果只请求保留其中一个成员，笔记替换逻辑会把不完整配对从保留集合中移除；更新成功时可能删除两个成员，包括你以为保留的那个。这与专用附件删除端点拒绝部分分组删除不同。应保留两个附件资源名，并核对返回的完整集合后，再处理备份。