更新日誌

Eagle Web API V2 更新日誌，記錄所有重要變更。

在找 V1 API 的更新日誌？請前往舊版 V1 API 文件。

---

V2 API — 首次發布

V2 API（/api/v2/...）是 V1 API 的全面替代版本，基於 Eagle 的 Plugin API 能力所建構。主要功能：

新功能（相比 V1）

• 全文搜尋 — POST /api/v2/item/query 支援進階查詢語法（AND、OR、NOT、片語）

• AI 語義搜尋 — 透過文字描述搜尋（searchByText）、圖片相似度搜尋（searchByBase64、searchByItemId）

• 標籤管理 — 建立、重新命名及合併標籤；管理標籤群組

• 資料夾管理 — 建立、移動、重新命名及整理資料夾

• 自動分頁 — 所有列表端點預設回傳分頁結果（offset / limit）

• 欄位選擇 — 在項目列表中使用 fields 參數，只回傳所需資料

端點

分類	端點
Item	get、query、countAll、add、save、open、select、setCustomThumbnail、refreshThumbnail
Folder	get、create、open、save
Tag	get、getRecentTags、getStarredTags、save、merge
Tag Group	get、create、save、remove、addTags、removeTags
Library	info
App	info
AI Search	isInstalled、isReady、isStarting、isSyncing、getSyncStatus、checkServiceHealth、searchByText、searchByBase64、searchByItemId

分頁

所有列表端點使用自動分頁：

• 預設限制：50

• 最大限制：1000

• 回應中包含 total、offset 和 limit 中繼資料