Skip to content

Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.

28.7 KB
Raw Blame
#!/usr/bin/env bash
# AgentFlow 绑定本机 CLI(bind-cli)。
#
# 在你的本地机器或 CVM 上执行,把这台机器的 Codex / Claude Code CLI
# 接入平台:角色绑定这台「执行器」后,任务会路由到本机 CLI 执行,
# CLI 登录凭证始终保留在本机。未绑定的角色仍走云端 API Key 模式。
#
# 用法(绑定码从平台「个人 → 执行器」页面复制的命令中自动携带):
#   curl -fsSL https://<平台地址>/runners/install.sh | bash -s -- \
#     --server https://workflow.example.com --token <执行器绑定码或接入令牌>
#
# 可选参数:
#   --name <名称>          机器显示名(默认主机名)
#   --concurrency <N>      最大并发任务数(默认 1)
#   --bin-dir <目录>       二进制安装目录(默认 ~/.local/bin)
#   --from <文件>          使用本地已编译的 agentflow-runner 二进制
#   --download-url <URL>   从指定 URL 下载二进制(含 {os} {arch} 占位符)
#   --source <目录>        平台未分发二进制时,从本地 AgentFlow 源码构建(需要 Go)
#   --strict-https         禁止在 HTTPS 网络不可达时降级到 HTTP
#   --service              安装常驻服务。macOS 用 launchd;Linux 有 systemd 时用用户服务,
#                          没有用户会话时会先拉起 systemd 用户实例。没有 systemd 时改为后台运行。
#   --no-start             只安装配置,不立即启动
#   --no-auto-update       禁止从平台自动更新(自定义二进制默认禁用)
#   --upgrade              原地升级已绑定的 runner,保留配置、机器绑定和工作区
#   --uninstall            卸载:通知平台注销机器、停止服务、删除全部文件和配置
#
# 默认直接从平台下载对应 OS/架构的二进制(由服务端 /runners/agentflow-runner 分发)。
# 脚本安装 agentflow-runner 和跨沙箱 Gate MCP helper、写配置并启动
# daemon。Runner 仅向平台发起出站 HTTPS,不开放任何入站端口。

set -euo pipefail

SERVER=""
TOKEN=""
NAME=""
CONCURRENCY="1"
BIN_DIR="${HOME}/.local/bin"
LOCAL_BINARY=""
DOWNLOAD_URL=""
SOURCE_DIR=""
INSTALL_SERVICE=0
NO_START=0
UNINSTALL=0
UPGRADE=0
STRICT_HTTPS=0
AUTO_UPDATE=1

while [[ $# -gt 0 ]]; do
  case "$1" in
    --server) SERVER="${2:-}"; shift 2 ;;
    --token) TOKEN="${2:-}"; shift 2 ;;
    --name) NAME="${2:-}"; shift 2 ;;
    --concurrency) CONCURRENCY="${2:-1}"; shift 2 ;;
    --bin-dir) BIN_DIR="${2:-}"; shift 2 ;;
    --from) LOCAL_BINARY="${2:-}"; shift 2 ;;
    --download-url) DOWNLOAD_URL="${2:-}"; shift 2 ;;
    --source) SOURCE_DIR="${2:-}"; shift 2 ;;
    --strict-https) STRICT_HTTPS=1; shift ;;
    --service) INSTALL_SERVICE=1; shift ;;
    --no-start) NO_START=1; shift ;;
    --no-auto-update) AUTO_UPDATE=0; shift ;;
    --upgrade) UPGRADE=1; shift ;;
    --uninstall) UNINSTALL=1; shift ;;
    *) echo "未知参数: $1" >&2; exit 1 ;;
  esac
done

# 自定义产物的生命周期由提供者管理,避免平台自动覆盖。
if [[ -n "$LOCAL_BINARY" || -n "$DOWNLOAD_URL" || -n "$SOURCE_DIR" ]]; then
  AUTO_UPDATE=0
fi

fail() { echo "[bind-cli] 错误: $*" >&2; exit 1; }
info() { echo "[bind-cli] $*"; }
warn() { echo "[bind-cli] 警告: $*" >&2; }

# systemctl --user 走用户 D-Bus。SSH 进 CVM、以 root 执行,或当前 shell
# 没有登录会话时,这条总线还不存在,会报 Failed to connect to bus。
# 系统总线这时通常仍可用:用它启用 linger 并启动 user@<uid>,再把
# XDG_RUNTIME_DIR 指到 /run/user/<uid>,用户总线就会出现。
prepare_systemd_user_env() {
  local uid runtime
  uid="$(id -u)"
  runtime="/run/user/${uid}"
  if [[ -z "${XDG_RUNTIME_DIR:-}" && -d "${runtime}" ]]; then
    export XDG_RUNTIME_DIR="${runtime}"
  fi
  if [[ -n "${XDG_RUNTIME_DIR:-}" && -z "${DBUS_SESSION_BUS_ADDRESS:-}" && -S "${XDG_RUNTIME_DIR}/bus" ]]; then
    export DBUS_SESSION_BUS_ADDRESS="unix:path=${XDG_RUNTIME_DIR}/bus"
  fi
}

