diff --git a/AGENTS.md b/AGENTS.md
index 44037792..397a9d7b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -9,7 +9,7 @@
 ```
 [ ] Zotero 已安装 + Better BibTeX 插件已启用
 [ ] Obsidian 已打开当前 Vault
-[ ] PaperForge 已安装 (pip install git+https://github.com/LLLin000/PaperForge.git)
+[ ] PaperForge 已安装 (pip install paperforge)
 [ ] PaddleOCR API Key 已配置（在 .env 中）
 [ ] 目录结构已创建（安装向导会自动完成）
 [ ] Zotero 数据目录已链接到 <system_dir>/Zotero
@@ -498,7 +498,7 @@ paperforge update
 
 **pip 安装用户：**
 ```bash
-pip install --upgrade git+https://github.com/LLLin000/PaperForge.git
+pip install --upgrade paperforge
 ```
 
 **pip editable / git clone 用户：**
diff --git a/INSTALLATION.md b/INSTALLATION.md
index 6a771b77..3710ca1b 100644
--- a/INSTALLATION.md
+++ b/INSTALLATION.md
@@ -19,7 +19,7 @@
 ## Method 2: CLI via pip (Developers)
 
 ```bash
-pip install git+https://github.com/LLLin000/PaperForge.git
+pip install paperforge
 ```
 
 Then run the headless setup:
@@ -31,7 +31,7 @@ python -m paperforge setup --headless --agent opencode --paddleocr-key <key>
 For the latest stable release, replace `master` with a version tag:
 
 ```bash
-pip install git+https://github.com/LLLin000/PaperForge.git@v1.4.17rc3
+pip install paperforge==1.5.2
 ```
 
 ---
diff --git a/README.en.md b/README.en.md
index 051178bd..5a9258df 100644
--- a/README.en.md
+++ b/README.en.md
@@ -262,7 +262,7 @@ BRAT auto-detects plugin updates. For the Python package:
 ```bash
 paperforge update
 # or
-pip install --upgrade git+https://github.com/LLLin000/PaperForge.git
+pip install --upgrade paperforge
 ```
 
 ---
diff --git a/README.md b/README.md
index 651cf77e..f873a015 100644
--- a/README.md
+++ b/README.md
@@ -262,7 +262,7 @@ BRAT 会自动检测插件更新。Python 包更新：
 ```bash
 paperforge update
 # 或
-pip install --upgrade git+https://github.com/LLLin000/PaperForge.git
+pip install --upgrade paperforge
 ```
 
 ---
diff --git a/docs/ai-agent-setup-guide-zh.md b/docs/ai-agent-setup-guide-zh.md
index d73e7342..7875da95 100644
--- a/docs/ai-agent-setup-guide-zh.md
+++ b/docs/ai-agent-setup-guide-zh.md
@@ -131,11 +131,11 @@ python --version
 ### Step 2: 安装 paperforge 包
 
 ```bash
-pip install git+https://github.com/LLLin000/PaperForge.git
+pip install paperforge
 ```
 
 - 成功 → "paperforge 已安装"，继续 Step 3
-- 权限错误 → 重试：`pip install --user git+https://github.com/LLLin000/PaperForge.git`
+- 权限错误 → 重试：`pip install --user paperforge`
 - 其他错误 → 把错误信息展示给用户，**停止**
 
 ---
@@ -275,7 +275,7 @@ python -m paperforge status
 
 加 `--user`：
 ```bash
-pip install --user git+https://github.com/LLLin000/PaperForge.git
+pip install --user paperforge
 ```
 
 ### 用户已经装过 PaperForge（升级场景）
diff --git a/docs/ai-agent-setup-guide.md b/docs/ai-agent-setup-guide.md
index 823d5836..c06f4416 100644
--- a/docs/ai-agent-setup-guide.md
+++ b/docs/ai-agent-setup-guide.md
@@ -131,11 +131,11 @@ python --version
 ### Step 2: Install paperforge package
 
 ```bash
-pip install git+https://github.com/LLLin000/PaperForge.git
+pip install paperforge
 ```
 
 - Success → "paperforge installed." Proceed to Step 3.
-- Permission error → retry: `pip install --user git+https://github.com/LLLin000/PaperForge.git`
+- Permission error → retry: `pip install --user paperforge`
 - Other errors → show the error to user, **STOP**.
 
 ---
@@ -216,7 +216,7 @@ paperforge setup --headless --vault "D:\Documents\MyVault" --agent opencode --zo
 
 | Exit code | Meaning | Action |
 |-----------|---------|--------|
-| 1 | Package root not found | Reinstall: `pip install --force-reinstall git+https://github.com/LLLin000/PaperForge.git` |
+| 1 | Package root not found | Reinstall: `pip install --force-reinstall paperforge` |
 | 4 | Worker scripts missing | Same as above |
 | 5 | Skill files missing | Same as above |
 | 6 | File integrity check failed | Check disk space and write permissions on vault path |
@@ -275,7 +275,7 @@ Wrap in quotes: `--vault "D:\My Documents\MyVault"`
 
 Add `--user`:
 ```bash
-pip install --user git+https://github.com/LLLin000/PaperForge.git
+pip install --user paperforge
 ```
 
 ### User already has PaperForge (upgrade scenario)