kicer 29be7bd9d7 feat(shell): 抽出执行后端,Windows 用 git-bash / busybox 跑命令
POSIX 上 spawn('/bin/sh') + kill(-pid) 是刻意选的最强约束:/bin/sh 固定
(不读 $SHELL,否则用户把 shell 设成 fish 后模型写的 POSIX 语法全废),
进程组让「停止」能一次带走孙进程。Windows 这三样都没有,同一个写法从
「有效」变成「静默失效」,detached 还会多弹一个控制台。

把三种能力收敛到 app/server/shell.js(resolve / spawnShell / killTree),
terminal、技能、engine 的取消都改走它,上层不再出现 process.platform 分支:

  - POSIX 分支逐字节不变,Linux / macOS / OpenWrt 行为与拆分前一致
  - Windows 依次探测 git-bash、busybox-w32,都没有就明确报错,不静默退到
    cmd.exe——cmd 的语法与模型写的 POSIX 差太远,降级只会让它反复试错
  - killTree 在 Windows 走 taskkill /T:child.kill() 只杀 shell 本身,
    模型起的 node/python/ffmpeg 孙进程会留下来继续占端口
  - detached 在 Windows 关闭(会新建控制台,且让子进程脱离 taskkill 的父子树)
  - 三级覆盖:AGENT_SHELL > config.terminal.shell > 自动探测;
    AGENT_SHELL_ARGS 可改参数模板(bash 想读 rc 时写 -lc)

新增 local/start-win.mjs:start.sh 那 1100 多行 bash 靠 lsof / pgrep /
readlink -f / nohup / setsid / 进程组信号,Windows 一个都没有。启动器这层
本来就只做进程管理,用 Node 重写更省事;业务代码一行都不分平台。首次运行
自动把 busybox-w32(单文件 600KB)下到 local/bin/,生成 local/config.win.yml,
之后不再覆盖。

验证(macOS 实跑):普通命令 / 超时 704ms / 取消 403ms 三条路径正常,进程组
3 个进程 kill 后归 0,procs 无残留;真实 core 启动 health 200,日志多一行
terminal=/bin/sh -c ← default。win32 分支只做了逻辑模拟(无 shell 的报错
文案、有 busybox 时解析为 busybox sh -c),真机待验。

未做:Windows 启动器未拉起四个同栈 MCP 与 office 预览网关,配置里
mcp_servers 暂为空,terminal / 文件工具 / 技能不受影响。
2026-11-19 11:27:17 +08:00
2026-10-20 16:04:39 +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。

需要从外网访问时,配好 tunnel/client.yml 后 start.sh 会一并拉起隧道 client;未配置则跳过。

组成

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

配置

./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 内网
  • 隧道只经服务器 nginx(TLS)对外,宿主机端口仅绑 127.0.0.1;server.yml 与 client.yml 的 token 必须一致
  • 命令在 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%