diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..b634d85
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1 @@
+*.pdf filter=lfs diff=lfs merge=lfs -text
diff --git a/README.CN.md b/README.CN.md
index 3b5d4ee..57419cb 100644
--- a/README.CN.md
+++ b/README.CN.md
@@ -24,6 +24,8 @@ Distillation）等误差缓解技术。其模块化设计支持独立使用各
 
 了解更多请访问 **[qc.zdxlz.com/cqlib](https://qc.zdxlz.com/cqlib)**。
 
+**[阅读白皮书](docs/whitepaper/Cqlib.pdf)** —— 一份文档讲清 Cqlib 的设计理念、系统架构与技术细节。
+
 ## 核心特性
 
 - **量子线路构建** — 直观的 API 用于构建、组合和参数化量子线路
diff --git a/README.md b/README.md
index 61968e9..46adcea 100644
--- a/README.md
+++ b/README.md
@@ -28,6 +28,8 @@ education, and integration into larger software stacks.
 
 Learn more at **[qc.zdxlz.com/cqlib](https://qc.zdxlz.com/cqlib)**.
 
+**[Read the Whitepaper](docs/whitepaper/Cqlib.pdf)** — Cqlib's design philosophy, architecture, and technical details in one document.
+
 ## Features
 
 - **Circuit Construction** — Intuitive APIs to build, compose, and parameterize quantum circuits
diff --git a/docs/whitepaper/Cqlib.pdf b/docs/whitepaper/Cqlib.pdf
index 16b3089..4ead2db 100644
Binary files a/docs/whitepaper/Cqlib.pdf and b/docs/whitepaper/Cqlib.pdf differ