diff --git a/CHANGELOG.md b/CHANGELOG.md
index d7d912f..ffb5ddc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,14 +4,22 @@ All notable user-facing changes to QOpen are documented here.
 
 ## [Unreleased]
 
+## [2.5.2] - 2026-09-18
+
 ### Fixed
 
-- Recovered the plugin directory from the plugin's own entry point URL when
-  Omarchy 4.0.3+ strips `__sourceDir` from third-party manifests, restoring the
-  catalog on shells that sanitize plugin manifests.
-- Derived the fallback plugin root by removing the complete menu entry-point
-  path, so backend lookup remains correct if the entry point moves into a
-  subdirectory.
+- Restored catalog loading on Omarchy versions that sanitize third-party
+  plugin manifests and no longer expose the internal `__sourceDir` field.
+- Resolved the plugin directory through Omarchy's scoped
+  `pluginRegistry.entryPointUrl(...)` API when `__sourceDir` is unavailable,
+  keeping the old manifest path for backward compatibility.
+- Stripped the complete menu entry-point path when deriving the plugin root,
+  so backend lookup stays correct if the QML entry point later moves into a
+  subdirectory such as `ui/QOpen.qml`.
+- Rejected non-`file://` entry-point URLs when deriving the local backend
+  path.
+- Required no migration or replacement of `~/.config/qopen/config.json`;
+  the personal catalog remains untouched by plugin updates.
 
 ## [2.5.1] - 2026-08-28
 
diff --git a/README.md b/README.md
index 507a616..7cd0ec2 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@ regrouped or removed by you.
 > 而是把项目目录、文件、常用文档、前端生态网站、TUI、命令和 SSH 目标集中到
 > 一个支持搜索、分组、收藏与原生编辑的界面中。
 
-Current release: **2.5.1**
+Current release: **2.5.2**
 
 **Documentation:** [简体中文](README.zh-CN.md) · [Development record](DEVELOPMENT.md)
 
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 7d46eb4..2f23b86 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -6,7 +6,7 @@ QOpen 是运行在 [Omarchy](https://omarchy.org/) 上的个人资源启动器
 
 > English summary: QOpen is a curated personal resource launcher for Omarchy. It brings projects, files, documentation, web tools, TUI applications, commands and SSH destinations into one searchable interface with grouping, favorites and native editing.
 
-当前版本：**2.5.1**
+当前版本：**2.5.2**
 
 **文档：** [English](README.md) · [开发记录](DEVELOPMENT.md)
 
diff --git a/bin/qopen b/bin/qopen
index 743aca0..9096f90 100755
--- a/bin/qopen
+++ b/bin/qopen
@@ -27,7 +27,7 @@ from pathlib import Path
 from typing import Any, Callable
 
 
-VERSION = "2.5.1"
+VERSION = "2.5.2"
 DEFAULT_CONFIG_PATH = Path("~/.config/qopen/config.json").expanduser()
 CONFIG_PATH = Path(os.path.expandvars(os.environ.get(
     "QOPEN_CONFIG", str(DEFAULT_CONFIG_PATH)
diff --git a/manifest.json b/manifest.json
index e1539ab..3f356a9 100644
--- a/manifest.json
+++ b/manifest.json
@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "id": "qopen.launcher",
   "name": "QOpen",
-  "version": "2.5.1",
+  "version": "2.5.2",
   "author": "CoderLambert",
   "description": "Unified launcher for web, files, projects, TUI tools, commands and SSH targets",
   "kinds": [