systemd_user_reachable() {
  systemctl --user show-environment >/dev/null 2>&1
}

# 先以当前用户执行。失败后再试免密 sudo:安装命令常通过 curl|bash 进入,
# 没有终端可以输入密码。
run_privileged() {
  if [[ "$(id -u)" -eq 0 ]]; then
    SYSTEMD_ASK_PASSWORD=0 "$@"
    return
  fi
  if SYSTEMD_ASK_PASSWORD=0 "$@" >/dev/null 2>&1; then
    return 0
  fi
  if command -v sudo >/dev/null 2>&1; then
    sudo -n "$@"
    return
  fi
  return 1
}

# 参数 quiet:连上总线,但不打印说明。返回 0 表示 systemctl --user 可用。
ensure_systemd_user_bus() {
  local announce="${1:-announce}" uid runtime user_name linger_ok attempt
  uid="$(id -u)"
  user_name="$(id -un)"
  runtime="/run/user/${uid}"
  linger_ok=0
  command -v systemctl >/dev/null 2>&1 || return 1
  SYSTEMD_ASK_PASSWORD=0 systemctl show --property=Version >/dev/null 2>&1 || return 1
  prepare_systemd_user_env
  if systemd_user_reachable; then
    return 0
  fi
  if [[ "${announce}" == announce ]]; then
    info "当前没有 systemd 用户总线,正在为 ${user_name} 启动用户实例..."
  fi
  if command -v loginctl >/dev/null 2>&1 && run_privileged loginctl enable-linger "${user_name}" >/dev/null 2>&1; then
    linger_ok=1
  fi
  run_privileged systemctl start "user@${uid}.service" >/dev/null 2>&1 || true
  if [[ -z "${XDG_RUNTIME_DIR:-}" || -S "${runtime}/bus" ]]; then
    export XDG_RUNTIME_DIR="${runtime}"
  fi
  attempt=0
  while [[ "${attempt}" -lt 10 ]]; do
    attempt=$((attempt + 1))
    if [[ -S "${runtime}/bus" && -z "${DBUS_SESSION_BUS_ADDRESS:-}" ]]; then
      export DBUS_SESSION_BUS_ADDRESS="unix:path=${runtime}/bus"
    fi
    if systemd_user_reachable; then
      if [[ "${announce}" == announce ]]; then
        if [[ "${linger_ok}" -eq 1 ]]; then
          info "已接通 systemd 用户总线;退出登录后服务仍会保持运行"
        else
          info "已接通 systemd 用户总线"
        fi
      fi
      return 0
    fi
    sleep 0.2
  done
  return 1
}

require_systemd_user_bus() {
  if ensure_systemd_user_bus; then
    return 0
  fi
  if ! command -v systemctl >/dev/null 2>&1 || ! SYSTEMD_ASK_PASSWORD=0 systemctl show --property=Version >/dev/null 2>&1; then
    fail "当前系统没有可用的 systemd,不能安装常驻服务。去掉 --service 可以在当前终端前台运行"
  fi
  if [[ "$(id -u)" -eq 0 ]]; then
    fail "无法启动 systemd 用户实例。请确认 systemd-logind 正在运行后重新安装"
  fi
  fail "无法连接 systemd 用户总线。请在终端执行:sudo loginctl enable-linger $(id -un),然后再运行安装命令"
}

# 容器和云开发机里经常装着 systemctl,但 1 号进程不是 systemd。
linux_has_systemd() {
  command -v systemctl >/dev/null 2>&1 || return 1
  SYSTEMD_ASK_PASSWORD=0 systemctl show --property=Version >/dev/null 2>&1
}

shell_quote() { printf '%q' "$1"; }

# 判断 pid 是不是正在执行 run-service.sh 的进程:argv[0] 就是这个脚本,或 argv[0]
# 是 bash/sh、argv[1] 是这个脚本。PID 文件可能是重启前留下的旧值,那个 PID 已被
# 别的进程复用;查看或编辑这个脚本的进程(less、vim …)命令行里也带着路径,都不能算。
is_background_runner_pid() {
  local pid="$1"
  local -a args=()
  [[ "$pid" =~ ^[0-9]+$ ]] || return 1
  if [[ -r "/proc/${pid}/cmdline" ]]; then
    mapfile -d '' -t args < "/proc/${pid}/cmdline" 2>/dev/null || return 1
  else
    read -r -a args <<< "$(ps -o args= -p "$pid" 2>/dev/null || true)" || true
  fi
  [[ "${#args[@]}" -gt 0 ]] || return 1
  [[ "${args[0]}" == "$BACKGROUND_SCRIPT" ]] && return 0
  case "${args[0]##*/}" in
    bash|sh) [[ "${args[1]:-}" == "$BACKGROUND_SCRIPT" ]] ;;
    *) return 1 ;;
  esac
}

