#!/bin/sh # local/start.sh —— 本机(macOS / Linux)一键启动 agent-core。 # # 这个脚本只负责「把容器部署的形状换成本机形状」,不改任何业务逻辑: # 1. 探测环境(node 必需;ffmpeg 决定能不能语音;python3 决定 Python 技能能否执行) # 2. 首次运行:选工作目录 + 生成 local/config.local.yml # 3. 起 core(+ 四个同栈 MCP 子进程),就绪后打开浏览器 # 4. 守护:core 退出就拉起来 # # 第 4 步是必须的,不是锦上添花:设置页的「重启」按钮实现是 process.exit(0), # 原本靠 Docker 的 restart 策略把容器拉起来(routes/system.js 注释写明「非 docker 部署不会自动拉起」)。 # 本地没有 Docker,没有这个循环,用户配完模型一点重启,服务就再也回不来了。 # # 为什么用 POSIX sh 写:macOS 自带的是 bash 3.2(2007 年),没有关联数组等语法, # 当作 sh 跑最稳,Linux 上也一样。 set -u HERE=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd) ROOT=$(CDPATH= cd -- "$HERE/.." && pwd) RUNTIME="$HERE/.runtime" CONFIG="$HERE/config.local.yml" LOG="$RUNTIME/core.log" NPM_LOG="$RUNTIME/npm-install.log" PORT="${PORT:-8090}" HOST_ADDR="127.0.0.1" NPM_REGISTRY="${NPM_REGISTRY:-}" # 依赖缓存:装成功后把 node_modules 打一张 tarball 存这里,重启 / 换 clone / 删 node_modules # 都能直接解压恢复,完全不走网络。放用户缓存目录(而不是仓库里)是为了多个 clone 共享; # 卸载时删这一个目录就行(README 有写)。 LOCAL_CACHE="${AGENT_LOCAL_CACHE:-${XDG_CACHE_HOME:-$HOME/.cache}/agent-local}" REGISTRY_CACHE="$RUNTIME/registry" # npm 源候选。并行探测、挑最快的,所以国内会选 npmmirror、海外会选官方,不用用户干预。 REGISTRY_CANDIDATES='https://registry.npmmirror.com https://registry.npmjs.org' # 四个同栈 MCP 服务在服务器上是各自独立的容器,都监听 3000 也不冲突; # 本地挤在同一台机器上,必须各占一个端口。默认紧跟 core 的 8090 往后排, # 所以 core 换端口时(PORT=xxx)要留意别撞上这四个——下面有冲突检查。 MCP_WEB_PORT="${MCP_WEB_PORT:-8091}" MCP_IMAGE_PORT="${MCP_IMAGE_PORT:-8092}" MCP_VIDEO_PORT="${MCP_VIDEO_PORT:-8093}" MCP_ASR_PORT="${MCP_ASR_PORT:-8094}" # core 与 MCP 抢同一个端口时,后起的那个会 bind 失败、被 start.sh 静默降级成 # 「能力缺失」,排查成本很高。这里直接拒绝启动。 PORT_COLLIDE=0 for p in "$MCP_WEB_PORT" "$MCP_IMAGE_PORT" "$MCP_VIDEO_PORT" "$MCP_ASR_PORT"; do [ "$p" = "$PORT" ] && PORT_COLLIDE=1 done mkdir -p "$RUNTIME" printf '\n==== %s 启动 ====\n' "$(date '+%Y-%m-%d %H:%M:%S')" >> "$LOG" if [ -t 1 ]; then C='\033[1;32m'; Y='\033[1;33m'; N='\033[0m' # 终端窗口标题:开着一堆窗口时能一眼认出哪个是它(也是「怎么停」的钥匙)。 printf '\033]0;Agent 本地端 :%s\007' "$PORT" else C=''; Y=''; N='' fi say() { printf "${C}==>${N} %s\n" "$*"; } warn() { printf "${Y}[!]${N} %s\n" "$*"; } # ---------- 探测 ---------- NODE_VER='' NODE_OK=0 if command -v node >/dev/null 2>&1; then NODE_VER=$(node -v 2>/dev/null || echo '') # 用真跑一次判定而不是只看版本字符串:确保这个 node 是可执行的。 if node -e 'process.exit(parseInt(process.versions.node, 10) >= 20 ? 0 : 1)' >/dev/null 2>&1; then NODE_OK=1 fi fi NPM_OK=0 command -v npm >/dev/null 2>&1 && NPM_OK=1 # macOS 的 /usr/bin/python3 是 Xcode 命令行工具的桩:文件存在,但没装 CLT 时一执行就弹安装窗。 # 所以必须真跑一句,command -v 会骗人。 PY_OK=0 PY_VER='' if command -v python3 >/dev/null 2>&1 && python3 -c 'import sys' >/dev/null 2>&1; then PY_OK=1 PY_VER=$(python3 -c 'import sys;print("%d.%d"%sys.version_info[:2])' 2>/dev/null || echo '') fi FF_OK=0 FF_VER='' if command -v ffmpeg >/dev/null 2>&1 && ffmpeg -version >/dev/null 2>&1; then FF_OK=1 FF_VER=$(ffmpeg -version 2>/dev/null | head -n 1 | sed -e 's/^ffmpeg version //' -e 's/ .*//') fi PORT_FREE=1 if [ "$NODE_OK" = 1 ]; then node -e 'const net=require("net"),s=net.createServer();s.once("error",()=>process.exit(1));s.listen(Number(process.argv[1]),"127.0.0.1",()=>s.close(()=>process.exit(0)))' "$PORT" >/dev/null 2>&1 || PORT_FREE=0 fi case "$(uname -s)" in Darwin) NODE_HINT='brew install node@20,或到 nodejs.org 下载 macOS 安装包';; *) NODE_HINT='用 nvm 安装(nvm install 20),或发行版包管理器装 nodejs 20+';; esac # ---------- 自检页(纯静态,无 node 也能打开) ---------- # 失败时会用浏览器打开它。浏览器里的标签页只有页面自己给的标题,所以每页都带应用名 # (否则用户开着一堆标签,根本不知道这窗口是谁弹的)+ 仓库/日志路径 + 失败日志尾部。 esc() { sed -e 's/&/\&/g' -e 's//\>/g'; } html_escape() { printf '%s' "$1" | esc; } open_target() { if command -v open >/dev/null 2>&1; then open "$1" >/dev/null 2>&1 || true elif command -v xdg-open >/dev/null 2>&1; then xdg-open "$1" >/dev/null 2>&1 || true fi } # ---------- 状态页 ---------- # 不需要常驻 HTTP 服务:脚本把状态写进 $RUNTIME/ui/ 下的文件,ui_render 拼成整页, # 页面靠 每秒重读。这样「连 node 都没装」时也能打开。 # 长步骤(npm install / 起 core)另起一个心跳子进程每秒重绘,日志尾巴也就跟着动了。 # # 状态全部落文件而不是留在 shell 变量里:心跳子进程拿到的是 fork 时的快照,用变量会越刷越旧。 # ui/title 页面大标题(一行) # ui/steps 追加的步骤行() # ui/busy 进行中的步骤:第一行文案、第二行开始时间戳 # ui/logpath 当前步骤要展示尾巴的日志文件 # ui/redirect 成功后自动跳转的地址 # ui/error 失败说明(HTML 片段) UI_DIR="$RUNTIME/ui" UI_OPEN=0 # 状态页是否已经开过一次。ui_init 开了就不在 ui_fail 里再开一个(同一个页面两个标签,用户会懵)。 UI_OPENED=0 TICKER_PID='' esc() { sed -e 's/&/\&/g' -e 's//\>/g'; } html_escape() { printf '%s' "$1" | esc; } open_target() { if command -v open >/dev/null 2>&1; then open "$1" >/dev/null 2>&1 || true elif command -v xdg-open >/dev/null 2>&1; then xdg-open "$1" >/dev/null 2>&1 || true fi } # 默认 macOS 自动弹出(桌面端就该这样);Linux 服务器上不乱开窗口,需要时 AGENT_LOCAL_UI=1。 ui_should_open() { case "${AGENT_LOCAL_UI:-auto}" in 0|off|no) return 1;; 1|on|yes) return 0;; esac [ "$(uname -s)" = 'Darwin' ] } ui_init() { rm -rf "$UI_DIR" mkdir -p "$UI_DIR" : > "$UI_DIR/steps" printf '启动中\n' > "$UI_DIR/title" ui_render if ui_should_open; then UI_OPEN=1 UI_OPENED=1 open_target "$RUNTIME/status.html" fi } # 无状态渲染:所有内容都从文件读,所以心跳子进程也能安全调。 # 先写临时文件再 mv:浏览器可能正好在刷新,不能让它读到半截 HTML。 # 临时文件名必须每次不同:$$ 在子 shell 里仍是主 shell 的 PID(POSIX), # 心跳与主流程同时渲染时会撞车(mv 报 No such file)。 ui_render() { tmp=$(mktemp "$RUNTIME/.status.XXXXXX" 2>/dev/null) || tmp="$RUNTIME/status.html.$$.tmp" { printf '\n\n' printf '\n' if [ -s "$UI_DIR/redirect" ]; then # 后续启动:2 秒后自动进应用(同一个标签页,不再多开一个窗) printf '\n' "$(cat "$UI_DIR/redirect")" elif [ -s "$UI_DIR/ready" ]; then # 首次安装:就停在这一页,不自动跳(也不刷新),等用户点链接 printf '\n' else printf '\n' fi printf 'Agent 本地端 - %s\n' "$(cat "$UI_DIR/title" 2>/dev/null)" cat <<'CSS' CSS printf '
\n' printf '

