# 下载运行绑定技能文件ZIP

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

下载当前可信运行冻结的技能版本文件。版本来自验证后的运行声明，不是URL参数或技能当前版本。

```text
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/skills/{skill_id}/runtime-files
```

## 调用前准备

`MOI_ENDPOINT` 使用产品 API 前缀 `https://api.moi.matrixorigin.cn/v5`；专有部署填写对应的产品 API 地址。

仅适用于已经由产品准入的子运行环境。使用该环境一起提供的Endpoint、技术API Key、工作区和X-MOI-Runtime-Authorization；后者为完整Bearer行，不用个人访问令牌或浏览器短期证明替代。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl --fail-with-body "$MOI_ENDPOINT/workspaces/$MOI_WORKSPACE_ID/skills/$SKILL_ID/runtime-files" \
  -H "X-API-Key: $MOI_API_KEY" \
  -H "X-Workspace-ID: $MOI_WORKSPACE_ID" \
  -H "X-MOI-Runtime-Authorization: $MOI_RUNTIME_AUTHORIZATION" \
  --output skill-files.zip
```

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `workspace_id` | string | 必须与已验证运行声明一致。 |
| `skill_id` | string | 声明中绑定且有唯一正版本的技能。 |
| 查询参数 | 不接受 | RawQuery非空会被拒绝，不能传version或来源工作区。 |
| 运行声明 | 受信上下文 | 绑定、来源仅当前工作区或system、唯一冻结版本由后端确认。 |

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```text
HTTP/1.1 200 OK
Content-Type: application/zip
Content-Disposition: attachment; filename=skill-files.zip
X-MOI-Skill-Version: 7
Cache-Control: private, no-store
X-Content-Type-Options: nosniff

<ZIP二进制字节>
```

:::::
:::::{tab-item} 字段说明

| 字段或响应项 | 类型 | 说明 |
| --- | --- | --- |
| 响应体 | ZIP字节 | 不是JSON封套，也不是单文件明文。 |
| `X-MOI-Skill-Version` | HTTP header | 实际冻结版本；示例7不是调用者选择值。 |
| 文件来源 | 协议行为 | 按冻结版本读取并校验文件路径、大小和摘要；当前版本更新不替换该快照。 |

:::::
::::::
:::::::

## 错误响应

声明缺失、未绑定、来源/版本/工作区不合法或有查询参数时可403；找不到冻结版本/文件可404；技能错误沿当前映射处理。不能用普通PAT下载成功的mock替代真实准入。