# 只给核对过命令行的 run-service.sh 进程发信号。PID 文件里的旧 PID 不匹配时只删文件;
# PID 文件丢失或过期时,再按 /proc 里的命令行找仍在运行的 run-service.sh。
stop_background_runner() {
  local pid="" proc
  local -a pids=()
  if [[ -f "$BACKGROUND_PID" ]]; then
    pid="$(tr -d '[:space:]' < "$BACKGROUND_PID" 2>/dev/null || true)"
    rm -f "$BACKGROUND_PID"
  fi
  if [[ -n "$pid" ]] && is_background_runner_pid "$pid"; then
    pids+=("$pid")
  fi
  if [[ -n "$BACKGROUND_SCRIPT" && -d /proc ]]; then
    for proc in /proc/[0-9]*; do
      proc="${proc#/proc/}"
      [[ "$proc" == "$pid" || "$proc" == "$$" ]] && continue
      is_background_runner_pid "$proc" && pids+=("$proc")
    done
  fi
  [[ "${#pids[@]}" -gt 0 ]] || return 0
  for proc in "${pids[@]}"; do
    kill -TERM "$proc" >/dev/null 2>&1 || true
  done
  sleep 0.2
  for proc in "${pids[@]}"; do
    pkill -P "$proc" >/dev/null 2>&1 || true
  done
}

# 读当前用户的 crontab 到 CRONTAB_CURRENT。读取成功,或明确是「还没有 crontab」时
# 返回 0;其他失败(权限、spool 读不了等)返回 1 并把原因放进 CRONTAB_ERROR。
# 调用方必须在失败时放弃改写:把读失败当成空表写回,会覆盖用户原有的定时任务。
read_user_crontab() {
  local err_file status=0
  CRONTAB_CURRENT=""
  CRONTAB_ERROR=""
  err_file="$(mktemp "${TMPDIR:-/tmp}/bind-cli-crontab.XXXXXX")" || {
    CRONTAB_ERROR="无法创建临时文件"
    return 1
  }
  CRONTAB_CURRENT="$(crontab -l 2>"$err_file")" || status=$?
  CRONTAB_ERROR="$(head -n 1 "$err_file" 2>/dev/null || true)"
  rm -f "$err_file"
  [[ "$status" -eq 0 ]] && return 0
  CRONTAB_CURRENT=""
  if [[ "$CRONTAB_ERROR" == *"no crontab for"* ]]; then
    CRONTAB_ERROR=""
    return 0
  fi
  [[ -n "$CRONTAB_ERROR" ]] || CRONTAB_ERROR="crontab -l 退出码 ${status}"
  return 1
}

remove_background_reboot_hook() {
  command -v crontab >/dev/null 2>&1 || return 0
  local filtered
  if ! read_user_crontab; then
    warn "读取 crontab 失败(${CRONTAB_ERROR}),未改动 crontab;如有 # agentflow-runner 开机项请手动删除"
    return 0
  fi
  [[ "$CRONTAB_CURRENT" == *"# agentflow-runner"* ]] || return 0
  filtered="$(printf '%s\n' "$CRONTAB_CURRENT" | grep -v '# agentflow-runner' || true)"
  printf '%s\n' "$filtered" | crontab - >/dev/null 2>&1 ||
    warn "写回 crontab 失败,请手动删除 # agentflow-runner 开机项"
}

install_background_reboot_hook() {
  command -v crontab >/dev/null 2>&1 || return 0
  [[ "$BACKGROUND_SCRIPT" != *" "* && "$RUNNER_HOME" != *" "* ]] || return 0
  local entry
  if ! read_user_crontab; then
    warn "读取 crontab 失败(${CRONTAB_ERROR}),为免覆盖已有定时任务,未安装开机自启;runner 本次仍在后台运行"
    return 0
  fi
  entry="@reboot ${BACKGROUND_SCRIPT} >> ${RUNNER_HOME}/runner.log 2>&1 # agentflow-runner"
  {
    if [[ -n "$CRONTAB_CURRENT" ]]; then
      printf '%s\n' "$CRONTAB_CURRENT" | grep -v '# agentflow-runner' || true
    fi
    printf '%s\n' "$entry"
  } | crontab - >/dev/null 2>&1 ||
    warn "写入 crontab 失败,未安装开机自启;runner 本次仍在后台运行"
}

