后台化与停止 - start.sh 默认后台启动(AGENT_LOCAL_DETACH=1):拉起真正的启动器后 1 秒返回, 终端窗口可以关掉;停止统一走新增的 local/stop.sh(pid 文件 → core 父进程 → 占端口 三级兜底,幂等)。保留 AGENT_LOCAL_DETACH=0 前台模式。 - 「已在运行」改看 supervisor.pid(kill -0 + 命令行校验),health 只做兜底。 原来只看 health 时,core 尚未就绪的几秒内连跑两次会拉起两个启动器抢同一端口。 启动失败与首装体验 - 没 node 时在入口就拦下(生成配置之前),终端打出安装方式,不再让用户白选目录。 - 首次安装停在状态页等点击,后续启动才 2 秒自动跳转;状态页同一轮只开一个标签。 - 后台子进程秒退时改为指向状态页与日志路径,不再打印两行无意义的启动横幅。 其他修正 - MCP 默认端口 3101~3104 → 8091~8094;PORT 撞 MCP 端口直接拒绝启动。 - 没 ffmpeg 时不启动 mcp_asr(配置条目保留,装好后重跑即生效)。 - 依赖检测改为逐包检查 + .agent-installed 时间戳;npm install 输出落盘进状态页。 - app/package-lock.json 的 resolved 从腾讯云内网镜像改为公共 registry。 - 删除 local/start.command(Finder 双击常被当文本预览,入口统一为 start.sh)。 - 文档:docs/local-mode.md 补验证结果与新设计说明;local/README.md 改为启动/停止用法。
agent-core
agent 仓库的 core 服务:Express + SQLite + 静态 H5 前端。
对外能力、部署与配置见仓库根 ../README.md。
本地运行
cd app
npm install
cp config.example.yml config.yml
# 本地调试时把 workspace_root / data_root 改到仓库内可写目录
AGENT_CONFIG=./config.yml node server/server.js
默认监听 8090。platforms 可以留空,启动后到设置页添加模型并重启。
关键文件
| 文件 | 职责 |
|---|---|
server/server.js |
装配配置、DB、SSE、路由与启动顺序 |
server/engine.js |
会话、模型池、Agent 主循环、压缩、标题、日记收口 |
server/llm.js |
消息组装与上游流式调用 |
server/tools/executor.js |
内置工具与路径沙箱 |
server/tools/definitions.json |
内置工具 schema |
server/routes/ |
HTTP API |
server/public/ |
前端(无构建,按序加载脚本) |