经隧道从手机访问时 core 跑在家里那台机器上、local 路由存在,前端会显示「工作目录」 入口;点下去调 /api/local/pick-dir 会在宿主机屏幕上弹原生对话框,用户看不到, 表现成点击无响应。 这些接口(弹目录对话框 / 开 Finder / 开终端)只有坐在这台机器前才有意义。加一个 中间件:非本机访问直接 404,行为和服务器形态完全一致(那边 server.js 根本不挂这个 路由),前端原有的 catch 就会把入口整条隐藏 —— 前端零改动。 判断看 X-Forwarded-* 头是否存在(反向代理的标准约定,不依赖具体 nginx 配置): - 不能用 IP:stream 把 443 分流到 127.0.0.1:1443,nginx 看到的源地址永远是 127.0.0.1 - 不能用 Host:tunnel client 用 fetch 转发时 Host 是禁止头,被重写成 127.0.0.1:8090
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/ |
前端(无构建,按序加载脚本) |