launch_background_wrapper() {
  mkdir -p "$RUNNER_HOME"
  if command -v nohup >/dev/null 2>&1; then
    nohup "$BACKGROUND_SCRIPT" >> "${RUNNER_HOME}/runner.log" 2>&1 < /dev/null &
  else
    "$BACKGROUND_SCRIPT" >> "${RUNNER_HOME}/runner.log" 2>&1 < /dev/null &
  fi
  echo "$!" > "$BACKGROUND_PID"
  disown "$!" >/dev/null 2>&1 || true
}

# 没有 systemd 时仍把 runner 留在后台,避免安装停在用户看不懂的报错上。
start_background_runner() {
  local arg
  stop_background_runner
  {
    echo '#!/usr/bin/env bash'
    # @reboot 直接执行本脚本、不经过 launch_background_wrapper,由脚本自己写 PID 文件,
    # 重启后 PID 文件里也是当前进程。
    echo "echo \$\$ > $(shell_quote "$BACKGROUND_PID")"
    echo "trap '' HUP"
    echo 'child=0'
    echo 'trap '\''if [[ "$child" != 0 ]]; then kill "$child" 2>/dev/null || true; fi; exit 0'\'' TERM INT'
    echo "export PATH=$(shell_quote "$USER_PATH")"
    echo "export AGENTFLOW_GATE_MCP_BINARY=$(shell_quote "$GATE_BINARY_PATTERN")"
    echo 'while true; do'
    printf '  %s' "$(shell_quote "$BINARY")"
    for arg in "${RUN_ARGS[@]}"; do
      printf ' %s' "$(shell_quote "$arg")"
    done
    echo ' &'
    echo '  child=$!'
    echo '  wait "$child" || true'
    echo '  sleep 5'
    echo 'done'
  } > "$BACKGROUND_SCRIPT"
  chmod 700 "$BACKGROUND_SCRIPT"
  launch_background_wrapper
  install_background_reboot_hook
  info "安装完成,已在后台运行。日志: ${RUNNER_HOME}/runner.log"
}

restart_background_runner() {
  [[ -x "$BACKGROUND_SCRIPT" ]] || fail "未找到后台启动脚本,无法原地升级"
  stop_background_runner
  launch_background_wrapper
  install_background_reboot_hook
  info "已原地升级并重启后台进程;机器绑定和工作区保持不变"
}

OS="$(uname -s | tr '[:upper:]' '[:lower:]')"
ARCH="$(uname -m)"
case "$ARCH" in
  arm64|aarch64) ARCH="arm64" ;;
  x86_64|amd64) ARCH="amd64" ;;
  *) fail "不支持的架构: $ARCH" ;;
esac
[[ "$OS" == "darwin" || "$OS" == "linux" ]] || fail "不支持的系统: ${OS}(Windows 请使用 PowerShell 安装方式)"

RUNNER_HOME="${HOME}/.agentflow-runner"
ENV_FILE="${RUNNER_HOME}/env"
STATE_FILE="${RUNNER_HOME}/state.json"
BINARY="${BIN_DIR}/agentflow-runner"
GATE_BINARY_PATTERN="${BIN_DIR}/agentflow-gate-mcp-{os}-{arch}"
PLIST="${HOME}/Library/LaunchAgents/com.agentflow.runner.plist"
UNIT="${HOME}/.config/systemd/user/agentflow-runner.service"
BACKGROUND_SCRIPT="${RUNNER_HOME}/run-service.sh"
BACKGROUND_PID="${RUNNER_HOME}/service.pid"

