附件和卡牌引用的关系
图片、音频、视频、PDF 和其他文件保存在当前牌组的附件资源库中。卡牌字段保存文件名或资源引用，用于在预览和学习时加载文件。同一个附件可以被多张卡牌、多个字段重复使用。
因此有两个容易混淆的概念：
- 附件存在：资源库中有记录或文件。
- 附件被引用：至少一处卡牌内容仍然使用它。
文件存在不等于正在使用；引用仍在也不等于本机文件一定完整。删除或清理前必须同时检查引用数量和附件状态。
支持格式和单文件限制
| 类型 | 支持格式 | 普通用户 | PLUS | 处理方式 |
|---|---|---|---|---|
| 图片 | JPG、JPEG、PNG、GIF | 5 MB | 10 MB | 非 GIF 原图最高可选择 30 MB；超过会员直接保存上限时自动压缩并转为 JPEG。GIF 不自动压缩。 |
| 音频 | MP3、M4A、AAC、WAV、OGG、OPUS | 20 MB | 30 MB | 不符合格式或大小时拒绝添加。 |
| 视频 | 编辑器文件选择器允许的常见视频格式 | 100 MB | 大文件导入和同步耗时更长。 | |
| PDF 和其他附件 | 编辑器允许选择的文件 | 100 MB | 预览能力取决于文件类型；接收方需要相应软件。 | |
非 GIF 图片超过 5 MB 或 10 MB 的会员上限、但不超过 30 MB 时，编辑器可以压缩到当前上限并保存为 JPEG。透明背景可能因此发生变化；动图 GIF 不会自动压缩。
在卡牌中插入附件
- 打开目标卡牌和字段。把光标放在媒体应该出现的位置。
- 选择对应工具。图片、音频、视频或文件应使用字段允许的功能；如果按钮不存在，先检查模板字段权限。
- 选择文件。确认格式、大小、内容和文件名。
- 等待处理完成。图片可能压缩，资源需要写入牌组；不要连续选择同一文件。
- 检查字段和预览。确认图片方向与清晰度、音频播放、视频打开和文件链接。
- 保存卡牌。附件添加成功不等于卡牌引用已经保存。
- 检查同步状态。保存后切换到“附件管理”，确认资源没有处于“缺失”或“异常”。
从“附件管理”添加文件
“附件管理”支持拖放文件或选择“添加附件”，适合先批量准备资源。添加前会校验格式和大小；如果一批文件中有不符合要求的项目，界面会显示拒绝数量，并询问是否继续添加其余文件。
批量导入可能出现部分成功。结果会说明最终得到多少附件以及自动压缩了多少张图片；出现错误时，也可能已经导入了前面的文件。先刷新列表核对，再重试失败文件。
从“附件管理”添加文件只准备附件。仍需在卡牌字段中写入或插入正确引用并保存卡牌。
搜索、筛选、预览和状态
附件列表可按文件名搜索，并按类型筛选。每一项会显示文件名、类型、大小、引用数和状态。操作菜单支持预览或播放、复制文件名和删除。
| 状态 | 含义 | 建议 |
|---|---|---|
| 本地 | 本机文件可用，尚未同步到云端 | 等待同步完成后再换设备 |
| 云端 | 附件仅在云端 | 预览时会尝试下载；保持网络稳定 |
| 已同步 | 本地和云端均可用 | 仍需根据引用数判断能否删除 |
| 缺失 | 附件文件缺失 | 检查同步、重新下载或补回正确文件 |
| 未登记 | 文件和附件记录没有正确对应 | 先执行安全检查，不直接批量删除 |
| 异常 | 状态或类型无法正常识别 | 停止继续修改，重启后仍异常再反馈 |
“复制文件名”适合在表格或字段引用中复用准确名称。不要在系统文件管理器中直接重命名牌组资源文件，因为原有卡牌引用不会随外部改名自动更新。
替换和删除附件
安全替换
- 添加新附件。保留旧文件，不先删除。
- 修改所有相关卡牌。把旧引用替换为新文件名并保存。
- 验证实际播放或预览。抽查不同模板和设备。
- 检查旧附件引用数。确认已经没有需要保留的引用。
- 删除旧附件。阅读确认窗口后执行。
删除附件
确认窗口会明确提示“被多少处引用”。继续删除会让这些位置缺图、无法播放或无法下载。正确做法是取消删除，先处理引用。
删除过程中如果本地文件和附件记录无法同时更新，系统会尝试恢复；若提示本地文件未能恢复，应停止继续清理，重启记乎桌面版后再检查。
清理和导出附件
“附件操作”中的“清理附件”会检查资源引用并清理确认无用的数据，同时更新引用计数。清理结果会显示删除多少项、更新多少项引用计数。
- 大规模编辑、模板迁移或表格导入正在进行时不要清理。
- 先等待同步，再记录清理前附件数量。
- 清理结束后检查包含图片、音频和视频的代表性卡牌。
- 结果明显异常时不要连续再次清理。
“导出附件”可以按附件类型选择并打包为 ZIP。导出结果会区分已导出和跳过数量；导出文件适合备查或迁移资源，但不能替代牌组数据和学习记录的同步。
表格导入的资源目录
表格导入支持选择配套资源目录。普通字段可使用 (example-audio.mp3) 或 [audio:example-audio.mp3] 插入内联资源；图片、音频、视频和文件字段也可填写相对路径。
| 规则 | 限制或行为 |
|---|---|
| 文件数量 | 单次最多 5000 个文件 |
| 目录总大小 | 单次最多 200 MB |
| 单文件 | 仍受图片、音频、视频或其他附件单文件限制 |
| 路径 | 必须是所选资源目录内的安全相对路径 |
| 匹配 | 文件名、扩展名、大小写和相对路径应与表格内容一致 |
预检发现缺失资源时，先修正路径或补齐文件。不要通过选择另一个含有大量同名文件的目录来碰运气。
完成后的检查
- 新添加附件可在卡牌实际预览中显示或播放。
- 卡牌已经保存，而不是只有编辑窗口中的临时引用。
- 附件列表中的状态符合预期，没有新增“缺失”或“异常”。
- 替换旧附件后，旧文件引用数已经降到可安全删除的范围。
- 批量添加、清理或导出时记录了成功、跳过和失败数量。
- 同步完成后，在另一设备打开代表性媒体卡牌。
常见问题
图片为什么变成 JPEG 或失去透明背景？
非 GIF 图片超过会员直接保存上限时可能自动压缩并转为 JPEG。需要透明背景时，先把图片处理到上限以内再添加。
附件在列表里，卡牌为什么不显示？
检查字段是否引用准确文件名、卡牌是否已经保存，以及附件是否为“缺失”或仅“云端”状态。
音频为什么无法播放？
确认格式和文件没有损坏；若状态为“云端”，保持网络稳定并等待下载。仍失败时重新添加经过验证的音频文件。
删除按钮为什么提示仍有引用？
至少一处卡牌内容仍使用该附件。取消删除，通过卡牌搜索、导出或已知模板逐项替换引用。