From 8d71d5d6b0fd38ee566d5f91226816cc40476318 Mon Sep 17 00:00:00 2001
From: t8y2 <1156263951@qq.com>
Date: Wed, 29 Apr 2026 18:24:56 +0800
Subject: [PATCH] docs: add install instructions and macOS unsigned app note

---
 README.md       | 14 ++++++++++++++
 README.zh-CN.md | 14 ++++++++++++++
 2 files changed, 28 insertions(+)

diff --git a/README.md b/README.md
index 83cb3f45d..926da08b1 100644
--- a/README.md
+++ b/README.md
@@ -63,6 +63,20 @@ pnpm tauri build
 
 The installer will be in `src-tauri/target/release/bundle/`.
 
+## Install
+
+Download the latest release from the [Releases](https://github.com/t8y2/dbx/releases) page.
+
+### macOS Note
+
+DBX is not signed with an Apple Developer certificate. On first launch, macOS will block the app. To fix this:
+
+```bash
+xattr -cr /Applications/dbx.app
+```
+
+Or: **System Settings → Privacy & Security → Open Anyway**.
+
 ## Tech Stack
 
 | Layer | Technology |
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 437390e98..a478ac20e 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -63,6 +63,20 @@ pnpm tauri build
 
 安装包输出在 `src-tauri/target/release/bundle/` 目录。
 
+## 安装
+
+从 [Releases](https://github.com/t8y2/dbx/releases) 页面下载最新版本。
+
+### macOS 说明
+
+DBX 未使用 Apple 开发者证书签名，首次打开时 macOS 会阻止运行。解决方法：
+
+```bash
+xattr -cr /Applications/dbx.app
+```
+
+或者：**系统设置 → 隐私与安全性 → 仍要打开**。
+
 ## 技术栈
 
 | 层级 | 技术 |