From 01e3f8f8fd6dacc5eed214ed4b505d6d85f4bcff Mon Sep 17 00:00:00 2001
From: Draculabo <a1842298680@gmail.com>
Date: Sun, 25 Jan 2026 17:47:13 +0800
Subject: [PATCH] docs: add macOS self-signing workaround for Keychain issues

---
 README.md       | 18 ++++++++++++++++++
 README.zh-CN.md | 18 ++++++++++++++++++
 2 files changed, 36 insertions(+)

diff --git a/README.md b/README.md
index 7e5d490..b487142 100644
--- a/README.md
+++ b/README.md
@@ -280,6 +280,24 @@ Please check:
 
 </details>
 
+<details>
+<summary><b>Q: macOS shows Keychain/Credential error and OAuth cannot be saved?</b></summary>
+
+This is a common macOS security behavior, usually when the app is unsigned or run directly from Downloads.
+This is a **temporary workaround** for personal use:
+
+1. Move the app to `/Applications`
+2. Run the following commands in Terminal (repeat after every update)
+
+```plaintext
+sudo xattr -dr com.apple.quarantine "/Applications/Antigravity Manager 2.app"
+codesign --force --deep --sign - "/Applications/Antigravity Manager 2.app"
+```
+
+Reopen the app and allow Keychain access if prompted.
+
+</details>
+
 <details>
 <summary><b>Q: How to report issues or suggestions?</b></summary>
 
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 09f3c40..91aa81d 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -280,6 +280,24 @@ AntigravityManager/
 
 </details>
 
+<details>
+<summary><b>Q: macOS 上提示 Keychain/凭据管理不可用，OAuth 无法保存？</b></summary>
+
+这是 macOS 安全机制导致的常见问题，通常出现在未签名的应用或从 Downloads 直接运行的场景。
+这是**临时方案**，仅适合个人设备：
+
+1. 将应用移动到 `/Applications`
+2. 打开终端执行以下命令（每次更新后都需要重新执行）
+
+```plaintext
+sudo xattr -dr com.apple.quarantine "/Applications/Antigravity Manager 2.app"
+codesign --force --deep --sign - "/Applications/Antigravity Manager 2.app"
+```
+
+重新打开应用后，Keychain 应会提示授权（可选“始终允许”）。
+
+</details>
+
 <details>
 <summary><b>Q: 如何反馈问题或建议？</b></summary>