素材
当前可从“照片”或“文件”导入常见图片与视频。图片包括 JPEG、PNG、GIF、BMP、TIFF、WebP、HEIC/HEIF；视频包括 MP4、MOV、M4V。能否预览还会受到系统解码能力影响。
Guide
使用文档
Shadow 是面向 iPhone 和 iPad 的视觉素材库：你可以收集图片与视频，用文件夹、标签、备注、评分和颜色建立自己的整理体系，并在本地、外接存储或受支持的云盘中继续使用。Shadow 也兼容 Eagle 素材库格式，让电脑上的资料能够自然延伸到移动端。
快速开始
第一次使用时，不必先理解所有兼容和同步细节。按下面的路径完成一个最小工作流即可：
- 打开 Shadow。应用会提供一个可直接使用的默认素材库；你也可以新建或打开其他素材库。
- 从“照片”或“文件”导入几张图片或一段视频。
- 创建一个文件夹，把素材移动或添加进去，再为素材补充标签和备注。
- 用搜索入口输入文件名、标签或备注中的词，再尝试颜色、形状、评分和格式筛选。
- 确认本地工作流符合预期后，再连接已有 Eagle library，或百度网盘、Google Drive 中的云素材库。
手机与平板的入口不同，能力基本一致
iPhone 以首页、分类页和底部工具栏为主；iPad 以侧边栏、素材网格和详情面板为主。本文会在操作步骤中分别说明。
1. 基本介绍
Shadow 的重点不是把文件简单堆在一起，而是让素材在移动设备上仍然可浏览、可检索、可整理、可迁移。它既可以独立创建素材库，也可以读取和写入兼容的 Eagle library；对于大型远端资料，还可以先导入索引，再按需获取缩略图和原图。
1.1 核心概念
素材库
素材原文件与文件夹、标签、备注、评分、来源链接等整理信息的集合。一个项目、一个客户或一个长期主题都可以单独建库。
索引
Shadow 为素材建立的可检索信息，包括素材清单、文件夹关系和元数据。云素材库先导入索引，不等于已经下载全部原图。
缓存
为提高云端浏览速度而保存在设备上的缩略图或原图副本。清理缓存通常不会删除云端文件，但“重置本地索引”会清除未同步的本地修改记录。
1.2 与 Eagle 工作流的关系
Shadow 兼容 Eagle 的 `.library` 目录结构和 `.eaglepack` 交换包。已有 Eagle 用户可以在电脑端继续大规模采集与整理，在移动端完成查找、演示、审阅和轻量编辑；没有使用过 Eagle 的用户则可以把 Shadow 当作独立的素材管理工具。
- 可读取素材、文件夹层级、标签组与标签、备注、评分、来源链接和已有颜色信息。
- 支持打开本地或外接存储中的完整 `.library`，并可导入、导出 `.eaglepack`。
- 对具备写入权限的素材库，可编辑名称、备注、来源链接、标签、评分和所属文件夹。
- 写入会尽量保持 Eagle 数据结构兼容，但 Eagle 格式可能随版本变化；重要库应先备份和小范围验证。
独立开发说明
Shadow 不是 Eagle 官方产品。文档中的 Eagle 名称仅用于说明文件格式兼容和工作流互操作；重要资料不要把“兼容”理解为无需备份的绝对保证。
1.3 Shadow 的扩展与独特价值
真正的移动端入口
针对 iPhone 单手浏览与 iPad 大屏工作分别设计界面，适合通勤检索、现场选片、会议演示和沙发整理。
无需 Eagle 也能开始
应用内可以直接创建和管理素材库；Eagle 格式是兼容能力，不是使用门槛。
大库按需访问
云素材库先建立索引和缩略图，再按需缓存原图，减少整库占满手机或平板空间的压力。
2. 素材来源说明
“素材来源”包含两层含义：素材库保存在哪里，以及新素材从哪里加入当前库。先选对素材库位置，再决定导入方式。
| 素材库来源 | 适合场景 | 主要特点 | 注意事项 |
|---|---|---|---|
| Shadow 默认素材库 | 第一次使用、随手收藏、稳定离线访问 | 由应用管理，始终保留在素材库列表中 | 占用设备空间；定期导出备份 |
| 本地或外接存储 | 新建独立库、打开已有 `.library`、大容量移动硬盘 | 速度稳定，可直接读写完整库 | 不要在读写时拔出设备；确认文件系统可写 |
| 百度网盘 | 跨设备访问、大型资料库、按需加载原图 | 先导入索引，缩略图和原图按需缓存，修改后手动同步 | 依赖网络、对应账号授权和服务接口状态 |
| Google Drive | 跨设备访问、大型资料库、按需加载原图 | 先导入索引，缩略图和原图按需缓存，修改后手动同步 | 依赖网络、对应账号授权和服务接口状态 |
可加入当前素材库的内容
- 照片：从系统照片选择图片或视频。
- 文件：从系统文件选择受支持的图片、视频，或选择本地文件夹批量导入。
- 云盘：从已连接的百度网盘或 Google Drive 选择素材或文件夹；大型任务会显示导入进度。
- Eaglepack：导入 `.eaglepack`，将其中的素材和文件夹结构合并进当前库。
导入意味着把内容纳入当前素材库并建立可检索信息，不只是临时打开文件。批量导入、云端下载和索引建立都可能需要时间。
3. 主要功能和操作指南
3.1 素材库的创建和打开
创建本地素材库：
- 打开素材库菜单，选择“创建素材库”。
- 选择本地来源，输入便于识别的名称，并在系统文件界面选择保存位置。
- 创建完成后进入空库，再通过添加入口导入素材或文件夹。
创建云盘素材库：选择百度网盘或 Google Drive 并指定云端位置后，Shadow 会先在设备上创建一份可编辑的本地工作副本。素材库会在第一次同步时真正创建到云盘，后续修改也通过手动同步写回远端。
打开已有本地素材库：
- 选择“打开素材库”与本地来源。
- 在系统文件界面选择完整的 `.library` 包，不要进入包内只选 `metadata.json` 或 `images` 文件夹。
- 等待 Shadow 读取结构并建立索引。首次打开大库会比再次进入耗时更长。
导入已有云盘素材库：连接百度网盘或 Google Drive，在 Shadow 的云端目录浏览器中选择包含 `metadata.json` 和 `images` 的完整 `.library` 目录，然后启动导入。开始前可以决定导入完成后是否自动打开该库；未完成的库会在素材库列表中显示继续导入入口。
素材库列表操作
你可以切换、更新和重命名素材库。本地库还可导出素材或完整 `.library`。将库“从列表移除”只会移除 Shadow 保存的入口，不会删除原位置的素材库；默认素材库不能移除。
3.2 添加素材
- 进入目标素材库和目标文件夹；如果没有合适分类，可先新建文件夹。
- 点击添加按钮，选择“照片”“文件”“导入文件夹”或“导入 Eaglepack”。
- 完成系统选择或云端选择，保持 App 运行并观察导入进度。
- 导入完成后检查失败提示；云端文件夹导入可能出现部分成功，可按提示重试剩余项目。
导入到某个文件夹时，素材仍属于整个素材库，只是同时记录了该文件夹归属。同一素材可以被添加到多个文件夹；“移动到”会替换原文件夹归属，“添加到”会保留原归属。
不要在导入中途强制退出
App 内的任务可以继续显示进度，但这不等同于系统保证在强制退出后仍执行。大量导入时建议连接稳定网络和电源，待任务明确完成后再关闭 App。
3.3 素材浏览与详情
iPhone
首页提供全部素材预览、快捷分类、文件夹和回收站。进入分类后用底部“浏览工具”调整筛选，用“搜索”查找；点击素材进入全屏详情。
iPad
侧边栏集中显示全部素材、收藏、标签、文件夹、未分类和回收站；主区域为素材网格，详情页利用大屏同时展示预览和信息面板。
- 网格浏览：按文件夹或快捷分类查看缩略图；云端缩略图首次出现时需要网络。
- 详情预览：查看图片或播放视频；图片可缩放、拖动和旋转预览，并可前后切换素材。
- 信息面板：查看名称、尺寸、格式、标签、文件夹、评分、备注、来源链接和颜色等信息。
- 分享与保存：可通过系统分享，或在系统允许时保存到照片。云端原图会先下载到本地缓存。
- 收藏：便于在本设备快速回看。收藏记录保存在 Shadow 的设备本地偏好中，不写入 Eagle 元数据，也不会自动同步到另一台设备。
3.4 搜索与筛选
关键词搜索会匹配素材名称、原始文件名、标签和备注。手机端可以搜索全部素材，也可以从某个分类进入后只搜索当前范围。
| 条件 | 用途 | 操作提示 |
|---|---|---|
| 关键词 | 按名称、标签或备注定位 | 先用短而明确的词；不支持时再换同义标签 |
| 标签 | 按主题、用途、项目或风格筛选 | 可以选择多个标签，条件越多结果通常越少 |
| 颜色 | 寻找主色接近的图片 | 可选择颜色或输入 Hex，并调整匹配精度 |
| 形状 | 筛选横图、竖图或方图 | 适合版式、封面和屏幕比例选材 |
| 评分 | 查看达到某星级或尚未评分的素材 | 星级条件按最低评分筛选 |
| 格式 | 只看某些图片或视频扩展名 | 格式列表来自当前素材库 |
推荐顺序：先确认搜索范围，再输入关键词，然后增加一到两个筛选条件。如果结果为空，先“清除全部条件”，再逐项恢复，以便找出限制过严的条件。
3.5 整理与编辑
- 单个素材：在详情页编辑名称、备注、来源链接、标签、评分和所属文件夹。字段停止修改约一段时间后自动保存；离开前留意保存状态。
- 批量选择：长按或进入选择模式后，可移动到文件夹、添加到更多文件夹、添加标签、收藏、导出或移入回收站。
- 文件夹管理：创建、重命名、调整层级与顺序。删除或重组前先确认其中素材的最终归属。
- 标签管理：创建标签组和标签，并维护已有名称。未分类标签来源于素材本身，空的未分类标签不能脱离素材单独保存。
- 回收站：删除先进入回收站；可通过重新指定文件夹恢复。清空回收站是永久删除，无法撤销。
如果当前素材库没有写入权限，或云端状态不允许安全修改，编辑操作会被禁用或提示先处理同步。不要绕过提示直接在“文件”App 中同时改动库内部结构。
3.6 备份、导出与同步
完整素材库备份
本地库可导出完整 `.library`，保留原文件和整理信息。适合迁移、归档和在重要操作前创建恢复点。
素材或 Eaglepack
可导出选中素材的原文件，或打包为 `.eaglepack` 与兼容工作流交换。云素材库的批量导出可能受缓存和当前能力限制。
云端同步
同步是把本地修改发布到远端；更新素材库是读取远端变化并重建本地索引。两者方向不同，不能互相替代。
- 重要素材库至少保留一份与工作副本分离、可验证打开的备份。
- 外接存储读写时不要拔出；云端同步完成前不要在另一设备继续编辑。
- 第一次用 Shadow 写入既有 Eagle library 时，先复制一个小型测试库验证桌面端读取结果。
4. 云素材库补充说明
4.1 为什么支持云素材库
云素材库不只是节省设备空间，也是实现多端素材管理的有效路径。远端素材库作为各设备共同使用的数据源，Shadow 再通过明确的“同步”和“更新素材库”动作控制数据方向，让 iPhone、iPad 与电脑端能够按顺序交接编辑结果。
多端一致性
在当前设备完成编辑后执行“同步”，把本地修改发布到云端；另一台设备开始工作前执行“更新素材库”，读取远端最新状态。它不是无感的实时双向同步，而是一套方向清晰、冲突可检查的多端协作节奏。
大库按需访问
Shadow 将云端访问拆为索引、缩略图和原图三层。先下载体积较小的索引建立文件夹结构与搜索能力，浏览时按需获取缩略图，只有查看、分享或编辑具体素材时才下载原图。
与挂载盘或网盘同步目录的区别
Eagle 和许多素材管理工具可以打开位于 iCloud、网盘同步目录或挂载盘中的素材库。这是一种成熟、直观的桌面工作流，文件会由系统或网盘客户端在本地提供给应用读取。Shadow 面向移动设备采用另一种方式：直接通过网盘接口建立索引并按需下载缩略图和原图，不要求先把完整素材库落地到设备。设备上仍会保留必要的本地索引和已访问内容缓存；需要离线使用的原图也必须提前缓存。
为什么 Shadow 直接连接云盘
直接连接百度网盘和 Google Drive，让 Shadow 能同时管理“下载什么”和“如何同步”：索引、缩略图与原图可以分层缓存，用户可以查看和清理各类占用；标签、文件夹、元数据和素材文件的修改则作为素材库操作写回远端。另一台设备执行“更新素材库”后，可以读取这些远端变化并重建本地索引。
因此，云端库既保持与兼容桌面工作流互通，也能在 iPhone 和 iPad 上成为一份可按需浏览、可编辑、可更新的云素材库。这不是后台无感的实时同步：Shadow 使用明确的“同步”和“更新素材库”动作控制方向、展示进度并检查潜在冲突。
4.2 支持的网盘厂商
- 百度网盘：当前正式可用，支持授权、原生目录浏览、创建或选择远端素材库、导入索引、按需缓存以及手动同步。
- Google Drive：当前正式可用，支持授权、原生目录浏览、创建或选择远端素材库、导入索引、按需缓存以及手动同步。
连接百度网盘或 Google Drive 时，Shadow 会在你授予的范围内浏览根目录、定位已有 `.library`、读取其后代文件，并创建或同步素材库内容。该访问只用于用户主动执行的素材库操作，文件不会传输到 Shadow 自有服务器。
4.3 同步、更新与一致性
| 动作 | 数据方向 | 什么时候使用 |
|---|---|---|
| 导入 | 云端 → 本地索引 | 第一次连接远端库；建立结构、素材清单和必要缓存 |
| 更新素材库 | 云端 → 本地索引 | 其他设备已经修改远端库，需要在 Shadow 读取最新状态 |
| 同步 | 本地修改 → 云端 | 在 Shadow 中编辑后，把待发布修改写回网盘 |
Shadow 不是实时双向同步盘。同步前会检查本地修改、远端状态和潜在冲突；如果远端在本地工作期间发生变化，应用可能要求你选择保留云端版本，或用本地版本继续覆盖。包含当前版本无法安全执行的远端删除或结构变化时，以同步预览和提示为准。
先同步，再更新
存在未同步本地修改时，“更新素材库”可能被阻止，以免远端索引覆盖本地工作。先完成同步或妥善处理冲突，再读取远端新状态。
4.4 缓存管理
在“设置 → 云端原图缓存上限”中可调整原图缓存容量，默认值为 10 GB。该上限控制设备空间使用，不限制云端素材库大小。进入某个云素材库的缓存管理页，还可以分别查看或清理索引、缩略图和原图。
- 清理原图：保留索引、元数据和缩略图；下次查看完整素材时重新下载。
- 清理缩略图：保留索引和已缓存原图；网格和封面需要重新获取或生成缩略图。
- 重置本地索引：删除该云素材库在设备上的索引、镜像、同步状态和缓存，然后重新导入。未同步的本地修改记录也会被清除，操作前必须确认。
普通缓存清理不会删除网盘中的原文件。若只是设备空间紧张，优先清理原图；只有索引明显异常、重复失败且已确认没有未同步修改时，才重置本地索引。
4.5 多端管理的推荐流程
- 选择一台设备作为当前编辑端，其他设备暂时只浏览。
- 在编辑端完成一组小而完整的修改，例如整理一个文件夹或一批标签。
- 在 Shadow 中检查同步预览并完成同步，等待状态明确显示成功。
- 如果电脑端还使用网盘客户端，等待网盘客户端完成本地同步后，再用 Eagle 打开。
- 另一台 iPhone 或 iPad 进入同一库时，先“更新素材库”，确认新状态后再开始下一轮编辑。
最稳妥的原则是“单端写入、完成同步、另一端更新”。不要让 Eagle、两台 Shadow 设备和网盘客户端同时修改同一素材库。
5. 故障排查
素材库打不开或导入后是空的
确认选择的是完整 `.library` 目录，其中应包含有效的 `metadata.json` 和 `images`。检查外接设备是否仍连接、目录是否被移动、文件权限是否可用。云端库还要确认授权没有过期；未完成导入时，从素材库列表选择“继续导入云端索引”。
首次导入很慢，或者进度长时间不变
大库需要遍历元数据并建立索引，百度网盘和 Google Drive 都会受到网络及厂商接口状态影响。保持 App 在前台、网络稳定并连接电源；若明确报错，记录失败阶段后重试，不要反复重置索引。
缩略图空白，原图一直加载
先确认网络可用且对应的百度网盘或 Google Drive 账号仍已授权。首次显示会下载或生成缓存；可以退出当前详情后重试。若只有个别文件失败，检查远端原文件是否仍存在；若整库持续异常，再考虑清理缩略图缓存，而不是直接重置索引。
搜索不到明明存在的素材
关键词只匹配名称、原始文件名、标签和备注。先检查当前搜索范围，再清除颜色、标签、形状、评分和格式条件。云端库若刚在其他设备修改，需要先更新素材库索引。
编辑按钮不可用或修改无法保存
检查素材库是否具有写入权限、外接存储是否只读，以及云素材库是否存在同步冲突或未完成任务。详情页采用延迟自动保存，连续编辑后稍等并观察保存状态再离开。
为什么另一台设备看不到收藏
收藏是 Shadow 在当前设备保存的快捷偏好，不属于 Eagle 素材元数据，因此不会随素材库或云盘同步。需要跨设备保留的分类，请使用文件夹、标签或评分。
同步失败或出现冲突
不要同时在另一设备继续编辑。先恢复网络并重试，让已完成项目保留；出现冲突时根据最新可信副本选择云端或本地版本。若不确定，先复制或导出可恢复备份，再处理冲突。
缓存占用过大
在设置中降低云端原图缓存上限，或在对应云素材库中清理原图。清理原图不影响索引和云端文件，只会让下次查看完整素材时重新下载。
如何提交有效的问题反馈
访问 支持页面，附上 Shadow 版本、iOS/iPadOS 版本、设备型号、素材库来源、素材库规模、是否使用云盘、出现问题前后的操作步骤、错误提示和截图。涉及特定素材时，可说明格式与大小，但不要发送含隐私的原文件。