更新日志

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

重要提醒：Eagle 4.0 Build12 预计近期发布，目前尚未正式推出。在此页面看到标注需要 Eagle 4.0 Build12+ 的新 API 功能，请等待正式版本发布后才能使用。

2025年8月21日

💻 App API 增强

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

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

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

console.log(eagle.app.userDataPath);
// "C:\Users\User\AppData\Roaming\Eagle"

2025年8月19日

📁 Folder API 增强

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

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

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

// 移动到其他父文件夹
folder.parent = 'parent_folder_id';
await folder.save();

// 移动到根目录  
folder.parent = null;
await folder.save();

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

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

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

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

folder.iconColor = eagle.folder.IconColor.Blue;
await folder.save();

2025年8月13日

🏷️ Tag API 功能扩展

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

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

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

  • 新增 Tag 实例属性：name（可修改）、count、color、groups、pinyin

// 过滤标签
const filteredTags = await eagle.tag.get({ name: "design" });

// 修改标签名称  
tag.name = 'new-name';
await tag.save();

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

2025年8月5日

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

新增功能：性能优化

// 只返回需要的字段
let items = await eagle.item.get({
    tags: ["Design"],
    fields: ["id", "name", "tags", "modifiedAt"]
});

// 高效增量同步
let fileInfo = await eagle.item.getIdsWithModifiedAt();

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

let count = await eagle.item.count({ isSelected: true });
await eagle.item.select(['ITEM_ID_1', 'ITEM_ID_2']);

增强功能：open() 方法

await eagle.item.open('item_id', { window: true });

2025年7月31日

🪟 Window API 扩展

新增功能：窗口几何控制

await eagle.window.getSize();
await eagle.window.setBounds({ x: 440, y: 225, width: 800, height: 600 });
await eagle.window.getBounds();

2024年11月28日

🏷️ TagGroup CRUD 操作

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

// 创建标签分组
await eagle.tagGroup.create({
    name: "new group",
    color: "red", 
    tags: ["tag1", "tag2"]
});

// 修改并保存
tagGroup.name = "new name";
await tagGroup.save();

// 删除分组
await tagGroup.remove();

🗑️ Item 删除功能

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

let item = await eagle.item.getById('item_id');
await item.moveToTrash();

2024年7月25日

🪟 Window API 增强

新增功能：HTTP Referer 设置

eagle.window.setReferer("https://example.com");

2024年5月10日

🖱️ Context Menu API

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

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

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

eagle.contextMenu.open([
    {
        id: "edit",
        label: "编辑",
        submenu: [...],
        click: () => { ... }
    }
]);

🪟 Window API 截图功能

新增功能：页面截图

// 全屏截图
const image = await eagle.window.capturePage();

// 指定区域截图
const image2 = await eagle.window.capturePage({ 
    x: 0, y: 0, width: 100, height: 50 
});

2024年4月17日

🔍 预览插件功能增强

新增功能：缩放控制参数

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

"thumbnail": {
    "path": "thumbnail/icns.js",
    "size": 400,
    "allowZoom": false
}
上一页AI SDK

最后更新于