feat(deployer): add deb package distribution and install via scp/apt

skills/deployer/SKILL.md

@@ -3,8 +3,9 @@ name: deployer
 description: >-
   管理多 VPS / NAS 的 Docker Compose 配置中心：仓库只存服务数据（compose.yaml、静态配置），
   部署方法与脚本由本 skill 提供。当用户要求部署、同步、升级、重启远程 Docker 服务，
-  新增/迁移/下线服务，梳理节点与服务清单，或提到 make sync/deploy/upgrade/TGT、_config.yaml、
-  rsync 同步、tar over SSH、Synology NAS 部署失败时使用。
+  新增/迁移/下线服务，梳理节点与服务清单，向节点分发安装 deb 包（scp 上传 + dpkg/apt 安装，
+  或从 URL 远程拉取安装），或提到 make sync/deploy/upgrade/TGT、_config.yaml、rsync 同步、
+  tar over SSH、Synology NAS 部署失败时使用。
 ---
 
 # deployer：多机 Compose 配置中心
@@ -17,6 +18,7 @@ description: >-
 ## 何时使用
 
 - 部署 / 同步 / 升级 / 重启某个远程 Docker Compose 服务
+- 向节点安装 deb 包：scp 上传本地 .deb 后 dpkg/apt 安装，或远程从 URL 直接拉取安装
 - 新增、迁移、下线一个服务；梳理「哪台机器跑什么」
 - sync 失败排查、证书丢失、改了配置不生效等运维问题
 - 提到 `make deploy TGT=...`、`TGT=`、`_config.yaml`、rsync/tar 同步
@@ -150,6 +152,31 @@ python3 <skill-dir>/scripts/deploy/sync.py <service-path>
 `ssh <node> "cd <base_path>/<name> && docker compose down"`，数据卷按需保留或删除。
 项目环境布局：删除对应 `.skiff/deployer/{env}/` 目录即可脱离发现体系，远程清理同上。
 
+### 7. 向节点安装 deb 包
+
+`deb.py` 把 deb 包发到节点并安装。目标两种写法：仓库内目录
+（复用 `_config.yaml` 继承链解析 node/port/identity_file，如 `hosts/web1`），
+或裸 SSH 别名 / `user@host`（须在 `~/.ssh/config` 中，可加 `--port`/`--identity`）。
+
+```bash
+# 本地 .deb → scp 上传 → 远程 apt 安装（失败自动 apt -f 修依赖），成功后删暂存包
+python3 <skill-dir>/scripts/deploy/deb.py <target> push ./foo_1.0_amd64.deb --yes
+
+# 仅上传到远程暂存目录（默认 {base_path}/.debs；裸主机为 /tmp/deployer-debs）
+python3 <skill-dir>/scripts/deploy/deb.py <target> scp ./foo_1.0_amd64.deb
+
+# 安装该节点暂存目录里已上传的全部 .deb（配合 scp 分步操作）
+python3 <skill-dir>/scripts/deploy/deb.py <target> dpkg --yes
+
+# 远程直接从 URL 下载安装（机器能出网时免上传）
+python3 <skill-dir>/scripts/deploy/deb.py <target> apt https://example.com/foo_1.0_amd64.deb --yes
+```
+
+- 非 root 用户走 `sudo -n`（需配好免密 sudo）；`--yes` 传 `-y` 免交互，
+  无终端交互能力，没配 sudo 免密/密钥时会直接失败。
+- 升级同版本号前想先看包信息：`ssh <node> "dpkg -I <暂存路径>"`；
+  装完验证：`ssh <node> "dpkg -l | grep <pkg>"`。
+
 ---
 
 ## 注意事项
@@ -188,9 +215,10 @@ python3 <skill-dir>/scripts/deploy/sync.py <service-path>
 
 | 文件 | 用途 |
 |------|------|
-| `scripts/deploy/lib.py` | 解析服务目录、合并继承 `_config.yaml`、SSH/rsync 参数构造 |
+| `scripts/deploy/lib.py` | 解析服务目录、合并继承 `_config.yaml`、SSH/rsync/scp 参数构造 |
 | `scripts/deploy/sync.py` | rsync -avz --delete 同步；无 rsync 时 tar over SSH 兜底 |
 | `scripts/deploy/remote.py` | SSH 远程 docker compose：up/recreate/restart/upgrade/ps/logs |
+| `scripts/deploy/deb.py` | deb 包分发安装：push(scp+apt)/scp/dpkg/apt(URL) |
 | `scripts/deploy/list.py` | 扫描全部可部署服务 |
 
 ## references/