@yixiaoermail/cli 3.1.0

package/skills/yixiaoer/references/platforms/video/index.md

@@ -0,0 +1,165 @@
+# 视频发布 (Video Publish)
+
+> [!CAUTION]
+> **阅读规范 (Reading Protocol)**:
+> 本文档是 **所有平台** 视频发布的 **唯一入口** 和 **基础 DTO 定义**。
+> 在查阅具体的平台文档（如 `douyin.md`）之前，你 **必须** 首先查阅本文档以理解 Payload 的根结构，否则将导致生成的 JSON 无法通过校验。
+
+## 触发场景 (Trigger)
+- **意图辨析**：当用户下达分发视频指令（无论是单平台发布还是多平台矩阵分发）时触发。涵盖从本地视频上传到最终推送的全链路。
+- **典型提示词**：
+  - “把这个视频发布到全平台”
+  - “帮我同步这个短剧到抖音和快手”
+  - “我的视频号要更新了，标题是 XXX”
+  - “使用本地模式分发这个视频”
+
+## 执行逻辑 (Logic Flow)
+1. **资源预处理**：
+   - 调用 `yxer upload` 将本地或 URL 视频及封面图上传至云端，并持有获得的 `key`。
+   - 严禁在 `publish` 负载中直接透传原始 URL。
+2. **账号与平台选取**：识别目标 `platforms` 列表及具体的 `platformAccountId`（通过 `yxer accounts` 查询）。
+3. **参数深度补全**：若涉及分类、地理位置、音乐等动态字段，调用对应 `yxer query categories`、`yxer query locations`、`yxer query music` 等命令获取合法对象。
+4. **Payload 装配**：按照本文档 1.1 - 1.3 节定义的 DTO 结构，组装包含 `action: "publish"` 的完整 JSON。
+5. **指令交付**：先执行 `yxer validate <platform> video <payload.json>`，再执行 `yxer publish video <platform> <payload.json> [clientId]`。
+6. **状态跟踪**：记录返回的 `taskSetId`，以便后续通过 `yxer query records` 查询进度。
+
+## 1. 数据结构 (Data Structure)
+
+接口要求传入 `CloudTaskPushRequest` 结构。
+
+### 1.1 基础结构 (Base Structure)
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `action` | `string` | **是** | 固定值：`publish` | - |
+| `publishType` | `string` | **是** | 固定为 `video` | - |
+| `platforms` | `string[]` | **是** | 目标平台枚举数组，详见下方平台列表 | - |
+| `coverKey` | `string` | **是** | 任务封面资源 Key | - |
+| `publishArgs` | `Object` | **是** | 发布参数核心容器 | - |
+| `taskSetId` | `string` | 否 | 任务集唯一标识 (草稿发布时必填) | - |
+| `desc` | `string` | 否 | 任务描述/摘要 | - |
+| `publishChannel` | `string` | 否 | `cloud` (云端) 或 `local` (本机) | `cloud` |
+| `clientId` | `string` | 否 | 客户端连接 ID (`local` 发布时必填) | - |
+| `isDraft` | `boolean` | 否 | 是否仅保存为草稿 (蚁小二草稿) | `false` |
+| `isAppContent` | `boolean` | 否 | 业务扩展标记，CLI 会原样透传 | - |
+
+### 1.2 草稿模式选取 (Draft Selection)
+
+| 场景 | 蚁小二草稿箱 | 目标平台草稿箱 |
+| :--- | :--- | :--- |
+| **位置** | `Payload` 根路径 | `accountForms` -> `contentPublishForm` |
+| **参数** | `"isDraft": true` | `"pubType": 0` (若平台不支持，见下方说明) |
+| **效果** | 仅保存在蚁小二系统，不发起平台推送 | 执行推送流程，但最终结果为平台端的草稿态 |
+| **用户话术** | “存为蚁小二草稿”、“以后再发” | “存到抖音草稿箱”、“推送到小红书草稿” |
+
+> [!TIP]
+> **字段兼容性补丁 (Draft Fallback Rule)**:
+> Agent 在处理“存为平台草稿”时必须遵循以下优先级：
+> 1.  **首选 (pubType)**：若目标平台文档定义了 `pubType` 字段，必须设置 `"pubType": 0`。
+> 2.  **次选 (visibleType)**：若无 `pubType` 但定义了 `visibleType`，则将其设置为 **`1` (私密)**。对应的，`0` 表示公开。
+> 3.  **不支持**：若上述两个字段均未定义，则说明该平台不支持草稿或私密保存，Agent 应告知用户并询问是否直接公开发布。
+
+
+### 1.3 发布参数 (publishArgs)
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `accountForms` | `Array` | **是** | 账号发布表单列表 | - |
+| `video` | `Object` | 否 | **标准请求体共享视频资源**。CLI 校验时会在缺失时复制到各 `accountForms[i].video` | - |
+| `images` | `Array` | 否 | **标准请求体共享图片资源**。视频场景通常仅作扩展透传 | - |
+| `cover` | `Object` | 否 | **标准请求体共享封面资源**。CLI 校验时会在缺失时复制到各 `accountForms[i].cover` | - |
+| `coverKey` | `string` | 否 | **标准请求体共享封面 Key**。CLI 校验时会在缺失时复制到各 `accountForms[i].coverKey` | - |
+
+> [!TIP]
+> **CLI 输入兼容规则**:
+> - 推荐优先使用“标准请求体”形态，即在 `publishArgs` 中声明共享的 `video`、`cover`、`coverKey`，再在 `accountForms[]` 中补平台差异字段。
+> - CLI 当前仍按**单平台命令**执行：`yxer publish video <platform> <payload.json> [clientId]`。即使请求体里可以表达多平台，命令本身仍需逐个平台调用。
+> - `yxer validate` 与 `yxer publish` 都接受完整标准请求体；在共享资源字段存在而账号项缺失时，CLI 会在校验阶段自动补齐到对应 `accountForms[]`。
+
+### 1.4 账号表单项 (accountForms Item)
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `platformAccountId` | `string` | **是** | 蚁小二平台账号唯一 ID | - |
+| `video` | `Object` | **是** | **VideoFormItem**: 视频对象 (`key`, `width`, `height`, `size`) | - |
+| `cover` | `Object` | **是** | **ImageFormItem**: 主封面对象 | - |
+| `contentPublishForm`| `Object` | **是** | **透传层**: `{}` | - |
+| `coverKey` | `string` | **是** | 账号级封面 Key (必须与 `cover.key` 一致) | - |
+| `fps` | `number` | 否 | 视频发布帧率 (海外平台使用) | - |
+| `mediaId` | `string` | 否 | 业务扩展字段，CLI 原样透传 | - |
+| `platformName` | `string` | 否 | 业务扩展字段，CLI 原样透传 | - |
+| `publishContentId` | `string` | 否 | 业务扩展字段，CLI 原样透传 | - |
+
+## 2. 发布示例 (Payload Example)
+
+```json
+{
+  "action": "publish",
+  "publishType": "video",
+  "platforms": ["抖音"],
+  "coverKey": "video_cover_key",
+  "desc": "视频发布任务",
+  "publishChannel": "local",
+  "clientId": "local-client",
+  "publishArgs": {
+    "video": {
+      "key": "video_oss_key",
+      "width": 1080,
+      "height": 1920,
+      "size": 52428800
+    },
+    "cover": {
+      "key": "video_cover_key",
+      "width": 1080,
+      "height": 1920,
+      "size": 307200
+    },
+    "coverKey": "video_cover_key",
+    "accountForms": [
+      {
+        "platformAccountId": "acc_vid_003",
+        "mediaId": "media_001",
+        "platformName": "抖音",
+        "publishContentId": "publish_content_001",
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "演示视频标题",
+          "description": "<p>演示视频简介</p>"
+        }
+      }
+    ]
+  }
+}
+```
+
+## 3. 支持平台列表 (Support Platforms)
+
+以下平台支持通过 `publishType: "video"` 进行发布。
+
+| 平台名称 | 标识符 | 文档链接 |
+| :--- | :--- | :--- |
+| **头条号** | `Toutiaohao` | [toutiaohao.md](./toutiaohao.md) |
+| **哔哩哔哩** | `Bilibili` | [bilibili.md](./bilibili.md) |
+| **抖音** | `Douyin` | [douyin.md](./douyin.md) |
+| **视频号** | `Shipinhao` | [shipinhao.md](./shipinhao.md) |
+| ... | ... | ... |
+
+## 4. 通用规则 (Common DTO Rules)
+
+### 4.1 级联分类组装 (Cascading Categories)
+许多平台要求传入由父及子的完整分类对象数组。
+- **组装逻辑**：Agent 从 `categories` 接口获取数据后，若存在层级关系，**必须自行构造** 路径数组。
+- **填表规范**：对于每一级，必须包含 `yixiaoerId`, `yixiaoerName` 以及对应的 **`raw`** 对象。
+- **层级示例**：
+  - 父分类：`{"yixiaoerId": "18", "yixiaoerName": "动漫", "raw": {...}}`
+  - 子分类：`{"yixiaoerId": "1", "yixiaoerName": "国产动漫", "raw": {...}}`
+  - **最终 Payload 形式**（Agent 需手动装配成此数组）：
+    ```json
+    "category": [
+      { "yixiaoerId": "18", "yixiaoerName": "动漫", "raw": {...} },
+      { "yixiaoerId": "1", "yixiaoerName": "国产动漫", "raw": {...} }
+    ]
+    ```
+
+> [!TIP]
+> 完整工作流请参考 `../../workflows/`，技能入口位于 `../../SKILL.md`。

