- deploy/deploy.sh：Alibaba Cloud Linux 3 一键部署脚本
  - dnf 安装依赖 + Caddy（COPR 源）
  - 服务账号 osagent + venv + 幂等 git pull
  - 2G 内存自动开 2GB swap（vm.swappiness=10）
  - firewalld 放行 80/443
- deploy/osagent.service：systemd unit
  - 只绑 127.0.0.1:8765，公网入口交给 Caddy
  - 沙盒加固（NoNewPrivileges/ProtectSystem/ReadWritePaths）
  - 资源限制 MemoryMax=1500M / CPUQuota=180%
- deploy/Caddyfile：反代 + basic_auth + gzip/zstd + 5min timeout
  - 当前 :80 IP 模式，将来切域名一行改自动 HTTPS
- deploy/osagent.env.example：生产环境变量模板
  - DEEPSEEK_API_KEY / OSAGENT_API_KEY / DATA_DIR=/var/lib/osagent/data
  - GIT_CONCURRENCY=2 适配 2G 内存
- deploy/README.md：完整上线 checklist（架构图+安全组+运维+排错+卸载）
- src/osagent/web/auth.py：可选 API Key 中间件
  - 未设 OSAGENT_API_KEY → 透传（开发模式无痛）
  - 设了 → 所有 POST/PUT/PATCH/DELETE 必须携 X-API-Key
  - 白名单：/static /api/health /report 等只读端点
- src/osagent/web/app.py：挂载中间件
- README.md：追加'部署上线'章节
- .gitignore：放行 deploy/osagent.env.example