Initialize crypto_monitor_user (user edition) from monitor codebase.

Retarget git remote, install path, and deploy docs from crypto_monitor to crypto_monitor_user.

Co-authored-by: Cursor <cursoragent@cursor.com>

deploy/lib/common.sh

@@ -0,0 +1,509 @@
+#!/usr/bin/env bash
+# deploy/lib/common.sh — 部署管理器公共函数
+set -e
+set -u
+if [ -n "${BASH_VERSION:-}" ]; then
+  set -o pipefail
+fi
+
+INSTALL_ROOT="${INSTALL_ROOT:-/opt/crypto_monitor_user}"
+GIT_URL="${GIT_URL:-https://git.bz121.com/dekun/crypto_monitor_user.git}"
+GIT_BRANCH="${GIT_BRANCH:-main}"
+BACKUP_ROOT="${BACKUP_ROOT:-/root/backups}"
+TZ_NAME="${CM_TZ:-Asia/Shanghai}"
+NODE_MAJOR="${NODE_MAJOR:-20}"
+
+LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DEPLOY_DIR="$(cd "${LIB_DIR}/.." && pwd)"
+REPO_ROOT="$(cd "${DEPLOY_DIR}/.." && pwd)"
+
+PM2_APPS=(
+  crypto_binance
+  crypto_gate
+  crypto_okx
+  manual-trading-hub
+  manual-agent-binance
+  manual-agent-okx
+  manual-agent-gate
+)
+
+# 历史进程名(仅 stop/delete 时兼容,不计入验收)
+PM2_APPS_LEGACY=(
+  crypto-monitor-binance
+  crypto-monitor-gate
+  crypto-monitor-okx
+)
+
+CONFIG_PATHS=(
+  crypto_monitor_binance/.env
+  crypto_monitor_okx/.env
+  crypto_monitor_gate/.env
+  manual_trading_hub/.env
+  manual_trading_hub/hub_settings.json
+)
+
+INSTANCE_DIRS=(
+  crypto_monitor_binance
+  crypto_monitor_gate
+  crypto_monitor_okx
+  manual_trading_hub
+)
+
+log() { printf '[%s] %s\n' "$(TZ="${TZ_NAME}" date '+%Y-%m-%d %H:%M:%S')" "$*"; }
+step() { echo ""; log "==> $*"; }
+
+die() {
+  echo "错误: $*" >&2
+  exit 1
+}
+
+require_root() {
+  if [[ "$(id -u)" -ne 0 ]]; then
+    die "请使用 root 执行(推荐: sudo -i 后运行)"
+  fi
+}
+
+require_ubuntu() {
+  if [[ ! -f /etc/os-release ]]; then
+    log "警告: 未检测到 /etc/os-release,跳过 Ubuntu 版本检查"
+    return 0
+  fi
+  # shellcheck source=/dev/null
+  source /etc/os-release
+  if [[ "${ID:-}" != "ubuntu" ]]; then
+    log "警告: 当前系统为 ${ID:-unknown},官方仅测试 Ubuntu 22.04/24.04"
+    return 0
+  fi
+  local ver="${VERSION_ID:-}"
+  if [[ "${ver}" != "22.04" && "${ver}" != "24.04" ]]; then
+    log "警告: Ubuntu ${ver} 未在文档中明确测试,继续执行"
+  fi
+}
+
+detect_server_ip() {
+  local ip=""
+  if command -v hostname >/dev/null 2>&1; then
+    ip="$(hostname -I 2>/dev/null | awk '{print $1}')"
+  fi
+  if [[ -z "${ip}" ]]; then
+    ip="127.0.0.1"
+  fi
+  echo "${ip}"
+}
+
+confirm_yes() {
+  local msg="$1"
+  local ans=""
+  cm_read ans "${msg} [y/N] "
+  [[ "${ans}" == [yY] || "${ans}" == [yY][eE][sS] ]]
+}
+
+confirm_uninstall() {
+  local ans=""
+  echo "此操作将停止全部 PM2 进程并移走安装目录."
+  cm_read ans "输入 UNINSTALL 确认卸载: "
+  [[ "${ans}" == "UNINSTALL" ]]
+}
+
+# curl | bash 时 stdin 是管道,须从 /dev/tty 读取用户输入
+cm_read() {
+  local __var="$1"
+  local __prompt="$2"
+  local __val=""
+  if [[ -r /dev/tty ]]; then
+    IFS= read -r -p "${__prompt}" __val </dev/tty || true
+  else
+    IFS= read -r -p "${__prompt}" __val || true
+  fi
+  printf -v "${__var}" '%s' "${__val}"
+}
+
+repo_ready() {
+  [[ -f "${1}/deploy/setup_env.sh" && -f "${1}/deploy/manage.sh" ]]
+}
+
+resolve_repo_root() {
+  if repo_ready "${INSTALL_ROOT}"; then
+    echo "${INSTALL_ROOT}"
+    return 0
+  fi
+  if repo_ready "${REPO_ROOT}"; then
+    echo "${REPO_ROOT}"
+    return 0
+  fi
+  return 1
+}
+
+install_log_file() {
+  local stamp
+  stamp="$(TZ="${TZ_NAME}" date +%Y%m%d-%H%M%S)"
+  mkdir -p "${BACKUP_ROOT}/deploy-logs"
+  echo "${BACKUP_ROOT}/deploy-logs/manage-${stamp}.log"
+}
+
+backup_configs_to() {
+  local src_root="$1"
+  local dest="$2"
+  mkdir -p "${dest}"
+  local rel copied=0
+  for rel in "${CONFIG_PATHS[@]}"; do
+    local src="${src_root}/${rel}"
+    if [[ -f "${src}" ]]; then
+      mkdir -p "${dest}/$(dirname "${rel}")"
+      cp -a "${src}" "${dest}/${rel}"
+      log "backup ${rel}"
+      copied=$((copied + 1))
+    fi
+  done
+  if [[ "${copied}" -eq 0 ]]; then
+    log "提示: 未找到可备份的配置文件"
+  fi
+}
+
+install_system_packages() {
+  step "安装系统依赖"
+  if ! command -v apt-get >/dev/null 2>&1; then
+    die "未检测到 apt-get,请手动安装 python3-venv git curl"
+  fi
+  export DEBIAN_FRONTEND=noninteractive
+  apt-get update -qq
+  apt-get install -y python3 python3-pip python3-venv curl git ca-certificates
+  local pyver=""
+  if command -v python3 >/dev/null 2>&1; then
+    pyver="$(python3 -c 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")')"
+    apt-get install -y "python${pyver}-venv" 2>/dev/null || apt-get install -y python3-venv
+  fi
+}
+
+install_node_pm2() {
+  step "检查 Node.js 与 PM2"
+  if command -v pm2 >/dev/null 2>&1; then
+    log "PM2 已安装: $(pm2 -v)"
+    return 0
+  fi
+  if ! command -v node >/dev/null 2>&1; then
+    log "安装 Node.js ${NODE_MAJOR}.x ..."
+    curl -fsSL "https://deb.nodesource.com/setup_${NODE_MAJOR}.x" | bash -
+    apt-get install -y nodejs
+  fi
+  log "安装 PM2 ..."
+  npm install -g pm2
+  log "PM2: $(pm2 -v)"
+}
+
+# pip 安装时显示进度条(避免 -q 静默导致用户以为卡死)
+# pip>=26 已移除 ascii，仅支持 auto|on|off|raw
+pip_progress_bar_arg() {
+  echo "on"
+}
+
+pip_upgrade_tools() {
+  local pip_bin="$1"
+  local bar
+  bar="$(pip_progress_bar_arg)"
+  echo "  升级 pip ..."
+  "${pip_bin}" install -U pip setuptools wheel \
+    --disable-pip-version-check \
+    --progress-bar "${bar}"
+}
+
+pip_install_requirements() {
+  local pip_bin="$1"
+  local req_file="$2"
+  local label="${3:-依赖}"
+  local bar
+  bar="$(pip_progress_bar_arg)"
+  echo "  安装${label} (下方为 pip 进度) ..."
+  [[ -f "${req_file}" ]] || die "缺少依赖文件: ${req_file}"
+  "${pip_bin}" install -r "${req_file}" \
+    --disable-pip-version-check \
+    --retries 5 \
+    --progress-bar "${bar}"
+  echo "  ${label}安装完成"
+}
+
+install_backup_cron_all() {
+  step "安装三所每日备份 cron"
+  local dir
+  for dir in crypto_monitor_binance crypto_monitor_gate crypto_monitor_okx; do
+    local inst="${REPO_ROOT}/${dir}/scripts/install_backup_cron.sh"
+    if [[ -f "${inst}" ]]; then
+      chmod +x "${inst}"
+      bash "${inst}" || log "警告: ${dir} cron 安装失败"
+    fi
+  done
+}
+
+remove_backup_cron_all() {
+  step "移除三所备份 cron"
+  local tmp removed=0
+  tmp="$(mktemp)"
+  if ! crontab -l 2>/dev/null >"${tmp}"; then
+    rm -f "${tmp}"
+    return 0
+  fi
+  local filtered
+  filtered="$(grep -vF "backup_data.sh" "${tmp}" || true)"
+  if [[ "${filtered}" != "$(cat "${tmp}")" ]]; then
+    printf '%s\n' "${filtered}" | awk '
+      BEGIN { tz = 0 }
+      /^CRON_TZ=Asia\/Shanghai$/ {
+        if (tz++) next
+      }
+      { print }
+    ' | crontab -
+    removed=1
+  fi
+  rm -f "${tmp}"
+  if [[ "${removed}" -eq 1 ]]; then
+    log "已移除 backup_data.sh 相关 cron"
+  fi
+}
+
+pm2_app_exists() {
+  local name="$1"
+  pm2 pid "${name}" >/dev/null 2>&1
+}
+
+# 仅操作本项目 PM2 进程,不影响服务器上其它应用
+pm2_stop_project_apps() {
+  if ! command -v pm2 >/dev/null 2>&1; then
+    log "未安装 pm2,跳过"
+    return 0
+  fi
+  local name stopped=0
+  for name in "${PM2_APPS[@]}" "${PM2_APPS_LEGACY[@]}"; do
+    if pm2_app_exists "${name}"; then
+      log "pm2 stop ${name}"
+      pm2 stop "${name}" 2>/dev/null || true
+      stopped=$((stopped + 1))
+    fi
+  done
+  if [[ "${stopped}" -eq 0 ]]; then
+    log "未发现本项目 PM2 进程(其它 PM2 不受影响)"
+  fi
+}
+
+pm2_delete_project_apps() {
+  if ! command -v pm2 >/dev/null 2>&1; then
+    return 0
+  fi
+  local name deleted=0
+  for name in "${PM2_APPS[@]}" "${PM2_APPS_LEGACY[@]}"; do
+    if pm2_app_exists "${name}"; then
+      log "pm2 delete ${name}"
+      pm2 delete "${name}" 2>/dev/null || true
+      deleted=$((deleted + 1))
+    fi
+  done
+  if [[ "${deleted}" -gt 0 ]]; then
+    pm2 save 2>/dev/null || true
+  fi
+}
+
+pm2_save_startup() {
+  step "PM2 save & startup"
+  pm2 save 2>/dev/null || true
+  if pm2 startup systemd -u root --hp /root 2>/dev/null | grep -q "sudo"; then
+    pm2 startup systemd -u root --hp /root 2>/dev/null | grep "^sudo" | bash || true
+  else
+    pm2 startup 2>/dev/null || true
+  fi
+}
+
+pm2_count_online() {
+  local name online=0
+  if ! command -v pm2 >/dev/null 2>&1; then
+    echo "0"
+    return 0
+  fi
+  for name in "${PM2_APPS[@]}"; do
+    if pm2 pid "${name}" >/dev/null 2>&1; then
+      online=$((online + 1))
+    fi
+  done
+  echo "${online}"
+}
+
+is_deployed() {
+  local root="$1"
+  [[ -x "${root}/crypto_monitor_binance/.venv/bin/python" ]] \
+    || [[ -x "${root}/crypto_monitor_gate/.venv/bin/python" ]] \
+    || [[ -x "${root}/crypto_monitor_okx/.venv/bin/python" ]] \
+    || [[ -x "${root}/manual_trading_hub/.venv/bin/python" ]]
+}
+
+# 单所实例: key -> 目录 / PM2 名 / 端口 / 展示名
+exchange_dir() {
+  case "$1" in
+    okx) echo "crypto_monitor_okx" ;;
+    binance) echo "crypto_monitor_binance" ;;
+    gate) echo "crypto_monitor_gate" ;;
+    *) return 1 ;;
+  esac
+}
+
+exchange_pm2_name() {
+  case "$1" in
+    okx) echo "crypto_okx" ;;
+    binance) echo "crypto_binance" ;;
+    gate) echo "crypto_gate" ;;
+    *) return 1 ;;
+  esac
+}
+
+exchange_http_port() {
+  case "$1" in
+    okx) echo "5004" ;;
+    binance) echo "5001" ;;
+    gate) echo "5000" ;;
+    *) return 1 ;;
+  esac
+}
+
+exchange_label() {
+  case "$1" in
+    okx) echo "OKX" ;;
+    binance) echo "Binance" ;;
+    gate) echo "Gate" ;;
+    *) echo "$1" ;;
+  esac
+}
+
+normalize_exchange_key() {
+  local k
+  k="$(echo "${1:-}" | tr '[:upper:]' '[:lower:]' | xargs)"
+  case "${k}" in
+    okx|binance|gate) echo "${k}" ;;
+    *) return 1 ;;
+  esac
+}
+
+check_http() {
+  local url="$1"
+  local code
+  code="$(curl -sS -o /dev/null -w '%{http_code}' --connect-timeout 5 "${url}" 2>/dev/null || echo "000")"
+  [[ "${code}" == "200" || "${code}" == "302" || "${code}" == "301" ]]
+}
+
+verify_deployment() {
+  local ip="${1:-$(detect_server_ip)}"
+  local mode="${2:-all}"
+  local ok=1
+  local online total
+  local ex_key=""
+
+  step "部署验收"
+  if [[ "${mode}" == "all" || -z "${mode}" ]]; then
+    total="${#PM2_APPS[@]}"
+    online="$(pm2_count_online)"
+    if [[ "${online}" -eq "${total}" ]]; then
+      echo "  [✓] PM2 进程 ${online}/${total} online"
+    else
+      echo "  [✗] PM2 进程 ${online}/${total} online"
+      ok=0
+      pm2 list 2>/dev/null || true
+    fi
+    local checks=(
+      "中控:http://127.0.0.1:5100/"
+      "Binance:http://127.0.0.1:5001/"
+      "Gate:http://127.0.0.1:5000/"
+      "OKX:http://127.0.0.1:5004/"
+    )
+    local item label url
+    for item in "${checks[@]}"; do
+      label="${item%%:*}"
+      url="${item#*:}"
+      if check_http "${url}"; then
+        echo "  [✓] ${label} 可访问"
+      else
+        echo "  [✗] ${label} 不可访问 (${url})"
+        ok=0
+      fi
+    done
+  else
+    if ! ex_key="$(normalize_exchange_key "${mode}")"; then
+      echo "  [✗] 未知验收模式: ${mode}"
+      return 1
+    fi
+    local pm2_name port label
+    pm2_name="$(exchange_pm2_name "${ex_key}")"
+    port="$(exchange_http_port "${ex_key}")"
+    label="$(exchange_label "${ex_key}")"
+    if pm2_app_exists "${pm2_name}"; then
+      echo "  [✓] PM2 ${pm2_name} 已注册"
+    else
+      echo "  [✗] PM2 缺少进程 ${pm2_name}"
+      ok=0
+      pm2 list 2>/dev/null || true
+    fi
+    if check_http "http://127.0.0.1:${port}/"; then
+      echo "  [✓] ${label} 可访问 (http://127.0.0.1:${port}/)"
+    else
+      echo "  [✗] ${label} 不可访问 (http://127.0.0.1:${port}/)"
+      ok=0
+    fi
+  fi
+
+  if [[ "${ok}" -eq 1 ]]; then
+    echo ""
+    log "验收通过: 进程都在 + 页面可打开"
+    return 0
+  fi
+  echo ""
+  log "验收未完全通过,可执行 pm2 logs <进程名> --lines 30 排查"
+  return 1
+}
+
+print_post_install_guide() {
+  local ip="${1:-$(detect_server_ip)}"
+  cat <<EOF
+
+═══════════════════════════════════════════
+  ✅ 部署完成
+
+  中控:     http://${ip}:5100
+  Binance:  http://${ip}:5001
+  Gate:     http://${ip}:5000
+  OKX:      http://${ip}:5004
+
+  登录账号: admin
+  登录密码: admin123
+  （请尽快在「系统设置」中修改）
+
+  下一步（浏览器）:
+  1. 中控 → 系统设置 → 确认账户 URL（有域名时改 flask_url）
+  2. 各所 → env 配置 → 填 API、风控、企业微信
+  3. 中控 → AI 配置（如需复盘）
+  4. 各所 env 配置 → 开启实盘下单 → 保存并重启
+
+  agent_url 默认本机 127.0.0.1:15200/15201/15202,一般无需修改
+═══════════════════════════════════════════
+EOF
+}
+
+print_post_install_guide_instance() {
+  local ex_key="$1"
+  local ip="${2:-$(detect_server_ip)}"
+  local label port
+  label="$(exchange_label "${ex_key}")"
+  port="$(exchange_http_port "${ex_key}")"
+  cat <<EOF
+
+═══════════════════════════════════════════
+  ✅ 单所实例部署完成（不含中控）
+
+  ${label}:  http://${ip}:${port}
+
+  登录账号: admin
+  登录密码: admin123
+  （请尽快在 env 配置中修改）
+
+  下一步（浏览器）:
+  1. ${label} → env 配置 → 填 API、风控、企业微信
+  2. 开启实盘下单 → 保存并重启该实例进程
+
+  说明: 本模式不起中控 / agent;整仓仍在 ${INSTALL_ROOT},仅启动本所 Flask.
+═══════════════════════════════════════════
+EOF
+}