package/skills/yixiaoer/references/platforms/video/kuaishou-open.md

@@ -0,0 +1,63 @@
+# 快手开放平台 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“快手”平台分发视频内容，且账号为开放平台账号时触发。
+- **典型提示词**：
+  - “把这个视频发布到快手”
+  - “同步视频到快手开放平台账号”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为快手，并使用对应开放平台账号。
+2. **参数装配**：识别并填充标题、描述等平台特定字段至 `contentPublishForm`。
+3. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+
+## 1. contentPublishForm 数据结构
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| formType | string | 是 | 固定为 `task` | `task` |
+| title | string | 否 | 快手标题 | - |
+| description | string | 否 | 快手描述 | - |
+| visibleType | number | 是 | 可见类型：0-公开, 1-私密, 3-好友可见 | 0 |
+| scheduledTime | number | 否 | 定时发布时间戳（13 位 Unix 时间戳，单位：毫秒） | - |
+
+## 2. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["快手"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "KS_OPEN_ACC_ID",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1080,
+          "height": 1920,
+          "duration": 15
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "快手开放平台视频标题",
+          "description": "通过快手开放平台发布的精彩内容内容描述。",
+          "visibleType": 0
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

package/skills/yixiaoer/references/platforms/video/kuaishou.md

@@ -0,0 +1,77 @@
+# 快手视频发布参数 (Kuaishou Video)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“快手”平台分发短视频，且需要配置如“可见范围控制 (visibleType)”、“同城展示 (nearby_show)”、“创作申明 (AI生成等)”或“合集挂载”等快手特色功能时触发。
+- **典型提示词**：
+  - “帮我把这个视频同步到快手”
+  - “快手发布，设置仅好友可见”
+  - “视频发到快手，不要在同城频道显示”
+  - “申明这个快手内容是由 AI 辅助生成的”
+
+## 执行逻辑 (Logic Flow)
+1. **意图解析**：识别用户对私密性、同城展示及原创属性的要求。
+2. **辅助字段检索**：
+   - 位置：若需要，调用 `locations` 获取 POI 数据。
+   - 合集：调用 `collections` 获取可用合集 ID。
+3. **参数装配**：构造 `accountForms[i].contentPublishForm`，注意布尔值字段（如 `nearby_show`）的映射。
+4. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+## 1. contentPublishForm 参数定义
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定为 `task` | `task` |
+| `title` | `string` | **否** | 视频标题 | - |
+| `description` | `string` | **否** | 视频描述 | - |
+| `declaration` | `number` | **否** | 视频声明：0-不申明, 1-内容为 AI 生成, 2-演绎情节仅供娱乐, 3-个人观点仅供参考 | 0 |
+| `location` | `object` | **否** | 视频位置，使用 `PlatformDataItem` 结构 | - |
+| `visibleType` | `number` | **是** | 可见类型：0-公开, 1-私密, 3-好友可见 | 0 |
+| `scheduledTime` | `number` | **否** | 定时发布时间戳 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `shopping_cart` | `object` | **否** | 关联商品信息 | - |
+| `collection` | `object` | **否** | 合集信息，使用 `Category` 结构 | - |
+| `mini_app` | `object` | **否** | 挂载小程序 (与购物车互斥) | - |
+| `nearby_show` | `boolean` | **否** | 是否同城展示 | `true` |
+| `allow_same_frame` | `boolean` | **否** | 是否允许同框 | `false` |
+| `allow_download` | `boolean` | **否** | 是否允许下载 | `false` |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "video",
+  "platforms": ["快手"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_ks_vid_001",
+        "video": { "key": "v_key", "size": 1024000, "width": 1080, "height": 1920, "duration": 15 },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "快手视频发布测试",
+          "visibleType": 0,
+          "nearby_show": true,
+          "declaration": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 3. 复杂对象结构说明
+
+### 3.1 PlatformDataItem / Category
+包含 `yixiaoerId`, `yixiaoerName`, `raw` (必须完整透传)。
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `location`  | `locations`   | [获取位置信息](../../get-locations.md) |
+| `collection`| `collections` | [获取合集列表](../../get-collections.md) |
+| `video.key` | `upload`      | [资源上传](../../upload-resource.md) |

package/skills/yixiaoer/references/platforms/video/meipai.md

@@ -0,0 +1,79 @@
+# 美拍 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Meipai”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Meipai”
+  - “同步视频到Meipai”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Meipai。
+2. **参数装配**：识别并填充标题、描述等平台特定字段至 `contentPublishForm`。
+3. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+
+## 1. contentPublishForm 数据结构
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| formType | string | 是 | 固定为 `task` | `task` |
+| title | string | 是 | 视频标题 | - |
+| description | string | 否 | 视频描述 | - |
+| category | object[] | 否 | 视频分类，使用 `CascadingPlatformDataItem[]` 结构 | - |
+| scheduledTime | number | 否 | 定时发布时间戳（13 位 Unix 时间戳，单位：毫秒） | - |
+
+## 2. 复杂对象结构
+
+### CascadingPlatformDataItem
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | string | 是 | 选项ID |
+| text | string | 是 | 选项文本 |
+| children | object[] | 否 | 子级选项列表 (CascadingPlatformDataItem[]) |
+| raw | object | 是 | 平台原始数据 |
+
+## 3. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["Meipai"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "MEIPAI_ACC_ID",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1080,
+          "height": 1920,
+          "duration": 15
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "美拍视频标题示例",
+          "description": "这是美拍平台的一段精彩短视频内容描述。",
+          "category": [
+            {
+              "id": "1",
+              "text": "生活",
+              "raw": {}
+            }
+          ]
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

package/skills/yixiaoer/references/platforms/video/meiyou.md

@@ -0,0 +1,59 @@
+# 美柚 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Meiyou”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Meiyou”
+  - “同步视频到Meiyou”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Meiyou。
+2. **参数装配**：识别并填充标题、描述等平台特定字段至 `contentPublishForm`。
+3. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+
+## 1. contentPublishForm 数据结构
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| formType | string | 是 | 固定为 `task` | `task` |
+| title | string | 是 | 视频标题 | - |
+| scheduledTime | number | 否 | 定时发布时间戳（13 位 Unix 时间戳，单位：毫秒） | - |
+
+## 2. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["Meiyou"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "MEIYOU_ACC_ID",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1080,
+          "height": 1920,
+          "duration": 15
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "美柚视频标题示例"
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

package/skills/yixiaoer/references/platforms/video/pipixia.md

@@ -0,0 +1,58 @@
+# 皮皮虾 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Pipixia”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Pipixia”
+  - “同步视频到Pipixia”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Pipixia。
+2. **参数装配**：识别并填充标题、描述等平台特定字段至 `contentPublishForm`。
+3. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+
+## 1. contentPublishForm 数据结构
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| formType | string | 是 | 固定为 `task` | `task` |
+| description | string | 否 | 视频描述 | - |
+
+## 2. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["Pipixia"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "PIPIXIA_ACC_ID",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1080,
+          "height": 1920,
+          "duration": 15
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "description": "皮皮虾，我们走！ #搞笑 #段子"
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

package/skills/yixiaoer/references/platforms/video/qiehao.md

@@ -0,0 +1,91 @@
+# 企鹅号 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Qiehao”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Qiehao”
+  - “同步视频到Qiehao”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Qiehao。
+2. **参数装配**：识别并填充标题、描述等平台特定字段至 `contentPublishForm`。
+3. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+
+## 1. contentPublishForm 数据结构
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定为 `task` | `task` |
+| `title` | `string` | **是** | 视频标题 | - |
+| `description` | `string` | **是** | 视频描述 | - |
+| `tags` | `string[]` | **是** | 视频标签 | - |
+| `category` | `object[]` | **是** | 视频分类，使用 `CascadingPlatformDataItem[]` 结构 | - |
+| `declaration` | `number` | 否 | 创作申明：0-暂不申明, 1-该内容由AI生成, 2-个人观点仅供参考, 3-剧情演绎仅供娱乐, 4-取材网络谨慎甄别, 5-旧闻 | 0 |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
+| `scheduledTime` | `number` | 否 | 定时发布时间戳（13 位 Unix 时间戳，单位：毫秒） | - |
+
+## 2. 复杂对象结构
+
+### 3.1 CascadingPlatformDataItem (级联分类对象)
+
+> [!IMPORTANT]
+> **规则 (Rule)**:
+> 所有的 `raw` 数据必须透传通过分类接口获取的原始对象。
+
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 蚁小二分类 ID |
+| `yixiaoerName` | `string` | **是** | 蚁小二分类名称 |
+| `children` | `object[]` | 否 | 子级分类列表 (`CascadingPlatformDataItem[]`) |
+| `raw` | `object` | **是** | 平台原始数据 (必须透传) |
+
+## 3. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["企鹅号"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_qh_001",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "企鹅号视频标题示例",
+          "description": "这是关于企鹅号内容的详细描述文字。",
+          "tags": ["综合", "生活"],
+          "category": [
+            {
+              "yixiaoerId": "cat_001",
+              "yixiaoerName": "生活",
+              "raw": { "id": "1", "name": "生活" }
+            }
+          ],
+          "declaration": 0,
+          "pubType": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |
+| `category` | `category` | [获取发布分类](../../get-publish-categories.md) |