Agent 本地端 / local/start.sh

\n' printf '

%s

\n' "$(cat "$UI_DIR/title" 2>/dev/null)" printf '

仓库 %s
日志目录 %s

\n' \ "$(html_escape "$ROOT")" "$(html_escape "$RUNTIME")" cat "$UI_DIR/error" 2>/dev/null if [ -s "$UI_DIR/steps" ]; then printf '\n' cat "$UI_DIR/steps" printf '
\n' fi if [ -f "$UI_DIR/busy" ]; then bmsg=$(sed -n 1p "$UI_DIR/busy") bsince=$(sed -n 2p "$UI_DIR/busy") case "$bsince" in ''|*[!0-9]*) bsince=$(date +%s);; esac printf '

进行中:%s(已 %s 秒)

\n' \ "$(html_escape "$bmsg")" "$(( $(date +%s) - bsince ))" fi # 日志尾巴:进行中和失败时都要。注意不能放在上面的 busy 分支里—— # ui_fail 会先清掉 busy,放里面的话失败页反而看不到日志。 if [ -f "$UI_DIR/busy" ] || [ -f "$UI_DIR/error" ]; then if [ -f "$UI_DIR/error" ]; then log_lines=40; log_title='日志(末尾 40 行)' else log_lines=20; log_title='实时输出(末尾 20 行)'; fi lf=$(cat "$UI_DIR/logpath" 2>/dev/null) if [ -n "$lf" ] && [ -f "$lf" ]; then printf '

%s

' "$log_title"
        tail -n "$log_lines" "$lf" 2>/dev/null | esc
        printf '
\n' fi fi # 首次安装的「下一步」提示(ui_done 写) cat "$UI_DIR/note" 2>/dev/null if [ -f "$UI_DIR/error" ]; then printf '

修好后重新执行 ./local/start.sh。日志都放在上面的日志目录里(core.log、npm-install.log、mcp-*.log)。

\n' elif [ -s "$UI_DIR/redirect" ] || [ -s "$UI_DIR/ready" ]; then url=$(cat "$UI_DIR/redirect" 2>/dev/null) [ -n "$url" ] || url=$(cat "$UI_DIR/ready") # 后续启动:会自己跳;首次安装:只停在这页等点击。两种情况都留一个按钮兜底。 if [ -s "$UI_DIR/redirect" ]; then printf '

2 秒后自动打开应用;没反应就点下面的按钮。

\n' fi printf '

打开应用 %s

\n' "$url" "$url" printf '

停止服务:运行 ./local/stop.sh(关掉这个页面不影响服务)。

\n' else printf '

本页每秒自动刷新,进度会自己出现。

\n' fi printf '
\n' } > "$tmp" && mv -f "$tmp" "$RUNTIME/status.html" rm -f "$tmp" } ui_title() { printf '%s\n' "$1" > "$UI_DIR/title"; ui_render; } # 步骤标记只用 ASCII(OK / .. / ! / X),别搞花哨符号。 ui_step() { # $1 文字 $2 ok|run|warn|bad case "$2" in ok) m='OK';; warn) m='!';; bad) m='X';; *) m='..';; esac printf '%s%s\n' "${2:-run}" "$m" "$(html_escape "$1")" >> "$UI_DIR/steps" ui_render } # 标记一个「正在进行」的步骤:会开一个每秒重绘的心跳,把计时和日志尾巴刷新出来。 ui_busy() { # $1 文案 $2 日志文件(可选) ui_stop_ticker printf '%s\n%s\n' "$1" "$(date +%s)" > "$UI_DIR/busy" if [ -n "${2:-}" ]; then printf '%s\n' "$2" > "$UI_DIR/logpath"; else : > "$UI_DIR/logpath"; fi ui_render if [ "$UI_OPEN" = 1 ]; then ( while [ -f "$UI_DIR/busy" ]; do sleep 1; ui_render; done ) & TICKER_PID=$! fi } # 只换「进行中」的文案,保留开始时间:换源重试时计时不该归零(否则看起来像卡死后重来)。 ui_busy_relabel() { if [ ! -f "$UI_DIR/busy" ]; then ui_busy "$1" "${2:-}"; return 0; fi bsince=$(sed -n 2p "$UI_DIR/busy" 2>/dev/null) case "${bsince:-}" in ''|*[!0-9]*) bsince=$(date +%s);; esac printf '%s\n%s\n' "$1" "$bsince" > "$UI_DIR/busy" [ -n "${2:-}" ] && printf '%s\n' "$2" > "$UI_DIR/logpath" ui_render } # 必须显式收掉并清空 PID:心跳在 busy 文件消失后自己退出,但变量还留着旧的 PID, # 下一个步骤就不会再起心跳(页面会永远停在「已 0 秒」)。 ui_stop_ticker() { [ -n "$TICKER_PID" ] && kill "$TICKER_PID" 2>/dev/null TICKER_PID='' } ui_idle() { ui_stop_ticker; rm -f "$UI_DIR/busy"; ui_render; } ui_done() { # $1 应用地址 $2 auto|click(首次安装用 click:给链接让用户自己点,不自动跳) ui_stop_ticker rm -f "$UI_DIR/busy" "$UI_DIR/error" "$UI_DIR/redirect" "$UI_DIR/ready" "$UI_DIR/note" printf '%s\n' "${1:-}" > "$UI_DIR/ready" if [ "${2:-auto}" = 'auto' ]; then printf '%s\n' "${1:-}" > "$UI_DIR/redirect" else # 首次安装用户就停在这页,那下一步怎么配模型也得写在页上,不能只在终端里。 printf '

