diff --git a/docs/deployment.md b/docs/deployment.md
index b1b181e..810364c 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -89,6 +89,31 @@ cat /var/lib/safesight-edge-agent/device_id
 
 ## 更新部署
 
+### 首次安装（新设备/离线部署）
+
+在开发机（已安装 safesight-edge 源码和编译环境）上：
+
+```bash
+cd ~/apps/safesight-edge
+git pull && bash scripts/package-offline.sh
+```
+
+将生成的包传到目标设备：
+
+```bash
+scp safesight-upgrade-*.tar.gz orangepi@<目标IP>:/tmp/
+```
+
+在目标设备上：
+
+```bash
+cd /tmp && tar -xzf safesight-upgrade-*.tar.gz
+cd safesight-upgrade-*
+sudo AGENT_TOKEN=<管理端token> ./deploy.sh install
+```
+
+> 安装后配置为空模板，通过管理端部署向导下发实际配置。
+
 ### 在线更新（可访问 git）
 
 ```bash
@@ -99,29 +124,11 @@ cd agent && go build -o safesight-edge-agent ./cmd/safesight-agent && cd ..
 sudo ./scripts/deploy.sh upgrade
 ```
 
-### 离线更新（生产内网）
-
-在开发机上执行：
+### 旧设备首次升级
 
 ```bash
-bash scripts/package-offline.sh
-```
-
-将生成的 `safesight-upgrade-*.tar.gz` 传到生产设备：
-
-```bash
-# 通过 SCP（替换 IP）
-scp safesight-upgrade-*.tar.gz orangepi@10.0.0.82:/tmp/
-
-# 或通过 U 盘挂载后复制
-```
-
-在生产设备上：
-
-```bash
-tar -xzf safesight-upgrade-*.tar.gz -C /tmp/
-cd /tmp/safesight-upgrade-*
-sudo ./deploy.sh upgrade    # 已升级过的新设备
-# 或
-sudo ./upgrade-from-old.sh   # 首次从旧版本升级
+cd ~/apps/safesight-edge && git pull
+bash scripts/build.sh -m -j4
+cd agent && go build -o safesight-edge-agent ./cmd/safesight-agent
+sudo ./scripts/upgrade-from-old.sh
 ```