更新日志

Eagle Plugin API 更新日志,记录自第一个 Plugin API 版本后的所有重要功能变更。

circle-info

已更新:Eagle 4.0 Build12 已正式发布。本文中标注「Eagle 4.0 Build12+」的功能现已可用。 若您仍使用旧版本,请先升级至 4.0 build12 或更高版本。

2026年1月22日

💻 App API 增强

新增功能:显示主窗口 (Eagle 4.0 build18+)

triangle-exclamation
  • 新增 eagle.app.show() 方法,让插件可以将 Eagle 主应用程序窗口唤起并显示在画面最上方

// 将 Eagle 主窗口显示在最上方
await eagle.app.show();

📄 Item API 增强

新增功能:修改导入时间 (Eagle 4.0 build18+)

triangle-exclamation
  • item.importedAt 属性现在支持修改,让插件可以自定义文件的导入时间

  • 适用于批量导入历史文件、数据迁移等需要保留原始时间戳的场景

// 修改导入时间
item.importedAt = new Date('2024-01-01').getTime();
await item.save();

2026年1月9日

🔍 AI Search 语意搜索 API

新增功能:AI 语意搜索整合 (Eagle 4.0 build18+)

triangle-exclamation
  • 新增 eagle.extraModule.aiSearch 模块,提供 AI 语意搜索功能

  • 状态查询方法

    • isInstalled() - 检查 AI Search 插件是否已安装

    • isReady() - 检查服务是否就绪

    • isStarting() - 检查服务是否正在启动中

    • isSyncing() - 检查是否正在同步数据

  • 服务控制方法

    • open() - 打开 AI Search 插件

    • checkServiceHealth() - 检查服务健康状态

    • getSyncStatus() - 获取详细的同步状态

  • 搜索方法

    • searchByText(query, options) - 文字语意搜索

    • searchByBase64(base64, options) - Base64 图片搜索

    • searchByItemId(itemId, options) - 以项目 ID 搜索相似图片

2026年1月8日

🏷️ TagGroup/Tag API 增量操作方法

新增功能:标签群组增量操作 (Eagle 4.0 build18+)

🏷️ TagGroup API 增强

新增功能:标签群组描述属性 (Eagle 4.0 build18+)

  • tagGroup 新增 description 属性,可为标签群组添加描述文字

  • 支持在 create()save() 方法中设置描述

2026年1月6日

🏷️ Tag API 增强

新增功能:获取常用标签 (Eagle 4.0 build18+)

文档修正

2025年8月21日

💻 App API 增强

新增功能:app.userDataPath 属性 (Eagle 4.0 build12+)

  • 新增 app.userDataPath 属性,返回当前用户数据目录的路径

  • 提供快速访问 Eagle 用户数据存储位置的途径

2025年8月19日

📁 Folder API 增强

新增功能:文件夹 parent 属性可修改 (Eagle 4.0 build12+)

  • 新增 folder.parent 属性修改支持,允许动态调整文件夹层级结构

  • 支持将文件夹移动到不同父目录或根目录

新增功能:文件夹 iconColor 属性可修改 (Eagle 4.0 build12+)

  • folder.iconColor 属性从只读变更为可修改

  • 新增 eagle.folder.IconColor 静态常量对象,提供预定义颜色选项

  • 支持的颜色:Red, Orange, Yellow, Green, Aqua, Blue, Purple, Pink

2025年8月13日

🏷️ Tag API 功能扩展

新增功能:标签过滤和 Tag 类增强

  • eagle.tag.get() 方法新增 name 参数,支持按名称模糊搜索标签

  • Tag 实例新增 save() 方法,支持修改标签名称

  • 新增 Tag 实例属性:name(可修改)、countcolorgroupspinyin

⚠️ 注意:修改标签名称会自动更新所有使用该标签的文件

2025年8月5日

📄 Item API 性能和选择功能大幅增强

新增功能:性能优化

新增功能:计数和选择方法

增强功能:open() 方法

2025年7月31日

🪟 Window API 扩展

新增功能:窗口几何控制

2024年11月28日

🏷️ TagGroup CRUD 操作

新增功能:完整的标签分组管理

🗑️ Item 删除功能

新增功能:文件回收站操作

2024年7月25日

🪟 Window API 增强

新增功能:HTTP Referer 设置

2024年5月10日

🖱️ Context Menu API

新增功能:自定义右键菜单

  • 新增 eagle.contextMenu.open() 方法,支持自定义右键菜单

  • 支持多层级子菜单、自定义点击事件、系统原生样式

🪟 Window API 截图功能

新增功能:页面截图

2024年4月17日

🔍 预览插件功能增强

新增功能:缩放控制参数

  • 预览插件配置新增 allowZoom 参数,控制是否允许用户缩放预览内容

最后更新于