# ---------- 卸载 ----------
if [[ "$UNINSTALL" == "1" ]]; then
  info "停止并移除 agentflow-runner..."

  # 先停止 daemon,避免注销 API 返回后存活进程立即用 bootstrap token
  # 重新注册;state/env 暂时保留,供下面的注销请求使用。
  if [[ "$OS" == "darwin" ]]; then
    [[ -f "$PLIST" ]] && launchctl unload "$PLIST" >/dev/null 2>&1 || true
  else
    stop_background_runner
    ensure_systemd_user_bus quiet || true
    systemctl --user stop agentflow-runner.service >/dev/null 2>&1 || true
  fi
  pkill -f 'agentflow-runner -server' >/dev/null 2>&1 || true

  # 先从 state.json 读取 server URL 和 session token,直接调 API 注销机器。
  # 这样不依赖 daemon 二进制版本:即使 daemon 是旧版(没有主动注销逻辑),
  # 服务端也能立即感知并删除机器记录。
  if [[ -f "$STATE_FILE" ]]; then
    SERVER_FROM_STATE=$(sed -n 's/.*"serverUrl"\s*:\s*"\([^"]*\)".*/\1/p' "$STATE_FILE" 2>/dev/null || true)
    SESSION_TOKEN=$(sed -n 's/.*"sessionToken"\s*:\s*"\([^"]*\)".*/\1/p' "$STATE_FILE" 2>/dev/null || true)
    if [[ -n "$SESSION_TOKEN" ]]; then
      # 从 env 文件读取 server URL(state.json 里可能没有 serverUrl)
      if [[ -z "$SERVER_FROM_STATE" ]] && [[ -f "$ENV_FILE" ]]; then
        SERVER_FROM_STATE=$(sed -n 's/^AGENTFLOW_SERVER_URL=//p' "$ENV_FILE" 2>/dev/null | head -1 || true)
      fi
      if [[ -n "$SERVER_FROM_STATE" ]]; then
        info "通知平台注销机器..."
        curl -fsSL -X POST -H "Authorization: Bearer $SESSION_TOKEN" \
          -H "Content-Type: application/json" -d '{}' \
          "$SERVER_FROM_STATE/runners/deregister" >/dev/null 2>&1 \
          && info "平台已注销机器" \
          || info "通知平台失败(可能是网络问题,服务端会通过心跳超时自动清理)"
      fi
    fi
  fi

  if [[ "$OS" == "darwin" ]]; then
    if [[ -f "$PLIST" ]]; then
      launchctl unload "$PLIST" >/dev/null 2>&1 || true
      rm -f "$PLIST"
      info "已移除 launchd 服务"
    fi
  else
    if [[ -f "$BACKGROUND_SCRIPT" || -f "$BACKGROUND_PID" ]]; then
      stop_background_runner
      remove_background_reboot_hook
      rm -f "$BACKGROUND_SCRIPT"
      info "已停止后台运行"
    fi
    if [[ -f "$UNIT" ]]; then
      ensure_systemd_user_bus quiet || true
      systemctl --user disable --now agentflow-runner.service >/dev/null 2>&1 || true
      rm -f "$UNIT"
      systemctl --user daemon-reload >/dev/null 2>&1 || true
      info "已移除 systemd 服务"
    fi
  fi
  # 回收异常退出时可能遗留的 runner 专属容器和临时镜像。名称严格
  # 限定为 agentflow-rt-*,不会碰同机控制面或用户自己的容器。
  if command -v docker >/dev/null 2>&1; then
    while IFS= read -r container; do
      [[ -n "$container" ]] || continue
      docker rm -f "$container" >/dev/null 2>&1 || true
    done < <(docker ps -aq --filter 'name=^/agentflow-rt-' 2>/dev/null || true)
    while IFS= read -r image; do
      [[ -n "$image" ]] || continue
      docker rmi -f "$image" >/dev/null 2>&1 || true
    done < <(docker images --format '{{.Repository}}' 2>/dev/null | awk '/^agentflow-tmp-rt-/' || true)
    info "已清理 runner Docker 沙箱和临时镜像"
  fi
  rm -f "$BINARY"
  rm -f "${BIN_DIR}"/agentflow-gate-mcp-darwin-amd64 \
    "${BIN_DIR}"/agentflow-gate-mcp-darwin-arm64 \
    "${BIN_DIR}"/agentflow-gate-mcp-linux-amd64 \
    "${BIN_DIR}"/agentflow-gate-mcp-linux-arm64
  rm -rf "$RUNNER_HOME"
  info "已删除二进制 ${BINARY}"
  info "已删除配置目录及全部工作区 ${RUNNER_HOME}"
  info "卸载完成。"
  exit 0
fi

if [[ "$UPGRADE" == "1" ]]; then
  [[ -f "$ENV_FILE" && -f "$STATE_FILE" && -f "$BINARY" ]] || fail "未发现完整的 runner 安装,无法原地升级"
  if [[ -z "$SERVER" ]]; then
    SERVER=$(sed -n 's/^AGENTFLOW_SERVER_URL=//p' "$ENV_FILE" | head -1)
  fi
else
  [[ -n "$TOKEN" ]] || fail "必须提供 --token(执行器绑定码,或管理员下发的接入令牌)"
fi
[[ -n "$SERVER" ]] || fail "必须提供 --server <平台地址或主机名>"

# 默认优先 HTTPS。仅连接、DNS、超时或 TLS 层失败时允许降级;如果 HTTPS
# 已经可达但返回 HTTP 错误,则不降级,避免把服务端故障误判成网络隔离。
probe_server() {
  curl -fsS --connect-timeout 3 --max-time 8 "$1/runners/health" >/dev/null 2>&1
}

