> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 发布画布

> 编译并发布技能构建器画布，将其作为技能发布，并设置可配置的可见性。

```http theme={null}
POST /api/v1/evi/canvases/{id}/publish
Authorization: Bearer theo_sk_...
Content-Type: application/json

{
  "slug": "my-support-agent",
  "version": "1.0.0",
  "author": { "name": "Your Name" },
  "visibility": "public",
  "readme": "# My Support Agent\nA customer service skill built with the Skill Builder.",
  "license": "MIT",
  "keywords": ["support", "customer-service"]
}
```

编译画布、运行自动化审核检查，并将其发布为技能。该技能会进入与通过 CLI 或 API 提交的技能相同的审核流程。

## 参数

* `slug`（字符串，必填）— 技能 slug。仅限小写字母数字及连字符。
* `version`（字符串，必填）— 语义化版本号（例如 `1.0.0`）。
* `author`（对象，必填）— `{ name, email?, url? }`。
* `visibility`（字符串，可选）— 发布可见性。默认值：`"private"`。
  * `"private"` — 仅你本人可见并可安装该技能。
  * `"org"` — 对目标组织的所有成员可见。需要提供 `target_org_id`。
  * `"public"` — 在公共技能商店中列出。
* `target_org_id`（字符串，可选）— 当 `visibility` 为 `"org"` 时必填。目标组织的 UUID。
* `readme`（字符串，可选）— 用于市场列表展示的 Markdown README（最多 50,000 字符）。
* `license`（字符串，可选）— SPDX 许可证标识符。默认值：`"MIT"`。
* `keywords`（数组，可选）— 最多 10 个搜索关键词。

## 响应（自动通过）

```json theme={null}
{
  "published": true,
  "visibility": "public",
  "submission": {
    "id": "uuid",
    "status": "approved",
    "reviewTier": "auto",
    "autoApproved": true
  },
  "skillId": "uuid"
}
```

## 响应（待审核）

```json theme={null}
{
  "published": true,
  "visibility": "org",
  "submission": {
    "id": "uuid",
    "status": "pending_review",
    "reviewTier": "staff",
    "autoApproved": false
  },
  "skillId": "uuid"
}
```

## 响应（编译或审核失败）

返回状态码 `422`，`published` 为 `false`，并附带描述失败原因的 `errors` 或 `review` 对象。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.