下载与文件 token
下载能力分为三类：
- 节点配置文本下载
- 后端生成文件下载
- MCP 返回短期下载 URL
节点配置文本
端点配置下载流程：
- 调用
/api/v1/configs/{config_id}/nodes/{node_id}/download-token创建下载 token。 - 使用返回的
download_path下载配置。
下载 token 只绑定该 config_id + node_id，不能下载其他端点配置。
客户端产物
构建接口：
http
POST /api/v1/tools/download/client-artifacts/build下载接口：
http
GET /api/v1/tools/download/client-artifacts/{artifact_id}下载接口支持管理员会话认证，也支持 kind=client_artifact 的文件下载 token。
配置批量下载包
生成接口：
http
POST /api/v1/tools/download/config-bulk/package下载接口：
http
GET /api/v1/tools/download/config-bulk/{package_id}配置批量下载不复用旧包。生成新包时会替换临时产物。
快照导出
快照导出接口：
http
GET /api/v1/backups/export/{snapshot_id}MCP 的 write_export_snapshot 只返回一个 5 分钟有效的 snapshot_export 下载 URL，不传输文件内容。
文件 token 规则
文件 token 绑定：
text
kind + resource_id当前支持：
| kind | resource_id |
|---|---|
client_artifact | artifact_id |
config_bulk_package | package_id |
snapshot_export | snapshot_id |
token 过期或 scope 不匹配时，返回 INVALID_DOWNLOAD_TOKEN 或 DOWNLOAD_TOKEN_SCOPE_MISMATCH。