resolve_server() {
  local requested="${SERVER%/}" host https_url http_url status
  case "$requested" in
    http://*)
      SERVER="$requested"
      echo "[bind-cli] 警告: 使用明文 HTTP,绑定码和任务通信仅适用于可信内网" >&2
      return
      ;;
    https://*) host="${requested#https://}" ;;
    *://*) fail "--server 仅支持 http://、https:// 或不带协议的主机名" ;;
    *) host="$requested" ;;
  esac
  [[ -n "$host" ]] || fail "--server 主机名不能为空"
  https_url="https://${host}"
  http_url="http://${host}"
  info "探测平台连接:优先 ${https_url}"
  if probe_server "$https_url"; then
    SERVER="$https_url"
    return
  else
    status=$?
  fi
  if [[ "$STRICT_HTTPS" == "1" ]]; then
    fail "HTTPS 连接失败(curl exit ${status}),且已启用 --strict-https"
  fi
  case "$status" in
    5|6|7|28|35|60) ;;
    *) fail "HTTPS 已响应但健康检查失败(curl exit ${status}),为避免不安全降级已停止" ;;
  esac
  info "HTTPS 网络不可达,尝试降级到 ${http_url}"
  if ! probe_server "$http_url"; then
    fail "HTTPS 与 HTTP 均无法连接平台,请检查 DNS、防火墙和服务端口"
  fi
  SERVER="$http_url"
  echo "[bind-cli] 警告: 已自动降级到明文 HTTP;仅应在可信隔离网络中使用" >&2
}

resolve_server

# ---------- 0. 预检本机 CLI ----------
info "检测本机 Agent CLI..."
for cli in claude codex codebuddy; do
  if command -v "$cli" >/dev/null 2>&1; then
    info "  发现 $cli: $(command -v "$cli")($("$cli" --version 2>/dev/null | head -1 || echo 版本未知))"
  else
    echo "[bind-cli] 提示: 未找到 ${cli},该 CLI 不会接入平台(可先完成 CLI 登录后重新执行本脚本)" >&2
  fi
done

# ---------- 0.5 Agent 浏览器 ----------
# docker 沙箱自带浏览器 sidecar;本机执行(runner/local/seatbelt)需要宿主 Chromium。
find_chromium() {
  local name path
  for name in chromium chromium-browser google-chrome-stable google-chrome; do
    if path="$(command -v "$name" 2>/dev/null)"; then printf '%s\n' "$path"; return 0; fi
  done
  for path in "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" "/Applications/Chromium.app/Contents/MacOS/Chromium" \
    "$HOME"/.cache/ms-playwright/chromium-*/chrome-linux*/chrome \
    "$HOME"/Library/Caches/ms-playwright/chromium-*/chrome-mac*/"Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing"; do
    if [[ -x "$path" ]]; then printf '%s\n' "$path"; return 0; fi
  done
  return 1
}
case "$(printf '%s' "${AGENTFLOW_BROWSER:-}" | tr '[:upper:]' '[:lower:]')" in
  off|0|false|no)
    info "AGENTFLOW_BROWSER=${AGENTFLOW_BROWSER},跳过 Agent 浏览器检测"
    ;;
  *)
    info "检测 Agent 浏览器..."
    if CHROMIUM_PATH="$(find_chromium)"; then
      info "  发现 Chromium: ${CHROMIUM_PATH}"
    elif command -v npx >/dev/null 2>&1; then
      info "  未找到 Chromium,安装 Playwright Chromium 到用户缓存(无需 sudo)..."
      # A stalled download must not hang the whole bind; it only costs browser tools.
      install_limit=""
      if command -v timeout >/dev/null 2>&1; then install_limit="timeout 600"; fi
      PLAYWRIGHT_DOWNLOAD_HOST="${PLAYWRIGHT_DOWNLOAD_HOST:-https://npmmirror.com/mirrors/playwright}" $install_limit npx -y playwright install chromium >/dev/null 2>&1 || true
      if CHROMIUM_PATH="$(find_chromium)"; then
        info "  已安装 Chromium: ${CHROMIUM_PATH}"
      else
        echo "[bind-cli] 提示: Chromium 安装失败,本机执行的任务将没有浏览器工具(docker 沙箱不受影响)" >&2
      fi
    else
      echo "[bind-cli] 提示: 未找到 Chromium 且无 npx,本机执行的任务将没有浏览器工具;安装 Chrome 后重新执行本脚本即可" >&2
    fi
    ;;
esac

