Compare commits
11
Commits
dca4e6be70
...
7a34f612e7
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
7a34f612e7 | ||
|
|
2e220d0a22 | ||
|
|
0ac161c579 | ||
|
|
81e0a44671 | ||
|
|
560bd9afd4 | ||
|
|
ce7a62dcba | ||
|
|
d0e6a981a6 | ||
|
|
1ea29c0448 | ||
|
|
d6b949969f | ||
|
|
bdc2de7128 | ||
|
|
b97b13095f |
@@ -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`(容器不存平台密钥)。
|
||||
|
||||
## 三条主链路
|
||||
@@ -110,7 +111,7 @@ flowchart TD
|
||||
|
||||
## 全局约束(改之前先读)
|
||||
|
||||
1. **单实例、单进程内存态**。`engine.js` 的 `runs`/`titling`、`wechat.js` 的回合投递状态与实例缓存、
|
||||
1. **单实例、单进程内存态**。`engine.js` 的 `runs`/`titling`/`pendings`(待投递消息队列)、`wechat.js` 的回合投递状态与实例缓存、
|
||||
`publicFiles` 的短链表、`download-token` 的随机密钥都在进程内——重启即清空,多实例不共享。
|
||||
(微信投递游标 `last_msg_id` 例外,它是落库的。)不要引入需要跨进程一致性的设计。
|
||||
2. **配置冷加载**。`config.js` 的 `DEFAULTS` 在启动时 deep-merge 并校验;改 `config.yml` 后必须
|
||||
@@ -161,9 +162,10 @@ 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` 的解析 |
|
||||
| 同栈 MCP 的 url / header 名 | `app/server/presets.json` ↔ `mcp/<服务>/src`(设置页引导表单的字段来自前者,不会自动跟随后者) |
|
||||
| 对外 API | `app/server/routes/*` ↔ 前端 `app/server/public/js/*` ↔ README |
|
||||
|
||||
## 代码约定
|
||||
|
||||
@@ -20,6 +20,7 @@
|
||||
| 隔离执行 | `terminal` 和技能在 `agent-executor` 容器中运行,只看到当前会话目录,根文件系统只读 |
|
||||
| 大文件交付 | 文件面板上传/下载/打包 zip;外部服务取图走带过期时间的公网短链 |
|
||||
| 上下文管理 | 手动压缩、按 token 阈值提示压缩、历史重放自动裁剪、会话标题自动生成 |
|
||||
| 回合中投递 | 运行中发的消息先进输入框上方的待发送条幅:默认等本轮结束自动发出;可「干预」(当前工具跑完就插话)或「立即发送」(终止本轮并立刻发)。队列在服务端,关页面不丢 |
|
||||
| 定时任务 | 每会话最多一个 cron 任务;触发前清空模型可见历史,按计划执行并推送结果 |
|
||||
| 微信接入 | 扫码绑定个人微信,文本/图片/视频/文件进入同一套会话与命令体系 |
|
||||
| 语音输入 | 输入框为空时发送键变麦克风:点一下进入语音模式,输入框位置变成「按住 说话」,松开即转写并直接发送;发送键位置变键盘按钮可切回打字。套壳 App 走原生录音(http 页面也能用),浏览器走 MediaRecorder(需 HTTPS);识别在 `mcp_asr`,不经过模型、不消耗 token |
|
||||
@@ -41,38 +42,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 +78,7 @@ docker compose logs -f agent-core
|
||||
|
||||
首次启动还会运行一次性的 `agent-executor-init`,把技能依赖安装到 `./skills/deps`,随后自动退出,属正常现象。
|
||||
|
||||
### 3. 访问
|
||||
### 3. 访问与首次配置
|
||||
|
||||
浏览器打开:
|
||||
|
||||
@@ -89,13 +86,23 @@ 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」会把四个同栈服务作为**内置服务卡片**列出来,
|
||||
点卡片 → 填表 → 保存即可(url 与 header 名由 `app/server/presets.json` 提供,不用记)。
|
||||
`web_search` 免费、无需 key;另外三个要填上游 key。手工写 YAML 的形状如下(容器不存密钥):
|
||||
|
||||
```yaml
|
||||
mcp_servers:
|
||||
@@ -106,7 +113,7 @@ mcp_servers:
|
||||
# url: "http://mcp_image_task:3000/mcp"
|
||||
# headers:
|
||||
# Authorization: Bearer <upstream-api-key>
|
||||
# X-Image-Task-Base-Url: "zhipu" # 或任意 OpenAI 兼容网关地址
|
||||
# X-Image-Task-Base-Url: "https://open.bigmodel.cn/api/paas/v4" # 任意 OpenAI 兼容的 images 上游(生成 /images/generations、编辑 /images/edits)
|
||||
# X-Image-Task-Model: "CogView-4"
|
||||
# mode: skill
|
||||
# - name: video_task
|
||||
@@ -125,9 +132,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 +268,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 +377,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 +438,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` |
|
||||
|
||||
+33
-2
@@ -39,6 +39,7 @@ AGENT_CONFIG=./config.yml node server/server.js
|
||||
|---|---|
|
||||
| `server/server.js` | 装配、路由挂载、`/api/models`、`/api/health`、prompt dump、优雅退出 |
|
||||
| `server/config.js` | YAML 加载/校验/默认值;`platforms` 展开成 `cfg.models`;配置文本改写(设置页) |
|
||||
| `server/presets.json` | 平台与同栈 MCP 的固定契约(url / type / header 名),设置页新增时的模板来源;改服务地址改这里 |
|
||||
| `server/db.js` | 建表、索引、幂等迁移;纯 SQL 数据层,不放业务 |
|
||||
| `server/engine.js` | **核心**:会话状态机、模型池调度、Agent 主循环、压缩、标题、日记收口、消息增删 |
|
||||
| `server/llm.js` | 消息组装、system prompt 拼接、上游流式调用、占位裁剪、多模态块编解码 |
|
||||
@@ -78,18 +79,48 @@ POST /api/sessions/:id/messages
|
||||
checkToolArgs:JSON 非法/缺必填 → 整条 assistant 标 type='errAck'
|
||||
saveMessage(assistant) + recordModelUsage
|
||||
压缩回合的收尾答复 → type='summary',之前全部消息 → type='archived'
|
||||
无 tool_calls → 若期间又有新 user 消息则继续,否则收尾
|
||||
无 tool_calls → 待投递里有「干预」则投递并继续;否则若有新 user 消息继续,否则收尾
|
||||
有 tool_calls → 逐个 executeTool → saveMessage(tool) → emit tool_result
|
||||
(每步之后与整批之前各查一次「干预」,命中就先闭合批次再投递)
|
||||
→ finalize
|
||||
closeToolBatch(兜底:补齐本批未执行调用的合成回执)
|
||||
cancelled → status=cancelled
|
||||
正常 → status=held,emit done,maybeGenerateTitle,run.taskWrap → taskClockOut
|
||||
收尾后若队列非空 → setImmediate 投递队首(排队模式的唯一出口)
|
||||
→ maybeAutoCompress(回合彻底结束后才检查)
|
||||
```
|
||||
|
||||
**给前端的是 SSE 事件,不是响应体**。前端在 `GET /api/sessions/:id/stream` 上听:
|
||||
`status`、`assistant_delta`、`reasoning_delta`、`tool_call_start`、`tool_call_args`、
|
||||
`tool_call`、`tool_result`、`assistant_message`、`done`、`error`、`title`、`auto_compress`、
|
||||
`ui_card`,以及每 15s 的具名心跳 `ping`(注释帧不触发 JS 事件,所以用具名事件做前端看门狗)。
|
||||
`ui_card`、`pending_added`、`pending_removed`、`user_message`,以及每 15s 的具名心跳 `ping`
|
||||
(注释帧不触发 JS 事件,所以用具名事件做前端看门狗)。
|
||||
|
||||
## 待投递消息(排队 / 干预 / 立即发送)
|
||||
|
||||
回合正在跑时,Web 端发送不再「立即插话」,而是进**服务端队列**(`engine.js` 的 `pendings`,
|
||||
进程内内存态,同 `runs`,重启即丢):输入框上方出现一行条幅,默认等本轮结束自动发出。
|
||||
|
||||
| 模式 | 入口 | 行为 |
|
||||
|---|---|---|
|
||||
| `queue`(默认) | 运行中点发送 | 本轮 `finalize` 后作为新回合的第一条消息发出 |
|
||||
| `interject`(干预) | 条幅「干预」 | 当前工具跑完(或本条回复落库)后,闭合批次、就地插话,同一回合继续 |
|
||||
| `now`(立即发送) | 条幅「立即发送」 | 杀进程 + abort 流,本回合判 `cancelled`,收尾后立刻发 |
|
||||
|
||||
**铁律:队列里的消息绝不先落 `messages` 表。** 只在安全边界写库——① 工具批次闭合
|
||||
(本批每个 `tool_call_id` 都有回执);② 无 `tool_calls` 的回复已落库;③ 回合 finalize。
|
||||
否则 `user` 行会夹在 `assistant.tool_calls` 与 `tool` 回执之间,或批次没闭合就收尾,
|
||||
上游一律拒收整个请求。
|
||||
|
||||
- `closeToolBatch(sessionId, reason)` 是配对兜底的唯一写入口:给最后一条带 `tool_calls` 的
|
||||
assistant 里缺回执的调用补一条 `is_error=1` 的合成 tool 行(「用户介入/终止,本次调用未执行」)。
|
||||
`finalize` 无条件调一次,取消路径与干预路径各调一次。
|
||||
- 读侧还有一层纯过滤(`llm.buildMessages` 的 `pairedByAssistant` / `emittedCallIds`):只下发
|
||||
「本批(紧邻的连续 tool 行)确有回执」的调用,孤儿回执也不下发。DB/UI 不动,专门兜历史脏数据。
|
||||
- `stop()`(用户点「停止」)**会清空队列**(全停语义);「立即发送」不走 `stop`,只中断当前回合、保留队首。
|
||||
- 只允许升级**队首**(`promotePending` 对非队首回 409),避免「越过后面的消息先发」。
|
||||
- HTTP:`POST /messages` 的 `delivery:'queue'`;`POST /pending/:qid {action}`;`DELETE /pending/:qid`;
|
||||
会话详情响应带 `pending`,`status` 事件也带 `pending`(前端把条幅当服务端状态的回显)。
|
||||
|
||||
## 会话状态机
|
||||
|
||||
|
||||
@@ -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:
|
||||
|
||||
+90
-17
@@ -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,25 +431,85 @@ 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');
|
||||
}
|
||||
|
||||
// 单项编辑:[{path:[...], value}] 或 [{path:[...], delete:true}] 或 [{path:[...], value, append:true}]。
|
||||
// 用 YAML Document 写回,保留注释与排版;路径段为纯数字时按数组下标处理(如 ["platforms",0,"keys",1,"models",0])。
|
||||
// append:向目标数组追加一项(新增平台/Key/模型用);目标不存在时创建新数组。
|
||||
//
|
||||
// 写回时的版式处理(只作用于本次编辑写入的节点,文件其它部分原样保留):
|
||||
// · 值带冒号(如模型 id "global:hy-image-3.5")强制双引号——裸写的 plain 标量换个解析器、
|
||||
// 或落进 flow 集合里就容易被当成分隔符;纯 URL 例外(裸写无歧义)。
|
||||
// · extra_params / thinking_params 这类小参数表用 flow 风格({k: v})写成一行,否则嵌套几层
|
||||
// 展开成十几行,读起来又乱又占版面。
|
||||
// · 追加整项时连同所在数组一起转 block:flow 数组里塞 block 映射会输出成残句(platforms: 后直接跟键)。
|
||||
const FLOW_PARAM_KEYS = new Set(['extra_params', 'thinking_params']);
|
||||
|
||||
function needsQuoteStr(v) {
|
||||
return typeof v === 'string' && v.includes(':') && !/^\w+:\/\/\S+$/.test(v);
|
||||
}
|
||||
|
||||
function styleWrittenNode(node, forceBlock) {
|
||||
if (!node || typeof node !== 'object') return;
|
||||
if (YAML.isScalar(node)) {
|
||||
if (needsQuoteStr(node.value)) node.type = 'QUOTE_DOUBLE';
|
||||
return;
|
||||
}
|
||||
if (YAML.isMap(node)) {
|
||||
if (forceBlock) node.flow = false;
|
||||
for (const pair of node.items) {
|
||||
const key = pair.key && pair.key.value;
|
||||
const child = pair.value;
|
||||
// 参数表保持 flow;内部值不再强制 block(不然 {k: {…}} 里的嵌套表会被抖开)
|
||||
if (FLOW_PARAM_KEYS.has(String(key)) && child && typeof child === 'object' && !YAML.isScalar(child)) {
|
||||
child.flow = true;
|
||||
styleWrittenNode(child, false);
|
||||
} else {
|
||||
styleWrittenNode(child, forceBlock);
|
||||
}
|
||||
}
|
||||
} else if (YAML.isSeq(node)) {
|
||||
if (forceBlock) node.flow = false;
|
||||
for (const item of node.items) styleWrittenNode(item, forceBlock);
|
||||
}
|
||||
}
|
||||
|
||||
function styledNode(doc, value, forceBlock) {
|
||||
const node = doc.createNode(value);
|
||||
if (forceBlock && node && typeof node === 'object' && !YAML.isScalar(node)) node.flow = false;
|
||||
styleWrittenNode(node, forceBlock);
|
||||
return node;
|
||||
}
|
||||
|
||||
function applyEditsToText(text, edits) {
|
||||
const doc = YAML.parseDocument(text || '');
|
||||
for (const e of edits || []) {
|
||||
if (!e || !Array.isArray(e.path) || !e.path.length) throw new Error('配置项 path 必须是非空数组');
|
||||
const docPath = e.path.map(s => (typeof s === 'string' && /^\d+$/.test(s)) ? Number(s) : s);
|
||||
if (e.delete) doc.deleteIn(docPath);
|
||||
else if (e.append) {
|
||||
if (e.delete) { doc.deleteIn(docPath); continue; }
|
||||
if (e.append) {
|
||||
const item = styledNode(doc, e.value, true);
|
||||
const target = doc.getIn(docPath, true);
|
||||
if (target && typeof target.add === 'function') target.add(e.value);
|
||||
else if (target === null || target === undefined) doc.setIn(docPath, [e.value]);
|
||||
else throw new Error('配置项 ' + docPath.join('.') + ' 不是数组,无法追加');
|
||||
} else doc.setIn(docPath, e.value);
|
||||
if (target && typeof target.add === 'function') {
|
||||
target.flow = false; // 与 block 化的新项保持一致,否则父数组仍是 flow
|
||||
target.add(item);
|
||||
} else if (target === null || target === undefined) {
|
||||
const seq = doc.createNode([]);
|
||||
seq.flow = false;
|
||||
seq.add(item);
|
||||
doc.setIn(docPath, seq);
|
||||
} else throw new Error('配置项 ' + docPath.join('.') + ' 不是数组,无法追加');
|
||||
continue;
|
||||
}
|
||||
const node = styledNode(doc, e.value, false);
|
||||
// 直接写参数键(整对象 set)时也要 flow
|
||||
if (FLOW_PARAM_KEYS.has(String(docPath[docPath.length - 1])) &&
|
||||
node && typeof node === 'object' && !YAML.isScalar(node)) node.flow = true;
|
||||
doc.setIn(docPath, node);
|
||||
}
|
||||
return doc.toString();
|
||||
}
|
||||
|
||||
+237
-11
@@ -16,6 +16,13 @@ const TOOL_DEFINITIONS = require('./tools/definitions.json');
|
||||
let cfg, db, bus;
|
||||
const runs = new Map(); // session_id -> {cancelled, procs:Set, abortController, looping:boolean}
|
||||
const titling = new Set(); // 正在生成标题的会话(防重入;标题落库后靠 title 非空自然不再触发)
|
||||
// 待投递消息队列:session_id -> [{id, content, deepThink, mode, created_at}]
|
||||
// 铁律:队列里的消息**绝不先落 messages 表**,只在「安全边界」写入并成为模型下一轮输入:
|
||||
// ① 工具批次闭合(本批每个 tool_call_id 都有回执);② 无 tool_calls 的回复已落库;
|
||||
// ③ 回合 finalize(循环已退、没有在跑的工具)。
|
||||
// 原因:tool 回执必须紧跟带 tool_calls 的 assistant,user 行插进批次中间、或批次没闭合就收尾,
|
||||
// 都会让上游拒收整个请求(tool_call 配对)。进程内内存态(同 runs),重启即丢,不跨实例共享。
|
||||
const pendings = new Map();
|
||||
|
||||
// ---------- 小工具 ----------
|
||||
const now = () => Date.now();
|
||||
@@ -142,6 +149,8 @@ function emitStatus(sessionId) {
|
||||
session_id: sessionId,
|
||||
status: s.status,
|
||||
model_id: s.model_id,
|
||||
// 待投递队列一并带上:前端把条幅当成服务端状态的回显,重连/换设备后自动对齐
|
||||
pending: listPending(sessionId),
|
||||
});
|
||||
}
|
||||
|
||||
@@ -456,6 +465,46 @@ function killRunProcs(run) {
|
||||
run.procs.clear();
|
||||
}
|
||||
|
||||
// 关闭当前工具批次:给「最后一条带 tool_calls 的 assistant」里还没有回执的调用补合成 tool 行。
|
||||
// 上游硬约束:assistant.tool_calls 必须逐个配 tool 消息,缺一条整个请求被拒(400)。
|
||||
// 触发点:取消(含「立即发送」硬中断)、干预跳过同批剩余调用、finalize 兜底(异常退出)。
|
||||
// 只在批次尾部补:若最后一条非 tool 行已经是 user(历史遗留脏数据、user 插在批次中间),
|
||||
// 补在后面会造成顺序错乱,交给 llm.buildMessages 的读侧配对过滤处理。
|
||||
// reason 是一句以冒号结尾的前缀,拼成模型能读懂的「为什么没执行」。
|
||||
function closeToolBatch(sessionId, reason) {
|
||||
// 会话已被删除(用户在工具执行中删了会话):不再往库里补行,否则留下无法归属的孤儿行。
|
||||
if (!getSession(sessionId)) return 0;
|
||||
// 只取最后一条非 tool 行 + 它之后的回执 id:走 idx_messages_session,不载全量历史
|
||||
//(finalize 每回合都会调一次,长会话下 loadHistory 太贵)。
|
||||
const last = db.prepare(
|
||||
"SELECT id, role, tool_calls FROM messages WHERE session_id = ? AND role != 'tool' ORDER BY id DESC LIMIT 1"
|
||||
).get(sessionId);
|
||||
if (!last || last.role !== 'assistant') return 0; // 最后一条非 tool 行不是 assistant:不是当前批次
|
||||
if (!last.tool_calls) return 0; // 收尾回复:批次已经闭合
|
||||
let calls = [];
|
||||
try { calls = JSON.parse(last.tool_calls) || []; } catch (_) { return 0; }
|
||||
if (!calls.length) return 0;
|
||||
const got = new Set(
|
||||
db.prepare(
|
||||
"SELECT tool_call_id FROM messages WHERE session_id = ? AND role = 'tool' AND id > ? AND tool_call_id IS NOT NULL AND tool_call_id != ''"
|
||||
).all(sessionId, last.id).map(r => r.tool_call_id)
|
||||
);
|
||||
let n = 0;
|
||||
for (const c of calls) {
|
||||
if (!c || !c.id || got.has(c.id)) continue;
|
||||
const name = (c.function && c.function.name) || '未知工具';
|
||||
const text = 'Error: ' + reason + '本次调用未执行(' + name + ')。';
|
||||
const msgId = saveMessage(sessionId, { role: 'tool', tool_call_id: c.id, name, content: text, is_error: true });
|
||||
// 同步广播:前端工具卡不能停在「调用中」呼吸态
|
||||
bus.emit(sessionId, 'tool_result', {
|
||||
tool_call_id: c.id, name, content: text, is_error: true, msg_id: msgId,
|
||||
});
|
||||
n++;
|
||||
}
|
||||
if (n) log.info('tool', sessionId + ' 补齐 ' + n + ' 条未执行调用的合成回执(' + reason + ')');
|
||||
return n;
|
||||
}
|
||||
|
||||
// ---------- Agent 主循环 ----------
|
||||
async function runLoop(sessionId) {
|
||||
const run = getRun(sessionId, true);
|
||||
@@ -481,22 +530,34 @@ function finalize(sessionId, run) {
|
||||
const s = getSession(sessionId);
|
||||
if (!s || s.status !== 'active') { runs.delete(sessionId); return; }
|
||||
const cancelled = run.cancelled;
|
||||
// 兜底:回合结束时本批 tool_call 必须逐个有回执。取消/异常/进程被杀都可能留下半批,
|
||||
// 缺的补一条「未执行」合成回执——这是「工具调用不匹配」的唯一根治点。
|
||||
try { closeToolBatch(sessionId, cancelled ? (run.interruptReason || '用户已终止任务:') : '回合异常结束:'); }
|
||||
catch (e) { log.warn('tool', sessionId + ' 关闭工具批次失败:' + (e && e.message || e)); }
|
||||
if (cancelled) {
|
||||
touch(sessionId, { status: 'cancelled', cancelled_at: now(), completed_at: null });
|
||||
runs.delete(sessionId);
|
||||
bus.emit(sessionId, 'done', { status: 'cancelled' });
|
||||
emitStatus(sessionId);
|
||||
return;
|
||||
} else {
|
||||
// 正常结束:进入 held,绑定保持(key 非独占、无租约,不再自动到期);用户追问直接复用模型,唯一出口是手动「断开」。
|
||||
touch(sessionId, { status: 'held', held_at: now(), completed_at: null, cancelled_at: null });
|
||||
runs.delete(sessionId);
|
||||
bus.emit(sessionId, 'done', { status: 'held' });
|
||||
emitStatus(sessionId);
|
||||
maybeGenerateTitle(sessionId, s, run);
|
||||
// 定时即下班:本回合创建过定时任务 → done 广播后收口(attachBus 监听已在 done 回调里同步捕获绑定入队投递,
|
||||
// 此时删绑定不影响微信本次回复送达)。
|
||||
if (run.taskWrap) taskClockOut(sessionId);
|
||||
}
|
||||
// 队首待投递消息:回合已收尾(循环已退、批次已闭合),这是排队模式唯一的安全出口。
|
||||
// setImmediate 让 finalize 所在的 finally 先跑完(maybeAutoCompress 会读状态),再开新一轮。
|
||||
if (headPending(sessionId)) {
|
||||
setImmediate(() => {
|
||||
try { deliverPendingHead(sessionId); }
|
||||
catch (e) { log.warn('msg', sessionId + ' 待投递消息发送失败:' + (e && e.message || e)); }
|
||||
});
|
||||
}
|
||||
// 正常结束:进入 held,绑定保持(key 非独占、无租约,不再自动到期);用户追问直接复用模型,唯一出口是手动「断开」。
|
||||
touch(sessionId, { status: 'held', held_at: now(), completed_at: null, cancelled_at: null });
|
||||
runs.delete(sessionId);
|
||||
bus.emit(sessionId, 'done', { status: 'held' });
|
||||
emitStatus(sessionId);
|
||||
maybeGenerateTitle(sessionId, s, run);
|
||||
// 定时即下班:本回合创建过定时任务 → done 广播后收口(attachBus 监听已在 done 回调里同步捕获绑定入队投递,
|
||||
// 此时删绑定不影响微信本次回复送达)。
|
||||
if (run.taskWrap) taskClockOut(sessionId);
|
||||
}
|
||||
|
||||
// 自动生成标题:每回合结束(finalize 成功分支)过门槛才触发,fire-and-forget 不阻塞收尾。
|
||||
@@ -736,6 +797,13 @@ async function runLoopInner(sessionId, run) {
|
||||
}
|
||||
|
||||
if (!hasTools) {
|
||||
// 「干预」升级过的待投递消息:本条回复已落库,正是安全边界——直接插话并继续同一回合
|
||||
//(不用等 finalize 再开新一轮,模型能接着刚才的上下文改弦更张)。
|
||||
const head = headPending(sessionId);
|
||||
if (head && head.mode === 'interject') {
|
||||
deliverPendingHead(sessionId);
|
||||
continue;
|
||||
}
|
||||
// 回合结束;但若期间用户又发了新消息(live 投递),继续下一轮而不是收尾
|
||||
if (!hasUserSince(sessionId, lastIncludedId)) break;
|
||||
continue;
|
||||
@@ -743,8 +811,19 @@ async function runLoopInner(sessionId, run) {
|
||||
|
||||
// 执行工具
|
||||
const vision = modelVision(session);
|
||||
// 干预(整批还没开跑):一个工具都不执行,整批补「未执行」回执后立刻插话。
|
||||
// 顺序不能反:必须先闭合批次(写完全部 tool 回执)再写 user 行,否则 user 会夹在
|
||||
// assistant.tool_calls 与 tool 回执之间,上游直接拒收。
|
||||
const headBeforeBatch = headPending(sessionId);
|
||||
if (headBeforeBatch && headBeforeBatch.mode === 'interject') {
|
||||
closeToolBatch(sessionId, '用户已介入并要求中止:');
|
||||
deliverPendingHead(sessionId);
|
||||
iter++;
|
||||
continue;
|
||||
}
|
||||
// 标题门槛信号:本批参数预检通过并真实执行 = 会话在干实事(finalize 据此判是否立题,
|
||||
// 见 maybeGenerateTitle);errAck 批(参数畸形、下轮整轮对模型不可见)不算。
|
||||
// 见 maybeGenerateTitle);errAck 批(参数畸形、下轮整轮对模型不可见)不算,
|
||||
// 被干预整批跳过(上面已 continue)也不计。
|
||||
if (!isErrAck) run.toolWorked = true;
|
||||
for (const tc of msgRow.tool_calls) {
|
||||
if (run.cancelled) break;
|
||||
@@ -837,7 +916,18 @@ async function runLoopInner(sessionId, run) {
|
||||
image_url: imageRel ? '/api/sessions/' + encodeURIComponent(sessionId) + '/files/download?path=' + encodeURIComponent(imageRel) : undefined,
|
||||
msg_id: toolMsgId,
|
||||
});
|
||||
// 干预(当前工具已跑完、回执已落库):同批剩余调用不再执行,闭合批次后立刻插话。
|
||||
// 不杀进程——这就是「干预」与「立即发送」的唯一区别。
|
||||
const headAfterTool = headPending(sessionId);
|
||||
if (headAfterTool && headAfterTool.mode === 'interject') {
|
||||
closeToolBatch(sessionId, '用户已介入并要求中止:');
|
||||
deliverPendingHead(sessionId);
|
||||
break;
|
||||
}
|
||||
}
|
||||
// 取消(含「立即发送」硬中断):本批还没跑到的调用补合成回执,否则库里留下
|
||||
// 「有调用无回执」的孤儿行,下一轮请求必被上游拒收(本次顺手修掉的存量 bug)。
|
||||
if (run.cancelled) closeToolBatch(sessionId, run.interruptReason || '用户已终止任务:');
|
||||
iter++;
|
||||
}
|
||||
if (iter >= maxIter && !run.cancelled) {
|
||||
@@ -1058,6 +1148,132 @@ function createSession(title, preferModelId, assistantType, user) {
|
||||
return session;
|
||||
}
|
||||
|
||||
// ---------- 待投递消息(排队 / 干预 / 立即发送) ----------
|
||||
// 三种模式的差别只在「何时写库」,写库之前一律躺在 pendings 里(见文件头注释的铁律):
|
||||
// queue → 本轮 finalize 后投递(默认;浏览器关了也照发,因为队列在服务端)
|
||||
// interject → 当前工具批次闭合 / 本条回复落库后立即投递,同一回合内让模型看到
|
||||
// now → 硬中断(杀进程 + abort 流,本回合判 cancelled),收尾后立刻投递
|
||||
// 只允许升级队首:越过后面的消息先发会让对话顺序不可解释(前端也只有队首有这两个按钮)。
|
||||
function newPendingId() {
|
||||
return 'q_' + Date.now().toString(36) + Math.random().toString(36).slice(2, 8);
|
||||
}
|
||||
|
||||
function publicPending(it) {
|
||||
return { id: it.id, content: it.content, mode: it.mode, created_at: it.created_at };
|
||||
}
|
||||
|
||||
function pendingList(sessionId) {
|
||||
return pendings.get(sessionId) || [];
|
||||
}
|
||||
|
||||
function headPending(sessionId) {
|
||||
const list = pendings.get(sessionId);
|
||||
return list && list.length ? list[0] : null;
|
||||
}
|
||||
|
||||
function listPending(sessionId) {
|
||||
return pendingList(sessionId).map(publicPending);
|
||||
}
|
||||
|
||||
// 清空队列(用户点「停止」、删会话、清空会话):逐条广播,前端条幅随之消失。
|
||||
function clearPendings(sessionId) {
|
||||
const list = pendings.get(sessionId);
|
||||
if (!list || !list.length) return 0;
|
||||
pendings.delete(sessionId);
|
||||
for (const it of list) bus.emit(sessionId, 'pending_removed', { id: it.id, reason: 'cancelled' });
|
||||
log.info('msg', sessionId + ' 清空待投递消息 ' + list.length + ' 条');
|
||||
return list.length;
|
||||
}
|
||||
|
||||
// 入队。没有在跑的回合时,任何模式都等价于立即发送(队列只对运行中的回合有意义)。
|
||||
function enqueueMessage(sessionId, content, opts) {
|
||||
const session = getSession(sessionId);
|
||||
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
|
||||
const text = String(content == null ? '' : content).trim();
|
||||
if (!text) throw Object.assign(new Error('content 不能为空'), { status_code: 400 });
|
||||
const run = runs.get(sessionId);
|
||||
if (!run || !run.looping) {
|
||||
const r = postUserMessage(sessionId, text, { deepThink: !!(opts && opts.deepThink) });
|
||||
return { message_id: r.message_id, delivered: r.delivered, pending: [] };
|
||||
}
|
||||
const item = {
|
||||
id: newPendingId(), content: text,
|
||||
deepThink: !!(opts && opts.deepThink), mode: 'queue', created_at: now(),
|
||||
};
|
||||
const list = pendingList(sessionId).slice();
|
||||
list.push(item);
|
||||
pendings.set(sessionId, list);
|
||||
bus.emit(sessionId, 'pending_added', publicPending(item));
|
||||
log.info('msg', sessionId + ' 待投递消息入队(队列 ' + list.length + '):' + text.slice(0, 60).replace(/\s+/g, ' '));
|
||||
return { pending_id: item.id, queued: true, pending: list.map(publicPending) };
|
||||
}
|
||||
|
||||
// 升级队首:interject(跑完当前这一步就插话) / now(立刻中断本轮)。
|
||||
// 回合已经结束(没在跑)时直接投递——用户点按钮时恰好收尾,不该把消息卡在队列里。
|
||||
function promotePending(sessionId, qid, action) {
|
||||
const session = getSession(sessionId);
|
||||
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
|
||||
const list = pendingList(sessionId);
|
||||
const idx = list.findIndex(x => x.id === qid);
|
||||
if (idx < 0) throw Object.assign(new Error('待发送消息不存在'), { status_code: 404 });
|
||||
if (idx !== 0) throw Object.assign(new Error('只能升级队首消息:前面的消息还没发出去'), { status_code: 409 });
|
||||
const run = runs.get(sessionId);
|
||||
if (!run || !run.looping) {
|
||||
deliverPendingHead(sessionId);
|
||||
return { ok: true, delivered: true, pending: listPending(sessionId) };
|
||||
}
|
||||
const item = list[0];
|
||||
if (action === 'now') {
|
||||
item.mode = 'now';
|
||||
bus.emit(sessionId, 'pending_added', publicPending(item)); // 前端按 id upsert,按钮态跟着变
|
||||
run.interruptReason = '用户选择立即发送:';
|
||||
run.cancelled = true;
|
||||
killRunProcs(run);
|
||||
if (run.abortController) { try { run.abortController.abort(); } catch (_) {} }
|
||||
log.info('msg', sessionId + ' 立即发送:中断当前回合,收尾后投递队首');
|
||||
} else {
|
||||
item.mode = 'interject';
|
||||
bus.emit(sessionId, 'pending_added', publicPending(item));
|
||||
log.info('msg', sessionId + ' 干预:等待当前工具/回复结束后插话');
|
||||
}
|
||||
return { ok: true, pending: listPending(sessionId) };
|
||||
}
|
||||
|
||||
// 取消队列里的一条(条幅上的 ×)。任意一条都可删:删队首后剩下的自然顺延,顺序仍是 FIFO。
|
||||
function cancelPending(sessionId, qid) {
|
||||
const session = getSession(sessionId);
|
||||
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
|
||||
const list = pendingList(sessionId);
|
||||
const idx = list.findIndex(x => x.id === qid);
|
||||
if (idx < 0) throw Object.assign(new Error('待发送消息不存在'), { status_code: 404 });
|
||||
const next = list.slice();
|
||||
next.splice(idx, 1);
|
||||
if (next.length) pendings.set(sessionId, next); else pendings.delete(sessionId);
|
||||
bus.emit(sessionId, 'pending_removed', { id: qid, reason: 'cancelled' });
|
||||
log.info('msg', sessionId + ' 取消待投递消息 ' + qid);
|
||||
return { ok: true, pending: next.map(publicPending) };
|
||||
}
|
||||
|
||||
// 投递队首:写库 + 广播。调用方必须已保证处在安全边界(批次已闭合 / 回合已收尾)。
|
||||
// 落库走 postUserMessage:正在跑时它是 live 追加(下一轮迭代自动带上),没在跑时直接开新一轮。
|
||||
function deliverPendingHead(sessionId) {
|
||||
const list = pendingList(sessionId);
|
||||
if (!list.length) return null;
|
||||
const item = list[0];
|
||||
const next = list.slice(1);
|
||||
if (next.length) pendings.set(sessionId, next); else pendings.delete(sessionId);
|
||||
const r = postUserMessage(sessionId, item.content, { deepThink: item.deepThink });
|
||||
const row = db.prepare('SELECT created_at FROM messages WHERE id = ?').get(r.message_id);
|
||||
bus.emit(sessionId, 'pending_removed', { id: item.id, reason: 'delivered' });
|
||||
// 排队期间前端不画这条消息(它还不是历史),落库这一刻才画
|
||||
bus.emit(sessionId, 'user_message', {
|
||||
id: r.message_id, content: item.content,
|
||||
created_at: (row && row.created_at) || item.created_at, pending_id: item.id,
|
||||
});
|
||||
log.info('msg', sessionId + ' 待投递消息已送达(原模式 ' + item.mode + ',剩余 ' + next.length + ' 条)');
|
||||
return r;
|
||||
}
|
||||
|
||||
// 用户消息入口:不再排队——任意非 looping 状态都是「拿模型立即开跑」(delivered 恒 live);
|
||||
// 绑定失效(配置改动后原模型被删/禁用)由 ensureBinding 自动改选,用户无感。
|
||||
// opts.deepThink: true 时启用模型该「深度思考」参数(记在会话 run 上,正在跑的回合下一轮迭代会取到最新值)。
|
||||
@@ -1088,9 +1304,13 @@ function postUserMessage(sessionId, content, opts) {
|
||||
function stop(sessionId) {
|
||||
const session = getSession(sessionId);
|
||||
if (!session) throw Object.assign(new Error('会话不存在'), { status_code: 404 });
|
||||
// 「停止」= 全停:待投递队列一并作废。否则 finalize 会立刻把队首当成新回合发出去,
|
||||
// 与用户按停止的意图相反(「立即发送」不走这里,它只中断当前回合、保留队首)。
|
||||
clearPendings(sessionId);
|
||||
const run = runs.get(sessionId);
|
||||
if (run) {
|
||||
run.cancelled = true;
|
||||
run.interruptReason = '用户已终止任务:';
|
||||
killRunProcs(run);
|
||||
if (run.abortController) { try { run.abortController.abort(); } catch (_) {} }
|
||||
}
|
||||
@@ -1415,6 +1635,7 @@ function clearSessionMessages(sessionId) {
|
||||
if (run.abortController) { try { run.abortController.abort(); } catch (_) {} }
|
||||
}
|
||||
runs.delete(sessionId);
|
||||
clearPendings(sessionId); // 历史清零:队列里的消息也没了着落,一并作废
|
||||
db.prepare('DELETE FROM messages WHERE session_id = ?').run(sessionId);
|
||||
wipeSessionTmp(sessionId); // 会话级 /tmp 随清空一并抹掉(尽力而为,失败只记日志不阻断)
|
||||
autoCompressProposed.delete(sessionId); // 历史清零,恢复自动压缩提议额度
|
||||
@@ -1523,6 +1744,10 @@ module.exports = {
|
||||
activeRuns,
|
||||
createSession,
|
||||
postUserMessage,
|
||||
enqueueMessage,
|
||||
promotePending,
|
||||
cancelPending,
|
||||
listPending,
|
||||
stop,
|
||||
releaseHold,
|
||||
renameSession,
|
||||
@@ -1537,6 +1762,7 @@ module.exports = {
|
||||
loadHistory,
|
||||
checkToolArgs, // 参数预检/信封解包两个纯函数:导出供探针与回归验证(运行链路由 runLoopInner 内部调用)
|
||||
unwrapToolArgs,
|
||||
closeToolBatch, // 批次闭合兜底:导出供回归验证(正常链路由 runLoopInner / finalize 调用)
|
||||
saveMessage,
|
||||
recordModelUsage,
|
||||
modelUsageStats,
|
||||
|
||||
+43
-3
@@ -219,7 +219,33 @@ function buildMessages(session, language, mintUrl, profile, withProfile, trimOn)
|
||||
}
|
||||
// tool 回执按 tool_call_id 索引:给 errAck 行拼错误提示时取执行时挡下的原因
|
||||
const toolRowById = new Map();
|
||||
for (const row of history) if (row.role === 'tool' && row.tool_call_id) toolRowById.set(row.tool_call_id, row);
|
||||
// 只收「会下发」的回执:archived 行不进模型,不能拿它当配对凭据
|
||||
//(否则 assistant 的调用被保留、回执却被跳过,上游照样拒收)。
|
||||
for (const row of history) {
|
||||
if (row.role !== 'tool' || !row.tool_call_id || row.type === 'archived') continue;
|
||||
toolRowById.set(row.tool_call_id, row);
|
||||
}
|
||||
// 已下发的 tool_call id 集合:tool 行按它反查自己有没有「主」。
|
||||
// 与下面的调用侧过滤合成「读侧配对兜底」:库里的孤儿行(旧版本中途终止留下的有调用无回执、
|
||||
// 或历史被外部改动)一律不进请求——严格上游对配对是硬约束,缺一条整请求被拒。
|
||||
// 只影响发给模型的那一份,DB 与 UI 完全不动。
|
||||
const emittedCallIds = new Set();
|
||||
// 预扫:每条带 tool_calls 的 assistant「紧跟着它的那批回执」里真实存在的 call id。
|
||||
// 只往下扫连续的 tool 行,遇到 user/assistant 就停——上游要求 tool 回执紧跟在
|
||||
// 带 tool_calls 的 assistant 后面,中间夹任何消息(旧版 live 追投就可能把 user 插进来)
|
||||
// 都会让整批非法。所以不能拿「全库里有这条回执」当配对凭据。
|
||||
const pairedByAssistant = new Map(); // assistant 行 id -> Set(call_id)
|
||||
for (let i = 0; i < history.length; i++) {
|
||||
const r = history[i];
|
||||
if (r.role !== 'assistant' || !r.tool_calls) continue;
|
||||
const ids = new Set();
|
||||
for (let j = i + 1; j < history.length && history[j].role === 'tool'; j++) {
|
||||
// archived 回执不进模型,不能当作「已答复」凭据(否则调用被保留、回执被跳过)
|
||||
if (history[j].type === 'archived') continue;
|
||||
if (history[j].tool_call_id) ids.add(history[j].tool_call_id);
|
||||
}
|
||||
pairedByAssistant.set(r.id, ids);
|
||||
}
|
||||
// 「已消费」分界 = 最后一条**写过文本**的 assistant 行(不要求无 tool_calls):
|
||||
// 描述写在 content 里 + 继续调工具,就是模型真看到图的证据(见文件头注释的循环复盘)。
|
||||
// errAck / archived 不发模型,不算回复:它们之前的图不算被消费。
|
||||
@@ -293,8 +319,20 @@ function buildMessages(session, language, mintUrl, profile, withProfile, trimOn)
|
||||
// reasoning_ack_field 改名注入后此键必被剥除,不会泄往上游)。
|
||||
if (row.reasoning) m.__reasoning = row.reasoning;
|
||||
if (row.tool_calls) {
|
||||
m.tool_calls = JSON.parse(row.tool_calls);
|
||||
if (trimActive && TRIM.writeRounds > 0) trimWriteCalls(m.tool_calls, roundsAfter.get(row.id) || 0);
|
||||
let calls = [];
|
||||
try { calls = JSON.parse(row.tool_calls) || []; } catch (_) { calls = []; }
|
||||
// 配对兜底(读侧):只下发本批确有回执的调用。旧版本中途终止、外部工具异常、
|
||||
// user 行插进批次中间,都会留下无法配对的调用,严格上游会拒收整个请求。
|
||||
const pairedIds = pairedByAssistant.get(row.id) || new Set();
|
||||
const paired = calls.filter(c => c && c.id && pairedIds.has(c.id));
|
||||
if (!paired.length) {
|
||||
// 整轮调用都没回执:纯工具轮整行不发;带正文的保留为普通文本回复
|
||||
if (!String(m.content || '').trim()) return;
|
||||
} else {
|
||||
m.tool_calls = paired;
|
||||
for (const c of paired) emittedCallIds.add(c.id);
|
||||
if (trimActive && TRIM.writeRounds > 0) trimWriteCalls(m.tool_calls, roundsAfter.get(row.id) || 0);
|
||||
}
|
||||
}
|
||||
if (!m.content) delete m.content;
|
||||
messages.push(m);
|
||||
@@ -302,6 +340,8 @@ function buildMessages(session, language, mintUrl, profile, withProfile, trimOn)
|
||||
}
|
||||
// errAck 轮的 tool 回执:随该轮一起丢弃,避免无主 tool 消息
|
||||
if (row.role === 'tool' && dropToolCallIds.has(row.tool_call_id)) return;
|
||||
// 孤儿 tool 回执(调用行被过滤/存档/errAck 丢弃):单独下发必被上游拒收,直接跳过
|
||||
if (row.role === 'tool' && !emittedCallIds.has(row.tool_call_id)) return;
|
||||
// tool/user 行:含图哨兵 JSON 还原为内容块(解析结果按行 id 缓存);已消费的图只留文字描述 + 标记
|
||||
const blocks = cachedDecodeBlocks(session, row);
|
||||
let content = row.content || '';
|
||||
|
||||
+26
-3
@@ -18,7 +18,21 @@ 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 头下发
|
||||
|
||||
// 每个服务的连接状态(启动发现 + 重试阶梯的实时结果),给设置页卡片上的「已连接 / 未连接」用。
|
||||
// 只反映运行态:改了 headers 没重启时仍是旧状态(页面顶部有「配置已写入,重启后生效」横幅兜底)。
|
||||
const statusMap = new Map(); // key = name|url|mode
|
||||
function statusKeyOf(s) {
|
||||
return [s.name, String(s.url || '').replace(/\/+$/, ''), s.mode || 'advertise'].join('|');
|
||||
}
|
||||
function setStatus(s, patch) {
|
||||
statusMap.set(statusKeyOf(s), Object.assign({
|
||||
name: s.name, url: s.url, mode: s.mode || 'advertise',
|
||||
ok: false, tools: 0, hidden: 0, disabled: false, error: '',
|
||||
}, patch));
|
||||
}
|
||||
function statuses() { return Array.from(statusMap.values()); }
|
||||
|
||||
// 发一次 JSON-RPC 请求,返回 { result, headers }(HTTP 非 2xx / error / 无法解析时抛异常)。
|
||||
// 某些 MCP 服务遵循 Streamable HTTP 规范会在 initialize 响应里返回 Mcp-Session-Id,
|
||||
@@ -169,9 +183,16 @@ async function loadServer(s) {
|
||||
log.warn('mcp', s.name + ': 名单过滤后剩 0 个工具,请核对 tools_allow/tools_deny 与 ' +
|
||||
'服务端实际工具名(如 ' + all.slice(0, 3).map(t => t.name).join(', ') + ' …)');
|
||||
}
|
||||
setStatus(s, { ok: true, tools: tools.length, hidden: hidden });
|
||||
return true;
|
||||
} catch (err) {
|
||||
log.warn('mcp', s.name + ' 工具发现失败(' + (err && err.message || err) + ')');
|
||||
// Node 的 fetch 只给一句 "fetch failed",真正原因在 cause(code=ECONNREFUSED / ENOTFOUND,
|
||||
// 或 message="bad port" 这类),设置页卡片的 title 要看这个才诊断得了
|
||||
const cause = err && err.cause;
|
||||
const detail = (cause && (cause.code || cause.message)) || '';
|
||||
const msg = String((err && err.message) || err) + (detail ? '(' + detail + ')' : '');
|
||||
log.warn('mcp', s.name + ' 工具发现失败(' + msg + ')');
|
||||
setStatus(s, { error: msg });
|
||||
return false;
|
||||
}
|
||||
}
|
||||
@@ -208,6 +229,7 @@ function retryFailed(failed) {
|
||||
async function init(cfg) {
|
||||
toolDefs = [];
|
||||
toolIndex.clear();
|
||||
statusMap.clear();
|
||||
PUBLIC_BASE = (cfg && cfg.public_link && cfg.public_link.base_url) || '';
|
||||
try {
|
||||
for (const d of require('./tools/definitions.json')) {
|
||||
@@ -221,6 +243,7 @@ async function init(cfg) {
|
||||
// mode: disable 时启动不加载该服务(不建工具表;配置保留,改回 advertise 重启后恢复)
|
||||
if (s.mode === 'disable') {
|
||||
log.info('mcp', s.name + ': mode=disable,跳过工具加载');
|
||||
setStatus(s, { disabled: true });
|
||||
continue;
|
||||
}
|
||||
if (!(await loadServer(s))) failed.push(s);
|
||||
@@ -295,4 +318,4 @@ async function notifyTool(name, args, timeoutMs, extraHeaders) {
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = { init, toolDefinitions, hasTool, skillTools, getSkillTool, callTool, notifyTool };
|
||||
module.exports = { init, toolDefinitions, hasTool, skillTools, getSkillTool, callTool, notifyTool, statuses };
|
||||
|
||||
@@ -0,0 +1,132 @@
|
||||
{
|
||||
"platforms": [
|
||||
{
|
||||
"key": "bigmodel",
|
||||
"label": "智谱",
|
||||
"url": "https://open.bigmodel.cn/api/paas/v4",
|
||||
"type": "bigmodel",
|
||||
"model_hint": "glm-5.3-flash",
|
||||
"model_defaults": {
|
||||
"vision": true,
|
||||
"extra_params": { "reasoning_effort": "low", "tool_stream": true },
|
||||
"thinking_params": { "reasoning_effort": "max" }
|
||||
}
|
||||
},
|
||||
{
|
||||
"key": "deepseek",
|
||||
"label": "DeepSeek",
|
||||
"url": "https://api.deepseek.com",
|
||||
"type": "deepseek",
|
||||
"model_hint": "deepseek-flash",
|
||||
"model_defaults": {
|
||||
"vision": true,
|
||||
"extra_params": { "thinking": { "type": "disabled" } },
|
||||
"thinking_params": { "thinking": { "type": "enabled" }, "reasoning_effort": "max" },
|
||||
"reasoning_ack_field": "reasoning_content"
|
||||
}
|
||||
},
|
||||
{
|
||||
"key": "qwen",
|
||||
"label": "通义千问",
|
||||
"url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
|
||||
"type": "qwen",
|
||||
"model_hint": "qwen3.8-flash",
|
||||
"model_defaults": {
|
||||
"vision": true,
|
||||
"extra_params": { "enable_thinking": false },
|
||||
"thinking_params": { "enable_thinking": true, "reasoning_effort": "xhigh" }
|
||||
}
|
||||
}
|
||||
],
|
||||
"mcp": [
|
||||
{
|
||||
"key": "web_search",
|
||||
"label": "网页搜索",
|
||||
"desc": "栈内搜索服务,无需密钥",
|
||||
"url": "http://mcp_web_search:3000/",
|
||||
"mode": "advertise",
|
||||
"fields": []
|
||||
},
|
||||
{
|
||||
"key": "image_task",
|
||||
"label": "图片生成",
|
||||
"desc": "文生图 / 图生图",
|
||||
"url": "http://mcp_image_task:3000/mcp",
|
||||
"mode": "skill",
|
||||
"fields": [
|
||||
{
|
||||
"header": "Authorization",
|
||||
"label": "鉴权",
|
||||
"secret": true,
|
||||
"prefix": "Bearer ",
|
||||
"required": true,
|
||||
"placeholder": "API Key"
|
||||
},
|
||||
{
|
||||
"header": "X-Image-Task-Base-Url",
|
||||
"label": "地址",
|
||||
"required": true,
|
||||
"placeholder": "https://<host>/v1",
|
||||
"hint": "OpenAI 兼容 generations / edits"
|
||||
},
|
||||
{
|
||||
"header": "X-Image-Task-Model",
|
||||
"label": "模型",
|
||||
"required": true,
|
||||
"placeholder": "上游的模型 id"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"key": "video_task",
|
||||
"label": "视频生成",
|
||||
"desc": "智谱 BigModel 异步视频接口",
|
||||
"url": "http://mcp_video_task:3000/mcp",
|
||||
"mode": "skill",
|
||||
"fields": [
|
||||
{
|
||||
"header": "Authorization",
|
||||
"label": "鉴权",
|
||||
"secret": true,
|
||||
"prefix": "Bearer ",
|
||||
"required": true,
|
||||
"placeholder": "智谱 API Key"
|
||||
},
|
||||
{
|
||||
"header": "X-Video-Task-Model",
|
||||
"label": "模型",
|
||||
"default": "cogvideox-flash"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"key": "asr",
|
||||
"label": "语音识别",
|
||||
"desc": "按住说话 / transcribe_audio",
|
||||
"url": "http://mcp_asr:3000/mcp",
|
||||
"mode": "skill",
|
||||
"fields": [
|
||||
{
|
||||
"header": "Authorization",
|
||||
"label": "鉴权",
|
||||
"secret": true,
|
||||
"prefix": "Bearer ",
|
||||
"placeholder": "支持自建免鉴权服务"
|
||||
},
|
||||
{
|
||||
"header": "X-ASR-Base-Url",
|
||||
"label": "地址",
|
||||
"required": true,
|
||||
"placeholder": "https://<host>/v1",
|
||||
"hint": "OpenAI 兼容的 /audio/transcriptions"
|
||||
},
|
||||
{
|
||||
"header": "X-ASR-Model",
|
||||
"label": "模型",
|
||||
"required": true,
|
||||
"placeholder": "上游的模型 id"
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
+103
-27
@@ -11,12 +11,24 @@
|
||||
--drawer-bg: rgb(249, 250, 251); /* 侧边栏底色(与页面白底区分;分组表头吸顶同色) */
|
||||
--border: #ececf1;
|
||||
--radius-lg: 24px;
|
||||
/* 安全区与软键盘(成因与注入约定见 js/viewport.js 顶部注释):
|
||||
--sat / --sab 默认取 env()——iOS 独立 PWA 下有效;安卓 WebView 的 env() 只反映
|
||||
屏幕挖孔(display cutout),不含状态栏/导航栏高度,基本恒为 0,需由套壳 App 用
|
||||
documentElement.style.setProperty 注入真实高度覆盖。
|
||||
--kb 是键盘占用的高度,取两个来源的较大值:--kb-page 由 viewport.js 按 visualViewport
|
||||
算(壳不注入时也能工作),--kb-native 由壳按 IME insets 注入(WebView 完全感知不到
|
||||
键盘时只能走这条)。两个变量分开放,避免页面与壳互相覆盖同一个值。 */
|
||||
--sat: env(safe-area-inset-top, 0px);
|
||||
--sab: env(safe-area-inset-bottom, 0px);
|
||||
--kb-page: 0px;
|
||||
--kb-native: 0px;
|
||||
--kb: max(var(--kb-page), var(--kb-native));
|
||||
}
|
||||
* { margin: 0; padding: 0; box-sizing: border-box; -webkit-tap-highlight-color: transparent; }
|
||||
/* 整站是视口锁定的 app shell:文档本身永不滚动,滚动只发生在内部容器
|
||||
(消息流 #chat-view / 抽屉列表 .drawer-list / 设置页 .set-scroll,均已 overflow-y:auto)。
|
||||
不写 overflow:hidden 时,桌面端只要有一行内容没收缩下(nowrap 胶囊/代码块/宽表格),
|
||||
浏览器就给窗口加横向滚动条;横向条又吃掉一屏高度,而 #app 死守 height:100%,
|
||||
浏览器就给窗口加横向滚动条;横向条又吃掉一屏高度,而 #app 死守视口高度,
|
||||
于是竖横向滚动条一起出现、缩窗口页面不动。 */
|
||||
html, body { height: 100%; overflow: hidden; }
|
||||
body {
|
||||
@@ -37,7 +49,9 @@ input, textarea { font: inherit; color: inherit; border: 0; outline: none; backg
|
||||
|
||||
/* ================= 应用骨架 ================= */
|
||||
#app {
|
||||
height: 100%;
|
||||
/* 减去 --kb:键盘弹起时整块 shell 收缩,footer 才会落在键盘上沿。
|
||||
壳已正确 resize(adjustResize / resizes-content)时 --kb 恒为 0,不重复收缩。 */
|
||||
height: calc(100% - var(--kb));
|
||||
max-width: 760px;
|
||||
margin: 0 auto;
|
||||
display: flex;
|
||||
@@ -53,7 +67,8 @@ input, textarea { font: inherit; color: inherit; border: 0; outline: none; backg
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
padding: 10px 12px;
|
||||
/* 顶栏自己吃下状态栏高度(背景跟着铺上去,不留白条);设置页顶栏同用 .header */
|
||||
padding: calc(10px + var(--sat)) 12px 10px;
|
||||
min-height: 56px;
|
||||
background: var(--drawer-bg);
|
||||
}
|
||||
@@ -280,7 +295,7 @@ main { flex: 1; min-height: 0; display: flex; flex-direction: column; }
|
||||
.tool-card .tool-time .act-del:hover { color: #c0392b; }
|
||||
|
||||
/* ================= 底部输入区 ================= */
|
||||
footer { position: relative; flex: none; padding: 8px 12px calc(10px + env(safe-area-inset-bottom, 0px)); background: var(--page); }
|
||||
footer { position: relative; flex: none; padding: 8px 12px calc(10px + var(--sab)); background: var(--page); }
|
||||
.attach-chips { display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 8px; }
|
||||
.attach-chip {
|
||||
display: inline-flex; align-items: center; gap: 6px;
|
||||
@@ -436,12 +451,12 @@ body.voice-active .scroll-bottom-btn { display: none; }
|
||||
#voice-overlay {
|
||||
position: absolute;
|
||||
top: -72px;
|
||||
bottom: calc(-11px - env(safe-area-inset-bottom, 0px));
|
||||
bottom: calc(-11px - var(--sab));
|
||||
left: -13px; right: -13px;
|
||||
z-index: 6;
|
||||
display: flex; flex-direction: column; align-items: center; justify-content: flex-end;
|
||||
gap: 20px;
|
||||
padding-bottom: calc(70px + env(safe-area-inset-bottom, 0px));
|
||||
padding-bottom: calc(70px + var(--sab));
|
||||
/* 底色必须是**不透明**的 var(--page):早先只铺一层 9% 蓝渐变,遮罩伸进会话流的那一段
|
||||
会把底下的消息文字透出来,「松手传送」看着就成了半透明。
|
||||
顶层那 20px 由透明渐变到 --page 只是把上边缘与会话流接上,别把整块都做成渐变。 */
|
||||
@@ -508,7 +523,7 @@ body.voice-active .scroll-bottom-btn { display: none; }
|
||||
border-radius: 16px 16px 0 0;
|
||||
box-shadow: 0 -6px 24px rgba(20, 30, 70, 0.16);
|
||||
transform: translateY(105%); transition: transform .25s ease; /* 收起时滑出屏幕 */
|
||||
padding-bottom: env(safe-area-inset-bottom, 0px);
|
||||
padding-bottom: var(--sab);
|
||||
overflow: hidden;
|
||||
}
|
||||
.files-panel.open { transform: translateY(0); }
|
||||
@@ -604,7 +619,7 @@ body.voice-active .scroll-bottom-btn { display: none; }
|
||||
padding: 10px 14px;
|
||||
border-top: 1px solid var(--border);
|
||||
background: var(--page);
|
||||
padding-bottom: calc(10px + env(safe-area-inset-bottom, 0px));
|
||||
padding-bottom: calc(10px + var(--sab));
|
||||
}
|
||||
.files-panel-count {
|
||||
font-size: 13px; color: var(--gray);
|
||||
@@ -757,7 +772,9 @@ body.voice-active .scroll-bottom-btn { display: none; }
|
||||
}
|
||||
#scrim.show { opacity: 1; pointer-events: auto; }
|
||||
#drawer {
|
||||
position: fixed; top: 0; bottom: 0; left: 0; z-index: 50;
|
||||
/* 抽屉是 fixed 全屏层:顶部让出状态栏,底部随键盘收缩(搜索框输入时列表不被盖住) */
|
||||
position: fixed; top: 0; bottom: var(--kb); left: 0; z-index: 50;
|
||||
padding-top: var(--sat);
|
||||
width: min(78vw, 320px);
|
||||
background: var(--drawer-bg);
|
||||
display: flex; flex-direction: column;
|
||||
@@ -848,7 +865,7 @@ body.voice-active .scroll-bottom-btn { display: none; }
|
||||
/* 底部用户区 */
|
||||
.drawer-user {
|
||||
flex: none; display: flex; align-items: center; gap: 10px;
|
||||
padding: 12px 14px calc(12px + env(safe-area-inset-bottom, 0px));
|
||||
padding: 12px 14px calc(12px + var(--sab));
|
||||
border-top: 1px solid var(--border);
|
||||
}
|
||||
.avatar {
|
||||
@@ -933,12 +950,12 @@ body.voice-active .scroll-bottom-btn { display: none; }
|
||||
/* 两层 img 绝对定位居中叠放:滑动切换时旧图滑出、新图同步滑入(见 js/stream.js 的 slideTo) */
|
||||
#img-viewer img { position: absolute; inset: 0; margin: auto; max-width: 100vw; max-height: 88vh; touch-action: none; cursor: grab; user-select: none; -webkit-user-drag: none; will-change: transform; }
|
||||
/* 组内页码:底部居中悬浮,不参与命中测试(点它等于点背景会关闭) */
|
||||
#img-count { position: fixed; left: 50%; bottom: calc(18px + env(safe-area-inset-bottom, 0px)); transform: translateX(-50%); z-index: 151; padding: 3px 12px; border-radius: 999px; background: rgba(0,0,0,0.5); color: #fff; font-size: 12px; letter-spacing: .5px; pointer-events: none; }
|
||||
#img-count { position: fixed; left: 50%; bottom: calc(18px + var(--sab)); transform: translateX(-50%); z-index: 151; padding: 3px 12px; border-radius: 999px; background: rgba(0,0,0,0.5); color: #fff; font-size: 12px; letter-spacing: .5px; pointer-events: none; }
|
||||
#fs-viewer { position: fixed; inset: 0; z-index: 130; background: rgba(8,10,20,0.88); padding: 40px 14px 24px; overflow: auto; /* 缩放后支持横纵滚动 */ }
|
||||
#fs-viewer.hidden { display: none; }
|
||||
.fs-panel { max-width: 860px; margin: 0 auto; background: var(--page); border-radius: 14px; padding: 18px 20px; font-size: 15.5px; }
|
||||
/* 顶部操作区:默认右上角悬浮(消息全屏用);文件预览走 fs-bar 模式时独立成一行 */
|
||||
.fs-actions { position: fixed; top: calc(2px + env(safe-area-inset-top, 0px)); right: 14px; z-index: 131; display: flex; align-items: center; gap: 8px; }
|
||||
.fs-actions { position: fixed; top: calc(2px + var(--sat)); right: 14px; z-index: 131; display: flex; align-items: center; gap: 8px; }
|
||||
.fs-name { display: none; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 13px; font-weight: 600; color: var(--ink); }
|
||||
.fs-btn {
|
||||
flex: none; display: flex; align-items: center; justify-content: center;
|
||||
@@ -955,8 +972,8 @@ body.voice-active .scroll-bottom-btn { display: none; }
|
||||
#fs-viewer.fs-bar .fs-actions {
|
||||
position: sticky; top: 0; z-index: 1;
|
||||
flex: none; width: 100%;
|
||||
height: calc(40px + env(safe-area-inset-top, 0px));
|
||||
padding: env(safe-area-inset-top, 0px) 10px 0 14px;
|
||||
height: calc(40px + var(--sat));
|
||||
padding: var(--sat) 10px 0 14px;
|
||||
justify-content: flex-end; gap: 6px;
|
||||
background: var(--page); border-bottom: 1px solid var(--border);
|
||||
}
|
||||
@@ -971,14 +988,14 @@ body.voice-active .scroll-bottom-btn { display: none; }
|
||||
#fs-viewer.fs-bar #fs-body .bubble-ai,
|
||||
#fs-viewer.fs-bar #fs-body .bubble-user {
|
||||
max-width: 100%; margin: 0; border-radius: 0; box-shadow: none; background: var(--page);
|
||||
padding: 14px 12px calc(28px + env(safe-area-inset-bottom, 0px)); font-size: 15.5px;
|
||||
padding: 14px 12px calc(28px + var(--sab)); font-size: 15.5px;
|
||||
}
|
||||
#fs-viewer.fs-bar #fs-src-pane { overflow: auto; }
|
||||
#fs-viewer.fs-bar #fs-src-code { max-height: none; border: 0; border-radius: 0; padding: 12px 14px calc(28px + env(safe-area-inset-bottom, 0px)); }
|
||||
#fs-viewer.fs-bar #fs-src-code { max-height: none; border: 0; border-radius: 0; padding: 12px 14px calc(28px + var(--sab)); }
|
||||
#fs-viewer.fs-bar .fs-img-frame { max-width: 100%; max-height: 100%; border-radius: 0; margin: 0 auto; }
|
||||
.fs-close {
|
||||
/* 顶到视口最上沿(避开刘海),不再压住预览面板顶部 */
|
||||
position: fixed; top: calc(2px + env(safe-area-inset-top, 0px)); right: 14px; z-index: 131; width: 34px; height: 34px;
|
||||
position: fixed; top: calc(2px + var(--sat)); right: 14px; z-index: 131; width: 34px; height: 34px;
|
||||
border: none; border-radius: 50%; background: rgba(0,0,0,0.42); color: #fff;
|
||||
box-shadow: 0 1px 5px rgba(0,0,0,0.22);
|
||||
font-size: 15px; line-height: 1; cursor: pointer;
|
||||
@@ -1028,7 +1045,7 @@ body.voice-active .scroll-bottom-btn { display: none; }
|
||||
.header-right .icon-btn:active, .header-right label.icon-btn:active { background: var(--surface); }
|
||||
label.icon-btn { cursor: pointer; }
|
||||
#set-body { flex: 1; min-height: 0; background: var(--surface); display: flex; flex-direction: column; }
|
||||
.set-scroll { flex: 1; min-height: 0; overflow-y: auto; overflow-x: hidden; padding: 12px 12px calc(16px + env(safe-area-inset-bottom, 0px)); }
|
||||
.set-scroll { flex: 1; min-height: 0; overflow-y: auto; overflow-x: hidden; padding: 12px 12px calc(16px + var(--sab)); }
|
||||
.empty-tip { color: var(--gray-light); text-align: center; padding: 18px; font-size: 13px; }
|
||||
|
||||
/* ---------- 设置主页卡片 ---------- */
|
||||
@@ -1186,6 +1203,9 @@ label.icon-btn { cursor: pointer; }
|
||||
.model-card-state.busy { background: #fdecea; color: #b3382c; }
|
||||
.model-card-state.pending { background: #fff4dc; color: #a06a00; }
|
||||
.model-card-state.off { background: var(--surface); color: var(--gray); }
|
||||
/* MCP 页分段标题:内置服务 / 其它服务 */
|
||||
.mcp-sec-title { margin: 16px 4px 0; font-size: 12.5px; font-weight: 600; color: var(--gray); }
|
||||
.mcp-list > .mcp-sec-title:first-child { margin-top: 10px; }
|
||||
/* 禁用态卡片:背景转灰、名称/token 区淡化,开关保持正常亮度可点 */
|
||||
.model-card.off { background: #f5f6f8; }
|
||||
.model-card.off .model-card-name, .model-card.off .cfg-kv { opacity: 0.5; }
|
||||
@@ -1204,6 +1224,8 @@ label.icon-btn { cursor: pointer; }
|
||||
/* 三段分区:平台字段 / Keys / 模型,用虚线分隔 + 留白,避免挤在一起 */
|
||||
.modal .mpe-sec { margin-top: 16px; padding-top: 12px; border-top: 1px dashed var(--border); }
|
||||
.modal .mpe-sec-head { display: flex; align-items: center; justify-content: space-between; gap: 8px; margin: 0 0 10px; font-size: 13px; font-weight: 600; color: var(--ink); }
|
||||
/* 标题右侧的说明(如内置服务的 desc):跟 flex 靠右,去掉 .cfg-note 的上边距;min-width 让它在窄屏可折行 */
|
||||
.modal .mpe-sec-head .cfg-note { margin: 0; text-align: right; min-width: 0; font-weight: 400; }
|
||||
.modal .mpe-foot { margin-top: 18px; }
|
||||
.modal .mpe-sec-head .ghost-btn.sm { flex: none; padding: 4px 12px; font-size: 12.5px; border-radius: 8px; }
|
||||
.modal .mpe-row { display: flex; align-items: center; gap: 6px; margin-bottom: 8px; }
|
||||
@@ -1213,22 +1235,50 @@ label.icon-btn { cursor: pointer; }
|
||||
.modal .mpe-mcard { border: 1px solid var(--border); border-radius: 10px; padding: 9px 10px; margin-bottom: 8px; background: #fafbfd; }
|
||||
.modal .mpe-mcard .mpe-row { margin-bottom: 0; }
|
||||
.modal .mpe-cks { display: flex; align-items: center; gap: 16px; margin-top: 8px; }
|
||||
/* 超时(ms)与「启用」同排。数字框单独成类,不吃 .mpe-ck input 那套 15px 无边框样式(那是给 checkbox 的);
|
||||
选择器带 .modal 前缀是为了压过 .modal input{width:100%},否则会被撑满整行。 */
|
||||
.modal .mpe-num { display: flex; align-items: center; gap: 5px; flex: none; font-size: 12.5px; color: var(--gray); }
|
||||
.modal .mpe-num input { width: 92px; padding: 5px 8px; margin: 0; font-size: 13px; border: 1px solid #dde1ea; border-radius: 8px; background: #fff; color: var(--ink); }
|
||||
.modal .mpe-num input:focus { border-color: var(--active); }
|
||||
/* MCP 的 mode 三态下拉:独立成行(弹窗内容宽仅 ~320px,与超时框同排会撑破),内层 select 用 .modal select 的全宽样式 */
|
||||
.modal .mpe-field { display: block; margin-top: 14px; font-size: 12.5px; color: var(--gray); }
|
||||
/* 单行设置项:左标签 / 右控件(与上面 header 那排同一种「一左一右」的节奏)
|
||||
选择器带 .modal 前缀是为了压过 .modal input{width:100%},否则输入框会撑满整行。 */
|
||||
.modal .mpe-line { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 10px; font-size: 12.5px; color: var(--gray); }
|
||||
.modal .mpe-line:last-child { margin-bottom: 0; }
|
||||
.modal .mpe-line > span { flex: none; white-space: nowrap; }
|
||||
.modal .mpe-line input { flex: 1; min-width: 0; margin: 0; }
|
||||
.modal .mpe-line select { width: auto; min-width: 180px; margin: 0; }
|
||||
/* 预设字段:一行(可选带说明)作为一个整体留间距 */
|
||||
.modal .mpe-item { margin-bottom: 10px; }
|
||||
.modal .mpe-item:last-child { margin-bottom: 0; }
|
||||
.modal .mpe-item .mpe-line { margin-bottom: 0; }
|
||||
.modal .mpe-item .cfg-note { margin-top: 4px; text-align: right; }
|
||||
/* ms 作为输入框内的后缀:定位在框内右侧,pointer-events:none 保证点击穿给输入框 */
|
||||
.modal .mpe-unit { position: relative; flex: none; width: 118px; }
|
||||
.modal .mpe-unit input { width: 100%; margin: 0; padding: 8px 30px 8px 10px; }
|
||||
.modal .mpe-unit i { position: absolute; right: 10px; top: 50%; transform: translateY(-50%); font-style: normal; font-size: 11.5px; color: var(--gray-light); pointer-events: none; }
|
||||
/* 预设模式下 name/url 是契约值(只读),压暗以区别于可编辑输入框 */
|
||||
.modal input[readonly] { background: #f1f3f7; color: var(--gray); }
|
||||
.modal .mpe-ck { display: flex; align-items: center; gap: 5px; font-size: 12.5px; color: var(--gray); }
|
||||
.modal .mpe-ck input { width: 15px; height: 15px; padding: 0; margin: 0; border: none; background: none; accent-color: var(--active); cursor: pointer; }
|
||||
.modal .mpe-del { flex: none; border: none; background: none; margin: 0; padding: 2px 7px; cursor: pointer; color: var(--gray-light); font-size: 18px; line-height: 1.2; }
|
||||
.modal .mpe-del:active { color: #c0392b; }
|
||||
/* 平台预设:新增平台时点一下填好 url/类型,模型卡带上该平台的参数缺省 */
|
||||
.modal .mpe-chips { display: flex; flex-wrap: wrap; gap: 6px; margin: 0 0 10px; }
|
||||
.modal .mpe-chip { flex: none; width: auto; padding: 5px 12px; border: 1px solid #dde1ea; border-radius: 999px; background: #fff; color: var(--gray); font-size: 12.5px; line-height: 1.4; }
|
||||
.modal .mpe-chip:active { background: var(--surface); }
|
||||
.modal .mpe-chip.on { border-color: var(--active); color: var(--active); background: var(--active-light); }
|
||||
/* 模型卡「高级」折叠区:沿用左标签/右控件;JSON 用等宽小字,高度可拖 */
|
||||
.modal .mpe-adv-btn { margin-left: auto; flex: none; padding: 0; font-size: 12px; color: var(--gray); }
|
||||
.modal .mpe-adv { margin-top: 8px; padding-top: 8px; border-top: 1px dashed var(--border); }
|
||||
.modal .mpe-adv .mpe-line { margin-bottom: 8px; }
|
||||
.modal .mpe-adv .mpe-line:last-child { margin-bottom: 0; }
|
||||
.modal .mpe-line textarea {
|
||||
flex: 1; min-width: 0; margin: 0; height: 46px; padding: 6px 9px;
|
||||
border: 1px solid #dde1ea; border-radius: 10px; background: #fff; color: var(--ink);
|
||||
font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-size: 12px; line-height: 1.45;
|
||||
resize: vertical;
|
||||
}
|
||||
.modal .mpe-line textarea:focus { border-color: var(--active); }
|
||||
|
||||
/* ---------- 编辑器页(config.yml 原文 / 技能文件) ---------- */
|
||||
.set-editor {
|
||||
flex: 1; min-height: 0; display: flex; flex-direction: column;
|
||||
padding: 10px 12px calc(12px + env(safe-area-inset-bottom, 0px));
|
||||
padding: 10px 12px calc(12px + var(--sab));
|
||||
}
|
||||
.set-editor textarea {
|
||||
flex: 1; width: 100%; resize: none; background: #fff; color: var(--ink);
|
||||
@@ -1254,13 +1304,18 @@ label.icon-btn { cursor: pointer; }
|
||||
.btn-row { display: flex; gap: 10px; }
|
||||
.btn-row .primary-btn { flex: 1; }
|
||||
.modal-overlay {
|
||||
position: fixed; inset: 0; background: rgba(20, 25, 50, 0.45);
|
||||
/* bottom 让出键盘:弹窗内的输入框(定时任务提示词等)不被软键盘压住 */
|
||||
position: fixed; inset: 0; bottom: var(--kb); background: rgba(20, 25, 50, 0.45);
|
||||
display: flex; align-items: center; justify-content: center; z-index: 100;
|
||||
}
|
||||
.modal {
|
||||
background: var(--page); border-radius: 14px; padding: 20px; width: 84%; max-width: 360px;
|
||||
position: relative; max-height: 88%; overflow-y: auto;
|
||||
}
|
||||
/* 移动端:表单是「左标签 + 右输入」双列,84% 宽度下输入框太窄 */
|
||||
@media (max-width: 639px) {
|
||||
#mcp-edit-modal .modal, #model-edit-modal .modal { width: calc(100% - 24px); padding: 18px 14px; }
|
||||
}
|
||||
.modal h3 { margin-bottom: 12px; font-size: 16px; }
|
||||
.modal input {
|
||||
width: 100%; border: 1px solid #dde1ea; border-radius: 10px;
|
||||
@@ -1579,6 +1634,27 @@ body.pv-resizing #pv-pane iframe { pointer-events: none; }
|
||||
}
|
||||
@keyframes drop-overlay-in { from { opacity: 0; } to { opacity: 1; } }
|
||||
|
||||
/* ================= 待发送条幅(运行中排队 / 干预 / 立即发送) ================= */
|
||||
/* 输入卡上方一行小条:正文单行省略 + 动作按钮。多条时逐条堆叠,每条仍是一行。
|
||||
配色刻意与「编辑提示条」的蓝色区分:排队是“稍后执行”的提示态,不是输入态。 */
|
||||
.send-queue { display: flex; flex-direction: column; gap: 6px; margin-bottom: 8px; }
|
||||
.sq-item {
|
||||
display: flex; align-items: center; gap: 6px;
|
||||
padding: 5px 5px 5px 11px;
|
||||
border-radius: 12px; background: #fff4dc; color: #a06a00; font-size: 12.5px;
|
||||
}
|
||||
.sq-item .sq-text { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
|
||||
.sq-item .sq-tag { flex: none; font-size: 11.5px; opacity: .75; }
|
||||
.sq-item button {
|
||||
flex: none; padding: 2px 9px; border-radius: 8px;
|
||||
font-size: 12.5px; font-weight: 600; color: inherit; background: none; border: none;
|
||||
}
|
||||
.sq-item button:active { background: rgba(160, 106, 0, 0.12); }
|
||||
.sq-item button:disabled { opacity: .45; }
|
||||
.sq-item .sq-x { padding: 2px 7px; font-weight: 500; }
|
||||
/* 已升级为「干预/立即发送」但还没到边界:按钮置灰,显示“等待当前步骤” */
|
||||
.sq-item.sq-busy button:not(.sq-x) { opacity: .45; }
|
||||
|
||||
/* ================= 编辑已发送消息提示条 ================= */
|
||||
/* 覆盖式重发:输入框内部的浅蓝提示条(嵌在 .input-shell 顶端,间距由 shell 的 gap 提供)。 */
|
||||
.edit-bar {
|
||||
|
||||
@@ -2,7 +2,10 @@
|
||||
<html lang="zh">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
|
||||
<!-- viewport-fit=cover:让 env(safe-area-inset-*) 生效(缺了它 iOS 上恒为 0);
|
||||
interactive-widget=resizes-content:键盘弹起时缩 layout viewport(新 Chromium 认;
|
||||
不认的浏览器会忽略,由 js/viewport.js 的 --kb 兜底)。 -->
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover, interactive-widget=resizes-content">
|
||||
<title>Agent 任务台</title>
|
||||
<script src="/vendor/marked.min.js"></script>
|
||||
<meta name="theme-color" content="#3964FE">
|
||||
@@ -157,10 +160,13 @@
|
||||
<!-- ================= 底部输入区 ================= -->
|
||||
<footer>
|
||||
<div class="attach-chips hidden" id="attach-chips"></div>
|
||||
<!-- 待发送条幅:运行中发出的消息先排在这里(不立即入库),逐条一行。
|
||||
默认等本轮结束自动发出;队首可「干预」(跑完当前这步就插话)或「立即发送」(中断本轮)。 -->
|
||||
<div class="send-queue hidden" id="send-queue" aria-live="polite"></div>
|
||||
<div class="input-shell">
|
||||
<!-- 编辑已发送消息:覆盖式重发提示条(发送后丢弃该条及其后的历史) -->
|
||||
<div class="edit-bar hidden" id="edit-bar">
|
||||
<span>正在编辑已发送的消息,发送后将丢弃其后的历史</span>
|
||||
<span>编辑已发送消息:发送后将丢弃原历史信息</span>
|
||||
<button id="edit-cancel" type="button">取消</button>
|
||||
</div>
|
||||
<div class="up-cards hidden" id="up-cards" aria-label="已上传文件"></div>
|
||||
@@ -296,6 +302,8 @@
|
||||
<svg viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
|
||||
</button>
|
||||
<h3 id="mpe-title">编辑平台</h3>
|
||||
<!-- 平台预设:仅新增平台时展示,点选即填好 url/类型并给模型卡带上该平台的参数缺省 -->
|
||||
<div class="mpe-chips hidden" id="mpe-presets"></div>
|
||||
<input type="text" id="mpe-name" placeholder="平台名(留空取 url 主机名首段)">
|
||||
<input type="text" id="mpe-url" placeholder="平台上游地址(OpenAI 兼容 /v1)">
|
||||
<div class="mpe-sec">
|
||||
@@ -310,7 +318,6 @@
|
||||
<button class="ghost-btn danger hidden" id="mpe-del-btn" onclick="sUI.mDelPlat()">删除平台</button>
|
||||
<button class="primary-btn" onclick="sUI.mSave()">保存</button>
|
||||
</div>
|
||||
<div class="cfg-note">仅写入配置,点击「重启服务」后生效。</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -343,27 +350,33 @@
|
||||
<svg viewBox="0 0 24 24"><line x1="18" y1="6" x2="6" y2="18"></line><line x1="6" y1="6" x2="18" y2="18"></line></svg>
|
||||
</button>
|
||||
<h3 id="mce-title">编辑 MCP 服务</h3>
|
||||
<input type="text" id="mce-name" placeholder="服务名(留空取 url 主机名首段)">
|
||||
<input type="text" id="mce-url" placeholder="MCP 服务 JSON-RPC 端点(完整 URL)">
|
||||
<div class="mpe-sec">
|
||||
<input type="text" id="mce-name" placeholder="服务名">
|
||||
<input type="text" id="mce-url" placeholder="MCP 服务 JSON-RPC URL">
|
||||
<!-- 内置服务预设字段(url/name 只读,表单由预设生成) -->
|
||||
<div class="mpe-sec hidden" id="mce-preset-sec">
|
||||
<div class="mpe-sec-head"><span>配置参数</span><span class="cfg-note" id="mce-preset-desc"></span></div>
|
||||
<div id="mce-preset-fields"></div>
|
||||
</div>
|
||||
<div class="mpe-sec" id="mce-headers-sec">
|
||||
<div class="mpe-sec-head"><span>请求头(headers)</span><button class="ghost-btn sm" onclick="mcpUI.addHeader()">添加 header</button></div>
|
||||
<div id="mce-headers"></div>
|
||||
</div>
|
||||
<div class="mpe-cks" style="margin-top:14px">
|
||||
<label class="mpe-num">单次调用超时<input type="number" id="mce-timeout" min="1000" max="600000" step="1000" placeholder="默认 60000">ms</label>
|
||||
<div class="mpe-sec">
|
||||
<label class="mpe-line"><span>单次调用超时</span>
|
||||
<span class="mpe-unit"><input type="number" id="mce-timeout" min="1000" max="600000" step="1000" placeholder="60000"><i>ms</i></span>
|
||||
</label>
|
||||
<label class="mpe-line"><span>工具暴露</span>
|
||||
<select id="mce-mode">
|
||||
<option value="advertise">advertise(下发给模型)</option>
|
||||
<option value="skill">skill(以技能形式暴露)</option>
|
||||
<option value="disable">disable(不加载)</option>
|
||||
</select>
|
||||
</label>
|
||||
</div>
|
||||
<label class="mpe-field">工具暴露
|
||||
<select id="mce-mode">
|
||||
<option value="advertise">advertise(下发给模型)</option>
|
||||
<option value="skill">skill(以技能形式暴露)</option>
|
||||
<option value="disable">disable(不加载)</option>
|
||||
</select>
|
||||
</label>
|
||||
<div class="btn-row mpe-foot">
|
||||
<button class="ghost-btn danger hidden" id="mce-del-btn" onclick="mcpUI.del()">删除服务</button>
|
||||
<button class="primary-btn" onclick="mcpUI.save()">保存</button>
|
||||
</div>
|
||||
<div class="cfg-note">仅写入配置,点击「重启服务」后生效。</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -515,6 +528,7 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<script src="/js/viewport.js"></script>
|
||||
<script src="/js/core.js"></script>
|
||||
<script src="/js/chat.js"></script>
|
||||
<script src="/js/sessions.js"></script>
|
||||
@@ -527,12 +541,12 @@
|
||||
// 启动自愈:外部工具改前端文件是非原子写入,极端时机下浏览器可能拿到半截或重复拼接的 HTML
|
||||
// (脚本缺半 → 白屏裸首页;重复注入 → 每个文件报 duplicate variable 后 JS 全挂)。
|
||||
// 这里检测关键脚本数量与入口全局,不对就自动整页重载一次(sessionStorage 防循环)。
|
||||
// 注意:js/ 脚本增减时需同步改这里的期望数 7。
|
||||
// 注意:js/ 脚本增减时需同步改这里的期望数 9。
|
||||
(function () {
|
||||
var ok = false;
|
||||
try {
|
||||
var n = document.querySelectorAll('script[src^="/js/"]').length;
|
||||
ok = n === 7 && typeof state !== 'undefined' &&
|
||||
ok = n === 9 && typeof state !== 'undefined' &&
|
||||
typeof openFilePreview === 'function' && typeof restartNow === 'function';
|
||||
} catch (_) {}
|
||||
if (ok) { try { sessionStorage.removeItem('boot-heal'); } catch (_) {} return; }
|
||||
|
||||
@@ -412,6 +412,8 @@
|
||||
state.status = (s && s.status) || '';
|
||||
state.modelId = (s && s.model_id) || ''; // 顶部动作区展示当前模型
|
||||
state.schedule = detail.schedule || null; // 定时任务数据(顶部动作区副标题)
|
||||
state.pending = Array.isArray(detail.pending) ? detail.pending : []; // 待投递队列(服务端内存态回显)
|
||||
renderSendQueue();
|
||||
renderHeader();
|
||||
updateHeaderActions();
|
||||
|
||||
|
||||
@@ -170,6 +170,7 @@
|
||||
schedule: null, // 当前会话定时任务(详情 schedule 字段,null=无)
|
||||
sessions: [], // 抽屉列表缓存
|
||||
attachments: [], // 待发送附件 {file, name, size}
|
||||
pending: [], // 待投递消息队列(服务端内存态的回显):{id, content, mode, created_at}
|
||||
editingMsgId: 0, // 正在编辑的历史消息 id(0=普通发送,覆盖式重发)
|
||||
lastImgBlobUrl: null, // 任务文件图片预览的 blob URL,下次预览或开新图时回收
|
||||
lastPdfBlobUrl: null, // 同上:PDF 页内预览的 blob URL(浏览器内建查看器用)
|
||||
|
||||
@@ -79,6 +79,8 @@
|
||||
state.sessionTitle = '';
|
||||
state.sessionType = 'secretary';
|
||||
state.pendingModel = '';
|
||||
state.pending = [];
|
||||
renderSendQueue();
|
||||
state.streamEl = null;
|
||||
state.streamText = '';
|
||||
state.toolCards = {};
|
||||
@@ -190,6 +192,8 @@
|
||||
state.status = '';
|
||||
state.modelId = '';
|
||||
state.schedule = null; // 防详情返回前残留上一会话的任务状态
|
||||
state.pending = []; // 同上:队列是会话级的,先清空,详情回来再回显
|
||||
renderSendQueue();
|
||||
// 先从抽屉列表缓存取会话类型,让顶部 icon 立即正确;详情回来后由 renderDetail 纠正
|
||||
const cached = (state.sessions || []).find(x => x.id === id);
|
||||
state.sessionType = (cached && cached.assistant_type) || 'secretary';
|
||||
@@ -249,6 +253,8 @@
|
||||
state.status = '';
|
||||
state.modelId = '';
|
||||
state.schedule = null;
|
||||
state.pending = [];
|
||||
renderSendQueue();
|
||||
state.pendingModel = '';
|
||||
state.attachments = [];
|
||||
if (typeof clearEditState === 'function') clearEditState();
|
||||
@@ -548,13 +554,15 @@
|
||||
async function stopSession() {
|
||||
if (!state.sessionId) return;
|
||||
const held = state.status === 'held';
|
||||
const queued = (state.pending || []).length;
|
||||
try {
|
||||
if (held) {
|
||||
await req('POST', '/api/sessions/' + state.sessionId + '/release');
|
||||
toast('已断开');
|
||||
} else {
|
||||
await req('POST', '/api/sessions/' + state.sessionId + '/stop');
|
||||
toast('已发送终止指令');
|
||||
// 「停止」是全停:服务端会把待投递队列一并作废,这里明确告知,不让消息静静消失
|
||||
toast(queued ? '已终止,队列中 ' + queued + ' 条消息已取消' : '已发送终止指令');
|
||||
}
|
||||
} catch (e) { toast((held ? '断开失败:' : '终止失败:') + e.message); }
|
||||
}
|
||||
|
||||
@@ -27,8 +27,11 @@
|
||||
pendingEnable: {}, // 已写盘但重启前 effective 仍是旧值的 enable 覆盖(id → bool),防卡片回弹
|
||||
deletedModels: {}, // 已从 config.yml 删除、重启前后端仍会返回的模型(id → true):前端隐藏防回弹
|
||||
expandedGroups: {}, balanceByGroup: {}, balanceRequested: {}, balanceTypes: [], // 平台编辑弹窗工作态见 pfEdit(模块级变量)
|
||||
modelProfileNames: [], // profile 下拉选项(顶层 model_profiles 的 key)
|
||||
// MCP 服务页:cfgMcp 缓存当前列表;改动待重启生效时置位,顶部常驻重启横幅
|
||||
cfgMcp: [], mcpPendingRestart: false,
|
||||
mcpStatus: null, // 运行态连接状态:key = name|url|mode(见 mcpStatusKey);null = 没拿到,不显示标记
|
||||
presets: null, // 平台/MCP 预设(GET /api/config/presets),设置页各页共用
|
||||
};
|
||||
let setTok = 0; // 异步渲染防竞态令牌
|
||||
|
||||
@@ -1186,13 +1189,15 @@
|
||||
const el = $('model-cards');
|
||||
if (!el || (ctx && !ctx())) return;
|
||||
try {
|
||||
const [rt, cg] = await Promise.all([req('GET', '/api/models'), req('GET', '/api/config')]);
|
||||
const [rt, cg] = await Promise.all([req('GET', '/api/models'), req('GET', '/api/config'), loadPresets()]);
|
||||
if (ctx && !ctx()) return;
|
||||
if (!$('model-cards')) return; // 异步期间已离开本页
|
||||
SET.runtimeById = {};
|
||||
for (const m of rt || []) SET.runtimeById[m.id] = m;
|
||||
SET.cfgPlatforms = (cg.effective && cg.effective.platforms) || [];
|
||||
SET.cfgModels = (cg.effective && cg.effective.models) || [];
|
||||
// 平台编辑器里的 profile 下拉只有名字有意义,不缓存整份 prompt
|
||||
SET.modelProfileNames = Object.keys((cg.effective && cg.effective.model_profiles) || {});
|
||||
// 已删除/已改名旧 id 的标记清理:配置(live)与运行池都已无此 id 才清——重启前池里残留时须保留标记,
|
||||
// 否则会话页选择弹窗(读 /api/models 运行池)会重新列出已不可用的模型。
|
||||
const liveIds = new Set(SET.cfgModels.map(m => m.id));
|
||||
@@ -1248,23 +1253,105 @@
|
||||
for (const m of SET.cfgModels) if (m.platform_index === pi && !seen.has(m.id)) { seen.add(m.id); models.push(m); }
|
||||
return models;
|
||||
}
|
||||
// 参数对象 → 弹窗里的 JSON 文本。空对象留空(placeholder 提示),避免每张卡都挂一对 {}
|
||||
function pfJsonText(o) {
|
||||
return o && typeof o === 'object' && Object.keys(o).length ? JSON.stringify(o) : '';
|
||||
}
|
||||
// 预设的模型参数缺省:抽成函数因为「选预设」和「加模型行」两处都要套
|
||||
function applyModelDefaults(r, preset) {
|
||||
const d = (preset && preset.model_defaults) || {};
|
||||
r.extra_params = pfJsonText(d.extra_params);
|
||||
r.thinking_params = pfJsonText(d.thinking_params);
|
||||
r.reasoning_ack_field = d.reasoning_ack_field || '';
|
||||
r.profile = d.profile || '';
|
||||
}
|
||||
// 该行的高级参数是否还是「空/上一个预设的缺省」:是才允许被新预设覆盖,不动用户手填的内容
|
||||
function pfUsesDefaults(r, preset) {
|
||||
const d = (preset && preset.model_defaults) || {};
|
||||
return String(r.extra_params || '') === pfJsonText(d.extra_params) &&
|
||||
String(r.thinking_params || '') === pfJsonText(d.thinking_params) &&
|
||||
String(r.reasoning_ack_field || '') === String(d.reasoning_ack_field || '') &&
|
||||
String(r.profile || '') === String(d.profile || '');
|
||||
}
|
||||
function pfNewModel() {
|
||||
const r = { ref: null, id: '', vision: true, enable: true, display_name: '', profile: '',
|
||||
extra_params: '', thinking_params: '', reasoning_ack_field: '', adv: false };
|
||||
if (pfEdit) applyModelDefaults(r, pfEdit.preset);
|
||||
return r;
|
||||
}
|
||||
function openModelEditor(pi) {
|
||||
const add = pi == null;
|
||||
const p = add ? {} : (SET.cfgPlatforms[pi] || {});
|
||||
pfEdit = {
|
||||
idx: add ? -1 : Number(pi),
|
||||
// 已有 Key:输入框置空(留空=保持原值),masked 存脱敏值仅做 placeholder 提示;绝不把脱敏值回写文件
|
||||
preset: null,
|
||||
// 已有 Key:输入框置空(留空=保持原值),masked 存脱敏仅做 placeholder 提示;绝不把脱敏值回写文件
|
||||
keys: add ? [] : (p.keys || []).map((k, ki) => ({ ref: ki, api_key: '', masked: k.api_key || '' })),
|
||||
models: add ? [] : platformModels(pi).map(m => ({ ref: m.model_index, id: m.mid || m.id, vision: !!m.vision, enable: m.enable !== false })),
|
||||
models: add ? [] : platformModels(pi).map(m => ({
|
||||
ref: m.model_index,
|
||||
id: m.mid || m.id,
|
||||
vision: !!m.vision,
|
||||
enable: m.enable !== false,
|
||||
// 显示名缺省就是 id(config.js 归一化过):相同时留空,弹窗里不重复展示
|
||||
display_name: m.display_name && m.display_name !== (m.mid || m.id) ? m.display_name : '',
|
||||
profile: m.profile || '',
|
||||
extra_params: pfJsonText(m.extra_params),
|
||||
thinking_params: pfJsonText(m.thinking_params),
|
||||
reasoning_ack_field: m.reasoning_ack_field || '',
|
||||
adv: false,
|
||||
})),
|
||||
};
|
||||
$('mpe-title').textContent = add ? '新增平台' : '编辑平台';
|
||||
$('mpe-name').value = add ? '' : (p.name || '');
|
||||
$('mpe-url').value = add ? '' : (p.url || '');
|
||||
if (add) { pfEdit.keys.push({ ref: null, api_key: '' }); pfEdit.models.push({ ref: null, id: '', vision: true, enable: true }); }
|
||||
if (add) { pfEdit.keys.push({ ref: null, api_key: '' }); pfEdit.models.push(pfNewModel()); }
|
||||
$('mpe-del-btn').classList.toggle('hidden', add);
|
||||
renderPfPresets();
|
||||
renderPfRows();
|
||||
$('model-edit-modal').classList.remove('hidden');
|
||||
}
|
||||
// 新增平台时的平台预设:点一下填好 url / 平台名,模型行带上该平台的参数缺省
|
||||
function renderPfPresets() {
|
||||
const box = $('mpe-presets');
|
||||
if (!box) return;
|
||||
const list = (SET.presets && SET.presets.platforms) || [];
|
||||
const show = !!pfEdit && pfEdit.idx < 0 && list.length > 0;
|
||||
box.classList.toggle('hidden', !show);
|
||||
if (!show) { box.innerHTML = ''; return; }
|
||||
const cur = pfEdit.preset ? pfEdit.preset.key : '';
|
||||
box.innerHTML = list.map(p =>
|
||||
'<button type="button" class="mpe-chip' + (cur === p.key ? ' on' : '') + '" onclick="sUI.mPreset(\'' + att(p.key) + '\')">' + esc(p.label || p.key) + '</button>'
|
||||
).join('') +
|
||||
'<button type="button" class="mpe-chip' + (cur ? '' : ' on') + '" onclick="sUI.mPreset(\'\')">自定义</button>';
|
||||
}
|
||||
function applyPfPreset(key) {
|
||||
if (!pfEdit || pfEdit.idx >= 0) return;
|
||||
// 已经是自定义:不重复清空用户正在手填的内容
|
||||
if (!key && !pfEdit.preset) return;
|
||||
const list = (SET.presets && SET.presets.platforms) || [];
|
||||
const preset = key ? (list.find(x => x.key === key) || null) : null;
|
||||
const prev = pfEdit.preset;
|
||||
pfEdit.preset = preset;
|
||||
if (preset) {
|
||||
$('mpe-url').value = preset.url || '';
|
||||
// 名称只在不覆盖手输时跟随预设(空 / 还等于上一个预设名)
|
||||
const nm = $('mpe-name').value.trim();
|
||||
if (!nm || nm === (prev ? prev.key : '')) $('mpe-name').value = preset.key || '';
|
||||
} else {
|
||||
// 自定义 = 从空白开始:清空平台字段与 Key/模型行(含刚套上的预设参数)
|
||||
$('mpe-name').value = '';
|
||||
$('mpe-url').value = '';
|
||||
pfEdit.keys = [{ ref: null, api_key: '' }];
|
||||
pfEdit.models = [pfNewModel()];
|
||||
}
|
||||
// 只改「新增行」且高级参数还是空/上一个预设缺省的行;已有模型与手填内容一律不动
|
||||
for (const r of pfEdit.models) {
|
||||
if (r.ref != null) continue;
|
||||
if (pfUsesDefaults(r, prev)) applyModelDefaults(r, preset);
|
||||
}
|
||||
renderPfPresets();
|
||||
renderPfRows();
|
||||
}
|
||||
// Key 行:全部可编辑。已有 Key 输入框置空 + placeholder 提示当前脱敏值,输入新值=替换,留空=保持。
|
||||
function pfKeysRowHtml(r, i) {
|
||||
const ph = r.ref == null
|
||||
@@ -1275,18 +1362,33 @@
|
||||
'<button class="mpe-del" title="删除此 Key" onclick="sUI.mDelKey(' + i + ')">×</button>' +
|
||||
'</div>';
|
||||
}
|
||||
// 模型子卡片两行:上行配 id,下行勾 vision/enable。id 可改(仅改 config.yml,重启生效)。
|
||||
// display_name/concurrency/type 不进弹窗:保存只按细粒度 path 改,不碰文件里其余字段。
|
||||
// 模型子卡片:上行配 id,中行勾 vision/enable + 「高级」,高级区放不常改的字段。
|
||||
// 全部走细粒度 path 保存,不整体覆盖模型对象(保住文件里的手写字段)。
|
||||
function pfModelsRowHtml(r, i) {
|
||||
const ph = (pfEdit && pfEdit.preset && pfEdit.preset.model_hint) || 'id(上游模型名)';
|
||||
const profiles = (SET.modelProfileNames || []).slice();
|
||||
// 配置里引用了但不在下拉里的 profile(手工改过 YAML):补一项,避免保存时被静默改回默认
|
||||
if (r.profile && profiles.indexOf(r.profile) < 0) profiles.push(r.profile);
|
||||
const adv = r.adv ? '<div class="mpe-adv">' +
|
||||
'<label class="mpe-line"><span>显示名</span><input type="text" placeholder="默认同 id" value="' + att(r.display_name) + '" oninput="sUI.mModField(' + i + ',\'display_name\',this.value)"></label>' +
|
||||
'<label class="mpe-line"><span>Profile</span><select onchange="sUI.mModField(' + i + ',\'profile\',this.value)">' +
|
||||
'<option value="">默认</option>' +
|
||||
profiles.map(n => '<option value="' + att(n) + '"' + (n === r.profile ? ' selected' : '') + '>' + esc(n) + '</option>').join('') +
|
||||
'</select></label>' +
|
||||
'<label class="mpe-line"><span>请求参数</span><textarea rows="2" spellcheck="false" placeholder=\'{"key":"value"}\' oninput="sUI.mModField(' + i + ',\'extra_params\',this.value)">' + esc(r.extra_params) + '</textarea></label>' +
|
||||
'<label class="mpe-line"><span>思考参数</span><textarea rows="2" spellcheck="false" placeholder=\'{"reasoning_effort":"max"}\' oninput="sUI.mModField(' + i + ',\'thinking_params\',this.value)">' + esc(r.thinking_params) + '</textarea></label>' +
|
||||
'<label class="mpe-line"><span>思考链回传</span><input type="text" placeholder="回传字段名" value="' + att(r.reasoning_ack_field) + '" oninput="sUI.mModField(' + i + ',\'reasoning_ack_field\',this.value)"></label>' +
|
||||
'</div>' : '';
|
||||
return '<div class="mpe-mcard">' +
|
||||
'<div class="mpe-row">' +
|
||||
'<input class="mpe-grow" type="text" placeholder="id(上游模型名)" value="' + esc(r.id) + '" oninput="sUI.mModId(' + i + ',this.value)">' +
|
||||
'<input class="mpe-grow" type="text" placeholder="' + att(ph) + '" value="' + att(r.id) + '" oninput="sUI.mModId(' + i + ',this.value)">' +
|
||||
'<button class="mpe-del" title="删除此模型" onclick="sUI.mDelModel(' + i + ')">×</button>' +
|
||||
'</div>' +
|
||||
'<div class="mpe-cks">' +
|
||||
'<label class="mpe-ck"><input type="checkbox"' + (r.vision ? ' checked' : '') + ' onchange="sUI.mModVision(' + i + ',this.checked)">图片输入</label>' +
|
||||
'<label class="mpe-ck"><input type="checkbox"' + (r.enable !== false ? ' checked' : '') + ' onchange="sUI.mModEnable(' + i + ',this.checked)">启用</label>' +
|
||||
'</div>' +
|
||||
'<button type="button" class="mpe-adv-btn" onclick="sUI.mAdvToggle(' + i + ')">' + (r.adv ? '收起' : '高级') + '</button>' +
|
||||
'</div>' + adv +
|
||||
'</div>';
|
||||
}
|
||||
// 行下标变化后需重渲染(事件处理器里捕获了旧 i),故增删后重建两段行列表。
|
||||
@@ -1296,7 +1398,7 @@
|
||||
$('mpe-models').innerHTML = pfEdit.models.map(pfModelsRowHtml).join('') || '<div class="model-group-empty">至少保留一个模型</div>';
|
||||
}
|
||||
function addPfKey() { if (!pfEdit) return; pfEdit.keys.push({ ref: null, api_key: '' }); renderPfRows(); }
|
||||
function addPfModel() { if (!pfEdit) return; pfEdit.models.push({ ref: null, id: '', vision: true, enable: true }); renderPfRows(); }
|
||||
function addPfModel() { if (!pfEdit) return; pfEdit.models.push(pfNewModel()); renderPfRows(); }
|
||||
function delPfKey(i) {
|
||||
if (!pfEdit) return;
|
||||
if (pfEdit.keys.length <= 1) return toast('至少保留一个 Key');
|
||||
@@ -1310,6 +1412,37 @@
|
||||
function setPfKey(i, f, v) { if (pfEdit && pfEdit.keys[i]) pfEdit.keys[i][f] = v; }
|
||||
function setPfModel(i, f, v) { if (pfEdit && pfEdit.models[i]) pfEdit.models[i][f] = v; }
|
||||
function closeModelEditor() { $('model-edit-modal').classList.add('hidden'); }
|
||||
// JSON 参数:留空 = {}(不写进文件);非空必须是 JSON 对象(数组/标量对上游没意义)
|
||||
function pfParams(r, key, label) {
|
||||
const txt = String(r[key] || '').trim();
|
||||
if (!txt) return {};
|
||||
let v;
|
||||
try { v = JSON.parse(txt); } catch (_) {
|
||||
throw new Error('模型「' + (String(r.id || '').trim() || '未命名') + '」的' + label + '不是合法 JSON');
|
||||
}
|
||||
if (!v || typeof v !== 'object' || Array.isArray(v)) {
|
||||
throw new Error('模型「' + (String(r.id || '').trim() || '未命名') + '」的' + label + '要填 JSON 对象,如 {"key":"value"}');
|
||||
}
|
||||
return v;
|
||||
}
|
||||
// 新增行/新增平台时落盘的模型对象:只写非缺省项,其余交给 config.js 的默认值
|
||||
function pfModelValue(r) {
|
||||
const id = String(r.id || '').trim();
|
||||
const nv = { id };
|
||||
if (r.vision === false) nv.vision = false; // 缺省 true,只在取消勾选时显式落键
|
||||
if (r.enable === false) nv.enable = false;
|
||||
const dn = String(r.display_name || '').trim();
|
||||
if (dn && dn !== id) nv.display_name = dn;
|
||||
const prof = String(r.profile || '').trim();
|
||||
if (prof) nv.profile = prof;
|
||||
const ep = pfParams(r, 'extra_params', '请求参数');
|
||||
if (Object.keys(ep).length) nv.extra_params = ep;
|
||||
const tp = pfParams(r, 'thinking_params', '思考参数');
|
||||
if (Object.keys(tp).length) nv.thinking_params = tp;
|
||||
const ra = String(r.reasoning_ack_field || '').trim();
|
||||
if (ra) nv.reasoning_ack_field = ra;
|
||||
return nv;
|
||||
}
|
||||
// 根据工作态算批量编辑:原地改(值变更项) → 删行(降序) → 新增行(append)。
|
||||
// YAML 数组删项后下标收紧,同批内删/改/增按原 ref 定位,服务端依次应用。
|
||||
function buildPfEdits() {
|
||||
@@ -1333,25 +1466,59 @@
|
||||
if (!pfEdit.keys.some(r => r.ref === ki)) delKeys.push(ki);
|
||||
}
|
||||
delKeys.sort((a, b) => b - a).forEach(ki => edits.push({ op: 'delete', path: ['platforms', pfEdit.idx, 'keys', ki] }));
|
||||
// 模型:已有行只按细粒度 path 改 vision/enable(不整体覆盖,保住文件里的 display_name/extra_params 等);
|
||||
// 新增行 append 最小对象(缺省项不写:display_name 后端同 id,enable 缺省启用)
|
||||
// 模型:已有行全部按细粒度 path 改(不整体覆盖,保住文件里的手写字段与其他参数);
|
||||
// 新增行 append 最小对象(缺省项不写:display_name 同 id、enable 缺省启用、参数为空)
|
||||
pfEdit.models.forEach(r => {
|
||||
if (r.ref != null) {
|
||||
const om = (p.models || [])[r.ref] || {};
|
||||
const mp = ['platforms', pfEdit.idx, 'models', r.ref];
|
||||
const nid = String(r.id || '').trim();
|
||||
if (nid && om.id && nid !== om.id) {
|
||||
edits.push({ path: ['platforms', pfEdit.idx, 'models', r.ref, 'id'], value: nid });
|
||||
edits.push({ path: mp.concat('id'), value: nid });
|
||||
SET.deletedModels[p.name + '/' + om.id] = true; // 重启前运行池里旧 id 不再可绑,标记隐藏
|
||||
delete SET.deletedModels[p.name + '/' + nid]; // 改成曾被删的 id:清掉旧标记防误屏蔽
|
||||
}
|
||||
if (!!om.vision !== !!r.vision) edits.push({ path: ['platforms', pfEdit.idx, 'models', r.ref, 'vision'], value: !!r.vision });
|
||||
if ((om.enable !== false) !== (r.enable !== false)) edits.push({ path: ['platforms', pfEdit.idx, 'models', r.ref, 'enable'], value: r.enable !== false });
|
||||
if (!!om.vision !== !!r.vision) edits.push({ path: mp.concat('vision'), value: !!r.vision });
|
||||
if ((om.enable !== false) !== (r.enable !== false)) edits.push({ path: mp.concat('enable'), value: r.enable !== false });
|
||||
// 显示名缺省 = id:空值/等于 id 都按「不写」处理
|
||||
const curDn = String(om.display_name || '');
|
||||
const dn = String(r.display_name || '').trim();
|
||||
if (!dn || dn === (nid || om.id)) {
|
||||
if (curDn && curDn !== om.id) edits.push({ path: mp.concat('display_name'), op: 'delete' });
|
||||
} else if (dn !== curDn) {
|
||||
edits.push({ path: mp.concat('display_name'), value: dn });
|
||||
}
|
||||
const curProf = String(om.profile || '');
|
||||
const prof = String(r.profile || '').trim();
|
||||
if (!prof) {
|
||||
if (curProf) edits.push({ path: mp.concat('profile'), op: 'delete' });
|
||||
} else if (prof !== curProf) {
|
||||
edits.push({ path: mp.concat('profile'), value: prof });
|
||||
}
|
||||
// 参数类:值没变就不写(避免无意义重写丢掉节点注释);清空 = 删键,回落默认 {}
|
||||
const curEp = om.extra_params || {};
|
||||
const ep = pfParams(r, 'extra_params', '请求参数');
|
||||
if (JSON.stringify(ep) !== JSON.stringify(curEp)) {
|
||||
edits.push(Object.keys(ep).length
|
||||
? { path: mp.concat('extra_params'), value: ep }
|
||||
: { path: mp.concat('extra_params'), op: 'delete' });
|
||||
}
|
||||
const curTp = om.thinking_params || {};
|
||||
const tp = pfParams(r, 'thinking_params', '思考参数');
|
||||
if (JSON.stringify(tp) !== JSON.stringify(curTp)) {
|
||||
edits.push(Object.keys(tp).length
|
||||
? { path: mp.concat('thinking_params'), value: tp }
|
||||
: { path: mp.concat('thinking_params'), op: 'delete' });
|
||||
}
|
||||
const curRa = String(om.reasoning_ack_field || '');
|
||||
const ra = String(r.reasoning_ack_field || '').trim();
|
||||
if (!ra) {
|
||||
if (curRa) edits.push({ path: mp.concat('reasoning_ack_field'), op: 'delete' });
|
||||
} else if (ra !== curRa) {
|
||||
edits.push({ path: mp.concat('reasoning_ack_field'), value: ra });
|
||||
}
|
||||
} else {
|
||||
const id = String(r.id || '').trim();
|
||||
const nv = { id };
|
||||
if (r.vision === false) nv.vision = false; // 后端缺省已改 true:勾上靠缺省不落键,取消勾选必须显式写 false
|
||||
if (r.enable === false) nv.enable = false;
|
||||
edits.push({ op: 'append', path: ['platforms', pfEdit.idx, 'models'], value: nv });
|
||||
edits.push({ op: 'append', path: ['platforms', pfEdit.idx, 'models'], value: pfModelValue(r) });
|
||||
}
|
||||
});
|
||||
const delMods = (p.models || []).map((_, i) => i).filter(i => !pfEdit.models.some(r => r.ref === i)).sort((a, b) => b - a);
|
||||
@@ -1376,23 +1543,23 @@
|
||||
let edits;
|
||||
try {
|
||||
if (add) {
|
||||
// 新增平台:一次 append 整个对象(name 留空由服务端取主机段;type/concurrency/display_name 均不落配置,走各自缺省)
|
||||
edits = [{ op: 'append', path: ['platforms'], value: {
|
||||
// 新增平台:一次 append 整个对象
|
||||
const obj = {
|
||||
name, url,
|
||||
keys: pfEdit.keys.map(r => ({ api_key: String(r.api_key || '').trim() })),
|
||||
models: pfEdit.models.map(r => {
|
||||
const id = String(r.id).trim();
|
||||
const nv = { id };
|
||||
if (r.vision === false) nv.vision = false; // 同上:缺省 true,只在取消勾选时显式落键
|
||||
if (r.enable === false) nv.enable = false;
|
||||
return nv;
|
||||
}),
|
||||
} }];
|
||||
models: pfEdit.models.map(pfModelValue),
|
||||
};
|
||||
// 用预设时把余额查询类型固定下来(不展示给用户):名字与预设一致可不写(服务端缺省 = 平台名)
|
||||
const presetType = pfEdit.preset ? String(pfEdit.preset.type || pfEdit.preset.key || '') : '';
|
||||
if (presetType && presetType !== name) obj.type = presetType;
|
||||
edits = [{ op: 'append', path: ['platforms'], value: obj }];
|
||||
} else {
|
||||
// 改名不影响 pi(数组位置);其余按原 ref 定位,见 buildPfEdits
|
||||
edits = buildPfEdits();
|
||||
if (!edits.length) { closeModelEditor(); return toast('没有变更'); }
|
||||
}
|
||||
} catch (e) { return toast(e.message); } // JSON 校验失败等:提示后不发请求
|
||||
try {
|
||||
await req('PATCH', '/api/config', { edits });
|
||||
// 重加同名模型(重启前被标记隐藏的):清掉删除标记防误屏蔽
|
||||
const pname = name || (SET.cfgPlatforms[pfEdit.idx] || {}).name || '';
|
||||
@@ -1425,8 +1592,38 @@
|
||||
// mode 三态:advertise(默认,工具下发给模型) / skill(不下发,以技能形式暴露) / disable(不加载):
|
||||
// 默认值不写进文件——选 advertise 时删键,回落到 config.js 的缺省。
|
||||
// 运行配置(cg.effective.mcp_servers)即文件刚解析后的视图,按 pi 直接定位;重启后才会重新发现工具。
|
||||
let mcpEdit = null; // 工作态:{ idx, headers:[{key, value, masked}] };idx=-1 为新增
|
||||
// 预设取一次就缓存:取不到不报错,退化成纯自定义列表,不阻塞设置页
|
||||
let presetsReq = null;
|
||||
function loadPresets() {
|
||||
if (SET.presets) return Promise.resolve(SET.presets);
|
||||
if (!presetsReq) {
|
||||
presetsReq = req('GET', '/api/config/presets').then(p => {
|
||||
SET.presets = { platforms: (p && p.platforms) || [], mcp: (p && p.mcp) || [] };
|
||||
return SET.presets;
|
||||
}).catch(() => {
|
||||
presetsReq = null; // 失败不缓存,下次进页再试
|
||||
return { platforms: [], mcp: [] };
|
||||
});
|
||||
}
|
||||
return presetsReq;
|
||||
}
|
||||
function presetMcpList() { return (SET.presets && SET.presets.mcp) || []; }
|
||||
|
||||
let mcpEdit = null; // 工作态:{ idx, preset, values:{header:值}, headers:[{key, value, masked}] };idx=-1 为新增
|
||||
const MCP_HEADER_MASK = '*****'; // 与后端 routes/config.js 的掩码保持一致
|
||||
const MCP_MODE_LABELS = {
|
||||
advertise: 'advertise(下发给模型)',
|
||||
skill: 'skill(以技能形式暴露)',
|
||||
disable: 'disable(不加载)',
|
||||
};
|
||||
// url 归一化:内置服务按 url 认亲(name 允许用户改),尾斜杠不算差异
|
||||
function normUrl(u) { return String(u || '').trim().replace(/\/+$/, ''); }
|
||||
function presetIdx(p) {
|
||||
const url = normUrl(p.url);
|
||||
let i = SET.cfgMcp.findIndex(s => normUrl(s.url) === url);
|
||||
if (i < 0) i = SET.cfgMcp.findIndex(s => String(s.name || '') === p.key);
|
||||
return i;
|
||||
}
|
||||
async function setPageMcp(ctx) {
|
||||
setTitle('MCP 服务');
|
||||
setActions('<button class="icon-btn" title="添加 MCP 服务" onclick="mcpUI.add()">' +
|
||||
@@ -1434,41 +1631,98 @@
|
||||
setBody('<div class="set-scroll" id="mcp-list"><div class="empty-tip">加载中…</div></div>');
|
||||
await loadMcpList(ctx);
|
||||
}
|
||||
// 连接状态的认亲键:name + url + mode(与后端 mcp.statusKeyOf 一致,url 去尾斜杠)
|
||||
function mcpStatusKey(s) {
|
||||
return [s.name, normUrl(s.url), s.mode || 'advertise'].join('|');
|
||||
}
|
||||
// 运行态连接标记:没有运行态记录 = 配置比进程新(刚加、改了 url/mode),需重启才生效;
|
||||
// 整个状态接口没拿到(null)= 无从判断,宁可不显示也不要全部误报「待重启」。
|
||||
function mcpConnChip(s) {
|
||||
if (!SET.mcpStatus) return '';
|
||||
const st = SET.mcpStatus.get(mcpStatusKey(s));
|
||||
if (!st) return '<span class="model-card-state pending" title="配置已写入,重启后生效">待重启</span>';
|
||||
if (st.disabled) return '<span class="model-card-state off">已停用</span>';
|
||||
if (st.ok) {
|
||||
const extra = st.hidden ? ',其中 ' + st.hidden + ' 个以技能暴露' : '';
|
||||
return '<span class="model-card-state idle" title="发现 ' + (st.tools || 0) + ' 个工具' + extra + '">已连接</span>';
|
||||
}
|
||||
return '<span class="model-card-state busy" title="' + att(st.error || '连接失败') + '">未连接</span>';
|
||||
}
|
||||
async function loadMcpList(ctx) {
|
||||
const box = $('mcp-list');
|
||||
if (!box || (ctx && !ctx())) return;
|
||||
try {
|
||||
const cg = await req('GET', '/api/config');
|
||||
if (ctx && !ctx()) return;
|
||||
if (!$('mcp-list')) return;
|
||||
const [cg, , st] = await Promise.all([
|
||||
req('GET', '/api/config'),
|
||||
loadPresets(),
|
||||
// 状态接口失败不该挡住整个页面(老进程没有该路由 / 网络抖动):拿不到就不显示连接标记
|
||||
req('GET', '/api/config/mcp-status').catch(() => null),
|
||||
]);
|
||||
if ((ctx && !ctx()) || !$('mcp-list')) return;
|
||||
SET.cfgMcp = (cg.effective && cg.effective.mcp_servers) || [];
|
||||
if (!SET.cfgMcp.length) {
|
||||
box.innerHTML = (SET.mcpPendingRestart
|
||||
? '<div class="restart-bar"><span>配置已写入,重启后生效</span><button class="primary-btn" onclick="sUI.restartNow()">重启服务</button></div>'
|
||||
: '') + '<div class="empty-tip">尚未配置 MCP 服务,点右上角 + 添加。</div>';
|
||||
return;
|
||||
}
|
||||
const banner = SET.mcpPendingRestart
|
||||
const statusList = st && Array.isArray(st.servers) ? st.servers : null;
|
||||
SET.mcpStatus = statusList ? new Map(statusList.map(x => [mcpStatusKey(x), x])) : null;
|
||||
const presets = presetMcpList();
|
||||
// 内置服务已占用的条目不再列入「其它」,避免同一服务出两张卡
|
||||
const taken = new Set(presets.map(presetIdx).filter(i => i >= 0));
|
||||
const others = SET.cfgMcp.map((s, i) => ({ s, i })).filter(o => !taken.has(o.i));
|
||||
let html = SET.mcpPendingRestart
|
||||
? '<div class="restart-bar"><span>配置已写入,重启后生效</span><button class="primary-btn" onclick="sUI.restartNow()">重启服务</button></div>'
|
||||
: '';
|
||||
box.innerHTML = banner + SET.cfgMcp.map(mcpCardHtml).join('') +
|
||||
'<div class="empty-tip">点卡片编辑 MCP 服务。advertise 的工具启动时发现并追加到内置工具之后;skill 不下发,改为以技能形式暴露(skill 工具里 get 拿到原始 input_schema)。</div>';
|
||||
if (presets.length) {
|
||||
html += '<div class="mcp-sec-title">内置服务</div>' + presets.map(presetCardHtml).join('');
|
||||
}
|
||||
if (others.length) {
|
||||
html += '<div class="mcp-sec-title">其它服务</div>' + others.map(o => mcpCardHtml(o.s, o.i)).join('');
|
||||
}
|
||||
if (!presets.length && !others.length) {
|
||||
html += '<div class="empty-tip">尚未配置 MCP 服务,点右上角 + 添加。</div>';
|
||||
}
|
||||
$('mcp-list').innerHTML = html;
|
||||
} catch (e) {
|
||||
const b = $('mcp-list');
|
||||
if (b && (!ctx || ctx())) b.innerHTML = '<div class="empty-tip">加载失败:' + esc(e.message) + '</div>';
|
||||
}
|
||||
}
|
||||
// 内置服务卡:未配置→添加;已配置→显示当前值与状态,点击编辑。密钥类只显示「已配置」,不外显真值。
|
||||
function presetCardHtml(p) {
|
||||
const idx = presetIdx(p);
|
||||
const s = idx >= 0 ? (SET.cfgMcp[idx] || {}) : null;
|
||||
const mode = s ? (s.mode || 'advertise') : '';
|
||||
// 标签用中性灰,颜色只表达连接状态(续=已连接 / 红=未连接 / 黄=待重启)
|
||||
const state = !s
|
||||
? '<span class="model-card-state off">未配置</span>'
|
||||
: '<span class="model-card-state off">已配置</span>' +
|
||||
(mode === 'disable' ? '' : mcpConnChip(s));
|
||||
const h = (s && s.headers) || {};
|
||||
const kv = (p.fields || []).map(f => {
|
||||
const v = h[f.header];
|
||||
const txt = f.secret ? (v ? '已配置' : '--') : (v ? String(v) : '--');
|
||||
return '<div class="cfg-kv"><label>' + esc(f.label || f.header) + '</label><b>' + esc(txt) + '</b></div>';
|
||||
}).join('');
|
||||
return '<div class="model-card' + (mode === 'disable' ? ' off' : '') + '"' +
|
||||
' onclick="mcpUI.' + (s ? 'editPreset' : 'addPreset') + '(\'' + att(p.key) + '\')">' +
|
||||
'<div class="model-card-head">' +
|
||||
'<span class="model-card-name">' + esc(p.label || p.key) + '</span>' +
|
||||
state +
|
||||
'</div>' +
|
||||
'<div class="cfg-kv"><label>地址</label><b>' + esc(p.url) + '</b></div>' + kv +
|
||||
'</div>';
|
||||
}
|
||||
// MCP 卡:头部 = 名称 + url + mode 状态;体内 = headers 键值列表。整卡点击进入编辑。
|
||||
function mcpCardHtml(s, pi) {
|
||||
const mode = s.mode || 'advertise';
|
||||
const stateHtml = mode === 'disable'
|
||||
? '<span class="model-card-state off">已禁用</span>'
|
||||
: mode === 'skill'
|
||||
? '<span class="model-card-state idle">以技能暴露</span>'
|
||||
: '<span class="model-card-state idle">启用</span>';
|
||||
// 同样:模式文字保持中性,颜色留给连接状态
|
||||
const stateHtml = '<span class="model-card-state off">' +
|
||||
(mode === 'disable' ? '已禁用' : mode === 'skill' ? '以技能暴露' : '启用') + '</span>' +
|
||||
(mode === 'disable' ? '' : mcpConnChip(s));
|
||||
const entries = Object.entries(s.headers || {});
|
||||
// header 值等同密码对待:后端 effective 已脱敏为固定短掩码,这里透传展示;若收到未脱敏原文也一律替换,不外显
|
||||
const maskVal = (v) => { const str = String(v == null ? '' : v); if (!str) return '--'; return str.includes('*') ? esc(str) : MCP_HEADER_MASK; };
|
||||
// 后端只对密钥类 header 脱敏(base-url/model 这类明文);掩码值统一显示「已配置」,不露长度
|
||||
const maskVal = (v) => {
|
||||
const str = String(v == null ? '' : v);
|
||||
if (!str) return '--';
|
||||
return str === MCP_HEADER_MASK ? '已配置' : esc(str);
|
||||
};
|
||||
const headersHtml = entries.length
|
||||
? entries.map(([k, v]) => '<div class="cfg-kv"><label>' + esc(k) + '</label><b>' + maskVal(v) + '</b></div>').join('')
|
||||
: '<div class="cfg-kv"><label>(无)</label><b>--</b></div>';
|
||||
@@ -1480,25 +1734,58 @@
|
||||
'</div>' + headersHtml +
|
||||
'</div>';
|
||||
}
|
||||
// 弹窗打开:add 模式 (idx=-1) → 空工作态;edit 模式 → 从当前配置复制。
|
||||
function openMcpEditor(idx) {
|
||||
// 弹窗打开:add 模式 (idx=null) → 空工作态;edit 模式 → 从当前配置复制。
|
||||
// presetKey 有值 = 内置服务模式:url/name/mode 是契约(只读),表单由预设的 fields 生成。
|
||||
function openMcpEditor(idx, presetKey) {
|
||||
const preset = presetKey ? (presetMcpList().find(p => p.key === presetKey) || null) : null;
|
||||
const add = idx == null;
|
||||
const s = add ? {} : (SET.cfgMcp[idx] || {});
|
||||
const curH = s.headers || {};
|
||||
const fieldHeaders = new Set(((preset && preset.fields) || []).map(f => f.header));
|
||||
mcpEdit = {
|
||||
idx: add ? -1 : Number(idx),
|
||||
preset: preset,
|
||||
values: {},
|
||||
// 预设字段走 values;这里只留「配置里有、预设未声明」的 header(手加的)——
|
||||
// headers 是整体替换的,不带着它们保存一次就丢了。
|
||||
headers: Object.keys(curH).filter(k => !fieldHeaders.has(k)).map(k => {
|
||||
const v = String(curH[k]);
|
||||
// 明文值直接回填(可原地改);掩码值置空,placeholder 提示「留空保持不变」
|
||||
return { key: k, value: v === MCP_HEADER_MASK ? '' : v, masked: v };
|
||||
}),
|
||||
};
|
||||
if (preset) {
|
||||
(preset.fields || []).forEach(f => {
|
||||
// 明文项回填当前值(看得见才好改);密钥项只提示「已配置」,留空即保持原值
|
||||
mcpEdit.values[f.header] = add
|
||||
? (f.secret ? '' : String(f.default || ''))
|
||||
: (f.secret ? '' : String(curH[f.header] || ''));
|
||||
});
|
||||
} else if (add) {
|
||||
// headers 数组:每个 {key, value, masked} 为一条编辑行。已有行 value 置空、masked 存当前脱敏值仅做提示
|
||||
// (同平台 Key 的留空=保持原值);新行 masked=null,必须手输真值。空 key 行保存时丢弃。
|
||||
headers: add
|
||||
? [{ key: '', value: '', masked: null }]
|
||||
: Object.entries(s.headers || {}).map(([k, v]) => ({ key: k, value: '', masked: String(v) })),
|
||||
};
|
||||
$('mce-title').textContent = add ? '添加 MCP 服务' : '编辑 MCP 服务';
|
||||
$('mce-name').value = add ? '' : (s.name || '');
|
||||
$('mce-url').value = add ? '' : (s.url || '');
|
||||
mcpEdit.headers = [{ key: '', value: '', masked: null }];
|
||||
}
|
||||
$('mce-title').textContent = (add ? '添加 ' : '编辑 ') + (preset ? preset.label : 'MCP 服务');
|
||||
$('mce-name').value = preset ? preset.key : (add ? '' : (s.name || ''));
|
||||
$('mce-url').value = preset ? preset.url : (add ? '' : (s.url || ''));
|
||||
$('mce-name').readOnly = !!preset;
|
||||
$('mce-url').readOnly = !!preset;
|
||||
// 运行配置里的 timeout_ms 已被 config.js 填上缺省值,所以这里显示的就是当前生效值(没配则为 60000)。
|
||||
$('mce-timeout').value = add || s.timeout_ms == null ? '' : String(s.timeout_ms);
|
||||
$('mce-mode').value = add ? 'advertise' : (s.mode || 'advertise');
|
||||
// 预设的 mode 是契约(asr / image_task 必须 skill 才不会把一堆转写/生成工具塞进每轮工具表),
|
||||
// 只允许在「预设值 / disable」之间切;手改成别的值时按契约值显示,不凭空改写文件。
|
||||
const curMode = add ? (preset ? (preset.mode || 'advertise') : 'advertise') : (s.mode || 'advertise');
|
||||
const modes = preset ? [preset.mode || 'advertise', 'disable'] : ['advertise', 'skill', 'disable'];
|
||||
$('mce-mode').innerHTML = modes.map(m => '<option value="' + att(m) + '">' + esc(MCP_MODE_LABELS[m] || m) + '</option>').join('');
|
||||
$('mce-mode').value = modes.indexOf(curMode) >= 0 ? curMode : modes[0];
|
||||
$('mce-preset-sec').classList.toggle('hidden', !preset);
|
||||
$('mce-preset-desc').textContent = preset ? (preset.desc || '') : '';
|
||||
// 预设已经覆盖该服务的全部 header,不再给「其它 header」入口;
|
||||
// 配置里若还留着历史多余 header,仍原样带着(保存是整体替换,不带着就丢),只是不展示。
|
||||
$('mce-headers-sec').classList.toggle('hidden', !!preset);
|
||||
$('mce-del-btn').classList.toggle('hidden', add);
|
||||
renderPresetFields();
|
||||
renderMcpHeaders();
|
||||
$('mcp-edit-modal').classList.remove('hidden');
|
||||
}
|
||||
@@ -1508,7 +1795,7 @@
|
||||
// 已有行:输入框置空,placeholder 提示当前脱敏值;留空=保持原值,输入新值=替换
|
||||
const ph = r.masked != null ? '当前: ' + r.masked + '(留空保持不变)' : '值';
|
||||
return '<div class="mpe-row">' +
|
||||
'<input class="mpe-grow" type="text" placeholder="Header 名(如 Authorization)" value="' + esc(r.key) + '" oninput="mcpUI.setHeader(' + i + ',\'key\',this.value)">' +
|
||||
'<input class="mpe-grow" type="text" placeholder="Header 字段" value="' + esc(r.key) + '" oninput="mcpUI.setHeader(' + i + ',\'key\',this.value)">' +
|
||||
'<input class="mpe-grow" type="text" placeholder="' + esc(ph) + '" value="' + esc(r.value) + '" oninput="mcpUI.setHeader(' + i + ',\'value\',this.value)">' +
|
||||
'<button class="mpe-del" title="删除此 header" onclick="mcpUI.delHeader(' + i + ')">×</button>' +
|
||||
'</div>';
|
||||
@@ -1530,13 +1817,82 @@
|
||||
renderMcpHeaders();
|
||||
}
|
||||
function setMcpHeader(i, f, v) { if (mcpEdit && mcpEdit.headers[i]) mcpEdit.headers[i][f] = v; }
|
||||
// 预设字段表单:label + 输入框 + 提示。密钥项只提示「已配置」,不回填真值(前端拿到的本来就是掩码)。
|
||||
function renderPresetFields() {
|
||||
if (!mcpEdit) return;
|
||||
const box = $('mce-preset-fields');
|
||||
if (!box) return;
|
||||
const p = mcpEdit.preset;
|
||||
if (!p) { box.innerHTML = ''; return; }
|
||||
const curH = ((mcpEdit.idx >= 0 && SET.cfgMcp[mcpEdit.idx]) || {}).headers || {};
|
||||
box.innerHTML = (p.fields || []).map(f => {
|
||||
const isSet = !!curH[f.header];
|
||||
const ph = f.secret && isSet ? '已配置,留空保持不变' : (f.placeholder || '');
|
||||
const val = mcpEdit.values[f.header] || '';
|
||||
// 左标签 / 右输入,与下方「单次调用超时 / 工具暴露」同一种单行排版。
|
||||
// 必填不加 * 标记(会破坏对齐)——空着保存时按 label 点名报错。
|
||||
return '<div class="mpe-item"><label class="mpe-line"><span>' + esc(f.label || f.header) + '</span>' +
|
||||
'<input type="' + (f.secret ? 'password' : 'text') + '"' +
|
||||
' value="' + att(val) + '"' +
|
||||
' placeholder="' + att(ph) + '"' +
|
||||
' autocomplete="off" spellcheck="false"' +
|
||||
' oninput="mcpUI.setField(\'' + att(f.header) + '\',this.value)">' +
|
||||
'</label>' + (f.hint ? '<div class="cfg-note">' + esc(f.hint) + '</div>' : '') + '</div>';
|
||||
}).join('');
|
||||
}
|
||||
function setPresetField(header, v) {
|
||||
if (mcpEdit && mcpEdit.values) mcpEdit.values[header] = v;
|
||||
}
|
||||
// 预设里的 prefix(如 Bearer )只在用户没带过时才补,避开「Bearer Bearer sk-x」
|
||||
function withPrefix(f, v) {
|
||||
const p = String(f.prefix || '');
|
||||
if (!p) return v;
|
||||
const re = new RegExp('^' + p.trim().replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '\\s', 'i');
|
||||
return re.test(v) ? v : p + v;
|
||||
}
|
||||
// 与配置里的 headers 比较:key 顺序不同不算改动(避免无意义重写丢掉节点里的注释)
|
||||
function sameHeaders(a, b) {
|
||||
const ka = Object.keys(a).sort(), kb = Object.keys(b).sort();
|
||||
if (ka.length !== kb.length) return false;
|
||||
return ka.every((k, i) => k === kb[i] && a[k] === b[kb[i]]);
|
||||
}
|
||||
// 自定义服务的 headers:空 key 行丢弃,已有行留空 = 发回掩码占位由后端按键名还原
|
||||
function plainHeaders() {
|
||||
const out = {};
|
||||
for (const r of mcpEdit.headers) {
|
||||
const k = String(r.key || '').trim();
|
||||
if (!k) continue;
|
||||
const v = String(r.value || '').trim();
|
||||
out[k] = v || (r.masked != null ? r.masked : '');
|
||||
}
|
||||
return out;
|
||||
}
|
||||
// 预设模式的 headers:字段按声明顺序取 values,空的可选项不写(不给上游塞空 header),
|
||||
// 必填项空着直接报错并点名 label;手加的 header 原样跟上(整体替换语义下不带就丢)。
|
||||
function presetHeaders() {
|
||||
const p = mcpEdit.preset;
|
||||
const curH = ((mcpEdit.idx >= 0 && SET.cfgMcp[mcpEdit.idx]) || {}).headers || {};
|
||||
const out = {};
|
||||
for (const f of p.fields || []) {
|
||||
const raw = String(mcpEdit.values[f.header] || '').trim();
|
||||
if (raw) { out[f.header] = withPrefix(f, raw); continue; }
|
||||
if (f.secret && curH[f.header]) { out[f.header] = MCP_HEADER_MASK; continue; }
|
||||
if (f.required) throw new Error('请填写「' + (f.label || f.header) + '」');
|
||||
}
|
||||
for (const r of mcpEdit.headers) {
|
||||
const k = String(r.key || '').trim();
|
||||
if (!k || out[k] !== undefined) continue;
|
||||
const v = String(r.value || '').trim();
|
||||
out[k] = v || (r.masked != null ? r.masked : '');
|
||||
}
|
||||
return out;
|
||||
}
|
||||
// 收集弹窗内的修改为批量 PATCH:服务端一次读文/写回/校验,原子生效。
|
||||
// headers 整体替换(简单可靠;键值对场景下增量 diff 收益小):空 key 行不写入。
|
||||
function buildMcpEdits() {
|
||||
if (!mcpEdit) return [];
|
||||
const edits = [];
|
||||
const name = $('mce-name').value.trim();
|
||||
const url = $('mce-url').value.trim();
|
||||
const preset = mcpEdit.preset;
|
||||
const mode = $('mce-mode').value;
|
||||
// 超时:留空 = 不写入该项(沿用缺省 60s)。区间在 UI 先把一道,
|
||||
// 比写进 YAML 再被 config.js 静默夹掉好排查(两边上限保持 600000 一致)。
|
||||
@@ -1547,6 +1903,10 @@
|
||||
if (!Number.isFinite(tmo) || tmo < 1000 || tmo > 600000) throw new Error('超时要填 1000 ~ 600000 毫秒(留空 = 默认 60s)');
|
||||
tmo = Math.round(tmo);
|
||||
}
|
||||
// 内置服务的 name/url 是契约(表单只读),只有自定义服务才从输入框取
|
||||
const name = preset ? preset.key : $('mce-name').value.trim();
|
||||
const url = preset ? preset.url : $('mce-url').value.trim();
|
||||
const headers = preset ? presetHeaders() : plainHeaders();
|
||||
const add = mcpEdit.idx < 0;
|
||||
if (add) {
|
||||
if (!url) throw new Error('请填写 url');
|
||||
@@ -1554,19 +1914,15 @@
|
||||
if (name) obj.name = name;
|
||||
if (mode !== 'advertise') obj.mode = mode;
|
||||
if (tmo != null) obj.timeout_ms = tmo;
|
||||
const headers = {};
|
||||
for (const r of mcpEdit.headers) {
|
||||
const k = String(r.key || '').trim();
|
||||
const v = String(r.value || '').trim();
|
||||
if (k) headers[k] = v;
|
||||
}
|
||||
if (Object.keys(headers).length) obj.headers = headers;
|
||||
edits.push({ op: 'append', path: ['mcp_servers'], value: obj });
|
||||
} else {
|
||||
const cur = SET.cfgMcp[mcpEdit.idx] || {};
|
||||
if (!url) throw new Error('请填写 url');
|
||||
if (name !== (cur.name || '')) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'name'], value: name });
|
||||
if (url !== (cur.url || '')) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'url'], value: url });
|
||||
if (!preset) {
|
||||
if (!url) throw new Error('请填写 url');
|
||||
if (name !== (cur.name || '')) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'name'], value: name });
|
||||
if (url !== (cur.url || '')) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'url'], value: url });
|
||||
}
|
||||
// mode:默认值不写进文件(选 advertise 就删键)
|
||||
if ((cur.mode || 'advertise') !== mode) edits.push(mode === 'advertise'
|
||||
? { path: ['mcp_servers', mcpEdit.idx, 'mode'], op: 'delete' }
|
||||
@@ -1576,17 +1932,10 @@
|
||||
if (tmo !== curTmo) edits.push(tmo == null
|
||||
? { path: ['mcp_servers', mcpEdit.idx, 'timeout_ms'], op: 'delete' }
|
||||
: { path: ['mcp_servers', mcpEdit.idx, 'timeout_ms'], value: tmo });
|
||||
// headers 仅在内容变更时整体 setIn;避免无意义重写(顺序可能不同)
|
||||
const newH = {};
|
||||
for (const r of mcpEdit.headers) {
|
||||
const k = String(r.key || '').trim();
|
||||
// 已有行留空 = 保持原值:把脱敏占位原样发回,由后端按键名还原真值(前端不持有真值)
|
||||
const v = String(r.value || '').trim() || (r.masked != null ? r.masked : '');
|
||||
if (k) newH[k] = v;
|
||||
// headers 仅在内容变更时整体 setIn;避免无意义重写(顺序或 key 顺序不同不算变更)
|
||||
if (!sameHeaders(headers, cur.headers || {})) {
|
||||
edits.push({ path: ['mcp_servers', mcpEdit.idx, 'headers'], value: headers });
|
||||
}
|
||||
const curH = cur.headers || {};
|
||||
const same = JSON.stringify(newH) === JSON.stringify(curH);
|
||||
if (!same) edits.push({ path: ['mcp_servers', mcpEdit.idx, 'headers'], value: newH });
|
||||
}
|
||||
return edits;
|
||||
}
|
||||
@@ -1618,6 +1967,13 @@
|
||||
}
|
||||
window.mcpUI = {
|
||||
add: function () { openMcpEditor(null); },
|
||||
addPreset: function (key) { openMcpEditor(null, key); },
|
||||
editPreset: function (key) {
|
||||
const p = presetMcpList().find(x => x.key === key);
|
||||
const i = p ? presetIdx(p) : -1;
|
||||
if (i >= 0) openMcpEditor(i, key);
|
||||
},
|
||||
setField: setPresetField,
|
||||
edit: openMcpEditor,
|
||||
close: closeMcpEditor,
|
||||
save: saveMcpEditor,
|
||||
@@ -1678,8 +2034,15 @@
|
||||
mDelModel: delPfModel,
|
||||
mKeyApi: function (i, v) { setPfKey(i, 'api_key', v); },
|
||||
mModId: function (i, v) { setPfModel(i, 'id', v); },
|
||||
mModField: function (i, f, v) { setPfModel(i, f, v); },
|
||||
mModVision: function (i, v) { setPfModel(i, 'vision', v); },
|
||||
mModEnable: function (i, v) { setPfModel(i, 'enable', v); },
|
||||
mAdvToggle: function (i) {
|
||||
if (!pfEdit || !pfEdit.models[i]) return;
|
||||
pfEdit.models[i].adv = !pfEdit.models[i].adv;
|
||||
renderPfRows();
|
||||
},
|
||||
mPreset: applyPfPreset,
|
||||
mDelPlat: delPlatformFromModal,
|
||||
restartNow: restartNow,
|
||||
toggleGroup: toggleModelGroup,
|
||||
|
||||
@@ -19,7 +19,7 @@
|
||||
const content = ta.value.trim();
|
||||
const editingId = state.editingMsgId || 0;
|
||||
// 没有文字就不发(避免产生空消息);但只有附件时允许发送——粘贴长文本转成的 .txt 需要能单独发出。
|
||||
// 运行中也是这条规则:有字就发(后端 live 追投),没字又没附件时按钮本身是「停止」。
|
||||
// 运行中也是这条规则:有字就发,没字又没附件时按钮本身是「停止」。
|
||||
if (!content && !state.attachments.length) return;
|
||||
|
||||
const pending = state.attachments.slice();
|
||||
@@ -43,7 +43,10 @@
|
||||
const text = names.length
|
||||
? '用户上传了文件:' + names.join('、') + (content ? '\n\n' + content : '')
|
||||
: content;
|
||||
const body = { content: text, deepThink: !!state.deepThink };
|
||||
// 是否排队由**服务端**决定:Web 端一律交 delivery:'queue',回合在跑就进队列,
|
||||
// 没在跑就等价于立即发送(enqueueMessage 直接走 postUserMessage)。
|
||||
// 不用 state.status 判断——SSE 状态可能过期,误判成 live 会把 user 行插进工具批次中间。
|
||||
const body = { content: text, deepThink: !!state.deepThink, delivery: 'queue' };
|
||||
let sent;
|
||||
if (editingId) {
|
||||
// 覆盖式编辑:先撤掉本地该条及其后的渲染,再让服务端删除同范围历史并以新内容重开一轮
|
||||
@@ -56,7 +59,15 @@
|
||||
}
|
||||
clearUploadCards(); // 消息已发出(告知行已拼入正文),卡片使命完成清掉
|
||||
|
||||
appendUserMsg(text, atts.map(a => a.name), sent && sent.message_id);
|
||||
// 排队回执:条幅以服务端返回的队列为准(本端不画气泡,等真正落库的 user_message 再画);
|
||||
// 竞态下服务端发现回合已结束会直接送达(没有 queued 字段),那就照常当普通发送处理。
|
||||
const queued = !!(sent && sent.queued);
|
||||
if (queued) {
|
||||
state.pending = sent.pending || [];
|
||||
renderSendQueue();
|
||||
} else {
|
||||
appendUserMsg(text, atts.map(a => a.name), sent && sent.message_id);
|
||||
}
|
||||
// 标题取用户原文,不带文件告知行;纯附件发送时退回粘贴文本的前缀
|
||||
const seed = content || (pending[0] && pending[0].titleSeed) || '';
|
||||
if (!state.sessionTitle && seed) {
|
||||
@@ -65,7 +76,8 @@
|
||||
renderHeader();
|
||||
// 运行中插话:正文字流进行中已有一个气泡作「活着」的信号,不再挂打字占位
|
||||
//(刚挂上就会被下一个 delta 移除,只会闪一下);工具间隙里补上占位反而有用。
|
||||
if (!state.streaming) addTyping();
|
||||
// 排队时本回合没有任何新动静,不挂占位。
|
||||
if (!queued && !state.streaming) addTyping();
|
||||
loadSessionList();
|
||||
} catch (e) {
|
||||
// 发送失败:附件还原+草稿文本回填(发送前已清空输入框,挂起/失败不能让文字蒸发),
|
||||
@@ -83,6 +95,56 @@
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 待发送条幅 ----------
|
||||
// 队列本身在服务端(engine.pendings),关页面/换设备/重连都不丢;这里只负责画。
|
||||
// 每条一行;只有队首有「干预 / 立即发送」,其余显示排队中(不能越过前一条先发)。
|
||||
function renderSendQueue() {
|
||||
const box = $('send-queue');
|
||||
if (!box) return;
|
||||
const list = state.pending || [];
|
||||
box.classList.toggle('hidden', !list.length);
|
||||
if (!list.length) { box.innerHTML = ''; return; }
|
||||
box.innerHTML = list.map((it, i) => {
|
||||
const busy = it.mode === 'interject' || it.mode === 'now';
|
||||
const tag = it.mode === 'now' ? '<span class="sq-tag">正在中断…</span>'
|
||||
: it.mode === 'interject' ? '<span class="sq-tag">等待当前步骤…</span>'
|
||||
: (i === 0 ? '' : '<span class="sq-tag">排队中</span>');
|
||||
const acts = (i === 0 && !busy)
|
||||
? '<button data-act="interject" title="当前工具调用结束后立即插话">干预</button>' +
|
||||
'<button data-act="now" title="终止本轮工具调用并立即发送">立即发送</button>'
|
||||
: '';
|
||||
return '<div class="sq-item' + (busy ? ' sq-busy' : '') + '" data-qid="' + esc(it.id) + '">' +
|
||||
'<span class="sq-text" title="' + esc(it.content) + '">' + esc(it.content) + '</span>' +
|
||||
tag + acts +
|
||||
'<button class="sq-x" data-act="cancel" title="取消这条">×</button></div>';
|
||||
}).join('');
|
||||
}
|
||||
|
||||
// 条幅按钮:× 取消;干预/立即发送升级队首(服务端只在安全边界真正投递)。
|
||||
async function onSendQueueClick(e) {
|
||||
const btn = e.target.closest('#send-queue button[data-act]');
|
||||
if (!btn || !state.sessionId) return;
|
||||
const item = btn.closest('.sq-item');
|
||||
const qid = item && item.dataset.qid;
|
||||
if (!qid) return;
|
||||
const act = btn.dataset.act;
|
||||
btn.disabled = true;
|
||||
try {
|
||||
const base = '/api/sessions/' + state.sessionId + '/pending/' + encodeURIComponent(qid);
|
||||
const r = act === 'cancel' ? await req('DELETE', base) : await req('POST', base, { action: act });
|
||||
if (r && Array.isArray(r.pending)) { state.pending = r.pending; renderSendQueue(); }
|
||||
if (act === 'cancel') return;
|
||||
if (r && r.delivered) return; // 回合已结束:服务端直接投递,等 user_message 画气泡
|
||||
toast(act === 'now' ? '已请求中断,随后立即发送' : '已请求干预:当前步骤结束后插话');
|
||||
} catch (err) {
|
||||
toast('操作失败:' + err.message);
|
||||
renderSendQueue();
|
||||
}
|
||||
}
|
||||
|
||||
const sendQueueBox = $('send-queue');
|
||||
if (sendQueueBox) sendQueueBox.addEventListener('click', onSendQueueClick);
|
||||
|
||||
// ---------- SSE 流 ----------
|
||||
// 助手消息流式容器:首个 delta 到达时创建,同时为思考面板预留挂载点
|
||||
function ensureStreamWrap() {
|
||||
@@ -158,12 +220,15 @@
|
||||
state.lastSseAt = Date.now(); // 建连即重置静默计时
|
||||
// 任何具名事件都算连接存活:静默看门狗与回前台宽限共用(error 不列,原生连接错误也走 error)
|
||||
['ping', 'status', 'assistant_delta', 'reasoning_delta', 'assistant_message', 'tool_call_start',
|
||||
'tool_call_args', 'tool_call', 'tool_result', 'ui_card', 'auto_compress', 'done', 'title', 'think_auto']
|
||||
'tool_call_args', 'tool_call', 'tool_result', 'ui_card', 'auto_compress', 'done', 'title', 'think_auto',
|
||||
'pending_added', 'pending_removed', 'user_message']
|
||||
.forEach(function (n) { es.addEventListener(n, function () { markSseAlive(n); }); });
|
||||
es.addEventListener('status', ev => {
|
||||
const d = JSON.parse(ev.data);
|
||||
state.status = d.status;
|
||||
if (d.model_id) state.modelId = d.model_id;
|
||||
// 待投递队列以服务端为准(重连/换标签页后条幅能自动回到真实状态)
|
||||
if (Array.isArray(d.pending)) { state.pending = d.pending; renderSendQueue(); }
|
||||
renderHeader();
|
||||
updateHeaderActions();
|
||||
updateScrollBottomBtn(); // 状态切换同步右下角转圈(开始/结束干活)
|
||||
@@ -348,8 +413,33 @@
|
||||
es.addEventListener('auto_compress', ev => {
|
||||
proposeAutoCompress(JSON.parse(ev.data));
|
||||
});
|
||||
// 待发送条幅:新入队 / 升级(同 id upsert)
|
||||
es.addEventListener('pending_added', ev => {
|
||||
const d = JSON.parse(ev.data);
|
||||
if (!d || !d.id) return;
|
||||
const list = state.pending.slice();
|
||||
const i = list.findIndex(x => x.id === d.id);
|
||||
if (i >= 0) list[i] = d; else list.push(d);
|
||||
state.pending = list;
|
||||
renderSendQueue();
|
||||
});
|
||||
// 出队(已送达 / 被取消 / 停止时整体清空)
|
||||
es.addEventListener('pending_removed', ev => {
|
||||
const d = JSON.parse(ev.data);
|
||||
state.pending = state.pending.filter(x => x.id !== (d && d.id));
|
||||
renderSendQueue();
|
||||
});
|
||||
// 排队消息真正落库:这一刻它才成为历史,画进聊天区(排队期间不画)
|
||||
es.addEventListener('user_message', ev => {
|
||||
const d = JSON.parse(ev.data);
|
||||
if (!d || !d.id || state.renderedSigs[d.id]) return; // 防重(重连补拉/多标签页)
|
||||
appendUserMsg(d.content, null, d.id);
|
||||
removeTyping();
|
||||
});
|
||||
es.addEventListener('done', ev => {
|
||||
removeTyping(); // 本轮结束,占位亦终止(如模型报错无回复)
|
||||
let doneStatus = '';
|
||||
try { doneStatus = (JSON.parse(ev.data) || {}).status || ''; } catch (_) { /* 无 data 的连接层错误 */ }
|
||||
// 压缩回合异常结束的兜底(模型报错回合直接 break / 被终止 → 不会有带 is_summary 的最终消息):
|
||||
// 复位等待状态并还原压缩按钮,历史保持原样不动。
|
||||
if (state.pendingSummary) {
|
||||
@@ -364,10 +454,20 @@
|
||||
state.streamWrap = null;
|
||||
state.streamReasoning = '';
|
||||
state.streamThinkEl = null;
|
||||
// 异常收尾兜底:把参数未流完的早卡就地回填收尾,避免占位态永远呼吸
|
||||
// 异常收尾兜底:把参数未流完的早卡就地回填收尾,避免占位态永远呼吸。
|
||||
// 被「立即发送/停止」硬中断时,这些调用根本没落库、不会再有回执,
|
||||
// 结果区要明确写「已取消」,否则卡片永远停在「执行中…」。
|
||||
for (const sid of Object.keys(state.toolCallStreaming)) {
|
||||
const stg = state.toolCallStreaming[sid];
|
||||
finalizeToolCardArgs(sid, stg.name, stg.args);
|
||||
const card = state.toolCards[sid];
|
||||
const pre = card && card.querySelector('.tool-result');
|
||||
if (pre && pre.textContent === '执行中…') {
|
||||
card.classList.add('error');
|
||||
const spin = card.querySelector('.spin');
|
||||
if (spin) spin.textContent = '⏹';
|
||||
pre.textContent = doneStatus === 'cancelled' ? '已取消(本轮被终止,未执行)' : '本轮已结束,未收到结果';
|
||||
}
|
||||
}
|
||||
state.toolCards = {};
|
||||
state.toolCallStreaming = {}; // 流式参数早卡映射随会话/回合重置
|
||||
|
||||
@@ -0,0 +1,76 @@
|
||||
// 视口适配:软键盘高度 → CSS 变量 --kb-page(纯页面侧兜底,不依赖套壳 App 改代码)
|
||||
// ----------------------------------------------------------------------------
|
||||
// 症状:套壳 App(Android WebView / ArkWeb)开了 edge-to-edge 后,
|
||||
// 1) 顶部内容压在状态栏下面 —— 安卓 WebView 的 env(safe-area-inset-top) 只反映屏幕
|
||||
// 挖孔(display cutout),不含状态栏高度,基本恒为 0;壳不额外注入就顶不上去。
|
||||
// 这一条由壳注入 CSS 变量解决,见下方「注入约定」,本文件不处理。
|
||||
// 2) 键盘弹起、输入框被盖住 —— Chromium 默认 interactive-widget=resizes-visual,只缩
|
||||
// visual viewport,layout viewport 不动。本页是 height:100% 的固定 shell,footer 全靠
|
||||
// layout viewport 变矮才会被顶上来,于是原地不动被键盘压住(看起来像「没给键盘留位置」)。
|
||||
//
|
||||
// 本文件只解决第 2 条:用 visualViewport 与 innerHeight 的差值算出键盘实际占用的高度,
|
||||
// 写进 --kb-page;#app 按 --kb(= max(--kb-page, --kb-native))收缩,footer 自动落在键盘上沿。
|
||||
// 壳若已正确 resize(adjustResize / resizes-content 生效),innerHeight 会同步变矮,
|
||||
// 差值恒为 0,本逻辑自动失效,不会二次收缩。
|
||||
//
|
||||
// 注入约定(壳侧,loadUrl 之后或 WindowInsets 变化时):
|
||||
// document.documentElement.style.setProperty('--sat', '36px'); // 状态栏高度
|
||||
// document.documentElement.style.setProperty('--sab', '20px'); // 导航栏/手势条高度
|
||||
// document.documentElement.style.setProperty('--kb-native', '300px'); // IME 高度(可选)
|
||||
// --kb-native 用于「WebView 完全感知不到键盘」的情况(窗口不 resize、visualViewport 也不缩),
|
||||
// 此时本文件量不到任何东西,只能靠壳把 IME insets 报进来;页面与壳各写各的变量,互不覆盖。
|
||||
(function () {
|
||||
'use strict';
|
||||
|
||||
const root = document.documentElement;
|
||||
const vv = window.visualViewport;
|
||||
// 没有 visualViewport 的老 WebView:只剩 interactive-widget / 壳 resize 两条路
|
||||
if (!vv) return;
|
||||
|
||||
// 键盘判定阈值:地址栏/浏览器 UI 收起通常 < 60px,软键盘一般 > 150px,
|
||||
// 取 80 让两者之间留足余量,避免把浏览器 UI 收起误判成键盘。
|
||||
const KB_MIN = 80;
|
||||
// 贴底判定:与 chat.js 的 SCROLL_BOTTOM_THRESHOLD 同量级即可,不必严格一致
|
||||
const STICK_PX = 80;
|
||||
|
||||
let kb = 0;
|
||||
let raf = 0;
|
||||
|
||||
function nearBottom(box) {
|
||||
return box.scrollHeight - box.scrollTop - box.clientHeight < STICK_PX;
|
||||
}
|
||||
|
||||
function measure() {
|
||||
raf = 0;
|
||||
// 键盘占掉的高度 = layout viewport 高度 -(visual viewport 顶部偏移 + 可视高度)。
|
||||
// 浏览器为露出光标会把 visual viewport 上推(offsetTop > 0),这部分要一并扣掉,
|
||||
// 否则会按「整段键盘」收缩,footer 反而被顶得比键盘上沿更高。
|
||||
let next = Math.round(window.innerHeight - vv.offsetTop - vv.height);
|
||||
// 双指缩放时 vv.height 被压缩,不代表键盘(user-scalable=no 下基本走不到)
|
||||
if (vv.scale > 1.01 || next < KB_MIN) next = 0;
|
||||
// 兜底上限:横屏 + 大字号等极端情况下别把整个 shell 收没
|
||||
next = Math.min(next, Math.round(window.innerHeight * 0.7));
|
||||
|
||||
if (next === kb) return;
|
||||
|
||||
const box = document.getElementById('chat-view');
|
||||
// 只在「键盘弹起导致变矮」时继续贴底;收键盘时保持当前阅读位置不动
|
||||
const stick = next > kb && !!box && nearBottom(box);
|
||||
kb = next;
|
||||
root.style.setProperty('--kb-page', kb + 'px');
|
||||
|
||||
if (stick) {
|
||||
// 等一次布局:#app 收缩后 scrollHeight / clientHeight 才是新值
|
||||
requestAnimationFrame(() => { box.scrollTop = box.scrollHeight; });
|
||||
}
|
||||
}
|
||||
|
||||
function schedule() {
|
||||
if (!raf) raf = requestAnimationFrame(measure);
|
||||
}
|
||||
|
||||
vv.addEventListener('resize', schedule);
|
||||
vv.addEventListener('scroll', schedule); // 浏览器平移 visual viewport 时 offsetTop 会变
|
||||
// 转屏后尺寸与 inset 都变了,等系统栏动画结束再量一次
|
||||
window.addEventListener('orientationchange', () => setTimeout(measure, 200));
|
||||
})();
|
||||
@@ -2,7 +2,7 @@
|
||||
<html lang="zh">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover, interactive-widget=resizes-content">
|
||||
<title>Agent 任务台 · 登录</title>
|
||||
<meta name="theme-color" content="#1e3c72">
|
||||
<meta name="apple-mobile-web-app-capable" content="yes">
|
||||
@@ -13,7 +13,8 @@
|
||||
<link rel="stylesheet" href="/css/style.css">
|
||||
<style>
|
||||
.login-wrap {
|
||||
position: fixed; inset: 0; display: flex; align-items: center; justify-content: center;
|
||||
/* bottom 让出软键盘:表单垂直居中,键盘弹起时卡片跟着可见区域上移(--kb 见 js/viewport.js) */
|
||||
position: fixed; inset: 0; bottom: var(--kb, 0px); display: flex; align-items: center; justify-content: center;
|
||||
background: linear-gradient(135deg, #1e3c72, #2a5299);
|
||||
}
|
||||
.login-card {
|
||||
@@ -39,6 +40,7 @@
|
||||
<p class="login-error" id="login-error"></p>
|
||||
</form>
|
||||
</div>
|
||||
<script src="/js/viewport.js"></script>
|
||||
<script>
|
||||
'use strict';
|
||||
const TOKEN_KEY = 'agent_token';
|
||||
|
||||
+108
-17
@@ -5,10 +5,55 @@ const express = require('express');
|
||||
const engine = require('../engine');
|
||||
const { loadConfigFromText, readConfigText, applyEditsToText, writeConfigText } = require('../config');
|
||||
const balance = require('../balance');
|
||||
const mcp = require('../mcp');
|
||||
const log = require('../log');
|
||||
|
||||
const router = express.Router();
|
||||
|
||||
// 平台 / MCP 预设:设置页「新增平台」「添加内置 MCP」的模板来源(纯静态,无密钥)。
|
||||
// 文件写坏时降级为空预设:通用表单仍可用,不影响其它功能。
|
||||
const MCP_MODES = ['advertise', 'skill', 'disable'];
|
||||
function checkPresetList(list, kind, bad) {
|
||||
const seen = new Set();
|
||||
(list || []).forEach((x, i) => {
|
||||
const at = kind + '[' + i + ']';
|
||||
if (!x || typeof x !== 'object') { bad.push(at + ' 必须是对象'); return; }
|
||||
if (!x.key || !x.url) { bad.push(at + ' 缺 key/url'); return; }
|
||||
if (seen.has(x.key)) { bad.push(at + ' key 重复:' + x.key); return; }
|
||||
seen.add(x.key);
|
||||
if (kind === 'platforms') {
|
||||
if (!x.type) bad.push(at + ' 缺 type');
|
||||
if (x.model_defaults != null && typeof x.model_defaults !== 'object') {
|
||||
bad.push(at + '.model_defaults 必须是对象');
|
||||
}
|
||||
return;
|
||||
}
|
||||
if (x.mode != null && MCP_MODES.indexOf(x.mode) < 0) {
|
||||
bad.push(at + '.mode 只能是 ' + MCP_MODES.join(' / '));
|
||||
}
|
||||
if (x.fields != null && !Array.isArray(x.fields)) { bad.push(at + '.fields 必须是数组'); return; }
|
||||
(x.fields || []).forEach((f, fi) => {
|
||||
if (!f || !f.header) bad.push(at + '.fields[' + fi + '] 缺 header');
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
function loadPresets() {
|
||||
const p = require('../presets.json') || {};
|
||||
const bad = [];
|
||||
checkPresetList(p.platforms, 'platforms', bad);
|
||||
checkPresetList(p.mcp, 'mcp', bad);
|
||||
if (bad.length) throw new Error(bad.join(';'));
|
||||
return { platforms: p.platforms || [], mcp: p.mcp || [] };
|
||||
}
|
||||
|
||||
let PRESETS = { platforms: [], mcp: [] };
|
||||
try {
|
||||
PRESETS = loadPresets();
|
||||
} catch (e) {
|
||||
log.warn('config', 'presets.json 无效,设置页将没有预设:' + String((e && e.message) || e));
|
||||
}
|
||||
|
||||
function sendErr(res, err) {
|
||||
const code = err && err.status_code || 500;
|
||||
res.status(code).json({ error: String(err && err.message || err) });
|
||||
@@ -112,13 +157,29 @@ function restorePasswords(submitted, orig) {
|
||||
}).join('\n');
|
||||
}
|
||||
|
||||
// MCP header 值脱敏(等同密码):统一固定短掩码 *****(不泄露长度),原文编辑器与 effective 视图共用。
|
||||
// MCP header 值脱敏:只遮「像密钥的」,base-url / model 这类明文回显——
|
||||
// 设置页的引导表单要看得见当前值才能改。两条启发式任一命中即遮:
|
||||
// 名字(Authorization / X-*-Token / X-Api-Key …)、值(Bearer … / sk-…)。
|
||||
// 值那条是兜底:用户自定义的怪名字(X-Upstream-Auth: sk-xxx)也不会明文外显。
|
||||
// headers 行 = `headers:` 块内比它更深缩进的键值行(如 ` Authorization: Bearer sk-xxx`,引号可选)。
|
||||
// 局限:块标量(|/>)续行内容无法逐行识别,与 api_key/password 的行级掩码同一量级的取舍。
|
||||
const MCP_HEADER_MASK = '*****';
|
||||
const HEADERS_BLOCK_LINE = /^(\s*)headers:\s*(?:#.*)?$/;
|
||||
const MCP_HEADER_LINE = /^(\s*(?:-\s+)?[\w.-]+:\s*)(["']?)(.*)\2\s*$/;
|
||||
function maskHeaderValue(v) { return v ? MCP_HEADER_MASK : ''; }
|
||||
const SECRET_NAME_RE = /^(authorization|cookie)$|(?:^|[-_])(token|key|secret|password)(?:[-_]|$)/i;
|
||||
const SECRET_VALUE_RE = /^Bearer\s|^sk-[A-Za-z0-9_-]{16,}/i;
|
||||
function isSecretHeader(name, value) {
|
||||
return SECRET_NAME_RE.test(String(name || '').trim()) ||
|
||||
SECRET_VALUE_RE.test(String(value == null ? '' : value).trim());
|
||||
}
|
||||
function maskHeaderValue(name, v) {
|
||||
if (!v) return '';
|
||||
return isSecretHeader(name, v) ? MCP_HEADER_MASK : v;
|
||||
}
|
||||
// 从匹配行里取 header 名(去掉列表短横与结尾冒号),用于按键名遮罩/还原
|
||||
function headerNameOf(m) {
|
||||
return String(m[1] || '').replace(/^\s*-\s*/, '').replace(/:\s*$/, '').trim();
|
||||
}
|
||||
// 遍历 headers 块内的键值行,fn(line, match) 返回替换后的行;块边界按缩进判定。
|
||||
function mapMcpHeaderLines(text, fn) {
|
||||
if (!text) return text;
|
||||
@@ -138,22 +199,32 @@ function mapMcpHeaderLines(text, fn) {
|
||||
}
|
||||
function maskMcpHeaders(text) {
|
||||
return mapMcpHeaderLines(text, function (line, m) {
|
||||
return m[1] + m[2] + maskHeaderValue(m[3]) + m[2];
|
||||
return m[1] + m[2] + maskHeaderValue(headerNameOf(m), m[3]) + m[2];
|
||||
});
|
||||
}
|
||||
// 还原:提交原文中值恰为 ***** 的 header 行 = 用户未改动,按出现顺序从原文件取回原值;其他值原样保留。
|
||||
// 还原:提交原文里值恰为 ***** 的行 = 用户未改动,按键名从原文件取回真值。
|
||||
// 按键名而非出现顺序:只遮部分 header 后,按顺序还原会张冠李戴。
|
||||
// 键名在原文里找不到(改名/新增行却留着占位)直接报错,绝不把占位写进配置。
|
||||
function restoreMcpHeaders(submitted, orig) {
|
||||
if (!submitted) return submitted;
|
||||
const origVals = [];
|
||||
mapMcpHeaderLines(orig || '', function (line, m) { origVals.push(m[3]); return line; });
|
||||
let i = 0;
|
||||
const origVals = {};
|
||||
mapMcpHeaderLines(orig || '', function (line, m) { origVals[headerNameOf(m)] = m[3]; return line; });
|
||||
return mapMcpHeaderLines(submitted, function (line, m) {
|
||||
if (m[3] !== MCP_HEADER_MASK) return line; // 用户改过,保留手输新值
|
||||
const ov = i < origVals.length ? origVals[i] : '';
|
||||
i++;
|
||||
return m[1] + m[2] + ov + m[2];
|
||||
const name = headerNameOf(m);
|
||||
if (!(name in origVals)) throw new Error('Header「' + name + '」的值为脱敏占位且找不到原值,请填写真实值');
|
||||
return m[1] + m[2] + origVals[name] + m[2];
|
||||
});
|
||||
}
|
||||
// 整文件编辑的还原链:掩码占位按原文件回填真值;还原不了属于用户输入问题,回 400
|
||||
function unmaskText(text, origText) {
|
||||
try {
|
||||
return restoreApiKeys(restorePasswords(restoreMcpHeaders(text, origText), origText), origText);
|
||||
} catch (e) {
|
||||
e.status_code = 400;
|
||||
throw e;
|
||||
}
|
||||
}
|
||||
// PATCH 细粒度编辑的 headers 还原:值=掩码占位时按键名找回原值(前端只持有脱敏视图,改不动真值)。
|
||||
// 找不到可还原的原值(新增服务/用户改了 header 名)则报错,绝不把占位符写进配置。
|
||||
function restoreHeaderMasks(headers, origHeaders) {
|
||||
@@ -168,13 +239,22 @@ function restoreMaskedHeaderEdit(e, curCfg) {
|
||||
if (e.delete) return;
|
||||
const p = e.path;
|
||||
if (p[0] !== 'mcp_servers') return;
|
||||
const origOf = (i) => (((curCfg || {}).mcp_servers || [])[Number(i)] || {}).headers || {};
|
||||
if (e.append) { // 新增服务没有“原值”可言,出现占位即拒绝
|
||||
if (e.value && e.value.headers) restoreHeaderMasks(e.value.headers, null);
|
||||
return;
|
||||
}
|
||||
if (p.length === 3 && p[2] === 'headers' && e.value && typeof e.value === 'object') {
|
||||
const orig = (((curCfg || {}).mcp_servers || [])[Number(p[1])] || {}).headers || {};
|
||||
restoreHeaderMasks(e.value, orig);
|
||||
restoreHeaderMasks(e.value, origOf(p[1]));
|
||||
return;
|
||||
}
|
||||
// 单个 header 的叶子写入(如 ['mcp_servers',0,'headers','Authorization'])同样要按键名还原;
|
||||
// 漏了这一支会把 ***** 当真值写进 config.yml(前端引导表单不走这条路,但 API 可直达)。
|
||||
if (p.length === 4 && p[2] === 'headers' && e.value === MCP_HEADER_MASK) {
|
||||
const one = {};
|
||||
one[p[3]] = MCP_HEADER_MASK;
|
||||
restoreHeaderMasks(one, origOf(p[1]));
|
||||
e.value = one[p[3]];
|
||||
}
|
||||
}
|
||||
|
||||
@@ -186,7 +266,7 @@ function maskEffective(cfg) {
|
||||
}));
|
||||
c.mcp_servers = (cfg.mcp_servers || []).map(s => {
|
||||
const headers = {};
|
||||
for (const [k, v] of Object.entries(s.headers || {})) headers[k] = maskHeaderValue(v);
|
||||
for (const [k, v] of Object.entries(s.headers || {})) headers[k] = maskHeaderValue(k, v);
|
||||
return Object.assign({}, s, { headers });
|
||||
});
|
||||
c.models = (cfg.models || []).map(m => Object.assign({}, m, { api_key: maskKey(m.api_key) }));
|
||||
@@ -215,13 +295,23 @@ router.get('/', wrap((req, res) => {
|
||||
res.json({ config_path: cfg.config_path || '', exists: text !== null, text: shown, effective: eff, balance_types: balance.types() });
|
||||
}));
|
||||
|
||||
// 预设模板(前端新增平台 / 添加内置 MCP 用)
|
||||
router.get('/presets', wrap((req, res) => { res.json(PRESETS); }));
|
||||
|
||||
// MCP 运行态连接状态(设置页卡片上的「已连接 / 未连接」):只读快照,
|
||||
// 来自 mcp.init 的工具发现结果(含重试阶梯的更新)。重启前改 header 不会反映出来
|
||||
// —— 那些情况由页面顶部的「配置已写入,重启后生效」横幅兜底。
|
||||
router.get('/mcp-status', wrap((req, res) => {
|
||||
res.json({ servers: mcp.statuses() });
|
||||
}));
|
||||
|
||||
// 干跑校验(编辑器保存前预检):body { text }
|
||||
// 还原脱敏后的 api_key/password 再校验,避免 diff 误报变更。
|
||||
router.post('/validate', wrap((req, res) => {
|
||||
const text = req.body && req.body.text;
|
||||
if (typeof text !== 'string') return badRequest(res, new Error('body.text 必须是字符串'));
|
||||
const origText = readConfigText(cfgOf()) || '';
|
||||
const restored = restoreApiKeys(restorePasswords(restoreMcpHeaders(text, origText), origText), origText);
|
||||
const restored = unmaskText(text, origText);
|
||||
try {
|
||||
const next = loadConfigFromText(restored, '');
|
||||
res.json({ ok: true, changed: diffTop(cfgOf(), next) });
|
||||
@@ -237,7 +327,7 @@ router.put('/', wrap((req, res) => {
|
||||
const text = req.body && req.body.text;
|
||||
if (typeof text !== 'string') return badRequest(res, new Error('body.text 必须是字符串'));
|
||||
const origText = readConfigText(cfg) || '';
|
||||
const restored = restoreApiKeys(restorePasswords(restoreMcpHeaders(text, origText), origText), origText);
|
||||
const restored = unmaskText(text, origText);
|
||||
let next;
|
||||
try { next = loadConfigFromText(restored, cfg.config_path); } catch (e) { return badRequest(res, e); }
|
||||
writeConfigText(cfg, restored);
|
||||
@@ -261,8 +351,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 {
|
||||
|
||||
@@ -16,17 +16,46 @@ function wrap(fn) {
|
||||
}
|
||||
|
||||
// 附件上传只写任务目录文件(见 routes/files.js),消息正文原样入库,不再拼接任何通知行。
|
||||
// delivery:
|
||||
// live(默认,兼容旧调用方/微信)→ 立即入库;回合在跑时下一轮迭代自动带上
|
||||
// queue → 回合在跑时进待投递队列(不落库),回合收尾后自动发出;不在跑则等价于 live
|
||||
// 「干预 / 立即发送」不走这里,而是对已在队列里的条目做升级(POST /pending/:qid)。
|
||||
router.post('/:id/messages', wrap((req, res) => {
|
||||
const content = String((req.body && req.body.content) || '').trim();
|
||||
if (!content) return res.status(400).json({ error: 'content 不能为空' });
|
||||
// deepThink:是否启用模型该「深度思考」参数(thinking_params 合并进上游请求体)
|
||||
const deepThink = !!(req.body && req.body.deepThink);
|
||||
const delivery = String((req.body && req.body.delivery) || 'live');
|
||||
if (delivery === 'queue') {
|
||||
const r = engine.enqueueMessage(req.params.id, content, { deepThink });
|
||||
log.info('msg', (req.user || '-') + ' ' + req.params.id + ' 用户消息(' +
|
||||
(r.queued ? '排队 ' + r.pending_id : r.delivered || '?') + '):' +
|
||||
content.slice(0, 60).replace(/\s+/g, ' '));
|
||||
return res.json(r);
|
||||
}
|
||||
const r = engine.postUserMessage(req.params.id, content, { deepThink });
|
||||
log.info('msg', (req.user || '-') + ' ' + req.params.id + ' 用户消息(' + (r && r.delivered || '?') + '):' +
|
||||
content.slice(0, 60).replace(/\s+/g, ' '));
|
||||
res.json(r);
|
||||
}));
|
||||
|
||||
// 待投递队列:升级队首(干预 / 立即发送)。
|
||||
// 干预 = 等当前工具跑完/本条回复落库后插话;立即发送 = 杀进程 + abort 流,本回合收尾后立刻发。
|
||||
router.post('/:id/pending/:qid', wrap((req, res) => {
|
||||
const action = String((req.body && req.body.action) || 'interject');
|
||||
if (action !== 'interject' && action !== 'now') {
|
||||
return res.status(400).json({ error: 'action 只能是 interject 或 now' });
|
||||
}
|
||||
const r = engine.promotePending(req.params.id, req.params.qid, action);
|
||||
log.info('msg', (req.user || '-') + ' ' + req.params.id + ' 待投递消息 ' + req.params.qid + ' → ' + action);
|
||||
res.json(r);
|
||||
}));
|
||||
|
||||
// 取消一条待投递消息(条幅上的 ×)。
|
||||
router.delete('/:id/pending/:qid', wrap((req, res) => {
|
||||
res.json(engine.cancelPending(req.params.id, req.params.qid));
|
||||
}));
|
||||
|
||||
|
||||
// 覆盖式编辑:删除该条及其后的历史,再以新内容重开一轮(运行中 409)。
|
||||
router.post('/:id/messages/:mid/edit', wrap((req, res) => {
|
||||
|
||||
@@ -208,6 +208,8 @@ router.get('/:id', wrap((req, res) => {
|
||||
files: listTaskFiles(taskDir),
|
||||
schedule,
|
||||
running: !!(engine.getRun(session.id) || {}).looping,
|
||||
// 待投递队列(刷新/换设备后条幅能原样恢复):只在服务端内存里,重启即空
|
||||
pending: engine.listPending(session.id),
|
||||
has_more: hasMore, // 分页模式下:是否还有更早的历史
|
||||
oldest_id: messages.length ? messages[0].id : null, // 本页最早行 id,作为下一页 before 游标
|
||||
});
|
||||
|
||||
+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 的额外端口
|
||||
|
||||
+6
-11
@@ -5,13 +5,12 @@
|
||||
| 目录 | 容器名 | 作用 | 容器内端口 | MCP 端点 |
|
||||
|---|---|---|---|---|
|
||||
| `web_search/` | `mcp_web_search` | 免费网页搜索(Parallel / Exa,无需 key) | `3000` | `POST /` |
|
||||
| `image_task/` | `mcp_image_task` | 图片生成 / 编辑(智谱原生或任意 OpenAI 兼容 `/images/generations`,单工具 op=create/get) | `3000` | `POST /mcp` |
|
||||
| `image_task/` | `mcp_image_task` | 图片生成 / 编辑(文生图走 `/images/generations`,图生图走 `/images/edits`,单工具 op=create/get) | `3000` | `POST /mcp` |
|
||||
| `video_task/` | `mcp_video_task` | 智谱 CogVideo 视频生成(异步,单工具 op=create/get) | `3000` | `POST /mcp` |
|
||||
| `asr/` | `mcp_asr` | 语音转文字(上游 OpenAI 兼容 `/audio/transcriptions`),**额外带一个给输入框用的 `POST /transcribe`** | `3000` | `POST /mcp` |
|
||||
|
||||
**这些服务一个宿主机端口都不占**——它们只挂在 `agent-mcp-net` 上,由 `agent-core` / `agent-executor`
|
||||
按容器名访问。所以整台服务器对外只需要开 agent-core 那一个端口(`AGENT_PORT`,默认 8090)。
|
||||
(要从宿主机 curl 调试时,把根 `docker-compose.yml` 里对应服务注释掉的 `ports` 两行打开。)
|
||||
|
||||
## 部署
|
||||
|
||||
@@ -48,8 +47,9 @@ mcp_servers:
|
||||
|
||||
`image_task` / `video_task` 的 token **不由服务端保存**——每个请求从 `Authorization` header 读取
|
||||
(agent 侧配在 `config.yml` 的 `mcp_servers[].headers`)。`video_task` 用智谱 token;
|
||||
`image_task` 用对应上游(智谱或 OpenAI 兼容网关)的 token,上游地址与模型分别由
|
||||
`X-Image-Task-Base-Url` / `X-Image-Task-Model` 指定。所以这两个服务不用配任何密钥。
|
||||
`image_task` 走任意 OpenAI 兼容的 images 上游:文生图 `/images/generations`、图生图 `/images/edits`,
|
||||
上游地址与模型分别由 `X-Image-Task-Base-Url` / `X-Image-Task-Model` 指定(两者都必填)。
|
||||
所以这两个服务不用配任何密钥。
|
||||
|
||||
`asr` 同理:上游的 key / base_url / model 全部由调用方随请求 header 带入
|
||||
(`Authorization` / `X-ASR-Base-Url` / `X-ASR-Model`,agent 侧配在 `config.yml` 的
|
||||
@@ -59,13 +59,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 关心)
|
||||
|
||||
|
||||
+53
-90
@@ -3,12 +3,9 @@
|
||||
一个基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 的图片生成 / 编辑服务。
|
||||
对外只有一个工具 `image_task`,用 `op` 区分动作(`create` / `get`),异步任务契约与 `video_task` 一致。
|
||||
|
||||
上游支持两种协议,由 `X-Image-Task-Base-Url` 选择:
|
||||
|
||||
| 通道 | 上游 | 请求体 |
|
||||
|---|---|---|
|
||||
| 智谱原生 | `https://open.bigmodel.cn/api/paas/v4/images/generations` | `{ model, prompt }` |
|
||||
| OpenAI 兼容 | 任意实现 `/images/generations` 的网关(如 `https://wb.ai.foresh.com/v1`) | `{ model, prompt, n: 1, response_format: "url", images? }` |
|
||||
上游必须是 OpenAI 兼容的 images 端点:文生图走 `/images/generations`,图生图走 `/images/edits`
|
||||
(智谱、各类网关走同一套协议)。`X-Image-Task-Base-Url` / `X-Image-Task-Model` / `Authorization`
|
||||
三个 header 都必填,服务不存密钥、也不预设厂商或默认模型。
|
||||
|
||||
- 协议:MCP **Streamable HTTP**(单端点 `/mcp`,支持 SSE 流)
|
||||
- 端口:容器内 `3000`(**不映射宿主机**,只在 `agent-mcp-net` 内被 agent 访问)
|
||||
@@ -25,8 +22,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
|
||||
# 不占端口的健康检查
|
||||
@@ -43,7 +40,7 @@ docker exec mcp_image_task node -e "fetch('http://localhost:3000/health').then(r
|
||||
"url": "http://localhost:8082/mcp",
|
||||
"headers": {
|
||||
"Authorization": "Bearer <upstream-api-key>",
|
||||
"X-Image-Task-Base-Url": "zhipu",
|
||||
"X-Image-Task-Base-Url": "https://open.bigmodel.cn/api/paas/v4",
|
||||
"X-Image-Task-Model": "CogView-4"
|
||||
}
|
||||
}
|
||||
@@ -78,13 +75,14 @@ docker exec mcp_image_task node -e "fetch('http://localhost:3000/health').then(r
|
||||
|
||||
`image` 是模式开关:
|
||||
|
||||
- 不传 → **文生图**;
|
||||
- 传一个公网 URL → **图生图 / 编辑**。
|
||||
- 不传 → **文生图**,请求 `POST <base>/images/generations`;
|
||||
- 传一个公网 URL → **图生图 / 编辑**,服务先把这张图拉下来,再以 multipart 上传到
|
||||
`POST <base>/images/edits`。
|
||||
|
||||
本地图片先用 `mint_public_link` 换成公网 URL,再传给 `image`。
|
||||
|
||||
> 尺寸、质量、模型、上游地址都**不是**工具参数:它们属于部署策略,由调用方在 header 里固定,
|
||||
> 避免 AI 乱填尺寸档位或模型名白烧额度。智谱原生通道也不接受尺寸,直接走上游默认值。
|
||||
> 避免 AI 乱填尺寸档位或模型名白烧额度。尺寸/质量直接走上游默认值。
|
||||
|
||||
### 返回
|
||||
|
||||
@@ -93,7 +91,7 @@ docker exec mcp_image_task node -e "fetch('http://localhost:3000/health').then(r
|
||||
```jsonc
|
||||
{
|
||||
"content": [
|
||||
{ "type": "text", "text": "Model: CogView-4\nProvider: zhipu\nMode: text-to-image\ntask_id: <uuid>\ntask_status: PROCESSING\n\nImage generation is running in background. Call this tool again with op=\"get\" and task_id=\"<uuid>\" to fetch the result." }
|
||||
{ "type": "text", "text": "Model: CogView-4\nMode: text-to-image\ntask_id: <uuid>\ntask_status: PROCESSING\n\nImage generation is running in background. Call this tool again with op=\"get\" and task_id=\"<uuid>\" to fetch the result." }
|
||||
]
|
||||
}
|
||||
```
|
||||
@@ -106,7 +104,7 @@ docker exec mcp_image_task node -e "fetch('http://localhost:3000/health').then(r
|
||||
```jsonc
|
||||
{
|
||||
"content": [
|
||||
{ "type": "text", "text": "task_id: <uuid>\nmodel: CogView-4\nprovider: zhipu\nelapsed: 12s\ntask_status: SUCCESS\nImage URL: https://..." }
|
||||
{ "type": "text", "text": "task_id: <uuid>\nmodel: CogView-4\nelapsed: 12s\ntask_status: SUCCESS\nImage URL: https://..." }
|
||||
]
|
||||
}
|
||||
```
|
||||
@@ -122,70 +120,53 @@ URL 由上游签名下发,**带有效期**(通常 24h),需要长期保
|
||||
| Header | 必填 | 说明 |
|
||||
|---|---|---|
|
||||
| `Authorization` | ✅ | `Bearer <key>`,原样作为上游 Bearer token |
|
||||
| `X-Image-Task-Base-Url` | ❌ | 别名或完整 URL;缺省 `zhipu` |
|
||||
| `X-Image-Task-Model` | 见下 | 模型名原样透传 |
|
||||
| `X-Image-Task-Base-Url` | ✅ | 上游 base URL(完整 `http(s)` 地址,如 `https://<host>/v1`);若已给到 `/images/generations` 或 `/images/edits` 会自动剥回 base,再按模式拼端点 |
|
||||
| `X-Image-Task-Model` | ✅ | 模型名原样透传 |
|
||||
|
||||
### Base-Url 别名
|
||||
|
||||
| 值 | 实际地址 | 协议 |
|
||||
|---|---|---|
|
||||
| `zhipu`(默认) | `https://open.bigmodel.cn/api/paas/v4` | 智谱原生 |
|
||||
|
||||
其余值必须是完整的 `http(s)` URL:
|
||||
|
||||
```yaml
|
||||
X-Image-Task-Base-Url: "https://wb.ai.foresh.com/v1"
|
||||
```
|
||||
|
||||
- 已经给到 `/images/generations` 全路径就直接用,否则自动补 `/images/generations`。
|
||||
- 解析后的 host 是 `bigmodel.cn`(含子域)→ 智谱原生请求体;其余 host → OpenAI 兼容请求体。
|
||||
- 因此把网关地址填进来即可,不需要额外指定“用哪家协议”。
|
||||
|
||||
### 模型
|
||||
|
||||
| 场景 | `X-Image-Task-Model` |
|
||||
|---|---|
|
||||
| Base-Url = `zhipu` | 可省略,缺省 `CogView-3-Flash` |
|
||||
| 其他 Base-Url | **必填**(不会把 CogView 误发到网关) |
|
||||
|
||||
模型只由 header 决定,AI 看不到也填不了。换模型 = 改 header 后重启 core。
|
||||
地址与模型只由 header 决定,AI 看不到也填不了;换模型 = 改 header 后重启 core。
|
||||
|
||||
### 图生图
|
||||
|
||||
`image` 只对 OpenAI 兼容通道生效:
|
||||
图生图**不能**走 `/images/generations`,必须走 `/images/edits`。服务会先把 `image` URL 下载成字节
|
||||
(独立 60s 超时,单图上限 20MB,响应需是 `image/*`,如 png / jpeg / webp / gif / bmp),再以 multipart 上传:
|
||||
|
||||
| Base-Url | 传 `image` |
|
||||
|---|---|
|
||||
| `zhipu` | 直接返回错误:智谱不支持图生图(只做文生图) |
|
||||
| 网关 URL | 上游请求体带 `images: [url]` |
|
||||
```text
|
||||
POST <base>/images/edits
|
||||
Content-Type: multipart/form-data; boundary=...
|
||||
|
||||
### 请求体差异
|
||||
model=<header 里的模型>
|
||||
prompt=<prompt>
|
||||
image=@<下载到的参考图> # 字段名 image,文件名按 MIME 补扩展名
|
||||
n=1
|
||||
response_format=url
|
||||
```
|
||||
|
||||
| 字段 | 智谱原生 | OpenAI 兼容 |
|
||||
|---|---|---|
|
||||
| `model` / `prompt` | ✅ | ✅ |
|
||||
| `n` | ❌ | 固定 `1` |
|
||||
| `response_format` | ❌ | 固定 `"url"` |
|
||||
| `size` / `quality` | ❌ | ❌(交给上游默认值) |
|
||||
| `images` | ❌ | 传图时带,数组形式 `[url]` |
|
||||
选 multipart 而不是 JSON + base64 data URL:参考图已经在本地手里,直接当文件传可省掉 base64 的
|
||||
1/3 体积膨胀,也避开网关对超大 JSON 体的限制。
|
||||
|
||||
### 请求体
|
||||
|
||||
- 文生图:JSON `{ model, prompt, n: 1, response_format: "url" }` → `/images/generations`
|
||||
- 图生图:multipart(字段见上)→ `/images/edits`
|
||||
|
||||
`size` / `quality` 一律不传,交给上游默认值。两种模式的成功响应都按 `data[0].url` 取图。
|
||||
|
||||
---
|
||||
|
||||
## 配置示例
|
||||
|
||||
### 智谱直连(默认)
|
||||
智谱与网关走同一套协议,只换地址与模型:
|
||||
|
||||
```yaml
|
||||
- name: image_task
|
||||
url: "http://mcp_image_task:3000/mcp"
|
||||
headers:
|
||||
Authorization: "Bearer <智谱 KEY>"
|
||||
Authorization: "Bearer <KEY>"
|
||||
X-Image-Task-Base-Url: "https://open.bigmodel.cn/api/paas/v4"
|
||||
X-Image-Task-Model: "CogView-4"
|
||||
mode: skill
|
||||
```
|
||||
|
||||
### OpenAI 兼容网关(文生图)
|
||||
|
||||
```yaml
|
||||
- name: image_task
|
||||
url: "http://mcp_image_task:3000/mcp"
|
||||
@@ -196,20 +177,6 @@ X-Image-Task-Base-Url: "https://wb.ai.foresh.com/v1"
|
||||
mode: skill
|
||||
```
|
||||
|
||||
### OpenAI 兼容网关(图生图 / 修图)
|
||||
|
||||
```yaml
|
||||
- name: image_task
|
||||
url: "http://mcp_image_task:3000/mcp"
|
||||
headers:
|
||||
Authorization: "Bearer <网关 KEY>"
|
||||
X-Image-Task-Base-Url: "https://wb.ai.foresh.com/v1"
|
||||
X-Image-Task-Model: "cn:hunyuan-image-alpha"
|
||||
mode: skill
|
||||
```
|
||||
|
||||
同一个网关换模型只改 `X-Image-Task-Model`;换供应商只改 `X-Image-Task-Base-Url`。
|
||||
|
||||
---
|
||||
|
||||
## 错误响应
|
||||
@@ -217,17 +184,18 @@ X-Image-Task-Base-Url: "https://wb.ai.foresh.com/v1"
|
||||
| 场景 | HTTP 状态 | 表现 |
|
||||
|---|---|---|
|
||||
| 缺 `Authorization` | `200`(MCP 工具返回) | `isError: true`,提示补 header |
|
||||
| `X-Image-Task-Base-Url` 非法 | `200`(MCP 工具返回) | `isError: true`,列出可用别名 |
|
||||
| 非 zhipu 通道缺 `X-Image-Task-Model` | `200`(MCP 工具返回) | `isError: true`,提示补 header |
|
||||
| zhipu 通道传了 `image` | `200`(MCP 工具返回) | `isError: true`,提示智谱不支持图生图,改用 OpenAI 兼容端点 |
|
||||
| 缺 `X-Image-Task-Base-Url` / 不是完整 http(s) URL | `200`(MCP 工具返回) | `isError: true`,提示填完整地址 |
|
||||
| 缺 `X-Image-Task-Model` | `200`(MCP 工具返回) | `isError: true`,提示补 header |
|
||||
| `image` 不是公网 http(s) URL | `200`(MCP 工具返回) | `isError: true`,提示只接受公网 URL,不接受文件上传 / base64 |
|
||||
| 参考图下载失败 / 超时(>60s)/ 超过 20MB / 不是图片 | `200`(MCP 工具返回) | 在 `op=get` 中以 `task_status: FAIL` 呈现,错误直述下载环节 |
|
||||
| `op=create` 缺 prompt / `op=get` 缺 task_id | `200`(MCP 工具返回) | `isError: true`,参数提示 |
|
||||
| `op=get` 查不到任务 | `200`(MCP 工具返回) | `isError: true`,提示 unknown task_id |
|
||||
| 上游 4xx/5xx | `200`(MCP 工具返回) | 在 `op=get` 中以 `task_status: FAIL` 呈现,正文含上游状态码和 body |
|
||||
| 上游只回 `b64_json` | `200`(MCP 工具返回) | `task_status: FAIL`,提示本服务只接受 URL |
|
||||
| 网络失败 / 超时(>180s) | `200`(MCP 工具返回) | `task_status: FAIL`,不会出现永久 PROCESSING 的僵尸任务 |
|
||||
|
||||
> JSON 请求体上限保持 2MB:`image` 只接受 URL,不接收文件或 base64。
|
||||
> JSON 请求体上限保持 2MB:工具参数里的 `image` 只接受 URL,不接收文件或 base64。
|
||||
> 参考图由服务自己下载后以 multipart 转发给上游,不经过 MCP 请求体。
|
||||
|
||||
---
|
||||
|
||||
@@ -264,11 +232,12 @@ curl -s -X POST http://localhost:8082/mcp \
|
||||
-H "Mcp-Session-Id: $SESSION" \
|
||||
-d '{"jsonrpc": "2.0", "method": "notifications/initialized"}'
|
||||
|
||||
# 3. 文生图(智谱通道;换成网关时补 X-Image-Task-Base-Url / X-Image-Task-Model)
|
||||
# 3. 文生图(三个 header 都必填)
|
||||
curl -s -X POST http://localhost:8082/mcp \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "Accept: application/json, text/event-stream" \
|
||||
-H "Authorization: Bearer $TOKEN" \
|
||||
-H "X-Image-Task-Base-Url: https://open.bigmodel.cn/api/paas/v4" \
|
||||
-H "X-Image-Task-Model: CogView-4" \
|
||||
-H "Mcp-Session-Id: $SESSION" \
|
||||
-d '{
|
||||
@@ -284,7 +253,7 @@ curl -s -X POST http://localhost:8082/mcp \
|
||||
}
|
||||
}'
|
||||
|
||||
# 4. 图生图(OpenAI 兼容通道)
|
||||
# 4. 图生图
|
||||
curl -s -X POST http://localhost:8082/mcp \
|
||||
-H "Content-Type: application/json" \
|
||||
-H "Accept: application/json, text/event-stream" \
|
||||
@@ -353,18 +322,10 @@ image_task/
|
||||
- token / 上游地址 / 模型在 `create` 那一刻从请求 header 捕获进闭包,后台完成前不再读取
|
||||
- **每 session 一个 transport + server**:通过 `Mcp-Session-Id` 复用
|
||||
- **模型 / 上游地址不入 schema**:只从 HTTP header 读取,AI 不可见
|
||||
- **`image` 单一开关**:不传 = 文生图,传一个公网 URL = 图生图;`image` 是单个字符串,只接受公网 `http(s)` URL
|
||||
- **`image` 单一开关**:不传 = 文生图(`/images/generations`),传一个公网 URL = 图生图
|
||||
(下载后 multipart 上传 `/images/edits`);`image` 是单个字符串,只接受公网 `http(s)` URL
|
||||
- **URL 提取**:只接受 `data[].url` 形式的 http(s) URL;上游若回 `b64_json` 则记 `FAIL` 并给出明确错误
|
||||
|
||||
### 默认模型
|
||||
|
||||
```js
|
||||
// src/mcp-server.js
|
||||
const DEFAULT_MODEL = "CogView-3-Flash"; // 仅 Base-Url=zhipu 时生效
|
||||
```
|
||||
|
||||
修改后 `docker compose up -d --build mcp_image_task` 即可生效。
|
||||
|
||||
---
|
||||
|
||||
## 常见问题
|
||||
@@ -378,11 +339,13 @@ A: 不需要重建 session,但 core 的 `mcp_servers[].headers` 是启动时
|
||||
**Q: 为什么只支持一张参考图?**
|
||||
A: 当前上游契约只稳定支持单张;`image` 因此是单个 URL 字符串。
|
||||
|
||||
**Q: 图生图为什么在 zhipu 通道报错?**
|
||||
A: 智谱原生接口不支持图生图。把 `X-Image-Task-Base-Url` 指向支持 `images` 字段的 OpenAI 兼容网关即可。
|
||||
**Q: 图生图报错?**
|
||||
A: 图生图走 `/images/edits` + multipart(字段名 `image`)。若上游模型不支持编辑、或网关不认这种入参,
|
||||
上游会回 4xx,在 `op=get` 里以 `task_status: FAIL` 呈现。换一个支持 `/images/edits` 的模型即可。
|
||||
|
||||
**Q: 本地图片怎么传?**
|
||||
A: 先调用 agent 内置的 `mint_public_link` 工具,把会话目录里的文件换成短期公网 URL,再传给 `image`。本服务不接受文件上传或 base64,上游服务器也无法访问你的本地路径。
|
||||
A: 先调用 agent 内置的 `mint_public_link` 工具,把会话目录里的文件换成短期公网 URL,再传给 `image`。
|
||||
本服务不接受文件上传或 base64(MCP 请求体不放图片字节),参考图由服务自己从这个 URL 拉取。
|
||||
|
||||
**Q: 上游是同步接口,为什么对外做成异步?**
|
||||
A: 和 `video_task` 保持同一套任务型契约;同时避免一次生图把 core 的 `tools/call` 拖超时。
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "mcp_image_task",
|
||||
"version": "1.0.0",
|
||||
"description": "MCP server for image generation and editing via Zhipu BigModel CogView or any OpenAI-compatible /images/generations endpoint (single tool image_task with op=create/get)",
|
||||
"description": "MCP server for image generation and editing via any OpenAI-compatible images API (/images/generations and /images/edits), single tool image_task with op=create/get",
|
||||
"type": "module",
|
||||
"main": "src/mcp-server.js",
|
||||
"scripts": {
|
||||
|
||||
@@ -6,20 +6,19 @@ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/
|
||||
import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
|
||||
import { z } from "zod";
|
||||
|
||||
// 上游地址既支持完整 URL,也支持别名。zhipu 走智谱原生协议(body 只有
|
||||
// model/prompt);其余地址一律按 OpenAI 兼容的 /images/generations 协议
|
||||
// (body 加 n / response_format=url)。别名目前只保留 zhipu。
|
||||
const BASE_URL_ALIASES = {
|
||||
zhipu: "https://open.bigmodel.cn/api/paas/v4",
|
||||
};
|
||||
// 只有智谱需要走原生请求体,其余主机一律按 OpenAI 兼容处理。
|
||||
const ZHIPU_HOST_SUFFIX = "bigmodel.cn";
|
||||
const DEFAULT_MODEL = "CogView-3-Flash";
|
||||
// 上游必须是 OpenAI 兼容的端点:文生图走 /images/generations,图生图走 /images/edits。
|
||||
// Base-Url / 模型 / 凭据全部由调用方随每个请求用 header 带入(X-Image-Task-Base-Url /
|
||||
// X-Image-Task-Model / Authorization),服务自己不存、也不预设任何厂商。
|
||||
|
||||
// 上游同步调用耗时上限(出图几十秒量级,留足余量)。
|
||||
// 超时后任务记为 FAIL,避免上游挂而不回时永远卡在 PROCESSING。
|
||||
const UPSTREAM_TIMEOUT_MS = 180_000;
|
||||
|
||||
// 图生图要先把参考图拉成字节再 multipart 上传:下载超时与体积都要单独兜底,
|
||||
// 否则慢 CDN 会拖死任务、超大原图会顶满容器内存。
|
||||
const IMAGE_DOWNLOAD_TIMEOUT_MS = 60_000;
|
||||
const MAX_IMAGE_BYTES = 20 * 1024 * 1024;
|
||||
|
||||
// ── 优雅退出 ──────────────────────────────────────────────────────────────
|
||||
// 容器里 node 以 PID 1 运行且未注册 SIGTERM 处理器时,内核不会对其执行默认
|
||||
// 终止动作,docker stop/restart 会白等满 10s 宽限期才被 SIGKILL。
|
||||
@@ -84,45 +83,36 @@ function pickModel(headers) {
|
||||
return pickHeaderString(headers, "x-image-task-model");
|
||||
}
|
||||
|
||||
// 解析 Base-Url:别名优先,否则必须是 http(s) URL。
|
||||
// 返回 { provider, url }:url 是最终 POST 的完整地址。
|
||||
function resolveEndpoint(rawBase) {
|
||||
const raw = String(rawBase || "zhipu").trim().replace(/\/+$/, "");
|
||||
const alias = BASE_URL_ALIASES[raw.toLowerCase()];
|
||||
const base = alias || raw;
|
||||
|
||||
let host;
|
||||
try {
|
||||
if (!/^https?:\/\//i.test(base)) throw new Error("not http(s)");
|
||||
host = new URL(base).hostname.toLowerCase();
|
||||
} catch {
|
||||
// 解析 Base-Url:必须是完整 http(s) URL。允许调用方直接填到 /images/generations 或
|
||||
// /images/edits(老配置、照抄文档的写法),统一剥回 base,端点由 mode 决定——
|
||||
// 否则图生图会被错发到 generations。
|
||||
function resolveBaseUrl(rawBase) {
|
||||
const base = String(rawBase || "").trim().replace(/\/+$/, "");
|
||||
if (!base) {
|
||||
throw new Error(
|
||||
`Invalid X-Image-Task-Base-Url "${raw}": use an alias (${Object.keys(BASE_URL_ALIASES).join(", ")}) ` +
|
||||
"or a full http(s) URL."
|
||||
"Missing X-Image-Task-Base-Url: pass the upstream base URL (e.g. https://<host>/v1)."
|
||||
);
|
||||
}
|
||||
|
||||
// 已经给到 /images/generations 就直接用;否则补在 base 后面。
|
||||
const url = /\/images\/generations$/i.test(base)
|
||||
? base
|
||||
: base + "/images/generations";
|
||||
const provider =
|
||||
host === ZHIPU_HOST_SUFFIX || host.endsWith("." + ZHIPU_HOST_SUFFIX)
|
||||
? "zhipu"
|
||||
: "openai";
|
||||
return { provider, url };
|
||||
if (!/^https?:\/\//i.test(base)) {
|
||||
throw new Error(
|
||||
`Invalid X-Image-Task-Base-Url "${base}": must be a full http(s) URL.`
|
||||
);
|
||||
}
|
||||
return base.replace(/\/images\/(generations|edits)$/i, "");
|
||||
}
|
||||
|
||||
// 模型只由 header 决定,AI 看不到也填不了。
|
||||
// zhipu 通道有默认模型;其他通道必须显式给 —— 否则会把 CogView 发到网关,
|
||||
// 换来的只是一个含义不明的 400。
|
||||
function resolveModel(headers, provider) {
|
||||
// mode=edit 走 /images/edits(图生图),否则走 /images/generations(文生图)。
|
||||
function resolveEndpoint(base, mode) {
|
||||
return base + (mode === "edit" ? "/images/edits" : "/images/generations");
|
||||
}
|
||||
|
||||
// 模型只由 header 决定,AI 看不到也填不了。不猜缺省值:猜错只会换来含义不明的 400。
|
||||
function resolveModel(headers) {
|
||||
const model = pickModel(headers);
|
||||
if (model) return model;
|
||||
if (provider === "zhipu") return DEFAULT_MODEL;
|
||||
throw new Error(
|
||||
"X-Image-Task-Model is required when X-Image-Task-Base-Url is not the zhipu alias."
|
||||
);
|
||||
if (!model) {
|
||||
throw new Error("Missing X-Image-Task-Model: pass the upstream model name.");
|
||||
}
|
||||
return model;
|
||||
}
|
||||
|
||||
// 一次解析出本次请求的上游、凭据、模型。
|
||||
@@ -132,31 +122,24 @@ function resolveTarget(headers) {
|
||||
if (!token) {
|
||||
throw new Error('Missing Authorization: use "Authorization: Bearer <token>".');
|
||||
}
|
||||
const { provider, url } = resolveEndpoint(pickBaseUrl(headers));
|
||||
return { provider, url, token, model: resolveModel(headers, provider) };
|
||||
return {
|
||||
base: resolveBaseUrl(pickBaseUrl(headers)),
|
||||
token,
|
||||
model: resolveModel(headers),
|
||||
};
|
||||
}
|
||||
|
||||
async function callImagesGenerations({ provider, url, token, model, prompt, image }) {
|
||||
// 智谱原生只认 model/prompt;OpenAI 兼容通道固定单图,并要求返回 URL
|
||||
// (b64_json 几十 MB,既塞不进任务表也没法给模型看)。尺寸/质量一律不传,
|
||||
// 交给上游默认值 —— 各家(尤其 CogView)对尺寸的限制并不一致。
|
||||
// 传了 image 就是图生图;上游字段是数组,所以这里包一层。
|
||||
const body =
|
||||
provider === "zhipu"
|
||||
? { model, prompt }
|
||||
: Object.assign(
|
||||
{ model, prompt, n: 1, response_format: "url" },
|
||||
image ? { images: [image] } : null
|
||||
);
|
||||
// 统一的上游 POST:超时、错误体解析都在这层,JSON 与 multipart 共用。
|
||||
// contentType 为空表示交给 fetch 自己写(multipart 必须这样,boundary 由它生成)。
|
||||
async function postUpstream({ url, token, body, contentType }) {
|
||||
const headers = { Authorization: `Bearer ${token}` };
|
||||
if (contentType) headers["Content-Type"] = contentType;
|
||||
let resp;
|
||||
try {
|
||||
resp = await fetch(url, {
|
||||
method: "POST",
|
||||
headers: {
|
||||
Authorization: `Bearer ${token}`,
|
||||
"Content-Type": "application/json",
|
||||
},
|
||||
body: JSON.stringify(body),
|
||||
headers,
|
||||
body,
|
||||
signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS),
|
||||
});
|
||||
} catch (e) {
|
||||
@@ -175,9 +158,8 @@ async function callImagesGenerations({ provider, url, token, model, prompt, imag
|
||||
data = { raw: text };
|
||||
}
|
||||
if (!resp.ok) {
|
||||
const label = provider === "zhipu" ? "Zhipu" : "OpenAI-compatible";
|
||||
const err = new Error(
|
||||
`${label} API error: ${resp.status} ${resp.statusText} - ${text}`
|
||||
`Upstream API error: ${resp.status} ${resp.statusText} - ${text}`
|
||||
);
|
||||
err.status = resp.status;
|
||||
err.detail = data;
|
||||
@@ -186,6 +168,126 @@ async function callImagesGenerations({ provider, url, token, model, prompt, imag
|
||||
return data;
|
||||
}
|
||||
|
||||
const MIME_TO_EXT = {
|
||||
"image/png": "png",
|
||||
"image/jpeg": "jpg",
|
||||
"image/webp": "webp",
|
||||
"image/gif": "gif",
|
||||
"image/bmp": "bmp",
|
||||
};
|
||||
const EXT_TO_MIME = {
|
||||
png: "image/png",
|
||||
jpg: "image/jpeg",
|
||||
jpeg: "image/jpeg",
|
||||
webp: "image/webp",
|
||||
gif: "image/gif",
|
||||
bmp: "image/bmp",
|
||||
};
|
||||
|
||||
function urlExtension(url) {
|
||||
try {
|
||||
const m = /\.([a-z0-9]+)$/i.exec(new URL(url).pathname);
|
||||
return m ? m[1].toLowerCase() : "";
|
||||
} catch {
|
||||
return "";
|
||||
}
|
||||
}
|
||||
|
||||
// 判定参考图的 MIME:优先响应头,其次 URL 扩展名。响应头只要声明是 image/* 就放行
|
||||
// (avif / tiff 这类冷门格式交给上游判断),避免本地图片被我们提前拒掉。
|
||||
// 两者都不是图片就报错——典型情况是链接过期后拿到 HTML 错误页,继续上传只会换来
|
||||
// 上游一句难懂的 400。
|
||||
function pickImageMime(contentType, url) {
|
||||
const ct = String(contentType || "").split(";")[0].trim().toLowerCase();
|
||||
if (/^image\/[a-z0-9.+-]+$/.test(ct)) return ct;
|
||||
const mime = EXT_TO_MIME[urlExtension(url)];
|
||||
if (mime) return mime;
|
||||
throw new Error(
|
||||
`Reference image is not an image: content-type "${ct || "none"}" (${url}).`
|
||||
);
|
||||
}
|
||||
|
||||
// multipart 里的文件名按 MIME 补扩展名;冷门 image/* 就把子类型当年扩展名。
|
||||
function extensionForMime(mime) {
|
||||
return (
|
||||
MIME_TO_EXT[mime] ||
|
||||
mime.slice("image/".length).replace(/[^a-z0-9]/g, "") ||
|
||||
"img"
|
||||
);
|
||||
}
|
||||
|
||||
// 图生图需要真实字节:先把 image URL 拉下来。带独立超时与体积上限,错误直述下载环节,
|
||||
// 便于区分「参考图挂了」和「上游出图失败」。
|
||||
async function downloadImage(url) {
|
||||
let resp;
|
||||
try {
|
||||
resp = await fetch(url, {
|
||||
signal: AbortSignal.timeout(IMAGE_DOWNLOAD_TIMEOUT_MS),
|
||||
});
|
||||
} catch (e) {
|
||||
if (e?.name === "TimeoutError" || e?.name === "AbortError") {
|
||||
throw new Error(
|
||||
`Failed to download reference image: timed out after ${IMAGE_DOWNLOAD_TIMEOUT_MS} ms (${url})`
|
||||
);
|
||||
}
|
||||
throw new Error(`Failed to download reference image: ${e.message} (${url})`);
|
||||
}
|
||||
if (!resp.ok) {
|
||||
throw new Error(
|
||||
`Failed to download reference image: ${resp.status} ${resp.statusText} (${url})`
|
||||
);
|
||||
}
|
||||
const declared = Number(resp.headers.get("content-length") || 0);
|
||||
if (declared > MAX_IMAGE_BYTES) {
|
||||
throw new Error(
|
||||
`Reference image is too large: ${declared} bytes (limit ${MAX_IMAGE_BYTES}) (${url})`
|
||||
);
|
||||
}
|
||||
// 不直接 arrayBuffer():没有 content-length 的响应会一路读进内存,
|
||||
// 这里边读边计数,超限立刻中止(断掉上游连接)。
|
||||
const chunks = [];
|
||||
let total = 0;
|
||||
for await (const chunk of resp.body) {
|
||||
total += chunk.length;
|
||||
if (total > MAX_IMAGE_BYTES) {
|
||||
throw new Error(
|
||||
`Reference image is too large: >${MAX_IMAGE_BYTES} bytes (limit ${MAX_IMAGE_BYTES}) (${url})`
|
||||
);
|
||||
}
|
||||
chunks.push(chunk);
|
||||
}
|
||||
if (total === 0) {
|
||||
throw new Error(`Reference image is empty (${url})`);
|
||||
}
|
||||
const buffer = Buffer.concat(chunks, total);
|
||||
const mime = pickImageMime(resp.headers.get("content-type"), url);
|
||||
return { buffer, mime, filename: `image.${extensionForMime(mime)}` };
|
||||
}
|
||||
|
||||
// 文生图:JSON 体。response_format=url(b64_json 几十 MB,既塞不进任务表也没法给模型看)。
|
||||
// 尺寸/质量一律不传,交给上游默认值。
|
||||
async function callImagesGenerations({ url, token, model, prompt }) {
|
||||
const body = JSON.stringify({ model, prompt, n: 1, response_format: "url" });
|
||||
return postUpstream({ url, token, body, contentType: "application/json" });
|
||||
}
|
||||
|
||||
// 图生图:上游只认 /images/edits,且实测只接受两种入参——
|
||||
// 1) multipart/form-data,image 字段是文件(image=@a.jpg);
|
||||
// 2) application/json,image 字段是 data:image/...;base64,... 的 data URL。
|
||||
// 这里走 multipart:参考图已经在本地手里,直接当文件上传,省掉 base64 的 1/3 体积膨胀,
|
||||
// 也避开网关对超大 JSON 体的限制。响应格式与 generations 一致(data[0].url)。
|
||||
async function callImagesEdits({ url, token, model, prompt, image }) {
|
||||
const ref = await downloadImage(image);
|
||||
const form = new FormData();
|
||||
form.append("model", model);
|
||||
form.append("prompt", prompt);
|
||||
form.append("image", new Blob([ref.buffer], { type: ref.mime }), ref.filename);
|
||||
form.append("n", "1");
|
||||
form.append("response_format", "url");
|
||||
// 不传 Content-Type:fetch 会带上含 boundary 的 multipart/form-data
|
||||
return postUpstream({ url, token, body: form });
|
||||
}
|
||||
|
||||
// 只认 http(s) URL。b64_json 不再当 URL 存:它会把任务表撑爆,模型也读不了。
|
||||
function extractUrls(data) {
|
||||
if (!data) return [];
|
||||
@@ -207,7 +309,7 @@ function hasInlineBase64(data) {
|
||||
}
|
||||
|
||||
// ===== 自维护任务表(异步语义全靠这层模拟) =====
|
||||
// 上游智谱 images 接口是同步阻塞的,但对外要和 video_task 一样提供
|
||||
// 上游智谱/网关的 images 接口是同步阻塞的,但对外要和 video_task 一样提供
|
||||
// create(立即返回 task_id)+ get(轮询结果)的异步契约:
|
||||
// create 登记 PROCESSING 后把同步调用丢到后台跑,get 从表里读最新状态。
|
||||
//
|
||||
@@ -239,14 +341,21 @@ function pruneTasks() {
|
||||
|
||||
// 后台跑同步上游调用,结果回写任务表(fire-and-forget,不 await)
|
||||
function runImageTask({ task, target, prompt, image }) {
|
||||
callImagesGenerations({
|
||||
provider: target.provider,
|
||||
url: target.url,
|
||||
token: target.token,
|
||||
model: target.model,
|
||||
prompt,
|
||||
image,
|
||||
})
|
||||
const upstream = image
|
||||
? callImagesEdits({
|
||||
url: resolveEndpoint(target.base, "edit"),
|
||||
token: target.token,
|
||||
model: target.model,
|
||||
prompt,
|
||||
image,
|
||||
})
|
||||
: callImagesGenerations({
|
||||
url: resolveEndpoint(target.base, "generation"),
|
||||
token: target.token,
|
||||
model: target.model,
|
||||
prompt,
|
||||
});
|
||||
upstream
|
||||
.then((data) => {
|
||||
task.finishedAt = Date.now();
|
||||
const urls = extractUrls(data);
|
||||
@@ -282,7 +391,8 @@ async function handleCreate({ args, headers }) {
|
||||
};
|
||||
}
|
||||
|
||||
// image 是文生图/图生图开关:不传 = 文生图;传一个公网 URL = 修图。
|
||||
// image 是文生图/图生图开关:不传 = 文生图(/images/generations);传一个公网 URL = 修图
|
||||
// (/images/edits,服务会先把这张图拉下来再以 multipart 上传)。
|
||||
// 只接受公网 http(s) URL;本地文件请先由调用方用 mint_public_link 换成公网链接。
|
||||
if (args.image !== undefined && typeof args.image !== "string") {
|
||||
return {
|
||||
@@ -318,26 +428,10 @@ async function handleCreate({ args, headers }) {
|
||||
};
|
||||
}
|
||||
|
||||
// 智谱原生接口不支持图生图;带 image 的请求只能走 OpenAI 兼容端点。
|
||||
if (image && target.provider === "zhipu") {
|
||||
return {
|
||||
isError: true,
|
||||
content: [
|
||||
{
|
||||
type: "text",
|
||||
text:
|
||||
'Image editing is not supported by the configured model. ' +
|
||||
'Remove "image" for text-to-image.',
|
||||
},
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
pruneTasks();
|
||||
const taskId = randomUUID();
|
||||
const task = {
|
||||
status: "PROCESSING",
|
||||
provider: target.provider,
|
||||
model: target.model,
|
||||
prompt,
|
||||
createdAt: Date.now(),
|
||||
@@ -350,7 +444,6 @@ async function handleCreate({ args, headers }) {
|
||||
const mode = image ? "edit" : "text-to-image";
|
||||
const summary =
|
||||
`Model: ${target.model}\n` +
|
||||
`Provider: ${target.provider}\n` +
|
||||
`Mode: ${mode}\n` +
|
||||
`task_id: ${taskId}\n` +
|
||||
`task_status: PROCESSING\n` +
|
||||
@@ -411,7 +504,6 @@ async function handleGet({ args }) {
|
||||
text:
|
||||
`task_id: ${taskId}\n` +
|
||||
`model: ${task.model}\n` +
|
||||
`provider: ${task.provider}\n` +
|
||||
`elapsed: ${elapsed}s\n` +
|
||||
`task_status: PROCESSING\n` +
|
||||
`\n` +
|
||||
@@ -429,7 +521,6 @@ async function handleGet({ args }) {
|
||||
type: "text",
|
||||
text:
|
||||
`task_id: ${taskId}\n` +
|
||||
`provider: ${task.provider}\n` +
|
||||
`elapsed: ${elapsedSeconds(task)}s\n` +
|
||||
`task_status: FAIL\n` +
|
||||
`error: ${task.error}`,
|
||||
@@ -447,7 +538,6 @@ async function handleGet({ args }) {
|
||||
const summary =
|
||||
`task_id: ${taskId}\n` +
|
||||
`model: ${task.model}\n` +
|
||||
`provider: ${task.provider}\n` +
|
||||
`elapsed: ${elapsedSeconds(task)}s\n` +
|
||||
`task_status: SUCCESS\n` +
|
||||
`${lines}`;
|
||||
|
||||
@@ -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