From b97b13095fc36e2f805e97fa5d4b40ac85b1aaca Mon Sep 17 00:00:00 2001 From: kicer Date: Sun, 25 Oct 2026 08:39:48 +0800 Subject: [PATCH] =?UTF-8?q?=E9=83=A8=E7=BD=B2=E5=88=9D=E5=A7=8B=E5=8C=96?= =?UTF-8?q?=E6=94=B6=E6=95=9B=EF=BC=9Ainit.sh=20=E4=B8=8D=E5=86=8D?= =?UTF-8?q?=E7=94=9F=E6=88=90=E9=85=8D=E7=BD=AE=EF=BC=8C=E5=8F=AA=E5=81=9A?= =?UTF-8?q?=20.env=20+=20=E5=85=AC=E7=BD=91=E5=9C=B0=E5=9D=80=20+=20?= =?UTF-8?q?=E5=88=9D=E5=A7=8B=20admin?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 文档 --- .env.example | 28 --- AGENTS.md | 11 +- README.md | 61 ++++--- app/config.example.yml | 2 +- app/server/config.js | 37 ++-- app/server/mcp.js | 2 +- app/server/routes/config.js | 5 +- docker-compose.yml | 31 ++-- mcp/README.md | 10 +- mcp/image_task/README.md | 4 +- mcp/video_task/README.md | 5 +- mcp/web_search/README.md | 3 +- scripts/init.sh | 346 +++++++++++------------------------- scripts/init_host.sh | 3 +- wxbot/README.md | 2 +- 15 files changed, 195 insertions(+), 355 deletions(-) delete mode 100644 .env.example diff --git a/.env.example b/.env.example deleted file mode 100644 index 1fe65be..0000000 --- a/.env.example +++ /dev/null @@ -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 diff --git a/AGENTS.md b/AGENTS.md index cd28489..d6407c6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 | diff --git a/README.md b/README.md index 3bfa982..06f4a4a 100644 --- a/README.md +++ b/README.md @@ -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>: ``` -使用 `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://` 访问且没有原生录音桥(非安全上下文开不了麦,见 `docs/voice-input.md`) | +| 麦克风按钮不显示 | `config.yml` 的 `mcp_servers` 里没有启用的 `asr` 段 / 该段缺 `X-ASR-Base-Url`(`GET /api/asr/status` 会返回 `reason`);或浏览器以 `http://` 访问且没有原生录音桥(非安全上下文开不了麦,见 `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` | diff --git a/app/config.example.yml b/app/config.example.yml index e30c311..311dc45 100644 --- a/app/config.example.yml +++ b/app/config.example.yml @@ -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: diff --git a/app/server/config.js b/app/server/config.js index 3f5c597..ebfd5d3 100644 --- a/app/server/config.js +++ b/app/server/config.js @@ -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://:8090 会把这个开关盖住。 -// 协议写死 https:前置了 nginx-proxy 一定是 HTTPS(证书由 acme-companion 签)。 -// 2) 否则用 config.yml 的 public_link.base_url(纯 IP:端口部署,init 脚本写 http://: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'); } diff --git a/app/server/mcp.js b/app/server/mcp.js index b7e53d2..ff4e915 100644 --- a/app/server/mcp.js +++ b/app/server/mcp.js @@ -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, diff --git a/app/server/routes/config.js b/app/server/routes/config.js index c80ce2e..84de24c 100644 --- a/app/server/routes/config.js +++ b/app/server/routes/config.js @@ -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 { diff --git a/docker-compose.yml b/docker-compose.yml index 8a5c239..f5ebbe5 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -4,8 +4,7 @@ services: container_name: agent-core restart: unless-stopped ports: - # 无 nginx-proxy:直接把容器 8090 映射到宿主机端口,用 http://<服务器IP>: 访问。 - # 改端口:在仓库顶层 .env 里设 AGENT_PORT(默认 8090)。 + # 直接把容器 8090 映射到宿主机端口,用 http://<服务器IP>: 访问。 - "${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://: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/(见 public_link):AI 调内置工具 # mint_public_link 在 core 进程内现签短链,不需要 executor 反查 core 的额外端口 diff --git a/mcp/README.md b/mcp/README.md index 55311e6..c32e43e 100644 --- a/mcp/README.md +++ b/mcp/README.md @@ -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 关心) diff --git a/mcp/image_task/README.md b/mcp/image_task/README.md index 10d79a0..d46bd0a 100644 --- a/mcp/image_task/README.md +++ b/mcp/image_task/README.md @@ -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 # 不占端口的健康检查 diff --git a/mcp/video_task/README.md b/mcp/video_task/README.md index 2f29a0d..547f73b 100644 --- a/mcp/video_task/README.md +++ b/mcp/video_task/README.md @@ -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。 diff --git a/mcp/web_search/README.md b/mcp/web_search/README.md index 8e5f60a..e9abafd 100644 --- a/mcp/web_search/README.md +++ b/mcp/web_search/README.md @@ -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 diff --git a/scripts/init.sh b/scripts/init.sh index 327b54b..7fa03a5 100755 --- a/scripts/init.sh +++ b/scripts/init.sh @@ -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" </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 </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 </dev/null || { warn "config.yml 是非空目录,请先处理:$CONFIG_YML"; exit 1; } + info "已删除被误建的空目录" +fi + +CREATED=0 +if [ -f "$CONFIG_YML" ]; then + info "已存在,跳过" +else + cat > "$CONFIG_YML" </v1)走任意 OpenAI 兼容的 /images/generations。 - # - name: image_task - # url: "http://mcp_image_task:3000/mcp" - # headers: - # Authorization: Bearer - # 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 - # mode: skill - # - # 语音转写(输入框「按住说话」与模型的 transcribe_audio 共用这一段)。 - # 任何 OpenAI 兼容的 /audio/transcriptions 都行,容器自己不存密钥;免鉴权的自建服务可省 Authorization。 - # - name: asr - # url: "http://mcp_asr:3000/mcp" - # headers: - # Authorization: Bearer - # X-ASR-Base-Url: "https:///v1" - # X-ASR-Model: "whisper-1" - # mode: skill -EOF - - echo - cat < "$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 '')" +fi +echo " 下一步 : docker compose up -d --build" diff --git a/scripts/init_host.sh b/scripts/init_host.sh index 6d61f5d..1472214 100755 --- a/scripts/init_host.sh +++ b/scripts/init_host.sh @@ -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 } diff --git a/wxbot/README.md b/wxbot/README.md index a21e7b1..7ef2d7c 100644 --- a/wxbot/README.md +++ b/wxbot/README.md @@ -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) ```