diff --git a/mcp/README.md b/mcp/README.md index f44cd08..e0f88e5 100644 --- a/mcp/README.md +++ b/mcp/README.md @@ -50,16 +50,18 @@ AI(agent 的 executor 沙箱里) │ curl -s "http://agent-core:8081/public-link?path=/workspace/tasks/<会话>/foo.png" ▼ agent-core :8081(内网、不映射宿主机 -> 无需凭据) - │ 现签一条签名下载链接(HMAC,含会话/路径/过期时间) + │ 现签一个不透明短 ID(22 字符随机),内存表记着“哪个会话的哪个文件 + 何时过期” ▼ AI 把拿到的 URL 当 image_url 交给 video_gen:3000/mcp │ ▼ -智谱 ──匿名 GET──► http://<服务器IP>:8090/api/sessions/<会话>/files/download-name/…&t=… +智谱 ──匿名 GET──► http://<服务器IP>:8090/p/9fQ2mZ7xK4tR1vBn 那个文件始终躺在 agent 的任务目录里,零拷贝 ``` -- 链接:不可猜(HMAC)、会过期(默认 30 分钟)、绑会话、agent 重启即全部失效。 +- 链接:`/p/<22 字符随机 ID>`,约 50 字符、纯 ASCII(不带文件名/会话名/签名)——因为这条 URL 会被模型 + 抄进工具参数、并永久留在会话历史里每轮重发,越短越安全也越省 token。 +- 过期:agent 侧 `public_link.ttl_ms`(默认 30 分钟);agent 重启或过期后该 ID 立即失效(内存表)。 - 前提:agent 侧 `config.yml` 配了 `public_link.base_url`(就是那个对外地址),否则签发端口不启动。 - 唯一公网可达的东西是 agent 的 8090,以及那条**签名**下载路径;mcp 这三家一个端口都不露。 @@ -69,7 +71,7 @@ AI 把拿到的 URL 当 image_url 交给 video_gen:3000/mcp |---|---|---| | `mcp_web_search` | 无 | 服务端无鉴权,**永远不要映射出去**(会被白嫖搜索额度);agent 走内网访问 | | `mcp_image_gen` | 无 | token 由调用方自带,暴露后可被拿去消耗你的智谱额度 | -| `mcp_video_gen` | 无 | 它需要的公网下载路径由 agent 的签名链接提供,自己不占端口 | +| `mcp_video_gen` | 无 | 它需要的公网下载路径由 agent 现签的匿名短链(`/p/`)提供,自己不占端口 | ## 单独调试 diff --git a/mcp/video_gen/README.md b/mcp/video_gen/README.md index 1cb75be..c54a559 100644 --- a/mcp/video_gen/README.md +++ b/mcp/video_gen/README.md @@ -78,10 +78,13 @@ docker exec mcp_video_gen node -e "fetch('http://localhost:3000/health').then(r= # AI 在 agent 的 executor 沙箱里执行;路径就是它平时看到的那个绝对路径 curl -s "http://agent-core:8081/public-link?path=/workspace/tasks/<会话>/foo.png" # stdout 就是现成 URL(纯文本,不需要解析 JSON): -# http://<服务器IP>:8090/api/sessions/<会话>/files/download-name/foo.png?path=foo.png&expires=…&t=… +# http://124.221.199.237:8090/p/9fQ2mZ7xK4tR1vBn ``` -- 那条链接是 agent 的**签名下载链接**:不可猜(HMAC)、会过期(默认 30 分钟)、绑会话、agent 重启即全部失效。 +- 那条链接是不透明短 ID:22 字符随机、纯 ASCII、不带文件名/会话名/签名,约 50 字符 + (签完由 agent 的 `public_files` 内存表记住“哪个文件 + 何时过期”)。刻意做短是因为它会被模型 + 抄进 `image_url` 参数、并永久留在会话历史里每轮重发。 +- 不可猜、会过期(默认 30 分钟)、agent 重启即全失效。 - `8081` 是 agent 侧的**内网**签发端口(`PUBLIC_LINK_PORT`),**不映射到宿主机**,所以接它不需要任何凭据; 地址由 env `PUBLIC_LINK_URL` 告诉本服务(compose 已默认指向 `http://agent-core:8081/public-link`)。 - `PUBLIC_LINK_URL` 没配时,工具描述里不会出现这条命令,而是提示“请运维配置”。 @@ -294,8 +297,8 @@ package.json # @modelcontextprotocol/sdk + express + multer - `model / quality / fps / watermark_enabled` 全部由 HTTP header 注入,避免 AI 误传或被诱导调高价档 - **异步语义暴露给 AI**:服务端不做轮询,`video_gen` 只提交、`query_video` 只查一次。AI 自主决定节奏 - **服务端自动 `request_id`**:每次提交服务端生成一个 UUID 作为智谱 `request_id`,便于日志关联,但不暴露给 AI -- **不搬字节**:本地文件 -> 公网 URL 完全由 agent 侧完成(`GET /public-link` 现签一条签名下载链接),本服务只把命令拼进工具描述;那只所以能不给本体加任何写入口、不落盘、不需要额外端口 -- **链接短命**:签名链接默认 30 分钟过期、绑会话、agent 重启即全失效;`PUBLIC_LINK_URL` 未配时工具描述退化为“请运维配置” +- **不搬字节**:本地文件 -> 公网 URL 完全由 agent 侧完成(`GET /public-link` 现签一个 22 字符随机短 ID),本服务只把命令拼进工具描述;所以能给本体不加任何写入口、不落盘、不需要额外端口 +- **链接短命且极短**:默认 30 分钟过期、agent 重启即全失效;`PUBLIC_LINK_URL` 未配时工具描述退化为“请运维配置” ### 默认模型 @@ -332,7 +335,7 @@ A: 可以。`/async-result/{id}` 是幂等的读接口,并发无副作用。 A: 不需要。Model header 在每次 `tools/call` 都从当前请求读取。 **Q: 上传的图片多久过期?** -A: 本服务不存图,不存在“上传的图片”:要用的图在 agent 的任务目录里,AI 现签一条签名链接给智谱拉。链接按 agent 的 `public_link.ttl_ms`(默认 30 分钟)过期,过期后 URL 变 403。 +A: 本服务不存图,不存在“上传的图片”:要用的图在 agent 的任务目录里,AI 现签一个短 ID 给智谱拉。链接按 agent 的 `public_link.ttl_ms`(默认 30 分钟)过期,过期或 agent 重启后该 URL 变 404。 **Q: `PUBLIC_LINK_URL` 不配会怎样?** A: 工具描述里不会出现“怎么把本地文件变成公网 URL”的命令,而是提示让运维配置,AI 就只能用已经是公网 URL 的图片(比如 image_gen 刚生成的图)。配的时候注意:它指向的是 agent 侧的**内网**签发端口(`http://agent-core:8081/public-link`),不是 agent 对外的 8090。 \ No newline at end of file diff --git a/mcp/video_gen/src/mcp-server.js b/mcp/video_gen/src/mcp-server.js index 348bbca..ccba590 100644 --- a/mcp/video_gen/src/mcp-server.js +++ b/mcp/video_gen/src/mcp-server.js @@ -22,8 +22,9 @@ const DEFAULT_WATERMARK_ENABLED = true; // 平台政策默认 true // ===== 本地图片怎么拿到公网 URL ===== // 本服务不搬字节:本地文件 -> 公网 URL 这件事由 agent(agent-core)侧完成: // agent-core 在【内网】端口上提供签发入口(GET /public-link?path=<绝对路径>), -// 沙箱里的 AI 命令 curl 它,换回一条短命的签名下载链接(复用登录下载那套:不可猜/会过期/绑会话)。 -// 这里只把那条命令拼进 tool description 告诉 AI;agent 侧的具体实现见其 routes/public-link.js。 +// 沙箱里的 AI 命令 curl 它,换回一个约 50 字符的短链(http://:8090/p/<22 字符随机 ID>, +// 不可猜 / 会过期 / 不带文件名与签名 —— 因为这个 URL 会进会话历史每轮重发)。 +// 这里只把那条命令拼进 tool description 告诉 AI;agent 侧实现见其 routes/public-link.js。 function resolvePublicLinkUrl() { return String(process.env.PUBLIC_LINK_URL || "").trim().replace(/\/+$/, ""); }