deploy/lib/install.sh

@@ -0,0 +1,175 @@
+#!/usr/bin/env bash
+# deploy/lib/install.sh — 一键部署(全套) / 单所仅实例
+set -e
+set -u
+if [ -n "${BASH_VERSION:-}" ]; then
+  set -o pipefail
+fi
+
+LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=common.sh
+source "${LIB_DIR}/common.sh"
+
+EXCHANGE=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --exchange)
+      EXCHANGE="${2:-}"
+      shift 2
+      ;;
+    -h|--help)
+      echo "用法: bash deploy/lib/install.sh [--exchange okx|binance|gate]"
+      echo "  无 --exchange: 全套(三所+中控)"
+      echo "  有 --exchange: 仅该所 Flask 实例(不含中控/agent)"
+      exit 0
+      ;;
+    *)
+      echo "未知参数: $1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+install_fresh() {
+  step "克隆仓库"
+  if [[ -d "${INSTALL_ROOT}" ]]; then
+    die "目录已存在: ${INSTALL_ROOT},请选修复环境或深度重装"
+  fi
+  mkdir -p "$(dirname "${INSTALL_ROOT}")"
+  git clone -b "${GIT_BRANCH}" "${GIT_URL}" "${INSTALL_ROOT}"
+}
+
+install_repair() {
+  step "修复环境(保留数据与配置)"
+  bash "${REPO_ROOT}/deploy/setup_env.sh" --install-system-deps
+}
+
+install_deep() {
+  step "深度重装(保留 .env,清库)"
+  bash "${REPO_ROOT}/deploy/reinstall.sh" --yes
+  verify_deployment "$(detect_server_ip)" || true
+  print_post_install_guide "$(detect_server_ip)"
+}
+
+run_install_pipeline() {
+  step "环境部署 setup_env.sh"
+  bash "${REPO_ROOT}/deploy/setup_env.sh" --install-system-deps
+
+  step "启动 PM2 全部进程"
+  bash "${REPO_ROOT}/deploy/pm2_start_all.sh"
+
+  pm2_save_startup
+  install_backup_cron_all
+
+  verify_deployment "$(detect_server_ip)" || true
+  print_post_install_guide "$(detect_server_ip)"
+}
+
+run_instance_pipeline() {
+  local ex_key="$1"
+  local dir_name
+  dir_name="$(exchange_dir "${ex_key}")"
+
+  step "单所环境部署 setup_env.sh --only ${ex_key}(不含中控)"
+  bash "${REPO_ROOT}/deploy/setup_env.sh" --only "${ex_key}" --install-system-deps
+
+  step "启动 PM2 仅 ${dir_name}"
+  bash "${REPO_ROOT}/deploy/pm2_start_all.sh" --only "${ex_key}"
+
+  pm2_save_startup
+  local cron_script="${REPO_ROOT}/${dir_name}/scripts/install_backup_cron.sh"
+  if [[ -x "${cron_script}" ]]; then
+    step "安装 ${ex_key} 备份 cron"
+    bash "${cron_script}" || true
+  fi
+
+  verify_deployment "$(detect_server_ip)" "${ex_key}" || true
+  print_post_install_guide_instance "${ex_key}" "$(detect_server_ip)"
+}
+
+handle_existing_install() {
+  echo ""
+  echo "检测到已部署安装: ${INSTALL_ROOT}"
+  echo "  a) 取消"
+  echo "  b) 修复环境(重建 venv,保留 .env 与数据库)"
+  echo "  c) 深度重装(保留 .env,清库,见 reinstall.sh)"
+  local choice=""
+  cm_read choice "请选择 [a/b/c]: "
+  case "${choice}" in
+    b|B)
+      install_repair
+      if command -v pm2 >/dev/null 2>&1; then
+        bash "${REPO_ROOT}/deploy/pm2_start_all.sh" 2>/dev/null || pm2 restart all 2>/dev/null || true
+        pm2_save_startup
+      fi
+      verify_deployment "$(detect_server_ip)" || true
+      print_post_install_guide "$(detect_server_ip)"
+      ;;
+    c|C)
+      install_deep
+      ;;
+    *)
+      log "已取消"
+      ;;
+  esac
+}
+
+ensure_repo_ready() {
+  if repo_ready "${INSTALL_ROOT}"; then
+    REPO_ROOT="${INSTALL_ROOT}"
+  elif [[ -n "${REPO_ROOT:-}" ]] && repo_ready "${REPO_ROOT}"; then
+    :
+  else
+    REPO_ROOT=""
+  fi
+
+  if [[ -z "${REPO_ROOT}" ]]; then
+    install_system_packages
+    install_node_pm2
+    install_fresh
+    REPO_ROOT="${INSTALL_ROOT}"
+  else
+    install_system_packages
+    install_node_pm2
+  fi
+}
+
+main_install_instance() {
+  local ex_key="$1"
+  require_root
+  require_ubuntu
+  ensure_repo_ready
+  run_instance_pipeline "${ex_key}"
+}
+
+main_install() {
+  require_root
+  require_ubuntu
+
+  if [[ -n "${EXCHANGE}" ]]; then
+    local ex_key=""
+    if ! ex_key="$(normalize_exchange_key "${EXCHANGE}")"; then
+      die "无效 --exchange: ${EXCHANGE} (期望 okx|binance|gate)"
+    fi
+    main_install_instance "${ex_key}"
+    return 0
+  fi
+
+  if repo_ready "${INSTALL_ROOT}"; then
+    REPO_ROOT="${INSTALL_ROOT}"
+  elif repo_ready "${REPO_ROOT}"; then
+    :
+  else
+    REPO_ROOT=""
+  fi
+
+  if [[ -n "${REPO_ROOT}" ]] && is_deployed "${REPO_ROOT}"; then
+    handle_existing_install
+    return 0
+  fi
+
+  ensure_repo_ready
+  run_install_pipeline
+}
+
+main_install "$@"