# ---------- 1. 安装二进制 ----------
install_binary() {
  mkdir -p "$BIN_DIR"
  TEMP_BINARY=$(mktemp "${BIN_DIR}/.agentflow-runner.XXXXXX")
  if [[ -n "$LOCAL_BINARY" ]]; then
    [[ -f "$LOCAL_BINARY" ]] || fail "本地二进制不存在: $LOCAL_BINARY"
    cp "$LOCAL_BINARY" "$TEMP_BINARY"
  elif [[ -n "$DOWNLOAD_URL" ]]; then
    URL="${DOWNLOAD_URL//\{os\}/$OS}"
    URL="${URL//\{arch\}/$ARCH}"
    info "从 ${URL} 下载二进制..."
    curl -fsSL "$URL" -o "$TEMP_BINARY"
  else
    # 默认:平台直接分发对应 OS/架构的二进制,无需本机 Go 工具链。
    info "从 ${SERVER} 下载 agentflow-runner(${OS}/${ARCH})..."
    if curl -fsSL "${SERVER}/runners/agentflow-runner?os=${OS}&arch=${ARCH}" -o "$TEMP_BINARY"; then
      :
    else
      # 平台未配置分发:回退到本地源码构建(--source 或当前目录为源码 checkout)。
      AUTO_UPDATE=0
      SRC="${SOURCE_DIR:-$PWD}"
      if [[ ! -d "$SRC/cmd/agentflow-runner" ]]; then
        fail "平台未提供二进制且未找到源码。解决方式任选其一:
  1) 平台管理员设置 AGENTFLOW_SOURCE_ROOT(源码目录)或 AGENTFLOW_RUNNER_BINARY(预编译产物)后重启服务
  2) 本命令追加 --source <AgentFlow 源码目录>(需要本机安装 Go)
  3) 本命令追加 --from <已编译的 agentflow-runner 二进制路径>"
      fi
      command -v go >/dev/null 2>&1 || fail "本机未安装 Go,无法从源码构建;请使用 --from 提供二进制"
      info "从源码 ${SRC} 构建(${OS}/${ARCH})..."
      (cd "$SRC" && CGO_ENABLED=0 GOOS="$OS" GOARCH="$ARCH" go build -o "$TEMP_BINARY" ./cmd/agentflow-runner) \
        || fail "源码构建失败;请检查 Go 版本(需 1.22+)或改用 --from"
    fi
  fi
  [[ -s "$TEMP_BINARY" ]] || fail "下载或构建的 runner 二进制为空"
  chmod +x "$TEMP_BINARY"
  mv -f "$TEMP_BINARY" "$BINARY"
  TEMP_BINARY=""
}

TEMP_BINARY=""
trap '[[ -z "$TEMP_BINARY" ]] || rm -f "$TEMP_BINARY"' EXIT
install_binary

install_gate_binary() {
  local target_os="$1" target_arch="$2" target
  target="${GATE_BINARY_PATTERN//\{os\}/$target_os}"
  target="${target//\{arch\}/$target_arch}"
  info "从 ${SERVER} 下载 Gate MCP(${target_os}/${target_arch})..."
  if curl -fsSL "${SERVER}/runners/agentflow-gate-mcp?os=${target_os}&arch=${target_arch}" -o "$target"; then
    chmod +x "$target"
    return
  fi
  local src="${SOURCE_DIR:-$PWD}"
  [[ -d "$src/cmd/agentflow-gate-mcp" ]] || fail "平台未提供 Gate MCP ${target_os}/${target_arch} 二进制,且未找到本地源码"
  command -v go >/dev/null 2>&1 || fail "本机未安装 Go,无法构建 Gate MCP;请让平台配置 AGENTFLOW_GATE_MCP_BINARY"
  info "从源码 ${src} 构建 Gate MCP(${target_os}/${target_arch})..."
  (cd "$src" && CGO_ENABLED=0 GOOS="$target_os" GOARCH="$target_arch" go build -o "$target" ./cmd/agentflow-gate-mcp) \
    || fail "Gate MCP 源码构建失败"
  chmod +x "$target"
}

# Host sandbox uses the native helper. Docker always uses Linux; on a macOS
# runner both artifacts are therefore required.
install_gate_binary "$OS" "$ARCH"
if [[ "$OS" != "linux" ]]; then
  install_gate_binary linux "$ARCH"
fi

if [[ "$UPGRADE" == "1" ]]; then
  if [[ "$OS" == "darwin" && -f "$PLIST" ]]; then
    launchctl unload "$PLIST"
    launchctl load "$PLIST"
    info "已原地升级并重启 launchd 服务;机器绑定和工作区保持不变"
  elif [[ "$OS" == "linux" && -f "$UNIT" ]] && linux_has_systemd; then
    require_systemd_user_bus
    systemctl --user restart agentflow-runner.service
    info "已原地升级并重启 systemd 服务;机器绑定和工作区保持不变"
  elif [[ "$OS" == "linux" && -x "$BACKGROUND_SCRIPT" ]]; then
    restart_background_runner
  else
    info "已原地升级 runner;请重启前台运行的旧进程以启用新版"
  fi
  exit 0
fi

