下载技能文件¶

下载随技能包导入的一个静态文件。成功响应为文件二进制内容，不使用 JSON 成功包络。

GET https://moi.matrixorigin.cn/newmoi/workspaces/{workspace_id}/skills/{skill_id}/files/content?path={path}

调用前准备¶

先查询技能文件取得 file_path。准备有目标工作区访问权限的个人访问令牌、目标工作区 ID 和技能 ID。

下方示例使用：

$AI_STUDIO_API_KEY：实际个人访问令牌，通过 X-API-Key Header 传递。
$WORKSPACE_ID：目标工作区 ID，通过 X-Workspace-ID Header 传递。
$SKILL_ID：技能 ID。

路径参数¶

参数	类型	是否必填	说明
`workspace_id`	string	是	当前工作区 ID。
`skill_id`	string	是	技能 ID。

查询参数¶

参数	类型	是否必填	说明
`path`	string	是	技能包内的文件相对路径。不能是目录、绝对路径、包含 `..` 或反斜杠的路径。

请求示例¶

curl -OJ "https://moi.matrixorigin.cn/newmoi/workspaces/$WORKSPACE_ID/skills/$SKILL_ID/files/content?path=references%2Fguide.md" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

成功响应¶

成功时返回 200 和文件内容。响应不是 JSON 包络。响应设置以下头：

响应头	说明
`Content-Type`	文件的实际媒体类型。
`Content-Disposition`	`attachment`，并提供 UTF-8 编码的文件名。
`X-Content-Type-Options`	固定为 `nosniff`。

错误响应¶

错误时返回 JSON：

{
  "code": 3,
  "message": "<错误信息>",
  "details": {
    "reason": "SKILL_PACKAGE_FILE_NOT_FOUND"
  }
}

常见 HTTP 错误¶

HTTP 状态码	错误代码	常见原因	建议操作
`400`	`2`（`INVALID_ARGUMENT`）	`path` 缺失或不是安全的技能包相对路径。	使用“查询技能文件”返回的 `file_path` 原样请求。
`401`	`6`（`UNAUTHENTICATED`）	缺少有效身份凭据。	检查 API Key。
`403`	`5`（`PERMISSION_DENIED`）	当前身份没有读取技能文件的权限。	检查工作区授权。
`404`	`3`（`NOT_FOUND`）	技能或指定文件不存在。	检查技能 ID 和 `path`。
`503`	`15`（`UNAVAILABLE`）	技能包存储不可用。	稍后重试。

后续操作¶

下载完成后如需继续管理，返回查询技能详情。

最后更新于 2026 年 8 月 22 日