deploy/lib/uninstall.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+# deploy/lib/uninstall.sh — 一键卸载
+set -e
+set -u
+if [ -n "${BASH_VERSION:-}" ]; then
+  set -o pipefail
+fi
+
+LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=common.sh
+source "${LIB_DIR}/common.sh"
+
+main_uninstall() {
+  require_root
+
+  local root=""
+  if ! root="$(resolve_repo_root)"; then
+    if [[ -d "${INSTALL_ROOT}" ]]; then
+      root="${INSTALL_ROOT}"
+    else
+      die "未找到安装目录 ${INSTALL_ROOT}"
+    fi
+  fi
+  REPO_ROOT="${root}"
+
+  if ! confirm_uninstall; then
+    log "已取消卸载"
+    return 0
+  fi
+
+  local stamp backup_dir removed_dir
+  stamp="$(TZ="${TZ_NAME}" date +%Y%m%d-%H%M%S)"
+  backup_dir="${BACKUP_ROOT}/pre-uninstall-${stamp}"
+  removed_dir="${INSTALL_ROOT}.removed.${stamp}"
+
+  step "备份配置到 ${backup_dir}"
+  backup_configs_to "${REPO_ROOT}" "${backup_dir}"
+  {
+    echo "created_at=${stamp}"
+    echo "install_root=${INSTALL_ROOT}"
+    echo "removed_dir=${removed_dir}"
+  } >"${backup_dir}/uninstall.manifest"
+
+  step "停止并移除本项目 PM2 进程(不影响其它 PM2)"
+  pm2_stop_project_apps
+  pm2_delete_project_apps
+
+  remove_backup_cron_all
+
+  step "移走安装目录"
+  if [[ -d "${INSTALL_ROOT}" ]]; then
+    mv "${INSTALL_ROOT}" "${removed_dir}"
+    log "已移动: ${INSTALL_ROOT} -> ${removed_dir}"
+  else
+    log "安装目录不存在,跳过"
+  fi
+
+  echo ""
+  echo "卸载完成."
+  echo "  配置备份: ${backup_dir}"
+  echo "  旧目录:   ${removed_dir} (确认无误后可手动删除)"
+  echo ""
+  echo "回滚示例:"
+  echo "  mv ${removed_dir} ${INSTALL_ROOT}"
+  echo "  bash ${INSTALL_ROOT}/deploy/manage.sh  # 选 1 修复环境"
+}
+
+main_uninstall "$@"

