# 按节点身份读取自定义算子源码

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

`GET /workflow/v2/custom-operators/source`，需要单个非空 `X-Workspace-ID`。传递规范的 `node_id`、`version`，可选 `task_id`；结果封套为字符串 `code: "OK"`、`msg: "OK"`、`data`。

<span id="查询参数"></span>

## 两种来源

提供非空 `task_id` 时，只选择任务工作区来源，返回 `origin: "workspace"`。任务须属于当前工作区并有上下文，读取前重复核对任务及上下文。当前加载器只接受 `version=draft`，节点前缀为 `moi:custom.operator:{workspace_id}:`，后接有效标识符。从该任务工作区的算子目录读取 `operator.json`、`main.py`；输入输出 schema 必须为对象，manifest 严格校验。身份、handler 与语言由受信工作区推导，当前为 Python、`main.handle`。缺少任务文件不会回退到已保存算子。

该 GET 可以在工作区首次读取时从持久化快照恢复本地目录并写 readiness manifest；不能声称它完全没有本地文件系统写入。它不发布算子或开始运行。

不提供 `task_id` 时，按 `node_id + version` 精确查找当前租户中持久化的算子，返回 `origin: "published"`。查询最多取两条以识别歧义，要求恰好一条。这里的 published 是协议来源值，不独立证明算子已启用或工作流已发布。算子须为代码类型且有非空 SourceFileID；通过 Catalog 读取源码，空白内容无效。当前详情读取没有单独过滤 disabled 状态，不能补造仅启用算子可读取的限制。

两个来源分别经过生成的授权边界；不能根据选择来源的 Platform 内部调用推断 HTTP 入口免授权。

## 请求示例

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

从已有工作流节点取得精确节点身份和版本。只在读取任务工作区草稿时额外传当前 authoring 任务 ID：

```bash
curl --get "$PRODUCT_API_BASE_URL/workflow/v2/custom-operators/source" \
  -H "X-API-Key: $PRODUCT_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --data-urlencode "node_id=$NODE_ID" \
  --data-urlencode "version=$NODE_VERSION" \
  --data-urlencode "task_id=$AUTHORING_TASK_ID"
```

读取持久化算子时省略最后一个参数。`task_id` 决定来源；不是草稿读取失败后的兜底提示。

`PRODUCT_API_BASE_URL` 使用产品 API 前缀 `https://api.moi.matrixorigin.cn/v5`。

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

| 字段 | 类型 | 必填 | 约束 |
| --- | --- | --- | --- |
| `node_id` | string | 是 | 节点规范身份，非整数算子 ID；只出现一次，非空且无首尾空白 |
| `version` | string | 是 | 与该身份精确匹配；只出现一次，非空且无首尾空白 |
| `task_id` | string | 否 | 至多一次；非空时不能含首尾空白，空字符串按未提供处理 |

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

## 响应字段

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `data.source` | string | 源码全文，可能含敏感业务信息，应按代码与密钥规范保存 |
| `data.origin` | string | `workspace` 或 `published` |
| `data.node_id` | string | 节点身份 |
| `data.version` | string | 节点版本 |
| `data.language` | string | 可省略，源码语言 |
| `data.handler` | string | 可省略，入口函数 |
| `data.name` | string | 可省略，算子名称 |
| `data.identifier` | string | 可省略，算子标识符 |

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

## 错误与待验

重复或空参数、非规范空白、无源码等映射 400/ErrParamInvalid，缺工作区头为400/ErrWorkspaceRequired。找不到持久化身份/任务、任务不匹配等沿服务错误映射；身份歧义及包装后的源码读取错误为500/ErrServer。任务目录中文件读取原始错误未统一转换为ErrNotFound，不要把所有缺文件场景都写成404。

前端共享函数注释仍写 draft 优先、published 兜底，与当前 service 分支不符；现有 Go/Python/CLI 测试固定值仍用 origin=draft。二者为维护候选，不能用其绿色测试确立协议枚举。
