diff --git a/docs/installation.md b/docs/installation.md
index 0e0850e..f36d2e1 100644
--- a/docs/installation.md
+++ b/docs/installation.md
@@ -49,6 +49,7 @@
 ### macOS client
 
 - 目录：`platforms/macos/client/`
+- 详细安装/构建说明：参见 `platforms/macos/README.md` 与 `platforms/macos/client/README.md`
 - 当前可判断的环境要求：
   - macOS 15.0+
   - Xcode 15+ 或等效 Swift toolchain
diff --git a/platforms/macos/README.md b/platforms/macos/README.md
index 4ad6206..3bb41f6 100644
--- a/platforms/macos/README.md
+++ b/platforms/macos/README.md
@@ -47,6 +47,11 @@ The macOS baseline is still in an early post-migration state. Source, project fi
 - Historical macOS repositories may be retained temporarily during migration
 - macOS source is kept separate from Windows code and is not mixed into `platforms/windows/`
 
+### Installation docs
+
+- Repository-level installation overview: `docs/installation.md`
+- macOS client build/package details: `platforms/macos/client/README.md`
+
 ---
 
 # 简体中文
@@ -93,3 +98,8 @@ macOS 客户端源码已迁入 `platforms/macos/client/`。
 - macOS 安装包应通过 GitHub Releases 分发
 - 迁移过程中，历史 macOS 仓库可能会暂时保留
 - macOS 源码不会混入 `platforms/windows/`
+
+### 安装文档入口
+
+- 仓库级安装总览：`docs/installation.md`
+- macOS 客户端构建与打包细节：`platforms/macos/client/README.md`