deploy/lib/update.sh

@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+# deploy/lib/update.sh — 更新
+set -e
+set -u
+if [ -n "${BASH_VERSION:-}" ]; then
+  set -o pipefail
+fi
+
+LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=common.sh
+source "${LIB_DIR}/common.sh"
+
+require_installed() {
+  if ! repo_ready "${REPO_ROOT}"; then
+    die "未找到安装,请先执行「1) 一键部署」"
+  fi
+}
+
+update_quick() {
+  step "快速更新"
+  bash "${REPO_ROOT}/deploy/pull_and_restart.sh"
+  verify_deployment "$(detect_server_ip)" || true
+}
+
+update_deps() {
+  step "依赖更新"
+  local dir
+  for dir in crypto_monitor_binance crypto_monitor_gate crypto_monitor_okx; do
+    local proj="${REPO_ROOT}/${dir}"
+    if [[ -x "${proj}/.venv/bin/pip" ]]; then
+      step "${dir}"
+      pip_install_requirements "${proj}/.venv/bin/pip" "${REPO_ROOT}/requirements.txt" "交易所共用依赖"
+    fi
+  done
+  local hub="${REPO_ROOT}/manual_trading_hub"
+  if [[ -x "${hub}/.venv/bin/pip" && -f "${hub}/requirements.txt" ]]; then
+    step "manual_trading_hub"
+    pip_install_requirements "${hub}/.venv/bin/pip" "${hub}/requirements.txt" "中控依赖"
+  fi
+  update_quick
+}
+
+update_deep() {
+  step "深度重装"
+  if ! confirm_yes "深度重装将清库并保留 .env,确认继续?"; then
+    log "已取消"
+    return 0
+  fi
+  bash "${REPO_ROOT}/deploy/reinstall.sh" --yes
+  verify_deployment "$(detect_server_ip)" || true
+}
+
+show_update_menu() {
+  while true; do
+    echo ""
+    echo "  更新选项:"
+    echo "  3-1) 快速更新(git pull + pm2 restart)"
+    echo "  3-2) 依赖更新(含 pip install)"
+    echo "  3-3) 深度重装(保留 .env,清库)"
+    echo "  0)   返回主菜单"
+    local choice=""
+    cm_read choice "请选择 [0/3-1/3-2/3-3]: "
+    case "${choice}" in
+      3-1|31|1) update_quick; break ;;
+      3-2|32|2) update_deps; break ;;
+      3-3|33|3) update_deep; break ;;
+      0) break ;;
+      *) echo "无效选项" ;;
+    esac
+  done
+}
+
+main_update() {
+  require_root
+  if ! REPO_ROOT="$(resolve_repo_root)"; then
+    die "未找到安装目录 ${INSTALL_ROOT},请先执行「1) 一键部署」"
+  fi
+  require_installed
+  show_update_menu
+}
+
+main_update "$@"