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
…

Agent 任务台

自托管的 Agent 系统。浏览器或微信下发任务,模型在独立工作目录里读写文件、执行命令、调用技能,产物直接回传。

Agent 任务台

快速开始

服务器

需要 Docker 与 Compose v2:

./scripts/init.sh
docker compose up -d --build

打开 http://<服务器 IP>:8090,用 admin / admin 登录,先改密码,再到「设置 → 模型」添加平台和 API Key,保存后点「重启服务」。

本机运行

macOS / Linux,Node 20+,不需要 Docker:

./local/start.sh    # 后台启动
./local/stop.sh

首次运行会让你选一个工作目录(技能、会话、数据库都在里面)。命令直接在本机执行,没有沙箱隔离,只监听 127.0.0.1。

组成

目录 说明
app/ agent-core:Express + SQLite + 前端静态资源,唯一对外端口
executor/ agent-executor:隔离的命令执行、Office 预览网关
wxbot/ 微信接入
mcp/ 四个 MCP 服务:网页搜索、图片生成、视频生成、语音转写
skills/ 内置技能
local/ 本机模式启动器

配置

./scripts/init.sh 首次生成 config.yml,只有 agent-core 读取。日常改动走设置页,保存后点「重启服务」。

platforms:
  - name: bigmodel
    url: https://open.bigmodel.cn/api/paas/v4
    models:
      - id: glm-5.3-flash
        vision: true
    keys:
      - api_key: "sk-..."

端口与其余环境变量在 docker-compose.yml 里。

升级

git pull
docker compose up -d --build

数据在 data/、tasks/ 和 config.yml 里,升级不受影响。

安全

  • 对外只开 agent-core 一个端口,其余服务只在 Docker 内网
  • 命令在 executor 容器里执行,只挂当前会话目录,根文件系统只读
  • 单租户设计:除管理员接口外不做用户级资源隔离,不要开放给互不信任的人
  • config.yml、.env、wxbot/data/ 存密钥,已加入 .gitignore

License

AGPL-3.0,见 LICENSE。

S
Description
自托管的 Agent 任务台。每个会话绑定服务器上一个独立工作目录,模型在其中读写文件、执行命令、抓取网页,并调用技能与 MCP 服务。任务可从浏览器或微信提交,产物直接写入该目录。模型层兼容任意 OpenAI /chat/completions 接口,命令在隔离容器中执行。
Readme AGPL-3.0
4.5 MiB
2026-11-19 22:16:54 +08:00
Languages
JavaScript 71.2%
Python 9.4%
CSS 6.6%
HTML 6.3%
Shell 4.2%
Other 2.3%