Files
agent/app
kicer 60d8278610 fix(local): 远程访问时 /api/local/* 一律 404,工作目录入口不再「点了没反应」
经隧道从手机访问时 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
2026-11-15 14:27:07 +08:00
..
2026-10-20 14:57:12 +08:00

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/ 前端(无构建,按序加载脚本)