部署初始化收敛:init.sh 不再生成配置,只做 .env + 公网地址 + 初始 admin
- scripts/init.sh 重写:不再生成模型/MCP/用户配置;只维护 .env(幂等复用密钥、保留手改变量)、 探测 PUBLIC_BASE_URL、config.yml 缺失时写入初始管理员(admin/admin)。已存在绝不改写; Docker 误建的空目录自动删除重建,非空目录报错退出;去掉 --env-only 参数 - config.js:config.yml 缺失/为空/被误建成目录都能正常启动(不再 EISDIR 崩);PATCH 在文件 缺失时以空文档继续并自动创建;public_link 改为 config.yml 优先、PUBLIC_BASE_URL 兜底 - compose:ASR_URL 固定为 http://mcp_asr:3000;agent-core 注入 PUBLIC_BASE_URL; token 缺失提示改指 scripts/init.sh - 删除 .env.example(与 init.sh/compose 重复),引用改指 README - 移除仓库内所有 VIRTUAL_HOST/VIRTUAL_PORT/CERT_NAME 关联(特定部署的反代约定,不进仓库) - 同步 README / AGENTS.md / config.example.yml / init_host.sh / wxbot / mcp 文档
This commit is contained in:
@@ -1,28 +0,0 @@
|
||||
# .env.example — 仓库根 .env 模板(.env 已 gitignore,不会被提交)。
|
||||
# 标准路径是跑 ./scripts/init.sh:自动生成下面全部密钥并幂等复用(重跑不掉登录态、不换 token)。
|
||||
# 本文件仅作手动部署参考;手动生成 token:openssl rand -hex 32。
|
||||
# 其余部署旋钮(EXECUTOR_URL、*_LOG_LEVEL、VIRTUAL_HOST 等)都在 docker-compose.yml 里改,不放这里。
|
||||
|
||||
# ---- 必填(compose 用 ${VAR:?} 检查,缺失则 docker compose up 直接报错)----
|
||||
|
||||
# core ↔ executor 调用鉴权(compose 注入两侧同值)
|
||||
EXECUTOR_TOKEN=change-me-openssl-rand-hex-32
|
||||
|
||||
# core ↔ wxbot 微信接入服务 token(compose 注入两侧同值;未就位 = 微信入口整体静默关闭)
|
||||
WXBOT_TOKEN=change-me-openssl-rand-hex-32
|
||||
|
||||
# 登录态签名密钥:init.sh 写进 config.yml 的 auth.secret 并在此复用;
|
||||
AUTH_SECRET=change-me-openssl-rand-hex-32
|
||||
|
||||
# ---- 可选 ----
|
||||
|
||||
# agent-core 映射到宿主机的端口(默认 8090),改这里就不用动 docker-compose.yml
|
||||
# AGENT_PORT=8090
|
||||
# agent-core 拼接 /transcribe 的基地址(默认内网 mcp_asr)。填外网地址即可把语音识别放到另一台机器,
|
||||
# 写成空值(ASR_URL=)则关闭语音输入。
|
||||
# ASR_URL=http://mcp_asr:3000
|
||||
|
||||
# ---- 仅调试:临时把对应 MCP 服务映射到宿主机端口(默认注释掉;改完记得注释回去)----
|
||||
# WEB_SEARCH_PORT=8081
|
||||
# IMAGE_TASK_PORT=8082
|
||||
# VIDEO_TASK_PORT=8083
|
||||
@@ -24,7 +24,7 @@
|
||||
| `wxbot/` | 微信 iLink 协议调制解调器(多实例) | 独立容器 `agent-wxbot` |
|
||||
| `mcp/` | 同栈 MCP 服务:`web_search` / `image_task` / `video_task` / `asr` | 四个容器,仅内网 |
|
||||
| `skills/` | 目录式技能(`SKILL.md` + `run.py`/`run.sh`) | 运行时挂载,`skills/deps` 为依赖层 |
|
||||
| `scripts/` | `init.sh` 生成 `.env` + `config.yml`;`init_host.sh` 裸机初始化 | 幂等 |
|
||||
| `scripts/` | `init.sh` 生成 `.env` + 首次创建 `config.yml`(仅初始管理员);`init_host.sh` 裸机初始化 | 幂等,**不覆盖已有配置** |
|
||||
| `docs/` | 专题文档:`tool-design.md`(工具接口规范)、`OFFICE.md` | — |
|
||||
| `tasks/` | **运行时数据**:每个会话一个工作目录 | gitignore |
|
||||
| `data/` | **运行时数据**:SQLite `.agent.db`、`prompt.txt` 调试产物 | gitignore |
|
||||
@@ -60,7 +60,7 @@ flowchart TD
|
||||
| `agent-core` | 8090 | 宿主机映射,**唯一对外** |
|
||||
| `agent-executor` | 9000(exec)、3100(预览网关) | 仅 `expose`,内网 |
|
||||
| `agent-wxbot` | 8093 | 仅内网 |
|
||||
| `mcp_*` | 3000 | 仅内网;compose 里注释掉的 `ports` 仅供本机调试 |
|
||||
| `mcp_*` | 3000 | 仅内网 |
|
||||
|
||||
### 数据持久化(bind mount)
|
||||
|
||||
@@ -83,8 +83,9 @@ flowchart TD
|
||||
### 环境变量(接线全靠根 `.env` + compose)
|
||||
|
||||
`AGENT_CONFIG`、`PORT`、`EXECUTOR_URL`、`EXECUTOR_TOKEN`、`WXBOT_URL`、`WXBOT_TOKEN`、
|
||||
`ASR_URL`、`VIRTUAL_HOST`、`PREVIEW_PROXIES`、`EXECUTOR_LOG_LEVEL`、`WXBOT_LOG_LEVEL`、`ASR_LOG_LEVEL`。
|
||||
密钥生成:`./scripts/init.sh`(幂等,重跑不掉登录态)。语音识别的上游 key/base/model 不在 env,
|
||||
`PUBLIC_BASE_URL`、`ASR_URL`、`PREVIEW_PROXIES`、`EXECUTOR_LOG_LEVEL`、`WXBOT_LOG_LEVEL`、`ASR_LOG_LEVEL`。
|
||||
密钥生成:`./scripts/init.sh`(幂等,重跑不掉登录态;**从不覆盖已有 config.yml**,只在其缺失时创建
|
||||
最小骨架)。语音识别的上游 key/base/model 不在 env,
|
||||
写在 `config.yml` 的 `mcp_servers[name=asr].headers`(容器不存平台密钥)。
|
||||
|
||||
## 三条主链路
|
||||
@@ -161,7 +162,7 @@ curl -s http://127.0.0.1:8090/api/health
|
||||
| 配置默认值 | `app/server/config.js` 的 `DEFAULTS` ↔ `app/config.example.yml` |
|
||||
| 内置工具 | `app/server/tools/definitions.json` ↔ `app/AGENTS.md` / README 工具表 ↔ `docs/tool-design.md` 规范 |
|
||||
| 新增服务 / 端口 / 卷 | `docker-compose.yml` ↔ `README.md` 的部署与安全章节 |
|
||||
| 新增环境变量 | `.env.example` ↔ compose ↔ README「环境变量」 |
|
||||
| 新增环境变量 | compose ↔ README「环境变量」 |
|
||||
| 发版号 | `app/package.json` 的 `version` ↔ `app/server/routes/system.js` 的 `VERSION` 字面量(两者不自动同步) |
|
||||
| 技能格式 | `skills/README.md` ↔ `app/server/tools/skills.js` 的解析 |
|
||||
| 对外 API | `app/server/routes/*` ↔ 前端 `app/server/public/js/*` ↔ README |
|
||||
|
||||
@@ -41,38 +41,34 @@
|
||||
|
||||
Debian 12 裸机可以先跑 `scripts/init_host.sh`(幂等,可重复执行,也可单独拷到服务器上跑):它会配好 Swap、Docker、国内镜像加速与基础 shell 环境;`REGION=oversea` 切海外源。跑完会打印后续的 `init.sh` 与部署步骤。
|
||||
|
||||
### 1. 生成配置
|
||||
### 1. 初始化(只做部署接线)
|
||||
|
||||
在仓库根目录执行:
|
||||
|
||||
```bash
|
||||
BIGMODEL_KEY=xxx \
|
||||
DEEPSEEK_KEY=yyy \
|
||||
QWEN_KEY=zzz \
|
||||
AUTH_USER=admin \
|
||||
AUTH_PASSWORD='换一个强密码' \
|
||||
PUBLIC_IP=1.2.3.4 \
|
||||
./scripts/init.sh
|
||||
```
|
||||
|
||||
三个模型 Key 都可选,填几个启用几个。`PUBLIC_IP` 也可选:**不配置时会自动探测公网 IP**(探测失败则 `public_link` 为空,外部服务取图功能不可用)。
|
||||
它只做三件事,**幂等**,随便重跑:
|
||||
|
||||
脚本会生成:
|
||||
1. 生成 `.env` 里的 `EXECUTOR_TOKEN` / `WXBOT_TOKEN` / `AUTH_SECRET`(已有值原样复用,重跑不会掉登录态,也不会换掉 executor 的 token)。
|
||||
2. 探测公网 IP 并写成 `PUBLIC_BASE_URL`(外部服务靠它回取会话文件,图生视频需要)。知道地址就直接给:
|
||||
```bash
|
||||
PUBLIC_IP=1.2.3.4 ./scripts/init.sh
|
||||
```
|
||||
3. 确保 `config.yml` 存在:**不存在时**才创建,内容只有初始管理员 `admin` / `admin`。已有文件**绝不改写**。
|
||||
|
||||
- `.env`:`EXECUTOR_TOKEN`、`WXBOT_TOKEN`、`AGENT_PORT` 等部署变量。
|
||||
- `config.yml`:模型平台、登录账号、`web_search`、公网前缀。
|
||||
脚本不再生成模型平台 / MCP / 语音这些配置——它们全部在前端「设置」里完成,写的就是同一个 `config.yml`。所以重跑脚本永远不会清掉你配好的东西(旧版脚本会覆盖,这是本次的行为变化)。
|
||||
|
||||
脚本只自动启用**模型平台**与 `web_search`。`image_task` / `video_task` / `asr` 需要各自的上游 key,脚本不替它猜平台、也不复用模型平台的 key——它们以**注释模板**写进 `mcp_servers`(url 与 header 名已填好),填上 key 后取消注释并重启 core 即生效。
|
||||
- 想换初始管理员:仅在**首次创建**时生效,`AUTH_USER=me AUTH_PASSWORD='强密码' ./scripts/init.sh`。
|
||||
- `config.yml` 被 Docker 误建成了空目录(源文件缺失时才会这样):脚本会自动删掉并重建;目录非空则报错让你手工处理。
|
||||
|
||||
`AUTH_USER` / `AUTH_PASSWORD` 不传时默认是 `admin` / `admin`,首次部署务必改掉。
|
||||
|
||||
`.env` 里的密钥会复用,重新执行不会让登录态失效;旧的 `config.yml` 会先备份为 `config.yml.bak.<时间戳>`。
|
||||
|
||||
注意:`config.yml` 每次都会按本次环境变量重新生成,平台 Key 不保存在 `.env` 里。已经部署过的实例请用设置页改配置,或带上原有变量重跑;只想刷新密钥时用 `./scripts/init.sh --env-only`。
|
||||
没有 `config.yml` 也能启动:`platforms` 为空、`auth` 为空即“无模型 + 不启用登录”,登录后从设置页补齐即可(保存后点「重启服务」生效)。
|
||||
|
||||
### 2. 启动
|
||||
|
||||
```bash
|
||||
# 迁移:把旧版根目录的 config.yml 原样留着即可,init.sh 不会动它
|
||||
docker compose up -d --build
|
||||
docker compose logs -f agent-core
|
||||
```
|
||||
@@ -81,7 +77,7 @@ docker compose logs -f agent-core
|
||||
|
||||
首次启动还会运行一次性的 `agent-executor-init`,把技能依赖安装到 `./skills/deps`,随后自动退出,属正常现象。
|
||||
|
||||
### 3. 访问
|
||||
### 3. 访问与首次配置
|
||||
|
||||
浏览器打开:
|
||||
|
||||
@@ -89,13 +85,21 @@ docker compose logs -f agent-core
|
||||
http://<服务器 IP>:<AGENT_PORT>
|
||||
```
|
||||
|
||||
使用 `init.sh` 里的账号登录。默认端口 `8090`,可用 `.env` 的 `AGENT_PORT` 修改。
|
||||
首次用 `admin` / `admin` 登录(**登录后立刻在「设置 → 账户」改密码**)。默认端口 `8090`,可用 `.env` 的 `AGENT_PORT` 修改。
|
||||
|
||||
对外只需要放行这一个端口。`agent-executor`、`wxbot` 和 MCP 服务都只在 Docker 内网,不映射到宿主机。
|
||||
登录后去「设置」补齐三块,保存后点页面顶部的「重启服务」:
|
||||
|
||||
| 设置页 | 配什么 |
|
||||
|---|---|
|
||||
| 模型 | 平台地址 + API Key + 模型 id(`extra_params` / `thinking_params` / profile 等在「高级」里) |
|
||||
| MCP | `image_task` / `video_task` / `asr` 需上游 key;`web_search` 免费,地址 `http://mcp_web_search:3000/` |
|
||||
| 用户 | 其余账号、角色、默认模型;改密码在「账户」 |
|
||||
|
||||
对外只需要放行 core 这一个端口。`agent-executor`、`wxbot` 和 MCP 服务都只在 Docker 内网,不映射到宿主机。
|
||||
|
||||
### 4. 同栈 MCP 服务
|
||||
|
||||
`init.sh` 只自动启用 `web_search`;其余三个需要上游 key 的服务以**注释模板**写入(url 与 header 名已填好),填 key 后取消注释再重启 core 即生效:
|
||||
初始 `config.yml` 不包含任何 MCP 服务;四个服务都在设置页「MCP」添加(`web_search` 免费、无需 key)。手工写 YAML 的形状如下(`url` 与 header 名是固定的,容器不存密钥):
|
||||
|
||||
```yaml
|
||||
mcp_servers:
|
||||
@@ -125,9 +129,9 @@ mcp_servers:
|
||||
|
||||
`web_search` / `image_task` / `video_task` / `asr` 四个容器与 core 由同一个根 `docker-compose.yml` 启动(与是否写进配置无关),没有先后顺序,也不占宿主机端口。工具说明、header 覆盖项与调试方式见 [mcp/README.md](mcp/README.md)。
|
||||
|
||||
`ASR_URL`(在 `.env` 里覆盖)是 core 调用语音转写的基地址:默认指向内网 `mcp_asr`;把它改成外网地址就能把转写放到另一台机器上(那台要能接受 `Authorization` / `X-ASR-Base-Url` / `X-ASR-Model` 三个 header),写成空值则关闭语音输入。
|
||||
`ASR_URL`(`docker-compose.yml` 里固定为 `http://mcp_asr:3000`)是 core 调用语音转写的基地址;把 `mcp_asr` 放到另一台机器时改这一行即可(那台要能接受 `Authorization` / `X-ASR-Base-Url` / `X-ASR-Model` 三个 header)。
|
||||
|
||||
语音输入(H5 输入框里说话)走的是另一条路:客户端录音 → `POST /api/asr/transcribe` → `mcp_asr` 的 `/transcribe`,**不经过模型、不消耗 token**,结果插入输入框可编辑。客户端录音契约(Android 套壳原生桥 / 浏览器 MediaRecorder)见 [docs/voice-input.md](docs/voice-input.md);`ASR_URL` 置空、或删掉 `asr` 那段,即整体关闭。
|
||||
语音输入(H5 输入框里说话)走的是另一条路:客户端录音 → `POST /api/asr/transcribe` → `mcp_asr` 的 `/transcribe`,**不经过模型、不消耗 token**,结果插入输入框可编辑。客户端录音契约(Android 套壳原生桥 / 浏览器 MediaRecorder)见 [docs/voice-input.md](docs/voice-input.md);删掉 `config.yml` 里的 `asr` 段即整体关闭。
|
||||
|
||||
`mcp_asr` 自己**不存任何平台密钥**:上游 key / base_url / model 都由 core 从这里那段 `asr.headers` 随请求带进去,换平台只改 YAML(不用重建镜像、不用动 `.env`),也不预设任何厂商。
|
||||
|
||||
@@ -261,14 +265,13 @@ platforms:
|
||||
| `PORT` | core 监听端口,容器内 `8090` |
|
||||
| `EXECUTOR_URL` | `agent-executor` 地址;空则命令在 core 进程内本地执行,仅适合开发 |
|
||||
| `EXECUTOR_TOKEN` | core ↔ executor 的 Bearer token,两侧同值 |
|
||||
| `ASR_URL` | core 拼接 `/transcribe` 的基地址(默认 `http://mcp_asr:3000`)。可填外网地址把 `mcp_asr` 放到另一台机器;写成空值则语音输入关闭 |
|
||||
| `ASR_URL` | core 拼接 `/transcribe` 的基地址,compose 里固定 `http://mcp_asr:3000`(把 `mcp_asr` 放别处时改那一行) |
|
||||
| `ASR_LOG_LEVEL` | `mcp_asr` 日志等级 |
|
||||
| `WXBOT_URL` | wxbot 地址;置空则微信功能整体关闭 |
|
||||
| `WXBOT_TOKEN` | core ↔ wxbot 的共享 token |
|
||||
| `VIRTUAL_HOST` | 设置后 `public_link.base_url` 强制取 `https://<第一个域名>` |
|
||||
| `PUBLIC_BASE_URL` | 对外的完整地址(如 `http://1.2.3.4:8090`),作为 `public_link` 的默认值;设置页填过则以设置页为准 |
|
||||
| `PREVIEW_PROXIES` | 覆盖内置预览反代注册表(JSON 数组) |
|
||||
| `EXECUTOR_LOG_LEVEL` / `WXBOT_LOG_LEVEL` | 两个附属服务的日志等级 |
|
||||
| `WEB_SEARCH_PORT` / `IMAGE_TASK_PORT` / `VIDEO_TASK_PORT` | 仅调试:临时把对应 MCP 服务映射到宿主机端口(默认注释掉) |
|
||||
|
||||
`config.yml` 与 `.env` 都含密钥,已在 `.gitignore` 中。不要提交,也不要挂给不需要它的容器。
|
||||
|
||||
@@ -371,7 +374,7 @@ proxy_buffering off;
|
||||
proxy_read_timeout 3600s;
|
||||
```
|
||||
|
||||
若设置了 `VIRTUAL_HOST`,公网链接前缀会自动变成 `https://<域名>`;仓库默认 compose 里带有 `VIRTUAL_HOST=agent.ai.foresh.com`,不接反向代理时应删除或改成自己的域名。
|
||||
公网链接前缀取 `config.yml` 的 `public_link.base_url`(设置页「服务 → 公网地址」);没填时用 `.env` 的 `PUBLIC_BASE_URL`(`init.sh` 会自动探测写入)。前置了反向代理 + HTTPS 的部署,直接把它填成域名即可。
|
||||
|
||||
---
|
||||
|
||||
@@ -432,9 +435,9 @@ curl -s http://127.0.0.1:8090/api/health
|
||||
|---|---|
|
||||
| 启动时报 `network agent-mcp-net has active endpoints` | 旧的双仓库部署残留:先停旧的 mcp 仓库(`docker compose down`),再 `up` 本栈 |
|
||||
| 套壳 App 填了服务器地址仍连不上 | 先 `curl <地址>/api/health` 看是否返回 `service:agent-core`;再查 Android 9+ 默认禁止明文 HTTP(需 `usesCleartextTraffic`)与 https 自签证书 |
|
||||
| 麦克风按钮不显示 | `ASR_URL` 为空(未部署 `mcp_asr`);或 `config.yml` 的 `mcp_servers` 里没有启用的 `asr` 段 / 该段缺 `X-ASR-Base-Url`(`GET /api/asr/status` 会返回 `reason`);或浏览器以 `http://<IP>` 访问且没有原生录音桥(非安全上下文开不了麦,见 `docs/voice-input.md`) |
|
||||
| 麦克风按钮不显示 | `config.yml` 的 `mcp_servers` 里没有启用的 `asr` 段 / 该段缺 `X-ASR-Base-Url`(`GET /api/asr/status` 会返回 `reason`);或浏览器以 `http://<IP>` 访问且没有原生录音桥(非安全上下文开不了麦,见 `docs/voice-input.md`) |
|
||||
| 点麦克风提示「语音识别服务不可用」 | `mcp_asr` 未起来(`docker compose logs --tail=50 mcp_asr`);或 `config.yml` 的 `asr.headers` 缺 `X-ASR-Base-Url` / `X-ASR-Model` |
|
||||
| `config.yml` 变成目录 | 启动前文件不存在,Docker 自动建了同名目录;停容器、删目录、放入配置文件 |
|
||||
| `config.yml` 变成目录 | 启动前文件不存在,Docker 自动建了同名目录;重跑 `./scripts/init.sh` 会自动删除空目录并重建(非空目录需先备份再手工删除) |
|
||||
| 没有可用模型 | `platforms` 为空或模型全部禁用;在设置页添加后重启 |
|
||||
| 创建会话报「无可用模型」 | 模型池为空,或指定模型所在平台没有 key |
|
||||
| 技能依赖缺失 | 重新 `docker compose up -d --build agent-executor`;或检查 `skills/deps` |
|
||||
|
||||
@@ -27,7 +27,7 @@ data_root: "/workspace/data" # 数据根目录:SQLite
|
||||
db_path: "" # 留空取 data_root/.agent.db
|
||||
log_level: "info" # debug < info < warn < error < none(仅 core 自身;executor/wxbot 的日志等级另走 EXECUTOR_LOG_LEVEL / WXBOT_LOG_LEVEL env,compose 注)
|
||||
|
||||
# executor(命令执行)与 wxbot(微信接入)均**不是本文件的配置项**,接线全走根 compose 注入的 env(见 .env.example):
|
||||
# executor(命令执行)与 wxbot(微信接入)均**不是本文件的配置项**,接线全走根 compose 注入的 env(见 README「环境变量」):
|
||||
# EXECUTOR_URL / EXECUTOR_TOKEN;WXBOT_URL(默认 http://agent-wxbot:8093,置空=微信入口静默关闭)/ WXBOT_TOKEN(init.sh 生成,两侧同值)。
|
||||
|
||||
terminal:
|
||||
|
||||
+26
-11
@@ -126,7 +126,7 @@ const DEFAULTS = {
|
||||
// mode 三态:advertise=工具下发给模型;skill=不下发,改为以技能形式暴露(get 返回原始
|
||||
// input_schema,run 直接转发);disable=不加载。
|
||||
mcp_servers: [],
|
||||
// 公网临时链接:base_url 非空才启用 mint_public_link;容器配 VIRTUAL_HOST 时以它为准。
|
||||
// 公网临时链接:base_url 非空才启用 mint_public_link(config.yml 优先,其次 env PUBLIC_BASE_URL)。
|
||||
public_link: { base_url: '', ttl_ms: 1800000 },
|
||||
};
|
||||
|
||||
@@ -383,16 +383,14 @@ function parseAndValidate(rawText, configPath) {
|
||||
// 公网链接宁可短不可长(“永久公开”正是这套机制要避免的东西)。
|
||||
//
|
||||
// 对外前缀的取值优先级:
|
||||
// 1) 容器 env 的 VIRTUAL_HOST 非空 → https://<第一个域名>
|
||||
// (nginx-proxy 的写法,逗号分隔多域名时取第一个)。只要配了域名 + HTTPS 这一层,
|
||||
// 返回给外部服务(video_task 取参考图)的链接就必须走域名,所以 env 优先;
|
||||
// 反之 config.yml 里那个 init 脚本生成的 http://<IP>:8090 会把这个开关盖住。
|
||||
// 协议写死 https:前置了 nginx-proxy 一定是 HTTPS(证书由 acme-companion 签)。
|
||||
// 2) 否则用 config.yml 的 public_link.base_url(纯 IP:端口部署,init 脚本写 http://<IP>:8090)。
|
||||
// 1) config.yml 的 public_link.base_url(设置页「公网地址」手填的值,以它为准)。
|
||||
// 2) env PUBLIC_BASE_URL(scripts/init.sh 探测公网 IP 后写进 .env 的部署地址)。
|
||||
// 它只是默认值:页面里填过 1) 之后就归 1) 管,避免“重跑部署脚本”和“UI 手改”互相打架。
|
||||
function normalizePublicLink(cfg) {
|
||||
const pl = cfg.public_link || {};
|
||||
const vhost = String(process.env.VIRTUAL_HOST || '').split(',')[0].trim();
|
||||
const baseUrl = vhost ? 'https://' + vhost : pl.base_url;
|
||||
const fromCfg = String(pl.base_url == null ? '' : pl.base_url).trim();
|
||||
const fromEnv = String(process.env.PUBLIC_BASE_URL || '').trim();
|
||||
const baseUrl = fromCfg || fromEnv;
|
||||
cfg.public_link = {
|
||||
base_url: String(baseUrl || '').trim().replace(/\/+$/, ''),
|
||||
ttl_ms: Math.min(Math.max(Number(pl.ttl_ms) || 1800000, 60 * 1000), 24 * 3600 * 1000),
|
||||
@@ -405,7 +403,22 @@ function normalizePublicLink(cfg) {
|
||||
|
||||
function loadConfig(configPath) {
|
||||
const p = configPath || process.env.AGENT_CONFIG || path.join(__dirname, '..', 'config.yml');
|
||||
const text = fs.existsSync(p) ? fs.readFileSync(p, 'utf8') : '';
|
||||
// 目录按“文件不存在”处理:Docker 在 bind mount 的源文件缺失时会建一个同名**空目录**,
|
||||
// 直接 readFileSync 会 EISDIR 崩在启动阶段——那时用户看不到任何可操作的报错。
|
||||
// 空文件/缺失都是合法状态:platforms 为空、auth 为空(= 未启用登录),全部配置可稍后在前端完成。
|
||||
let text = '';
|
||||
let isDir = false;
|
||||
try {
|
||||
const st = fs.statSync(p);
|
||||
if (st.isFile()) text = fs.readFileSync(p, 'utf8');
|
||||
else isDir = true;
|
||||
} catch (_) { /* 不存在 */ }
|
||||
if (isDir) {
|
||||
log.warn('config', 'config.yml 是目录(Docker 在挂载源文件缺失时会自动建同名目录,容器内无法当文件写):' + p +
|
||||
';请在宿主机上删掉该空目录后重跑 scripts/init.sh');
|
||||
} else if (!text.trim()) {
|
||||
log.warn('config', 'config.yml 缺失或为空(' + p + '):当前无模型、无登录鉴权;可在前端「设置」里补齐配置(保存后重启生效)');
|
||||
}
|
||||
return parseAndValidate(text, p);
|
||||
}
|
||||
|
||||
@@ -418,7 +431,9 @@ function loadConfigFromText(text, configPath) {
|
||||
// 读当前配置文件原文(保留注释);文件不存在返回 null。
|
||||
function readConfigText(cfg) {
|
||||
const p = cfg && cfg.config_path;
|
||||
if (!p || !fs.existsSync(p)) return null;
|
||||
if (!p) return null;
|
||||
// 目录(Docker 误建)与缺失一视同仁按“不存在”返回,交给调用方决定新建还是报错。
|
||||
try { if (!fs.statSync(p).isFile()) return null; } catch (_) { return null; }
|
||||
return fs.readFileSync(p, 'utf8');
|
||||
}
|
||||
|
||||
|
||||
+1
-1
@@ -18,7 +18,7 @@ const CALL_TIMEOUT_MS = 60000;
|
||||
let toolDefs = []; // OpenAI function 格式(所有 MCP 工具)
|
||||
const toolIndex = new Map(); // 发送名 -> { server, tool, def }(服务配置 + 原始工具名 + 原始契约)
|
||||
let builtinNames = new Set();
|
||||
let PUBLIC_BASE = ''; // core 自身公网前缀(loadConfig 已归一:VIRTUAL_HOST 优先 config.yml);随每次请求 X-Public-Base 头下发
|
||||
let PUBLIC_BASE = ''; // core 自身公网前缀(loadConfig 已归一:config.yml 优先,其次 PUBLIC_BASE_URL);随每次请求 X-Public-Base 头下发
|
||||
|
||||
// 发一次 JSON-RPC 请求,返回 { result, headers }(HTTP 非 2xx / error / 无法解析时抛异常)。
|
||||
// 某些 MCP 服务遵循 Streamable HTTP 规范会在 initialize 响应里返回 Mcp-Session-Id,
|
||||
|
||||
@@ -261,8 +261,9 @@ function normEdit(e) {
|
||||
}
|
||||
router.patch('/', wrap((req, res) => {
|
||||
const cfg = cfgOf();
|
||||
const text = readConfigText(cfg);
|
||||
if (text === null) return sendErr(res, Object.assign(new Error('配置文件不存在:' + (cfg.config_path || '(未知路径)')), { status_code: 409 }));
|
||||
// 文件缺失(或曾被 Docker 误建成空目录)不阻塞:以空文档继续,写入时由 writeConfigText 创建。
|
||||
// 前提是父目录可写(容器里 /app 可写);否则 fs.writeFileSync 会报错并在下面回 500。
|
||||
const text = readConfigText(cfg) || '';
|
||||
const body = req.body || {};
|
||||
let edits;
|
||||
try {
|
||||
|
||||
+10
-21
@@ -4,8 +4,7 @@ services:
|
||||
container_name: agent-core
|
||||
restart: unless-stopped
|
||||
ports:
|
||||
# 无 nginx-proxy:直接把容器 8090 映射到宿主机端口,用 http://<服务器IP>:<AGENT_PORT> 访问。
|
||||
# 改端口:在仓库顶层 .env 里设 AGENT_PORT(默认 8090)。
|
||||
# 直接把容器 8090 映射到宿主机端口,用 http://<服务器IP>:<AGENT_PORT> 访问。
|
||||
- "${AGENT_PORT:-8090}:8090"
|
||||
volumes:
|
||||
- ./tasks:/workspace/tasks # 持久化:任务目录
|
||||
@@ -20,16 +19,15 @@ services:
|
||||
- EXECUTOR_URL=http://agent-executor:9000
|
||||
# 调用鉴权 token:两侧同一值。从 .env 读取(已 gitignore),不再硬编码进仓库;
|
||||
# 未设置则 compose 直接报错,避免静默无鉴权。生成:openssl rand -hex 32
|
||||
- EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - see .env.example}
|
||||
- EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - run scripts/init.sh}
|
||||
# 微信接入
|
||||
- WXBOT_URL=http://agent-wxbot:8093
|
||||
- WXBOT_TOKEN=${WXBOT_TOKEN:?WXBOT_TOKEN not set - run scripts/init.sh}
|
||||
# 语音识别(可选):core 拼 /transcribe 的基地址。默认指内网 mcp_asr;
|
||||
# 也可以填外网地址(例如 mcp_asr 跑在另一台机器上:http://<ip>:3000)。
|
||||
# 注意:那台服务要能接受 Authorization / X-ASR-Base-Url / X-ASR-Model 三个 header,
|
||||
# 且 core 能出网访问它(https 自签证书会因证书校验失败)。
|
||||
# 想关掉语音输入:在 .env 里写 ASR_URL= (空值,照样不发默认值)或删掉 config.yml 的 asr 段。
|
||||
- ASR_URL=${ASR_URL-http://mcp_asr:3000}
|
||||
# 语音识别(可选):core 拼 /transcribe 的基地址,固定指向栈内 mcp_asr。
|
||||
- ASR_URL=http://mcp_asr:3000
|
||||
# 对外地址:public_link 的默认值(scripts/init.sh 探测公网 IP 后写进 .env)。
|
||||
# 设置页里填过 public_link.base_url 时以设置页为准。
|
||||
- PUBLIC_BASE_URL=${PUBLIC_BASE_URL:-}
|
||||
networks:
|
||||
- agent-mcp-net
|
||||
|
||||
@@ -85,8 +83,8 @@ services:
|
||||
- ./skills:/workspace/skills:ro # 技能目录:所有任务/会话共享同一份技能
|
||||
environment:
|
||||
- PORT=9000
|
||||
# 与 agent-core 侧同一值,从 .env 读取(见 .env.example):
|
||||
- EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - see .env.example}
|
||||
# 与 agent-core 侧同一值,从根 .env 读取(scripts/init.sh 生成):
|
||||
- EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - run scripts/init.sh}
|
||||
# 日志等级:debug|info|warn|error|none(默认 info);
|
||||
# debug 会把与 core 的完整交互打印出来(请求、/exec 请求体、每条 SSE 帧、JSON 响应):
|
||||
- EXECUTOR_LOG_LEVEL=info
|
||||
@@ -174,9 +172,6 @@ services:
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
start_period: 5s
|
||||
# 调试用(默认关):
|
||||
# ports:
|
||||
# - "${WEB_SEARCH_PORT:-8081}:3000"
|
||||
networks:
|
||||
- agent-mcp-net
|
||||
|
||||
@@ -190,9 +185,6 @@ services:
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
start_period: 5s
|
||||
# 调试用(默认关):
|
||||
# ports:
|
||||
# - "${IMAGE_TASK_PORT:-8082}:3000"
|
||||
networks:
|
||||
- agent-mcp-net
|
||||
|
||||
@@ -206,9 +198,6 @@ services:
|
||||
timeout: 5s
|
||||
retries: 5
|
||||
start_period: 5s
|
||||
# 调试用(默认关;这里映的是 MCP 端口,会暴露 /mcp,仅本机短时调试用):
|
||||
# ports:
|
||||
# - "${VIDEO_TASK_PORT:-8083}:3000"
|
||||
networks:
|
||||
- agent-mcp-net
|
||||
|
||||
@@ -236,7 +225,7 @@ services:
|
||||
- agent-mcp-net
|
||||
|
||||
networks:
|
||||
# 全部服务共用一个网络;由本仓库创建(固定名字,避免被加上 compose 项目名前缀)。
|
||||
# 全部服务共用一个网络;由本仓库创建
|
||||
# - core 与 executor 靠它按容器名访问 MCP 服务(如 http://mcp_web_search:3000/)
|
||||
# - 外部服务取参考图走的是 core 对外的 GET /p/<id>(见 public_link):AI 调内置工具
|
||||
# mint_public_link 在 core 进程内现签短链,不需要 executor 反查 core 的额外端口
|
||||
|
||||
+2
-8
@@ -11,7 +11,6 @@
|
||||
|
||||
**这些服务一个宿主机端口都不占**——它们只挂在 `agent-mcp-net` 上,由 `agent-core` / `agent-executor`
|
||||
按容器名访问。所以整台服务器对外只需要开 agent-core 那一个端口(`AGENT_PORT`,默认 8090)。
|
||||
(要从宿主机 curl 调试时,把根 `docker-compose.yml` 里对应服务注释掉的 `ports` 两行打开。)
|
||||
|
||||
## 部署
|
||||
|
||||
@@ -59,13 +58,8 @@ mcp_servers:
|
||||
|
||||
### 调试端口
|
||||
|
||||
写在仓库顶层 `.env` 里即可(不写就用默认值;开了端口记得调试完注释回去):
|
||||
|
||||
| 变量 | 默认 | 说明 |
|
||||
|---|---|---|
|
||||
| `WEB_SEARCH_PORT` | `8081` | 只在临时打开 web_search 调试端口时用 |
|
||||
| `IMAGE_TASK_PORT` | `8082` | 只在临时打开 image_task 调试端口时用 |
|
||||
| `VIDEO_TASK_PORT` | `8083` | 只在临时打开 video_task 调试端口(MCP 口,仅本机短时调试)时用 |
|
||||
本栈默认不给 MCP 服务映射宿主机端口(它们只在 `agent-mcp-net` 内网可达)。要从宿主机直连,
|
||||
自行在 `docker-compose.yml` 给对应服务加 `ports` 即可。
|
||||
|
||||
## 图片是怎么到智谱手上的(只有 video_task 关心)
|
||||
|
||||
|
||||
@@ -25,8 +25,8 @@ cd /root/workspace/tools/agent
|
||||
docker compose up -d --build mcp_image_task
|
||||
```
|
||||
|
||||
服务容器名 `mcp_image_task`。要从宿主机 curl 调试,把根 `docker-compose.yml` 里
|
||||
`mcp_image_task` 注释掉的 `ports` 两行打开(默认 8082),调试完记得注释回去。
|
||||
服务容器名 `mcp_image_task`,**默认不占宿主机端口**,由 agent 走 `agent-mcp-net` 按容器名访问。
|
||||
要从宿主机 curl 调试,自行给该服务加 `ports` 映射。
|
||||
|
||||
```bash
|
||||
# 不占端口的健康检查
|
||||
|
||||
@@ -23,8 +23,7 @@ docker compose up -d --build mcp_video_task
|
||||
```
|
||||
|
||||
服务容器名 `mcp_video_task`,**默认不占宿主机端口**:由 agent 走 `agent-mcp-net` 按容器名访问
|
||||
(`http://mcp_video_task:3000/mcp`)。需要从宿主机 curl 调试时,去仓库根 `docker-compose.yml`
|
||||
把 `mcp_video_task` 注释掉的 `ports` 两行打开(映的是 MCP 端口 3000,仅本机短时调试用)。
|
||||
(`http://mcp_video_task:3000/mcp`)。要从宿主机 curl 调试,自行给该服务加 `ports` 映射。
|
||||
|
||||
```bash
|
||||
# 容器内健康检查(无需占端口)
|
||||
@@ -53,7 +52,7 @@ docker exec mcp_video_task node -e "fetch('http://localhost:3000/health').then(r
|
||||
}
|
||||
```
|
||||
|
||||
> 上面 `url` 里的端口 `8083` 需要先把 compose 里注释的 `ports` 打开(默认不占宿主端口)。
|
||||
> 上面的 `localhost:8083` 只是示例:本栈默认不给 MCP 服务映射宿主端口,要直连需自行加 `ports`。
|
||||
|
||||
> **重要**:客户端必须在 **每一个 HTTP 请求**(`initialize` / `notifications/initialized` / `tools/call`)都带上 `Authorization` header。
|
||||
|
||||
|
||||
@@ -38,8 +38,7 @@ MCP 端点:
|
||||
`docker-compose.yml` 中的 `mcp_web_search` 服务直接构建本目录,Dockerfile 已改为拷贝源码启动(不再有 `npm install -g`)。
|
||||
|
||||
容器内监听 3000,**默认不占宿主端口**:agent 走 `agent-mcp-net` 按容器名访问
|
||||
(`http://mcp_web_search:3000/`)。需要从宿主机 curl 调试时,把仓库根 `docker-compose.yml` 里
|
||||
`mcp_web_search` 注释掉的 `ports` 两行打开(默认写的是 8081),调试完记得注释回去。
|
||||
(`http://mcp_web_search:3000/`)。要从宿主机 curl 调试,自行给该服务加 `ports` 映射。
|
||||
|
||||
```bash
|
||||
docker compose build mcp_web_search && docker compose up -d mcp_web_search
|
||||
|
||||
+107
-239
@@ -1,268 +1,136 @@
|
||||
#!/bin/bash
|
||||
# init.sh — 生成 .env 与 config.yml。
|
||||
# init.sh — 首次部署准备:生成 .env、探测公网地址、创建初始管理员。幂等。
|
||||
#
|
||||
# 只读环境变量,不依赖任何外部文件;**全部可选**,什么都不给也能直接跑。
|
||||
# ./scripts/init.sh # 已有 .env / config.yml 均不覆盖
|
||||
#
|
||||
# 用法:
|
||||
# ./scripts/init.sh # 全用默认值(无模型、admin/admin)
|
||||
# BIGMODEL_KEY=xxx AUTH_USER=me ./scripts/init.sh # 给几个变量就行
|
||||
# ./scripts/init.sh --env-only # 只刷新 .env 密钥(幂等,不碰 config.yml)
|
||||
#
|
||||
# 输入(都可选):
|
||||
# BIGMODEL_KEY / DEEPSEEK_KEY / QWEN_KEY 模型平台 key,填几个启用几个(0~3 个)
|
||||
# AUTH_USER / AUTH_PASSWORD 登录账号(默认 admin / admin,请自行改掉)
|
||||
# PUBLIC_IP / AGENT_PORT 对外地址与端口,写进 public_link.base_url;
|
||||
# PUBLIC_IP 不配置则自动探测公网 IP
|
||||
# AUTH_SECRET / EXECUTOR_TOKEN / WXBOT_TOKEN 一般不用给:不给就自动生成并复用(见下)
|
||||
#
|
||||
# 本脚本只自动写「模型平台 + web_search」。image_task / video_task / asr 需要上游 key,
|
||||
# 一律以**注释模板**写进 mcp_servers(含默认 url 与 header 名),取消注释并填好 key 即生效——
|
||||
# 不替用户猜平台、也不复用任何模型平台 key。
|
||||
#
|
||||
# 微信接入(wxbot 已合入根 compose,作为栈内服务):本脚本只负责生成/复用根 .env 的 WXBOT_TOKEN;
|
||||
# wxbot 自身零配置文件(compose 注 env + 内置默认,同 executor 模式),无需任何同步动作。
|
||||
#
|
||||
# config.yml 只写 deploy 相关的段:platforms / auth / mcp_servers / public_link;
|
||||
# 其余配置项一律走 server/config.js 的 DEFAULTS(完整清单见 app/config.example.yml)。
|
||||
#
|
||||
# ⚠️ config.yml 是本脚本的生成物,不要手改(每次生成前会把旧的备份为 config.yml.bak.<时间戳>)。
|
||||
# 可选变量:PUBLIC_IP、AGENT_PORT、AUTH_USER / AUTH_PASSWORD(默认 admin / admin)、
|
||||
# EXECUTOR_TOKEN / WXBOT_TOKEN / AUTH_SECRET(不给则生成并复用)。
|
||||
set -euo pipefail
|
||||
|
||||
# ============================================================
|
||||
# 路径与默认值
|
||||
# ============================================================
|
||||
REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$REPO_DIR"
|
||||
|
||||
# 支持 --env-only 参数:只刷 .env 密钥(幂等,绝不碰 config.yml)
|
||||
if [ "${1:-}" = "--env-only" ]; then ENV_ONLY=1; fi
|
||||
|
||||
CONFIG_YML="$REPO_DIR/config.yml"
|
||||
ENV_FILE="$REPO_DIR/.env"
|
||||
CONFIG_YML="$REPO_DIR/config.yml"
|
||||
|
||||
BIGMODEL_KEY="${BIGMODEL_KEY:-}"
|
||||
DEEPSEEK_KEY="${DEEPSEEK_KEY:-}"
|
||||
QWEN_KEY="${QWEN_KEY:-}"
|
||||
PUBLIC_IP="${PUBLIC_IP:-}"
|
||||
PORT_INPUT="${AGENT_PORT:-}"
|
||||
AUTH_USER="${AUTH_USER:-admin}"
|
||||
AUTH_PASSWORD="${AUTH_PASSWORD:-admin}"
|
||||
PUBLIC_IP="${PUBLIC_IP:-}"
|
||||
# 记住用户是否显式给了端口(下面 .env 复用逻辑不能踩掉显式传参)
|
||||
AGENT_PORT_INPUT="${AGENT_PORT:-}"
|
||||
AGENT_PORT="${AGENT_PORT_INPUT:-8090}"
|
||||
EXECUTOR_TOKEN="${EXECUTOR_TOKEN:-}"
|
||||
AUTH_SECRET="${AUTH_SECRET:-}"
|
||||
# 微信接入服务 token(core ↔ wxbot 双向共用,compose 两侧同值注入;wxbot 已并入仓库)
|
||||
WXBOT_TOKEN="${WXBOT_TOKEN:-}"
|
||||
|
||||
log() { echo -e "\n\033[1;32m===== $* =====\033[0m"; }
|
||||
info() { echo -e "\033[1;36m[INFO]\033[0m $*"; }
|
||||
warn() { echo -e "\n\033[1;33m[WARN]\033[0m $*"; }
|
||||
info() { echo -e "\033[1;36m[INFO]\033[0m $*"; }
|
||||
warn() { echo -e "\n\033[1;33m[WARN]\033[0m $*"; }
|
||||
title() { echo -e "\n\033[1;32m===== $* =====\033[0m"; }
|
||||
|
||||
gen_hex() { # $1 = 字节数(默认 32)
|
||||
local n="${1:-32}"
|
||||
gen_hex() {
|
||||
if command -v openssl >/dev/null 2>&1; then
|
||||
openssl rand -hex "$n"
|
||||
openssl rand -hex 32
|
||||
else
|
||||
head -c "$n" /dev/urandom | od -An -tx1 | tr -d ' \n'
|
||||
head -c 32 /dev/urandom | od -An -tx1 | tr -d ' \n'
|
||||
fi
|
||||
}
|
||||
|
||||
# ============================================================
|
||||
# 1. 生成 .env(密钥只生成一次,之后复用 → 重跑不掉登录态、不改 executor token)
|
||||
# ============================================================
|
||||
log "生成 $ENV_FILE"
|
||||
|
||||
if [ -f "$ENV_FILE" ]; then
|
||||
EXECUTOR_TOKEN="${EXECUTOR_TOKEN:-$(sed -n 's/^EXECUTOR_TOKEN=//p' "$ENV_FILE" | head -1)}"
|
||||
AUTH_SECRET="${AUTH_SECRET:-$(sed -n 's/^AUTH_SECRET=//p' "$ENV_FILE" | head -1)}"
|
||||
WXBOT_TOKEN="${WXBOT_TOKEN:-$(sed -n 's/^WXBOT_TOKEN=//p' "$ENV_FILE" | head -1)}"
|
||||
# AGENT_PORT 同理复用:避免不带参数重跑时把部署机自定义端口重置回 8090(显式传参优先)
|
||||
AGENT_PORT="${AGENT_PORT_INPUT:-$(sed -n 's/^AGENT_PORT=//p' "$ENV_FILE" | head -1)}"
|
||||
AGENT_PORT="${AGENT_PORT:-8090}"
|
||||
fi
|
||||
EXECUTOR_TOKEN="${EXECUTOR_TOKEN:-$(gen_hex 32)}"
|
||||
AUTH_SECRET="${AUTH_SECRET:-$(gen_hex 32)}"
|
||||
WXBOT_TOKEN="${WXBOT_TOKEN:-$(gen_hex 32)}"
|
||||
|
||||
cat > "$ENV_FILE" <<EOF
|
||||
# 本文件由 scripts/init.sh 生成,勿手改(改配置请重新运行该脚本,或用环境变量覆盖)
|
||||
# EXECUTOR_TOKEN: core 与 executor 之间的调用鉴权(两侧同值,compose 注入)
|
||||
# AUTH_SECRET: 登录态签名密钥(写进 config.yml 的 auth.secret)
|
||||
# WXBOT_TOKEN: core ↔ wxbot 微信接入服务 token(compose 注入两侧;wxbot 零配置文件,env 即全部接线)
|
||||
# AGENT_PORT: agent-core 映射到宿主机的端口
|
||||
# 注意:语音识别(mcp_asr)的上游 key/base_url/model 不在本文件,写在 config.yml 的 asr.headers(容器自己不存密钥)
|
||||
EXECUTOR_TOKEN=$EXECUTOR_TOKEN
|
||||
AUTH_SECRET=$AUTH_SECRET
|
||||
WXBOT_TOKEN=$WXBOT_TOKEN
|
||||
AGENT_PORT=$AGENT_PORT
|
||||
EOF
|
||||
info "EXECUTOR_TOKEN / AUTH_SECRET / WXBOT_TOKEN 已就位(沿用已有 .env 的值,没有则新生成)"
|
||||
|
||||
# --env-only:只刷密钥,绝不碰 config.yml(平台 key 不在 .env 里,重跑全量会清空已部署配置)
|
||||
if [ "${ENV_ONLY:-}" = "1" ]; then
|
||||
log "完成 ✅(--env-only:未改动 config.yml)"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
# PUBLIC_IP 兜底:只有没给时才去探测(探测不到只告警,不影响启动,只是图生视频用不了)
|
||||
if [ -z "$PUBLIC_IP" ]; then
|
||||
for u in https://ifconfig.me https://api.ipify.org; do
|
||||
if command -v curl >/dev/null 2>&1; then
|
||||
PUBLIC_IP="$(curl -fsS --max-time 5 "$u" 2>/dev/null || true)"
|
||||
[ -n "$PUBLIC_IP" ] && break
|
||||
fi
|
||||
done
|
||||
fi
|
||||
if [ -z "$PUBLIC_IP" ]; then
|
||||
warn "没给 PUBLIC_IP 也探测不到:public_link 不生效(需要外部服务来取文件的场景用不了)。"
|
||||
warn "设置后重跑即可: PUBLIC_IP=<公网IP> $0"
|
||||
fi
|
||||
|
||||
# ============================================================
|
||||
# 2. 生成 config.yml(只写 platforms / auth / mcp_servers / public_link)
|
||||
# ============================================================
|
||||
log "生成 $CONFIG_YML"
|
||||
|
||||
if [ -f "$CONFIG_YML" ]; then
|
||||
cp "$CONFIG_YML" "$CONFIG_YML.bak.$(date +%s)"
|
||||
info "旧 config.yml 已备份为 config.yml.bak.<时间戳>"
|
||||
fi
|
||||
|
||||
# 单个平台骨架(url / 模型 / 参数固定,只有 key 来自变量)
|
||||
emit_platform() {
|
||||
case "$1" in
|
||||
bigmodel)
|
||||
cat <<EOF
|
||||
- name: bigmodel
|
||||
url: https://open.bigmodel.cn/api/paas/v4
|
||||
keys:
|
||||
- api_key: "$2"
|
||||
models:
|
||||
- id: glm-5.3-flash
|
||||
vision: true
|
||||
extra_params: { reasoning_effort: "low", tool_stream: true }
|
||||
thinking_params: { reasoning_effort: "max" }
|
||||
EOF
|
||||
;;
|
||||
deepseek)
|
||||
cat <<EOF
|
||||
- name: deepseek
|
||||
url: https://api.deepseek.com
|
||||
keys:
|
||||
- api_key: "$2"
|
||||
models:
|
||||
- id: deepseek-flash
|
||||
vision: true
|
||||
extra_params: { thinking: { type: "disabled" } }
|
||||
thinking_params: { thinking: { type: "enabled" }, reasoning_effort: "max" }
|
||||
EOF
|
||||
;;
|
||||
qwen)
|
||||
cat <<EOF
|
||||
- name: qwen
|
||||
url: https://dashscope.aliyuncs.com/compatible-mode/v1
|
||||
keys:
|
||||
- api_key: "$2"
|
||||
models:
|
||||
- id: qwen3.8-flash
|
||||
vision: true
|
||||
extra_params: { enable_thinking: false }
|
||||
thinking_params: { enable_thinking: true, reasoning_effort: "xhigh" }
|
||||
EOF
|
||||
;;
|
||||
esac
|
||||
env_get() {
|
||||
[ -f "$ENV_FILE" ] || return 0
|
||||
awk -F= -v k="$1" '$1==k { sub(/^[^=]*=/, ""); print; exit }' "$ENV_FILE" || true
|
||||
}
|
||||
|
||||
enabled_plats=()
|
||||
if [ -n "$BIGMODEL_KEY" ]; then enabled_plats+=("bigmodel"); fi
|
||||
if [ -n "$DEEPSEEK_KEY" ]; then enabled_plats+=("deepseek"); fi
|
||||
if [ -n "$QWEN_KEY" ]; then enabled_plats+=("qwen"); fi
|
||||
yaml_q() {
|
||||
local s="${1//\\/\\\\}"
|
||||
s="${s//\"/\\\"}"
|
||||
printf '"%s"' "$s"
|
||||
}
|
||||
|
||||
detect_public_ip() {
|
||||
command -v curl >/dev/null 2>&1 || return 0
|
||||
local u ip
|
||||
for u in https://ifconfig.me https://api.ipify.org; do
|
||||
ip="$(curl -fsS --max-time 5 "$u" 2>/dev/null || true)"
|
||||
if [ -n "$ip" ]; then printf '%s' "$ip"; return 0; fi
|
||||
done
|
||||
}
|
||||
|
||||
# ---------- .env ----------
|
||||
title "生成 $ENV_FILE"
|
||||
|
||||
EXECUTOR_TOKEN="${EXECUTOR_TOKEN:-$(env_get EXECUTOR_TOKEN)}"
|
||||
WXBOT_TOKEN="${WXBOT_TOKEN:-$(env_get WXBOT_TOKEN)}"
|
||||
AUTH_SECRET="${AUTH_SECRET:-$(env_get AUTH_SECRET)}"
|
||||
AGENT_PORT="${PORT_INPUT:-$(env_get AGENT_PORT)}"
|
||||
AGENT_PORT="${AGENT_PORT:-8090}"
|
||||
OLD_URL="$(env_get PUBLIC_BASE_URL)"
|
||||
|
||||
EXECUTOR_TOKEN="${EXECUTOR_TOKEN:-$(gen_hex)}"
|
||||
WXBOT_TOKEN="${WXBOT_TOKEN:-$(gen_hex)}"
|
||||
AUTH_SECRET="${AUTH_SECRET:-$(gen_hex)}"
|
||||
|
||||
if [ -n "$PUBLIC_IP" ]; then
|
||||
PUBLIC_BASE_URL="http://$PUBLIC_IP:$AGENT_PORT"
|
||||
elif [ -n "$OLD_URL" ]; then
|
||||
# 显式改端口时只换端口,保留原协议与主机
|
||||
if [ -n "$PORT_INPUT" ]; then
|
||||
PUBLIC_BASE_URL="$(printf '%s' "$OLD_URL" | sed -E "s#^(https?://[^/:]+)(:[0-9]+)?#\1:$AGENT_PORT#")"
|
||||
else
|
||||
PUBLIC_BASE_URL="$OLD_URL"
|
||||
fi
|
||||
else
|
||||
DETECTED_IP="$(detect_public_ip)"
|
||||
PUBLIC_BASE_URL="${DETECTED_IP:+http://$DETECTED_IP:$AGENT_PORT}"
|
||||
if [ -z "$PUBLIC_BASE_URL" ]; then
|
||||
warn "未探测到公网 IP,PUBLIC_BASE_URL 留空(可设 PUBLIC_IP 后重跑)"
|
||||
fi
|
||||
fi
|
||||
|
||||
EXTRAS=""
|
||||
if [ -f "$ENV_FILE" ]; then
|
||||
EXTRAS="$(awk -F= '/^[A-Za-z_][A-Za-z0-9_]*=/ &&
|
||||
$1 !~ /^(EXECUTOR_TOKEN|WXBOT_TOKEN|AUTH_SECRET|AGENT_PORT|PUBLIC_BASE_URL)$/ { print }' \
|
||||
"$ENV_FILE" || true)"
|
||||
fi
|
||||
|
||||
{
|
||||
echo "# 本文件由 scripts/init.sh 生成,请勿手改!"
|
||||
echo "# 只含 deploy 相关段(platforms / auth / mcp_servers / public_link),其余走 server/config.js 默认值。"
|
||||
echo "# 生成时间: $(date '+%Y-%m-%d %H:%M:%S')"
|
||||
echo "# 已启用平台: ${enabled_plats[*]:-(无)}"
|
||||
echo
|
||||
|
||||
if [ "${#enabled_plats[@]}" -eq 0 ]; then
|
||||
echo "platforms: [] # 没有配置平台 key(BIGMODEL_KEY / DEEPSEEK_KEY / QWEN_KEY)"
|
||||
else
|
||||
echo "platforms:"
|
||||
if [ -n "$BIGMODEL_KEY" ]; then emit_platform bigmodel "$BIGMODEL_KEY"; fi
|
||||
if [ -n "$DEEPSEEK_KEY" ]; then emit_platform deepseek "$DEEPSEEK_KEY"; fi
|
||||
if [ -n "$QWEN_KEY" ]; then emit_platform qwen "$QWEN_KEY"; fi
|
||||
echo "# 由 scripts/init.sh 生成;重跑复用已有密钥,并保留其它变量。"
|
||||
echo "EXECUTOR_TOKEN=$EXECUTOR_TOKEN"
|
||||
echo "WXBOT_TOKEN=$WXBOT_TOKEN"
|
||||
echo "AUTH_SECRET=$AUTH_SECRET"
|
||||
echo "AGENT_PORT=$AGENT_PORT"
|
||||
echo "PUBLIC_BASE_URL=$PUBLIC_BASE_URL"
|
||||
if [ -n "$EXTRAS" ]; then
|
||||
echo
|
||||
printf '%s\n' "$EXTRAS"
|
||||
fi
|
||||
echo
|
||||
} > "$ENV_FILE"
|
||||
|
||||
cat <<EOF
|
||||
info "EXECUTOR_TOKEN / WXBOT_TOKEN / AUTH_SECRET 已就位"
|
||||
|
||||
# ---------- config.yml(只写初始管理员)----------
|
||||
title "检查 $CONFIG_YML"
|
||||
|
||||
if [ -d "$CONFIG_YML" ]; then
|
||||
rmdir "$CONFIG_YML" 2>/dev/null || { warn "config.yml 是非空目录,请先处理:$CONFIG_YML"; exit 1; }
|
||||
info "已删除被误建的空目录"
|
||||
fi
|
||||
|
||||
CREATED=0
|
||||
if [ -f "$CONFIG_YML" ]; then
|
||||
info "已存在,跳过"
|
||||
else
|
||||
cat > "$CONFIG_YML" <<EOF
|
||||
auth:
|
||||
secret: "$AUTH_SECRET"
|
||||
secret: $(yaml_q "$AUTH_SECRET")
|
||||
users:
|
||||
- user: $AUTH_USER
|
||||
password: "$AUTH_PASSWORD"
|
||||
role: admin # 初始账号为管理员;其余用户的增删/角色/默认模型在前端「设置→用户」里配
|
||||
|
||||
mcp_servers:
|
||||
- name: web_search
|
||||
url: "http://mcp_web_search:3000/"
|
||||
- user: $(yaml_q "$AUTH_USER")
|
||||
password: $(yaml_q "$AUTH_PASSWORD")
|
||||
role: admin
|
||||
EOF
|
||||
info "已创建,初始管理员 $AUTH_USER"
|
||||
CREATED=1
|
||||
fi
|
||||
|
||||
# 另外三个服务需要上游 key,默认整段注释掉:脚本不替用户选平台,也不复用模型平台 key。
|
||||
# 取消注释 + 填 key 后重启 core 即生效(mode: skill = 不下发到每轮工具表,按技能形式暴露)。
|
||||
cat <<'EOF'
|
||||
|
||||
# 以下三项默认注释:填好上游 key 再取消注释(重启 core 生效)
|
||||
#
|
||||
# 图片生成 / 编辑。X-Image-Task-Base-Url 填 zhipu 走智谱原生通道,
|
||||
# 填网关地址(如 https://<host>/v1)走任意 OpenAI 兼容的 /images/generations。
|
||||
# - name: image_task
|
||||
# url: "http://mcp_image_task:3000/mcp"
|
||||
# headers:
|
||||
# Authorization: Bearer <upstream-api-key>
|
||||
# X-Image-Task-Base-Url: "zhipu"
|
||||
# X-Image-Task-Model: "CogView-4"
|
||||
# mode: skill
|
||||
#
|
||||
# 视频生成(智谱 BigModel 异步接口)。模型可选,默认 cogvideox-flash;
|
||||
# 要换模型再加一行 X-Video-Task-Model(取值见 mcp/video_task/README.md)。
|
||||
# - name: video_task
|
||||
# url: "http://mcp_video_task:3000/mcp"
|
||||
# headers:
|
||||
# Authorization: Bearer <zhipu-api-key>
|
||||
# mode: skill
|
||||
#
|
||||
# 语音转写(输入框「按住说话」与模型的 transcribe_audio 共用这一段)。
|
||||
# 任何 OpenAI 兼容的 /audio/transcriptions 都行,容器自己不存密钥;免鉴权的自建服务可省 Authorization。
|
||||
# - name: asr
|
||||
# url: "http://mcp_asr:3000/mcp"
|
||||
# headers:
|
||||
# Authorization: Bearer <key>
|
||||
# X-ASR-Base-Url: "https://<host>/v1"
|
||||
# X-ASR-Model: "whisper-1"
|
||||
# mode: skill
|
||||
EOF
|
||||
|
||||
echo
|
||||
cat <<EOF
|
||||
# 给外部服务(如智谱)现签公网临时链接用;改地址后重跑本脚本
|
||||
public_link:
|
||||
base_url: "${PUBLIC_IP:+http://$PUBLIC_IP:$AGENT_PORT}"
|
||||
EOF
|
||||
} > "$CONFIG_YML"
|
||||
|
||||
info "平台: ${enabled_plats[*]:-无};MCP: web_search 已启用,image_task / video_task / asr 为注释模板(填 key 后取消注释)"
|
||||
|
||||
# ============================================================
|
||||
# 3. 汇总
|
||||
# ============================================================
|
||||
log "汇总"
|
||||
echo "---------------------------------------------"
|
||||
echo " 访问地址 : http://${PUBLIC_IP:-<公网IP>}:${AGENT_PORT}"
|
||||
echo " 账号 : $AUTH_USER"
|
||||
echo " 密码 : $AUTH_PASSWORD"
|
||||
echo " 平台 : ${enabled_plats[*]:-(无)}"
|
||||
echo " MCP 服务 : web_search 已启用;image_task / video_task / asr 以注释模板写入(填 key 后取消注释)"
|
||||
echo " 微信接入 : WXBOT_TOKEN 已就位(compose 注入 core 与 wxbot 两侧;wxbot 无需配置文件)"
|
||||
echo "---------------------------------------------"
|
||||
log "完成 ✅"
|
||||
# ---------- 汇总 ----------
|
||||
title "汇总"
|
||||
echo " 访问地址 : ${PUBLIC_BASE_URL:-(未设置)}"
|
||||
if [ "$CREATED" = "1" ]; then
|
||||
echo " 初始账号 : $AUTH_USER${AUTH_PASSWORD:+ / }$([ "$AUTH_PASSWORD" = "admin" ] && echo 'admin(登录后请修改)' || echo '<AUTH_PASSWORD 传入值>')"
|
||||
fi
|
||||
echo " 下一步 : docker compose up -d --build"
|
||||
|
||||
@@ -359,8 +359,7 @@ print_next_steps() {
|
||||
|
||||
备注:
|
||||
- 上面若提示需要重启(内核/核心库更新),建议先 reboot,再执行第 ③ 步
|
||||
- init.sh 可重复执行:.env 里的密钥复用,config.yml 会先备份为 .bak.<时间戳>
|
||||
- 只刷新密钥、不动配置:./scripts/init.sh --env-only
|
||||
- init.sh 可重复执行:已有的 .env 与 config.yml 都不会被覆盖
|
||||
EOF
|
||||
}
|
||||
|
||||
|
||||
+1
-1
@@ -50,7 +50,7 @@ agent-core 的 `wechat_bindings` 表;扫码二维码呈现在 agent-core 的 W
|
||||
## 部署
|
||||
|
||||
```sh
|
||||
./scripts/init.sh --env-only # 生成/复用根 .env 的 WXBOT_TOKEN(幂等,不碰 config.yml)
|
||||
./scripts/init.sh # 生成/复用根 .env 的 WXBOT_TOKEN(幂等)
|
||||
docker compose up -d --build agent-wxbot # 首次构建镜像(npm 源可 --build-arg NPM_REGISTRY= 换)
|
||||
docker compose up -d agent-core # core 带 WXBOT_URL/WXBOT_TOKEN 重建(compose 检测到 env 变化自动 recreate)
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user