首次使用:进去后点左下角「用户区」→ 设置 → 模型池,添加平台和 API Key,再点「重启」(服务会自动拉起来)。

\n' > "$UI_DIR/note" fi ui_title '已启动' } ui_fail() { # $1 标题 $2 说明(HTML) $3 日志文件(可选) ui_stop_ticker rm -f "$UI_DIR/busy" "$UI_DIR/redirect" printf '%s\n' "$1" > "$UI_DIR/title" printf '

%s

\n' "$2" > "$UI_DIR/error" [ -n "${3:-}" ] && printf '%s\n' "$3" > "$UI_DIR/logpath" ui_render # 失败一定要让人看到:本次还没弹过就补开一次(Linux 上 ui_init 默认不开,失败也要能看见)。 if [ "$UI_OPENED" != 1 ]; then UI_OPENED=1 open_target "$RUNTIME/status.html" fi printf '\n状态页:%s\n' "$RUNTIME/status.html" } ui_checks() { if [ "$NODE_OK" = 1 ]; then ui_step "Node.js ${NODE_VER}(需要 20+)" ok else ui_step "Node.js 缺失或版本过低:$NODE_HINT" bad; fi if [ "$NPM_OK" = 1 ]; then ui_step 'npm 可用(装依赖用)' ok else ui_step 'npm 缺失:随 Node.js 一起装,重装 Node 即可' bad; fi if [ "$PY_OK" = 1 ]; then ui_step "python3 ${PY_VER}" ok else ui_step 'python3 未安装(Python 技能会失败)' warn; fi if [ "$FF_OK" = 1 ]; then ui_step "ffmpeg ${FF_VER}" ok else ui_step 'ffmpeg 未安装(语音不可用)' warn; fi if [ "$PORT_FREE" = 1 ]; then ui_step "端口 $PORT 可用" ok else ui_step "端口 $PORT 已被占用(换 PORT=8099)" bad; fi } # ---------- 首次运行:选目录 + 生成配置 ---------- choose_workspace() { ws='' if [ "$(uname -s)" = 'Darwin' ] && command -v osascript >/dev/null 2>&1; then ws=$(osascript -e 'POSIX path of (choose folder with prompt "选择 Agent 的工作目录:会在里面创建 data、skills、tasks 三个子目录")' 2>/dev/null) || ws='' fi if [ -z "$ws" ] && [ -t 0 ]; then printf '工作目录(会在里面创建 data、skills、tasks)[%s/AgentWork]: ' "$HOME" read -r ans || ans='' if [ -n "${ans:-}" ]; then ws=$ans; else ws="$HOME/AgentWork"; fi fi [ -z "$ws" ] && ws="$HOME/AgentWork" printf '%s\n' "${ws%/}" } generate_config() { ws=$1 mkdir -p "$ws/tasks" "$ws/data" "$ws/skills" 2>/dev/null || { say "无法创建工作目录:$ws"; exit 1; } cat > "$CONFIG" </skills),与 data/、tasks/ 同级。仓库 skills/ 只是出厂副本: # 这里只补缺——工作目录里没有的内置技能才复制,已存在的一律不动,所以用户改过的、 # AI 自己新建的技能都不会被覆盖。要拿仓库里的新版技能:删掉对应子目录再重跑本脚本。 # deps 不复制:仓库那份是服务器构建期产物,平台和版本都不该跟着走;本地 pip 自己装。 # 取配置里一个标量值(去掉引号)。不试图当 YAML 解析器用:配置是本脚本生成的,格式稳定。 cfg_get() { sed -n "s/^[[:space:]]*$1:[[:space:]]*[\"']\{0,1\}\([^\"']*\)[\"']\{0,1\}[[:space:]]*$/\1/p" \ "$CONFIG" 2>/dev/null | head -n 1 } # 技能根:配置里的 skills_root;留空则取 workspace_root 的同级 skills(与 core 的默认一致)。 skills_dir() { d=$(cfg_get skills_root) if [ -z "$d" ]; then w=$(cfg_get workspace_root) [ -n "$w" ] && d="$(dirname "$w")/skills" fi printf '%s' "$d" } sync_skills() { dest=$1 [ -n "$dest" ] || { warn '配置里既没有 skills_root 也没有 workspace_root,技能不可用'; return 1; } mkdir -p "$dest/deps" 2>/dev/null || { warn "无法创建技能目录:$dest"; return 1; } added=0 for s in "$ROOT/skills"/*; do [ -d "$s" ] || continue name=${s##*/} [ "$name" = 'deps' ] && continue [ -e "$dest/$name" ] && continue cp -R "$s" "$dest/$name" 2>/dev/null && added=$((added + 1)) done [ "$added" -gt 0 ] && say "技能:复制 $added 个内置技能到 $dest" return 0 } # 依赖是否装全:0 = 齐全,非 0 = 缺(npm install 中途失败、被手工删过等)。 # 为什么不用 require.resolve:mcp/image_task 依赖 @modelcontextprotocol/sdk 这类纯 ESM 包, # 它的 exports.require 指向的文件在发布包里并不存在(只有 import 能解析), # require.resolve 会误判成「没装」,于是每次启动都重装一遍。 # 改为看 node_modules//package.json 在不在:能拦住「目录建了但内容没解开」的半成品。 deps_resolvable() { node -e ' const fs = require("fs"), path = require("path"); const dir = process.argv[2]; const pkg = require(path.resolve(process.argv[1])); for (const dep of Object.keys(pkg.dependencies || {})) { if (!fs.existsSync(path.join(dir, "node_modules", dep, "package.json"))) process.exit(1); } ' "$1/package.json" "$1" >/dev/null 2>&1 } # ---------- npm 源:自动探测 ---------- # 国内直连 registry.npmjs.org 经常几十秒超时,而 npm 自己不会换源。用户不该被要求懂这些, # 所以装之前并行探一次候选源、挑最快的,结果缓存一天。 # 约束:只通过命令行参数传源,绝不写 ~/.npmrc —— 不为了装依赖改用户的全局配置。 probe_registry() { node -e ' const ctl = (ms) => { const c = new AbortController(); setTimeout(() => c.abort(), ms); return c.signal; }; const probe = async (r) => { const t0 = Date.now(); try { await fetch(r + "/-/ping", { signal: ctl(3000) }); return { r, ms: Date.now() - t0 }; } catch { return null; } }; Promise.all(process.argv.slice(1).map(probe)).then((rs) => { const ok = rs.filter(Boolean).sort((a, b) => a.ms - b.ms); if (!ok.length) process.exit(1); process.stdout.write(ok[0].r); }); ' $REGISTRY_CANDIDATES } registry_cached() { [ -f "$REGISTRY_CACHE" ] || return 1 reg=$(sed -n 1p "$REGISTRY_CACHE" 2>/dev/null) ts=$(sed -n 2p "$REGISTRY_CACHE" 2>/dev/null) [ -n "${reg:-}" ] || return 1 case "${ts:-}" in ''|*[!0-9]*) return 1;; esac [ $(( $(date +%s) - ts )) -lt 86400 ] || return 1 printf '%s' "$reg" } registry_remember() { { printf '%s\n' "$1"; date +%s; } > "$REGISTRY_CACHE" 2>/dev/null || true } short_reg() { printf '%s' "${1#https://}" | sed -e 's|/$||'; } # 选出要用的源;返回 1 = 一个都连不上。 pick_registry() { # 用户显式指定的源优先级最高 if [ -n "$NPM_REGISTRY" ]; then printf '%s' "$NPM_REGISTRY"; return 0; fi # 有代理时探针不可信(node 的 fetch 不走 env 代理,npm 会走),交给 npm 自己 if [ -n "${HTTPS_PROXY:-}${https_proxy:-}${HTTP_PROXY:-}${http_proxy:-}${ALL_PROXY:-}" ]; then printf '%s' "$(npm config get registry 2>/dev/null || printf '')" return 0 fi # npm 全局配置里显式改过源(公司私有源)→ 尊重它,不覆盖 cfg=$(npm config get registry 2>/dev/null || printf '') case "$cfg" in ''|https://registry.npmjs.org|https://registry.npmjs.org/) : ;; *) printf '%s' "$cfg"; return 0 ;; esac cached=$(registry_cached) && { printf '%s' "$cached"; return 0; } reg=$(probe_registry) || return 1 [ -n "${reg:-}" ] || return 1 registry_remember "$reg" printf '%s' "$reg" } # ---------- 依赖缓存 ---------- # 装成功之后把 node_modules 打一张 tarball 放到用户缓存目录:重启、删 node_modules、 # 换一个 clone 都直接解压恢复,完全不走网络。文件名带平台 / 架构 / Node ABI / # 依赖清单哈希 —— 原生模块(better-sqlite3 的 .node)与 ABI 绑定,不能混用。 cache_key() { node -e ' const fs = require("fs"), crypto = require("crypto"); const h = crypto.createHash("sha256"); for (const f of process.argv.slice(1)) { try { h.update(fs.readFileSync(f)); } catch {} } process.stdout.write(h.digest("hex").slice(0, 16)); ' "$ROOT/app/package.json" "$ROOT/app/package-lock.json" "$ROOT"/mcp/*/package.json } cache_file() { abi=$(node -p 'process.versions.modules' 2>/dev/null || printf '0') printf '%s/deps-%s-%s-abi%s-%s.tgz' "$LOCAL_CACHE" \ "$(uname -s | tr 'A-Z' 'a-z')" "$(uname -m)" "$abi" "$(cache_key)" } # 有依赖并且已经装好的目录(相对仓库根 + /node_modules),打包缓存用它。 cache_dirs() { for d in "$ROOT/app" "$ROOT"/mcp/*/; do [ -f "$d/package.json" ] || continue [ -d "$d/node_modules" ] || continue node -e 'process.exit(Object.keys(require(process.argv[1]).dependencies||{}).length?0:1)' "$d/package.json" >/dev/null 2>&1 || continue rel=${d#"$ROOT"/}; rel=${rel%/} printf '%s\n' "$rel/node_modules" done } # 需要安装的目录(每行一个,容忍路径里有空格)。 # 不能只看 node_modules 在不在:npm install 中途失败会留下「目录在、包不全」的半成品, # 按「存在即已装」判断就会永远跳过安装,core 起来立刻 require 失败。 need_dirs() { for d in "$ROOT/app" "$ROOT"/mcp/*/; do [ -f "$d/package.json" ] || continue node -e 'process.exit(Object.keys(require(process.argv[1]).dependencies||{}).length?0:1)' "$d/package.json" >/dev/null 2>&1 || continue if [ ! -d "$d/node_modules" ] || [ ! -f "$d/node_modules/.agent-installed" ] \ || [ "$d/package.json" -nt "$d/node_modules/.agent-installed" ] \ || ! deps_resolvable "$d"; then printf '%s\n' "$d" fi done } cache_restore() { f=$(cache_file) [ -f "$f" ] || return 1 say "使用本地依赖缓存:$f" ui_busy_relabel '恢复本地依赖缓存(不走网络)' if ! tar -xzf "$f" -C "$ROOT" >>"$NPM_LOG" 2>&1; then warn '缓存解压失败,改为联网安装' return 1 fi return 0 } cache_save() { list=$(cache_dirs) [ -n "$list" ] || return 0 mkdir -p "$LOCAL_CACHE" 2>/dev/null || return 0 f=$(cache_file) tmp="$f.part" # tar 里的路径相对仓库根,解压时 -C "$ROOT" 就能还原 if printf '%s\n' "$list" | tar -czf "$tmp" -C "$ROOT" -T - >/dev/null 2>&1; then mv -f "$tmp" "$f" 2>/dev/null || rm -f "$tmp" # 只留最近 3 份:每次依赖变化都会产生新文件,不清理会一直涨 ls -t "$LOCAL_CACHE"/deps-*.tgz 2>/dev/null | tail -n +4 | while IFS= read -r old; do rm -f "$old"; done say "依赖缓存:$f" else rm -f "$tmp" 2>/dev/null || true fi } # ---------- 依赖安装 ---------- # 跑一次 npm install(输出落日志),带看门狗。 # npm 10 + Node 22 在网络失败时既不退出也不报错(已知的 "Exit handler never called"): # 没有超时用户就会干等到崩溃。超过上限就杀掉,交给外层换源重试。 NPM_TIMEOUT="${AGENT_LOCAL_NPM_TIMEOUT:-240}" npm_install_into() { _dir=$1; _reg=$2 ( cd "$_dir" && npm install --no-audit --no-fund --omit=dev \ --registry "$_reg" --replace-registry-host=always \ --fetch-retries=2 --fetch-timeout=20000 --prefer-offline ) >>"$NPM_LOG" 2>&1 & _pid=$! _waited=0 NPM_TIMED_OUT=0 while kill -0 "$_pid" 2>/dev/null; do if [ "$_waited" -ge "$NPM_TIMEOUT" ]; then warn "npm ${NPM_TIMEOUT} 秒没有响应,结束它并换源重试" # 直接 KILL:npm 卡死时不理 TERM;kill_tree_hard 先递归子进程再杀自己, # 不会像「先 TERM 后 KILL」那样把 npm 变成孤儿(PPID=1)漏在外面。 NPM_TIMED_OUT=1 kill_tree_hard "$_pid" break fi sleep 2 _waited=$((_waited + 2)) # 前台模式下给个心跳,否则长时间没输出像是卡死了 if [ $((_waited % 20)) -eq 0 ]; then printf ' ... %s 秒\n' "$_waited"; fi done wait "$_pid" 2>/dev/null } # 不只 app:mcp/image_task 与 mcp/video_task 也带 npm 依赖(@modelcontextprotocol/sdk + express), # 服务器上这些是镜像构建时装好的,本地得自己装。asr / web_search 是零依赖,自动跳过。 ensure_deps() { if ! need_dirs | grep -q .; then ui_step 'Node 依赖已就绪(无需安装)' ok return 0 fi if [ "$NPM_OK" != 1 ]; then SETUP_TITLE='缺少 npm,无法安装依赖' SETUP_HINT='Node.js 一般自带 npm。若你是用系统包管理器装的 node,可能需要单独安装 npm。' return 1 fi : > "$NPM_LOG" # 1) 本地缓存:装过一次后,重启 / 删 node_modules / 换 clone 都是解压,秒级且零网络 if cache_restore; then if ! need_dirs | grep -q .; then ui_idle ui_step 'Node 依赖已就绪(本地缓存恢复)' ok return 0 fi warn '缓存不完整,剩下的改为联网安装' fi # 2) 选源。一个都连不上就别让 npm 重试三次刷屏,直接给结论。 reg=$(pick_registry) || reg='' if [ -z "$reg" ]; then SETUP_TITLE='连不上任何 npm 源' SETUP_HINT="npmmirror 与官方源都连不上,安装没法进行。检查代理 / VPN 后重跑;或在有网络的机器上装好,把缓存目录拷过来:$(html_escape "$LOCAL_CACHE")。" return 1 fi # 什么情况不自动换源:用户显式指定了源,或用的是公司私有源(乱兜底到公网可能装错东西)。 # 用公共源(npmmirror / 官方)时换源重试是安全的,也是国内环境最需要的。 allow_fallback=0 case "$reg" in *registry.npmmirror.com*|*registry.npmjs.org*) allow_fallback=1 ;; esac [ -n "$NPM_REGISTRY" ] && allow_fallback=0 REG_TRY="$reg" if [ "$allow_fallback" = 1 ]; then for c in $REGISTRY_CANDIDATES; do [ "$c" = "$reg" ] || REG_TRY="$REG_TRY $c" done fi ntry=0 for t in $REG_TRY; do ntry=$((ntry + 1)); done say "安装 Node 依赖(源:$(short_reg "$reg"),通常 1~3 分钟;已装好的目录会跳过)" # 长步骤:页面上会持续显示已用秒数 + npm 输出的尾巴(心跳每秒重绘)。 ui_busy '安装 Node 依赖' "$NPM_LOG" ui_step "依赖源:$(short_reg "$reg")" ok TRIED_REGS='' ndir=0 need_dirs > "$RUNTIME/needs.txt" while IFS= read -r d; do [ -n "$d" ] || continue ndir=$((ndir + 1)) drel=${d#"$ROOT"/}; drel=${drel%/} installed=0 i=0 for try_reg in $REG_TRY; do i=$((i + 1)) say " npm install → ${drel}($(short_reg "$try_reg"),第 $i/$ntry 次)" ui_busy_relabel "安装依赖:${drel}($(short_reg "$try_reg"),第 $i/$ntry 次)" "$NPM_LOG" # 上一轮失败会留下半成品,不清掉重试大概率还是失败 [ "$i" -gt 1 ] && rm -rf "$d/node_modules" npm_install_into "$d" "$try_reg" TRIED_REGS="$TRIED_REGS $try_reg" if deps_resolvable "$d"; then installed=1 # 换源成功就记住它,下次不用再探测 [ -n "$NPM_REGISTRY" ] || registry_remember "$try_reg" break fi done if [ "$installed" != 1 ]; then install_failed "$drel" return 1 fi # 打时间戳:npm 在「已经是最新」时不会更新 node_modules 的 mtime, # 只看目录 mtime 会导致每次启动都白跑一次 install。 touch "$d/node_modules/.agent-installed" done < "$RUNTIME/needs.txt" ui_idle ui_step "Node 依赖已装好($ndir 个目录)" ok cache_save return 0 } # 把 npm 的输出翻译成一句人话:用户不该去读 gyp / ETIMEDOUT 这些字眼。 # 原文仍然完整落在 npm-install.log,状态页只在尾巴里展示。 npm_hint() { tail -n 300 "$NPM_LOG" 2>/dev/null > "$RUNTIME/npm-tail.txt" if grep -qiE 'gyp ERR!|xcrun: error|Command Line Tools|clang: error|cannot find Python' "$RUNTIME/npm-tail.txt"; then printf '%s' '本机缺少编译工具链:某个依赖要现场编译原生模块。装一下 Xcode 命令行工具再重跑:xcode-select --install。' elif grep -qiE 'EAI_AGAIN|ENOTFOUND|ETIMEDOUT|ECONNRESET|ECONNREFUSED|Exit handler never called|CERT_|self.signed|socket hang up|network' "$RUNTIME/npm-tail.txt"; then printf '%s' '网络没通:npm 连不上源(已自动换源重试过)。多半是代理 / VPN,或公司网络拦截了 registry。' elif grep -qiE 'EACCES|EPERM|permission denied' "$RUNTIME/npm-tail.txt"; then printf '%s' '没有写权限:常见于以前用 sudo 装过依赖(目录属主变成 root)。删掉这些 node_modules 后重跑。' elif [ "${NPM_TIMED_OUT:-0}" = 1 ]; then printf '%s' '源没有响应:npm 卡住超过上限被终止(已自动换源重试)。多半是网络 / 代理 / 被墙。' else printf '%s' '依赖没有装成功,原因见下面的 npm 输出。' fi } # 安装失败时把「怎么再试」写进自检页。npm 在断网时只会吐一句 # "Exit handler never called!"(npm 10 + Node 22 的已知毛病),不提源就无从下手。 install_failed() { SETUP_TITLE='依赖安装失败' tried='' for t in ${TRIED_REGS:-}; do [ -n "$tried" ] && tried="${tried}、" tried="$tried$(short_reg "$t" | esc)" done [ -n "$tried" ] || tried='(默认配置)' SETUP_HINT="$(printf '%s' "$1" | esc):$(npm_hint)
已尝试的源:${tried}。也可以自己指定:NPM_REGISTRY=https://registry.npmmirror.com ./local/start.sh。下面是 npm 的原始输出。" } # ---------- 子进程 ---------- MCP_PIDS='' # 四个服务对接参数的方式不一样,别混用: # image_task / video_task / web_search → 认 --http --host --port # mcp_asr → 只认 PORT 环境变量(它的 argv 不解析) start_mcp_flags() { dir=$1; mport=$2; tag=$3; shift 3 ( cd "$ROOT/mcp/$dir" && exec node "$@" --host "$HOST_ADDR" --port "$mport" >>"$RUNTIME/mcp-$tag.log" 2>&1 ) & MCP_PIDS="$MCP_PIDS $!" } start_mcp_env() { dir=$1; mport=$2; tag=$3; shift 3 ( cd "$ROOT/mcp/$dir" && exec env PORT="$mport" node "$@" >>"$RUNTIME/mcp-$tag.log" 2>&1 ) & MCP_PIDS="$MCP_PIDS $!" } CORE_PID='' STOPPING=0 kill_tree() { # 只用 $1,不先赋给变量:POSIX sh 没有局部变量,递归会覆盖它,回到外层时 # kill 的就不是原本那个进程(踩过:看门狗杀了子进程,父进程和 npm 都留着)。 [ -n "${1:-}" ] || return 0 if command -v pgrep >/dev/null 2>&1; then for c in $(pgrep -P "$1" 2>/dev/null); do kill_tree "$c"; done fi kill "$1" 2>/dev/null || true } # 彻底送走(SIGKILL):npm 卡死时会忽略 TERM(就是 "Exit handler never called" 那个毛病)。 kill_tree_hard() { [ -n "${1:-}" ] || return 0 if command -v pgrep >/dev/null 2>&1; then for c in $(pgrep -P "$1" 2>/dev/null); do kill_tree_hard "$c"; done fi kill -KILL "$1" 2>/dev/null || true } do_cleanup() { # 心跳子进程也得收掉,不然退出后它会继续每秒重绘页面。 ui_stop_ticker rm -f "$RUNTIME/ui/busy" "$RUNTIME/supervisor.pid" "$RUNTIME/preview.port" for p in $CORE_PID $MCP_PIDS; do kill_tree "$p"; done CORE_PID='' MCP_PIDS='' } # 收到 INT/TERM/HUP 就真停:先置标志,再主动收掉 core。 # 只置标志不够:信号可能只到了脚本(终端关窗发 HUP 就是这种),而 core 还活着, # 启动器会卡在 wait 上不退出。kill 掉 core 才能让 wait 返回、循环看到 STOPPING 后收尾。 # 信号处理在「后台化」之后才安装:父进程 spawn 完子进程就退出, # 如果此时已有 EXIT trap,do_cleanup 会把子进程刚写的 supervisor.pid 删掉(实测过)。 health() { if command -v curl >/dev/null 2>&1; then curl -fsS --max-time 2 "http://$HOST_ADDR:$PORT/api/health" >/dev/null 2>&1 else node -e 'fetch("http://127.0.0.1:"+process.argv[1]+"/api/health").then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))' "$PORT" >/dev/null 2>&1 fi } # 是否已有启动器在跑(打印它的 pid,退出码 0/1)。 # 只看 health() 不够:core 起来要几秒(先起 MCP、装依赖可能更久),这期间再跑一次 start.sh # 就会拉起第二个启动器;两个 core 抢同一个端口,一个 EADDRINUSE 被守护循环反复重启(实测过), # 而 stop.sh 只认 pid 文件里那一个,等于停不干净。 # 子进程一启动就把自己的 pid 写进 supervisor.pid,所以这个判断是秒级的。 running_supervisor() { [ -f "$RUNTIME/supervisor.pid" ] || return 1 spid=$(cat "$RUNTIME/supervisor.pid" 2>/dev/null) || return 1 [ -n "$spid" ] || return 1 kill -0 "$spid" 2>/dev/null || return 1 # pid 可能已被系统回收给别的进程:确认它真是本脚本(命令行可能是相对路径,匹配文件名即可)。 case "$(ps -p "$spid" -o command= 2>/dev/null || true)" in *start.sh*) printf '%s' "$spid"; return 0 ;; esac return 1 } port_open() { node -e 'const s=require("net").connect(Number(process.argv[1]),"127.0.0.1");s.setTimeout(800);s.on("connect",()=>{s.destroy();process.exit(0)});s.on("error",()=>process.exit(1));s.on("timeout",()=>{s.destroy();process.exit(1)})' "$1" >/dev/null 2>&1 } # MCP 起不来是静默降级(core 只会发现不到工具),所以启动后主动点名报告。 check_mcp() { if ! port_open "$1"; then warn "MCP $2 没起来(端口 $1)——日志:local/.runtime/mcp-$2.log" fi } # ---------- 预览网关:office 文档的 iframe 预览 ---------- # 服务器上这条链是 core → 反代 /preview → executor 的 :3100 预览网关;本地没有 executor, # 由 local/preview-gateway.js 顶上:收到预览请求就按需起 `officecli watch`,再转发页面与 SSE。 # 端口默认 3100(与服务器一致),被占就往后找几个:本机可能已经有别的服务占着 3100。 pick_preview_port() { p="${PREVIEW_PORT:-3100}" i=0 while [ "$i" -lt 10 ]; do port_open "$p" || { printf '%s' "$p"; return 0; } p=$((p + 1)); i=$((i + 1)) done return 1 } start_preview() { printf '%s\n' "$PREVIEW_PORT" > "$RUNTIME/preview.port" ( cd "$ROOT" && exec env \ OFFICE_PREVIEW_HOST="$HOST_ADDR" \ OFFICE_PREVIEW_PORT="$PREVIEW_PORT" \ AGENT_TASKS_ROOT="$TASKS_DIR" \ AGENT_SKILLS_ROOT="$SKILLS_DIR" \ AGENT_REPO_ROOT="$ROOT" \ AGENT_CORE_URL="http://$HOST_ADDR:$PORT" \ AGENT_RUNTIME="$RUNTIME" \ node local/preview-gateway.js >>"$RUNTIME/preview.log" 2>&1 ) & MCP_PIDS="$MCP_PIDS $!" } start_core() { # PYTHONPATH 把技能依赖层 <工作目录>/skills/deps 放进 python 搜索路径(与服务器上 executor 容器 # 的 PYTHONPATH 对齐,那边由 compose 注入)。本地没有 agent-executor-init 替我们装包, # 所以另外把目录路径作为 AGENT_SKILLS_DEPS 传下去:技能缺什么时,模型按该技能目录的 # AGENTS.md 自行安装(提示词里只给这一句指路),启动器不认识任何具体技能。 # AGENT_IMAGE_INLINE:本机监听 127.0.0.1,模型厂商拉不到回环地址,读图回传改走内联 # data URL(服务器形态不设,照旧签 /p/ 短链)。 ( cd "$ROOT/app" && exec env \ PORT="$PORT" \ HOST="$HOST_ADDR" \ AGENT_CONFIG="$CONFIG" \ AGENT_FILE_SCOPE=workspace \ AGENT_LOCAL_PICK=1 \ AGENT_IMAGE_INLINE=1 \ ASR_URL="$ASR_URL" \ PYTHONPATH="$SKILLS_DIR/deps" \ AGENT_SKILLS_DEPS="$SKILLS_DIR/deps" \ PREVIEW_PROXIES="[{\"name\":\"office\",\"prefix\":\"/preview\",\"host\":\"$HOST_ADDR\",\"port\":${PREVIEW_PORT:-3100}}]" \ OFFICE_GATEWAY_PORT="${PREVIEW_PORT:-3100}" \ node server/server.js >>"$LOG" 2>&1 ) & CORE_PID=$! } open_browser() { url="http://$HOST_ADDR:$PORT" if command -v open >/dev/null 2>&1; then open "$url" >/dev/null 2>&1 || true elif command -v xdg-open >/dev/null 2>&1; then xdg-open "$url" >/dev/null 2>&1 || true fi } # ============ 后台化 ============ # start.sh 只做入口:把真正的启动器甩到后台(独立会话)就返回,所以终端里跑完就能关窗口/做别的事。 # 停止统一走 ./local/stop.sh(或状态页上写的命令)。 # 前台模式(看实时日志、Ctrl-C 停):AGENT_LOCAL_DETACH=0 ./local/start.sh # AGENT_LOCAL_DETACHED 是子进程标记,防自己无限重入。 if [ "${AGENT_LOCAL_DETACH:-1}" = 1 ] && [ "${AGENT_LOCAL_DETACHED:-0}" != 1 ]; then if spid=$(running_supervisor); then say "已在运行(启动器 pid ${spid}):http://$HOST_ADDR:$PORT" printf '停止:%s/stop.sh\n' "$HERE" exit 0 fi # 启动器已经退出的残留 pid 文件:留着会误导下面这次启动,直接清掉。 rm -f "$RUNTIME/supervisor.pid" if health; then # 端口上有 agent-core,但不是本启动器拉起的(例如手动 node server.js,或启动器被 kill -9 后的遗留)。 # 这里不能再起一个(两个 core 抢同一端口),也不能声称"已在运行"(本次没有守护循环)。 say "$PORT 端口上已有 agent-core 在运行(不是本启动器拉起的)" printf '先停掉它,再重新启动:%s/stop.sh\n' "$HERE" exit 0 fi # node 是硬前提,且跟「选哪个目录」无关:先拦下来,别让用户白选目录、白生成一份配置。 if [ "$NODE_OK" != 1 ]; then ui_init ui_checks warn '启动前自检未通过:没有找到可用的 Node.js 20+' printf '安装方式:%s\n' "$NODE_HINT" ui_fail '启动前自检未通过' '没有找到可用的 Node.js 20+,服务起不来。按下面表格里的提示装好后,重新执行 ./local/start.sh。' exit 1 fi # 首次运行在父进程里做完(选目录需要 tty / 弹窗),子进程只管起服务。 first_run=0 if [ ! -f "$CONFIG" ]; then say '首次运行:需要选一个 AI 的工作目录' WS=$(choose_workspace) generate_config "$WS" first_run=1 fi # 用 node 起而不是 nohup:detached 会 setsid,子进程脱离终端的会话与进程组,关窗口/杀终端 # 都碰不到它。只靠 nohup 不行——子进程里 trap HUP 覆盖了 nohup 的忽略位,终端一关 # 就走到 on_signal,把 core 和 MCP 一起收掉(Terminal 上实测会挂,iTerm2 不断只是因为 # 它送信号的方式不同,不能指望)。 child=$(node -e ' const fs = require("fs"); const [log, script, first] = process.argv.slice(1); const fd = fs.openSync(log, "a"); const c = require("child_process").spawn("/bin/sh", [script], { detached: true, stdio: ["ignore", fd, fd], env: Object.assign({}, process.env, { AGENT_LOCAL_DETACHED: "1", AGENT_LOCAL_FIRST_RUN: first }) }); c.unref(); process.stdout.write(String(c.pid)); ' "$LOG" "$HERE/start.sh" "$first_run" 2>>"$LOG") sleep 1 if [ -n "$child" ] && kill -0 "$child" 2>/dev/null; then printf '\n已转到后台运行(pid %s)\n' "$child" printf '应用:http://%s:%s\n' "$HOST_ADDR" "$PORT" printf '进度/日志:%s/status.html · %s\n' "$RUNTIME" "$LOG" printf '停止:%s/stop.sh\n' "$HERE" exit 0 fi warn "启动失败:$(cat "$UI_DIR/title" 2>/dev/null || printf '后台进程立刻退出了')" # 真正的错误和日志尾巴都在状态页上(子进程的 stdout 只进日志,光 tail 日志看不到为什么)。 printf '原因和日志:%s/status.html\n' "$RUNTIME" printf '后台日志:%s\n' "$LOG" exit 1 fi # 把自己记下来:local/stop.sh 靠它先停启动器(只停 core 会被守护重新拉起来)。 printf '%s\n' "$$" > "$RUNTIME/supervisor.pid" # 信号处理:收到 INT/TERM/HUP 就真停(只置标志不够,core 还活着时 wait 不会返回)。 on_signal() { STOPPING=1 [ -n "$CORE_PID" ] && kill_tree "$CORE_PID" } trap 'on_signal' INT TERM HUP trap 'do_cleanup' EXIT # ============ 主流程 ============ ui_init ui_checks if [ "$NODE_OK" != 1 ]; then warn '启动前自检未通过:没有找到可用的 Node.js 20+' printf '安装方式:%s\n' "$NODE_HINT" ui_fail '启动前自检未通过' '没有找到可用的 Node.js 20+,服务起不来。按下面表格里的提示装好后,重新执行 ./local/start.sh。' exit 1 fi if [ "$PORT_COLLIDE" = 1 ]; then ui_fail '端口冲突' "core 要用 ${PORT},但这四个端口被 MCP 服务占着(8091~8094)。要么换 core 端口(PORT=8099 ./local/start.sh),要么显式改写 MCP 端口(如 MCP_WEB_PORT=8101),但后者还要同步改配置里的 url。" exit 1 fi if [ "$PORT_FREE" != 1 ]; then ui_fail '端口被占用' "端口 $PORT 上已经有程序在监听。关掉它,或者换个端口启动:PORT=8099 ./local/start.sh(8091~8094 留给 MCP,别占用;记得把设置页里的访问地址一起改)。" exit 1 fi # 首次安装(配置是本次刚生成的)不自动跳进应用:状态页给按钮,用户自己点。 # 后台模式下这件事是父进程做完再告诉子进程的(AGENT_LOCAL_FIRST_RUN),否则子进程看到的 # 配置已经存在,会误判成「二次启动」而自动跳转。 FIRST_RUN="${AGENT_LOCAL_FIRST_RUN:-0}" if [ ! -f "$CONFIG" ]; then FIRST_RUN=1 say '首次运行:需要选一个 AI 的工作目录' ui_busy '请在弹出的窗口里选择 AI 的工作目录' WS=$(choose_workspace) generate_config "$WS" ui_idle ui_step "工作目录:$WS" ok ui_step '已生成 local/config.local.yml' ok else say "使用已有配置:$CONFIG" ui_step '沿用已有配置 local/config.local.yml' ok # 配置首次生成后永不覆盖,所以 MCP 端口只存在配置里。如果它和本次要起的端口不一致 # (改过默认值、或用了 MCP_*_PORT 覆盖),core 会发现不到工具,但只会在日志里留一条 warn。 for pair in "web:$MCP_WEB_PORT" "image:$MCP_IMAGE_PORT" "video:$MCP_VIDEO_PORT" "asr:$MCP_ASR_PORT"; do tag=${pair%%:*}; mp=${pair#*:} grep -q "127.0.0.1:$mp" "$CONFIG" || { warn "配置里的 $tag MCP 端口与本次启动(${mp})不一致,该能力将不可用;改 $CONFIG 或重新生成配置" ui_step "配置里 $tag MCP 端口不是 ${mp}(该能力将不可用)" warn } done fi if ! ensure_deps; then ui_fail "${SETUP_TITLE:-依赖安装失败}" "${SETUP_HINT:-安装 app/ 的 Node 依赖时出错了,多半是网络问题。}" "$NPM_LOG" exit 1 fi SKILLS_DIR=$(skills_dir) [ -n "$SKILLS_DIR" ] || SKILLS_DIR="$ROOT/skills" # 配置里两个键都被删掉时的兼底 if sync_skills "$SKILLS_DIR"; then if [ "$PY_OK" = 1 ]; then ui_step "技能:$SKILLS_DIR" ok else ui_step "技能:${SKILLS_DIR}(python3 未安装,Python 技能会失败)" warn; fi else ui_step '技能目录不可用(检查配置里的 skills_root)' warn fi # 会话工作区:配置里的 workspace_root(local 形态 = <工作目录>/tasks);给预览网关解析会话目录用。 TASKS_DIR=$(cfg_get workspace_root) [ -n "$TASKS_DIR" ] || TASKS_DIR="$(dirname "$SKILLS_DIR")/tasks" if PREVIEW_PORT=$(pick_preview_port); then start_preview ui_step "预览网关:$HOST_ADDR:${PREVIEW_PORT}(office 文档)" ok else PREVIEW_PORT='' warn '找不到空闲的预览端口(3100-3109),office 文档的预览将不可用' ui_step '预览网关未启动(3100-3109 都被占用)' warn fi # 语音:ffmpeg 在就启用,两条线都靠同一个开关: # ASR_URL 注入 → core 才挂 /api/asr、前端才显示麦克风 # mcp_asr 子进程 → 模型的 transcribe_audio 工具(它转码依赖 ffmpeg,没有就没意义) # 配置里的 asr 条目总是保留(配置首次生成后不覆盖),所以没 ffmpeg 时 core 会报一次 # 「asr 工具发现失败」——那是预期,不是故障。 say '启动 MCP 服务…' ui_busy "启动 MCP 服务(${MCP_WEB_PORT}-${MCP_ASR_PORT})" start_mcp_flags web_search "$MCP_WEB_PORT" web server.js --http start_mcp_flags image_task "$MCP_IMAGE_PORT" image src/mcp-server.js --http start_mcp_flags video_task "$MCP_VIDEO_PORT" video src/mcp-server.js --http if [ "$FF_OK" = 1 ]; then ASR_URL="http://$HOST_ADDR:$MCP_ASR_PORT" start_mcp_env asr "$MCP_ASR_PORT" asr src/server.js MCP_COUNT='4 个' else ASR_URL='' MCP_COUNT='3 个(asr 未启动:没有 ffmpeg)' fi ui_idle ui_step "MCP 子进程已启动:$MCP_COUNT" ok say "启动 agent-core(${HOST_ADDR}:${PORT})…" # 等 core 健康检查最多 60 秒,这期间页面一直显示「进行中 + core 日志尾巴」。 ui_busy "启动 agent-core(${HOST_ADDR}:${PORT})" "$LOG" FIRST=1 FAILS=0 while :; do start_core i=0 while [ "$i" -lt 60 ]; do health && break kill -0 "$CORE_PID" 2>/dev/null || break sleep 1 i=$((i + 1)) done if health; then if [ "$FIRST" = 1 ]; then FIRST=0 ui_idle ui_step "agent-core 已就绪:http://${HOST_ADDR}:${PORT}" ok check_mcp "$MCP_WEB_PORT" web check_mcp "$MCP_IMAGE_PORT" image check_mcp "$MCP_VIDEO_PORT" video [ "$FF_OK" = 1 ] && check_mcp "$MCP_ASR_PORT" asr # 预览网关挂了不会影响别的功能,但它静默失败时用户只会看到空白预览,所以点名。 if [ -n "${PREVIEW_PORT:-}" ] && ! port_open "$PREVIEW_PORT"; then warn "预览网关没起来(端口 ${PREVIEW_PORT})——日志:local/.runtime/preview.log" fi if [ "$FIRST_RUN" = 1 ]; then # 首次安装:停在状态页,给一个按钮让用户自己点(先看完「首次使用」提示再进去)。 ui_done "http://${HOST_ADDR}:${PORT}" click # 状态页没弹出来时(Linux / AGENT_LOCAL_UI=0)总得给个入口,否则用户什么都看不到。 [ "$UI_OPEN" = 1 ] || open_browser else ui_done "http://${HOST_ADDR}:${PORT}" auto open_browser fi printf '\n' say "已启动:http://$HOST_ADDR:$PORT" sleep 1 if [ "$FF_OK" = 1 ]; then say '语音:可用' else say '语音:未启用(缺 ffmpeg)' fi if [ "$PY_OK" = 1 ]; then say '技能:已启用' else say '技能:python3 未安装(Python 技能暂不可用)' fi if [ "$FIRST_RUN" = 1 ]; then printf '\n首次使用:左下角「用户区」→ 设置 → 模型池,添加平台和 API Key,然后点「重启」。\n' fi printf '停止:Ctrl-C,或 %s/stop.sh\n\n' "$HERE" fi else warn 'agent-core 没能起来,最近日志:' tail -n 30 "$LOG" 2>/dev/null || true kill_tree "$CORE_PID" CORE_PID='' ui_fail 'agent-core 没能启动' "配置或依赖有问题,服务没起来。日志尾部附在下方;改完重跑 ./local/start.sh。若刚在设置页改过配置,也可能是 YAML 写坏了:$(html_escape "$CONFIG" | sed -e 's|.*/||')。" "$LOG" exit 1 fi wait "$CORE_PID" 2>/dev/null code=$? [ "$STOPPING" = 1 ] && break # 设置页的「重启」就是 exit 0;非 0 = 崩溃。连续崩 5 次就停下来别刷屏(典型是配置写坏了)。 if [ "$code" = 0 ]; then FAILS=0; else FAILS=$((FAILS + 1)); fi if [ "$FAILS" -ge 5 ]; then warn "agent-core 连续 $FAILS 次异常退出,不再自动重启。最近日志:" tail -n 30 "$LOG" 2>/dev/null || true ui_fail "agent-core 反复启动失败($FAILS 次)" '最常见的原因是配置写坏了(YAML 缩进/引号)或依赖装了一半。日志尾部在下方;改完重跑 ./local/start.sh。' "$LOG" exit 1 fi warn 'agent-core 已退出,1 秒后自动拉起(设置页点「重启」走的也是这条路)' sleep 1 done say '已停止。'