# ---------- 2. 写入配置 ----------
mkdir -p "$RUNNER_HOME" "$RUNNER_HOME/workspace"
chmod 700 "$RUNNER_HOME"
cat > "$ENV_FILE" <<EOF
AGENTFLOW_SERVER_URL=${SERVER}
AGENTFLOW_RUNNER_BOOTSTRAP_TOKEN=${TOKEN}
AGENTFLOW_RUNNER_NAME=${NAME:-$(hostname)}
AGENTFLOW_RUNNER_CONCURRENCY=${CONCURRENCY}
AGENTFLOW_GATE_MCP_BINARY=${GATE_BINARY_PATTERN}
EOF
chmod 600 "$ENV_FILE"
info "配置已写入 ${ENV_FILE}(权限 600)"
export AGENTFLOW_GATE_MCP_BINARY="$GATE_BINARY_PATTERN"

# ---------- 3. 注册 / 启动 ----------
RUN_ARGS=(-server "$SERVER" -token "$TOKEN" -name "${NAME:-$(hostname)}" -concurrency "$CONCURRENCY" -state "$STATE_FILE")
if [[ "$AUTO_UPDATE" == "0" ]]; then
  RUN_ARGS+=(-auto-update=false)
fi

# 用户当前 PATH:launchd/systemd 的服务环境只有 /usr/bin:/bin,不含
# ~/.local/bin、Homebrew、nvm 等 CLI 安装目录,必须显式带入。
USER_PATH="${PATH}"

if [[ "$NO_START" == "1" ]]; then
  info "已完成安装与配置(--no-start,未启动)。手动启动:"
  info "  $BINARY ${RUN_ARGS[*]}"
  info "常驻方式:追加 --service 重新执行本脚本;卸载:追加 --uninstall(--purge 删除全部配置)"
elif [[ "$INSTALL_SERVICE" == "1" ]]; then
  if [[ "$OS" == "darwin" ]]; then
    cat > "$PLIST" <<EOF
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
  <key>Label</key><string>com.agentflow.runner</string>
  <key>ProgramArguments</key><array>
    <string>${BINARY}</string>
EOF
    for arg in "${RUN_ARGS[@]}"; do printf '    <string>%s</string>\n' "$arg" >> "$PLIST"; done
    # plist 值需要 XML 转义(& 等)
    ESCAPED_PATH=$(printf '%s' "$USER_PATH" | sed 's/&/\&amp;/g; s/</\&lt;/g; s/>/\&gt;/g')
    ESCAPED_GATE_PATTERN=$(printf '%s' "$GATE_BINARY_PATTERN" | sed 's/&/\&amp;/g; s/</\&lt;/g; s/>/\&gt;/g')
    cat >> "$PLIST" <<EOF
  </array>
  <key>EnvironmentVariables</key><dict>
    <key>PATH</key><string>${ESCAPED_PATH}</string>
    <key>AGENTFLOW_GATE_MCP_BINARY</key><string>${ESCAPED_GATE_PATTERN}</string>
  </dict>
  <key>RunAtLoad</key><true/>
  <key>KeepAlive</key><true/>
  <key>StandardOutPath</key><string>${RUNNER_HOME}/runner.log</string>
  <key>StandardErrorPath</key><string>${RUNNER_HOME}/runner.log</string>
</dict></plist>
EOF
    launchctl unload "$PLIST" >/dev/null 2>&1 || true
    launchctl load "$PLIST"
    info "launchd 服务已安装并启动(日志: ${RUNNER_HOME}/runner.log)"
  elif linux_has_systemd; then
    mkdir -p "$(dirname "$UNIT")"
    {
      echo "[Unit]"
      echo "Description=AgentFlow CLI Runner"
      echo "After=network-online.target"
      echo ""
      echo "[Service]"
      echo "Environment=PATH=${USER_PATH}"
      echo "Environment=AGENTFLOW_GATE_MCP_BINARY=${GATE_BINARY_PATTERN}"
      printf 'ExecStart=%s' "$BINARY"
      for arg in "${RUN_ARGS[@]}"; do printf ' %s' "$arg"; done
      echo ""
      echo "Restart=always"
      echo "RestartSec=5"
      echo ""
      echo "[Install]"
      echo "WantedBy=default.target"
    } > "$UNIT"
    require_systemd_user_bus
    systemctl --user daemon-reload
    systemctl --user enable agentflow-runner.service
    systemctl --user restart agentflow-runner.service
    info "systemd 服务已安装并启动(journalctl --user -u agentflow-runner -f 查看日志)"
  else
    start_background_runner
  fi
  info "卸载方式:curl -fsSL ${SERVER}/runners/install.sh | bash -s -- --uninstall"
else
  info "前台启动 agentflow-runner(Ctrl+C 停止;常驻请加 --service)..."
  exec "$BINARY" "${RUN_ARGS[@]}"
fi