第一次使用羽集

1. 在电脑上准备 Eagle 和坚果云

1. 安装 Eagle Desktop（使用支持插件的 Eagle 4 或更新版本）。
2. 安装 坚果云桌面客户端，登录你自己的坚果云账号。
3. 在 Eagle 中打开你要在手机浏览的资源库。第一次试用，建议先用一个只有几张图片的测试库。

羽集不提供额外的素材云盘。你的资源库仍保存在自己的电脑和坚果云中。

2. 安装羽集助手

1. 去插件下载页，按电脑系统下载 macOS 或 Windows 包。
2. 解压 ZIP。Mac 在 Finder 中双击解压；Windows 在资源管理器中右键选择“全部解压缩”。
3. 双击解压后的 Feather-0.4.2.eagleplugin，在 Eagle 的安装窗口中确认安装。
4. 打开 Eagle 顶部“插件”菜单，选择“羽集助手”。确认显示的是你当前的资源库，并等待“本地已就绪”。
5. 点击“后台运行”。以后随 Eagle 自动启动，不需要再记住导入、导出按钮。

这是 Eagle 里的插件，不是单独的 Mac 或 Windows 应用；不需要另外安装一个 exe 或 dmg。已经装过旧版的电脑，先看升级步骤。

3. 让坚果云同步整个资源库

1. 为当前 Eagle 的整个 资源库名称.library 文件夹启用同步，不要只选里面的图片文件夹。按电脑系统选择下面的入口：

   

   

   

   点小图可查看原图。选择的是整个 Eagle 资源库文件夹，不是某张图片或网页分享链接。

2. 确认该文件夹能在坚果云网页端看到，并等待桌面客户端显示同步完成。首次同步大库可能较久。
3. 记下资源库在坚果云里的路径。例如网页端显示在“我的坚果云 → 素材 → 演示.library”，手机资源库路径就填 我的坚果云/素材/演示.library。

这里填写的是坚果云里的相对路径，不是电脑上的 /Users/… 或 C:\…，也不是网页分享链接。以你实际 WebDAV 目录中看到的名称和层级为准。

保持桌面 Eagle 与坚果云运行，插件自动准备手机浏览资料、导入手机上传。助手的“本地已就绪”表示电脑准备完成；还要等坚果云把文件同步出去。

4. 在坚果云生成应用密码

1. 在坚果云官网登录，打开“账户信息 → 安全选项 → 第三方应用管理”。
2. 选择添加应用密码，名称可填“羽集”，生成密码并妥善保存。
3. 把这个应用密码用于手机羽集，不要填写坚果云网页登录密码。

如果你的账户没有第三方应用管理或 WebDAV 权限，请先向坚果云确认账户可用性。密码只填进羽集，不要发送给他人或填写在本站。

5. 在 iPhone / iPad 连接资源库

1. 测试用户先安装 Apple 的 TestFlight，通过开发者提供的有效邀请安装羽集。测试邀请请向开发者获取。
2. 打开羽集，点左上角“羽集”进入“设置”。
3. 依次填写下面四项，然后点“验证并连接”。

验证成功后会保存连接并自动读取资源库。无需再单独登录 Eagle 账号。已经保存连接的用户直接升级 App 即可，不要为了更新先卸载手机 App。

6. 日常怎么用

浏览与刷新

用文件夹、标签、类型筛选素材，点卡片查看详情。在网格中双指捏合改变缩略图大小；滑到页面顶部继续下拉，松手后刷新。也可点工具栏刷新按钮。普通上传和刷新在后台进行，想看原因或处理异常时点资源库名称旁的来源标记，打开“同步详情”。

把手机照片放进 Eagle

1. 如果需要指定分类或标签，先选好首页的文件夹和标签筛选。
2. 点顶部加号，选择照片或视频并确认；也可以点旁边的文件按钮选择系统文件。
3. 卡片先带“待导入”角标。保持电脑端 Eagle 和坚果云运行，完成同步后角标消失。

也可以在系统照片或文件的分享菜单中选择“羽集”，再点“收藏”。暂时没看到羽集时，在分享菜单“更多”中找到它。再次收藏完全相同的文件会复用已有素材，只补充分类和标签，保留原名称和注释。

保存与整理

打开素材详情可保存支持的图片、视频到系统照片；首次保存按系统提示授权。文件夹、标签、注释和移入回收站等操作由桌面插件执行，电脑未打开时需要等待。删除会进入 Eagle 可恢复的回收站，操作前仍会要求确认。

多台电脑

每台要处理羽集操作的电脑都安装 0.4.2 插件。坚果云可以一直开着，建议轮流打开 Eagle。发出的任务会等待当时指定的那台电脑，不会自动转交给另一台。先启动原电脑完成待处理任务，再切换使用。

其他电脑：卸载旧插件、安装新版

1. 先让已有同步完成，暂停手机新增操作。
2. 打开 Eagle“插件 → 插件中心”，进入“已安装”。找到旧的“Feather 后台同步服务”或“Feather-Sync-Service”，右键打开菜单，选择移除/卸载。没有这一项就跳过。
3. 旧“Feather”或“羽集助手”优先用新包覆盖更新。如果安装器不能更新，先在“已安装”里移除这一项，再安装新版。不要同时留下新旧两份后台。
4. 完全退出 Eagle，再重新打开。Mac 使用“Eagle → 退出 Eagle”；Windows 用 Eagle 菜单退出，不只是关闭插件窗口。
5. 下载对应系统的包，解压后双击 Feather-0.4.2.eagleplugin，在 Eagle 确认安装或更新。
6. 打开羽集助手，确认只剩一个助手、版本为 0.4.2，并显示“本地已就绪”。手机已有连接不用重填。

只移除插件，不要删除 Eagle 资源库、库内 .feather 文件夹或 Eagle 应用数据中的 FeatherSync 本机执行记录。也不要把 FeatherSync 复制到另一台电脑。历史提示不是让你重新执行旧任务的指令。

不同 Eagle 版本的菜单名称可能略有区别，可对照官方的移除插件说明。卸载插件不会代替你删除或迁移素材。

遇到问题，按顺序看

仍有问题请去技术支持，提供系统、App 和插件版本，以及不含账号密码或私人媒体的错误描述。