youran-agent

把一台有 Docker 的 Linux 机器变成 Youran worker 节点。公开发布在 npmjs，安装零配置：

npm i -g youran-agent
youran-agent up     # 交互式向导:问网关(有默认值)/token/并发 → 体检 → 常驻运行

up 幂等可反复跑：已配置项回车跳过；改并发也可以再跑一次 up 或 youran-agent config set AGENT_MAX_CONCURRENT_RUNS=N（即时生效）。 脚本化场景用 up --gateway <url> --token <t> --concurrency N 免交互。

宿主机前置：Docker、Node ≥ 22（macOS/Linux 均可，常驻托管由内置 PM2 跨平台处理）。除网关地址与 token 外的全部运行配置（含 worker 镜像版本）由中心下发；daemon 轮询检测到配置版本变化后 drain 并重建 worker 容器， 镜像热更新即配置变更的特例。

| 命令 | 作用 | | ---------------------------------------------- | ---------------------------------------------- | | enroll --gateway <url> --token <t> | 注册并验证网关（网关地址与 key 属本机配置） | | start [--poll-seconds N] [--drain-seconds N] | 前台运行 reconcile daemon | | status | enroll / 本机配置 / 期望版本 / worker 状态 | | local [set K=V...\|unset K...] | 本机配置：并发/标签/浏览器等机器属性 | | config [set K=V...\|unset K...\|set-image R] | 中心配置：镜像/LLM 等全局项（admin token） | | logs [--follow] | worker 容器日志 | | stop [--drain-seconds N] | drain 停掉 worker 容器 | | uninstall | 停掉并删除 worker 容器（状态目录保留） |

配置分两层：本机配置（config，存 ~/.youran-agent/local.env，dotenv 格式可手编） 只收机器属性——并发量、标签、浏览器/监控墙开关，因为每台宿主机承载力不同，这类值 本机优先于中心下发。中心配置（镜像版本、LLM provider、Phoenix 等全局一致项）由 管理员经 backend 的 GET/PUT /v1/admin/workers/config 管理——worker 机上的 CLI 刻意 不提供改全网配置的能力。任一层变更后 daemon 都会在下个轮询周期内 drain+重建 worker 生效，机器上无需手工重启。

状态目录默认 ~/.youran-agent（YOURAN_AGENT_HOME 覆盖）。daemon 退出不带走 worker 容器；升级 daemon 不影响在跑任务。

本包不含任何凭证与业务逻辑——worker 镜像（私有 GHCR，拉取凭证随中心配置下发） 才承载业务；架构、配置契约与 systemd 模板见仓库内 wiki/agent-cli-daemon.md。