@yixiaoermail/cli 3.1.0

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

@@ -0,0 +1,95 @@
+# 视频号视频发布参数 (WeiXin ShiPinHao Video)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“微信视频号”平台分发视频内容，且需要执行如“地点标记”、“关联网店商品”、“参加活动”或“存为视频号草稿”等微信生态功能时触发。
+- **典型提示词**：
+  - “帮我把这个视频发到我的视频号”
+  - “视频号发布，带上我在广州的位置”
+  - “在视频号推文里挂载这个商品链接”
+  - “参加视频号最新的创作激励活动”
+
+## 执行逻辑 (Logic Flow)
+1. **意图解析**：识别是否需要挂载商品 (Goods)、活动 (Activity) 或位置 (Location)。
+2. **多维辅助检索**：
+   - 位置：调用 `locations` 获取 POI。
+   - 活动：调用 `activities` 获取活动 ID。
+   - 商品：调用 `goods` 获取带货商品信息。
+3. **参数装配**：将获取的 `raw` 结构与 `yixiaoerId` 组装进 `accountForms[i].contentPublishForm`。
+4. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+> [!TIP]
+> 示例优先使用“标准请求体”格式：共享资源放在 `publishArgs` 根级，账号差异字段放在 `accountForms[]`。CLI 会在校验阶段自动补齐缺失资源字段。
+
+## 1. contentPublishForm 参数定义
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定为 `task` | `task` |
+| `title` | `string` | 否 | 视频标题 (最多 80 字) | - |
+| `short_title` | `string` | 否 | 视频短标题 | - |
+| `description` | `string` | 否 | 视频描述，支持 HTML 格式和 `@` 好友/话题标签 | - |
+| `horizontalCover` | `object` | 否 | 视频横板封面，使用 `OldCover` 结构 | - |
+| `createType` | `number` | **是** | 创建类型：1-草稿，2-直接发布 | 2 |
+| `pubType` | `number` | **是** | 发布类型：0-草稿，1-直接发布 | 1 |
+| `location` | `object` | 否 | 视频位置，使用 `PlatformDataItem` 结构 | - |
+| `scheduledTime` | `number` | 否 | 定时发布时间戳 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `shoppingCart` | `object` | 否 | 关联商品信息 (`yixiaoerId`, `yixiaoerName`, `raw`) | - |
+| `collection` | `object` | 否 | 合集信息 (`yixiaoerId`, `yixiaoerName`, `raw`) | - |
+| `activity` | `object` | 否 | 活动信息 (`yixiaoerId`, `yixiaoerName`, `raw`) | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "video",
+  "platforms": ["视频号"],
+  "coverKey": "cover_key",
+  "publishArgs": {
+    "video": { "key": "v_key", "size": 1024000, "width": 1080, "height": 1920, "duration": 15 },
+    "cover": { "key": "cover_key", "size": 102400, "width": 1080, "height": 1920 },
+    "coverKey": "cover_key",
+    "accountForms": [
+      {
+        "platformAccountId": "SPH_ACC_ID",
+        "mediaId": "media_001",
+        "platformName": "视频号",
+        "publishContentId": "publish_content_001",
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "记录美好瞬间",
+          "description": "<p>这是我的视频号首发 #生活 #记录</p>",
+          "createType": 2,
+          "pubType": 1,
+          "location": {
+            "yixiaoerId": "loc_001",
+            "yixiaoerName": "广州市",
+            "raw": {}
+          }
+        }
+      }
+    ]
+  }
+}
+```
+
+## 3. 复杂对象结构说明
+
+### 3.1 OldCover
+包含 `key`, `size`, `width`, `height`。
+
+### 3.2 PlatformDataItem (位置/商品/合集/活动)
+包含 `yixiaoerId`, `yixiaoerName`, `raw` (必须完整透传)。
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 文档参考 |
+| :--- | :--- | :--- |
+| `location`  | `locations` | [获取位置信息](../../get-locations.md) |
+| `activity`  | `activities` | [获取活动列表](../../get-publish-activities.md) |
+| `shoppingCart`| `goods`   | [获取商品列表](../../get-goods.md) |
+| `video.key` | `upload`    | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,91 @@
+# 搜狐号视频发布参数 (SouHuHao Video)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Souhuhao”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Souhuhao”
+  - “同步视频到Souhuhao”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Souhuhao。
+2. **参数装配**：识别并填充标题、描述等平台特定字段至 `contentPublishForm`。
+3. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+本平台视频发布通过 `contentPublishForm` 承载以下参数。
+
+## 1. contentPublishForm 参数定义
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定值: `task` | `task` |
+| `title` | `string` | **是** | 视频标题 (5-72 字符) | - |
+| `description` | `string` | **是** | 视频描述 (5-200 字符) | - |
+| `tags` | `string[]` | **是** | 视频标签 | - |
+| `category` | `Array` | **是** | 视频分类 (`CascadingPlatformDataItem[]`) | - |
+| `declaration` | `number` | **是** | 原创类型: 0-无特别声明, 1-引用申明, 2-自行拍摄, 3-包含AI创作内容, 4-包含虚构创作 | 0 |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | - |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+
+## 2. 复杂对象结构
+
+### CascadingPlatformDataItem (级联分类)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `id` | `string` | **是** | 选项 ID |
+| `text` | `string` | **是** | 选项文本 |
+| `children` | `Array` | 否 | 子级选项列表 (`PlatformDataItem[]`) |
+| `raw` | `object` | **是** | 平台原始数据 |
+
+## 3. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "video",
+  "platforms": ["搜狐号"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_sh_video_001",
+        "video": {
+          "key": "video_resource_key",
+          "size": 10240000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "搜狐号视频发布标题示例",
+          "description": "这是关于在该平台发布视频的描述信息内容。",
+          "tags": ["科技", "数码"],
+          "category": [
+            {
+              "id": "1",
+              "text": "科技",
+              "raw": { "id": "1", "name": "科技" }
+            }
+          ],
+          "declaration": 2,
+          "pubType": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标字段 | 对应 Action | 文档参考 |
+| :--- | :--- | :--- |
+| `category` | `categories` | [获取账号分类](../../get-publish-categories.md) |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,64 @@
+# 搜狐视频 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Souhushipin”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Souhushipin”
+  - “同步视频到Souhushipin”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Souhushipin。
+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[] | 否 | 视频标签 | - |
+| declaration | number | 否 | 搜狐视频申明：0-无需申明, 3-AI生成, 4-虚构演绎, 5-AI数字人生成 | 0 |
+
+## 2. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["Souhushipin"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "SOUHU_VIDEO_ACC_ID",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "搜狐视频标题示例",
+          "description": "这是大搜狐平台的精彩视频分享内容。",
+          "tags": ["生活", "见闻"],
+          "declaration": 0
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

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

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

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

@@ -0,0 +1,66 @@
+# 头条号视频发布参数 (TouTiaoHao Video)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“今日头条 (头条号)”分发视频，且需要配置如“流量激励/申明（Declaration）”、“定时发布”或“可见性设置”等功能时触发。
+- **典型提示词**：
+  - “把这个视频发到我的头条号上”
+  - “头条号发布，申明是自行拍摄的原创内容”
+  - “我的头条视频要定时在今天晚上 8 点发布”
+  - “设为头条私密视频”
+
+## 执行逻辑 (Logic Flow)
+1. **标题优化**：头条对标题敏感且有字数要求 (1-80 字符)。
+2. **标签装配**：识别用户提供的关键词，转换为 `tags` 字符串数组（限制 1-5 个）。
+3. **申明校验**：根据内容来源注入 `declaration` 枚举；若涉及 AI 创作，必须标注为 `3-AI生成`。
+4. **参数装配**：构造 `accountForms[i].contentPublishForm`。
+5. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+## 1. contentPublishForm 参数定义
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定值: `task` | `task` |
+| `title` | `string` | **是** | 视频标题 (1-80 字符) | - |
+| `description` | `string` | **是** | 视频描述 (1-400 字符) | - |
+| `tags` | `string[]` | **是** | 视频标签 (1-5 个，字符串数组) | - |
+| `declaration` | `number` | 否 | 创作者申明：1-自行拍摄, 2-取自站外, 3-AI生成, 6-虚构演绎故事经历, 7-投资观点仅供参考, 8-健康医疗分享仅供参考 | - |
+| `scheduledTime` | `number` | 否 | 定时发布时间戳（13 位 Unix 时间戳，单位：毫秒） | - |
+| `visibleType` | `number` | **是** | 可见性: 0-公开, 1-私密 | 0 |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "video",
+  "platforms": ["头条号"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_tt_video_001",
+        "video": { "key": "v_key", "size": 10240000, "width": 1920, "height": 1080, "duration": 60 },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "今日头条发布测试",
+          "description": "这是测试视频的描述内容...",
+          "tags": ["生活", "摄影"],
+          "declaration": 1,
+          "visibleType": 0,
+          "pubType": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,93 @@
+# 网易号 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Wangyihao”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Wangyihao”
+  - “同步视频到Wangyihao”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Wangyihao。
+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` | 否 | 创作申明：1-内容由AI生成, 2-个人原创, 3-取材网络, 4-虚构演绎 | - |
+| `createType` | `number` | 否 | 创作类型：0-非原创, 1-原创 | 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_wy_002",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "网易号视频标题示例",
+          "description": "这是网易号平台的视频内容描述。",
+          "tags": ["科技", "前沿", "AI"],
+          "category": [
+            {
+              "yixiaoerId": "cat_002",
+              "yixiaoerName": "科技",
+              "raw": { "id": "1", "name": "科技" }
+            }
+          ],
+          "createType": 1,
+          "declaration": 2,
+          "pubType": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |
+| `category` | `category` | [获取发布分类](../../get-publish-categories.md) |

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

@@ -0,0 +1,61 @@
+# 腾讯微视 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Weishi”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Weishi”
+  - “同步视频到Weishi”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Weishi。
+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 | 是 | 视频描述 | - |
+| scheduledTime | number | 否 | 定时发布时间戳（13 位 Unix 时间戳，单位：毫秒） | - |
+
+## 2. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["Weishi"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "WEISHI_ACC_ID",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1080,
+          "height": 1920,
+          "duration": 15
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "腾讯微视视频标题示例",
+          "description": "这是关于腾讯微视平台内容发布的简洁描述内容。"
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,133 @@
+# 小红书视频发布参数 (XiaoHongShu Video)
+
+> [!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]`。
+
+> [!TIP]
+> 示例优先使用“标准请求体”格式：共享资源放在 `publishArgs` 根级，账号差异字段放在 `accountForms[]`。CLI 会在校验阶段自动补齐缺失资源字段。
+
+在本平台视频发布通过 `contentPublishForm`承载以下参数。
+
+## 1. contentPublishForm 参数定义
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定为 `task` | `task` |
+| `title` | `string` | 否 | 视频标题 (最多 20 字) | - |
+| `description` | `string` | 否 | 视频描述 (最多 1000 字) | - |
+| `declaration` | `number` | 否 | 内容类型申明: 1-虚构演绎, 2-笔记含 AI 合成内容 | - |
+| `createType` | `number` | 否 | 创作类型: 1-原创, 0-不申明 | 0 |
+| `location` | `object` | 否 | 视频位置，使用 `PlatformDataItem` 结构 | - |
+| `scheduledTime` | `number` | 否 | 定时发布时间戳 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `visibleType` | `number` | **是** | 可见类型: 0-公开, 1-私密, 3-好友可见 | 0 |
+| `collection` | `object` | 否 | 合集信息，使用 `Collection` 结构 | - |
+| `group` | `object` | 否 | 群聊信息，使用 `Group` 结构 | - |
+| `bind_live_info` | `object` | 否 | 直播预告信息，使用 `LiveInfo` 结构 | - |
+| `shopping_cart` | `object[]` | 否 | 关联商品信息，使用 `ShoppingCartItem` 结构数组 | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "video",
+  "platforms": ["小红书"],
+  "coverKey": "cover_key",
+  "publishArgs": {
+    "video": {
+      "key": "v_key",
+      "size": 1024000,
+      "width": 1080,
+      "height": 1440,
+      "duration": 30
+    },
+    "cover": {
+      "key": "cover_key",
+      "size": 102400,
+      "width": 1080,
+      "height": 1440
+    },
+    "coverKey": "cover_key",
+    "accountForms": [
+      {
+        "platformAccountId": "XHS_ACC_ID",
+        "mediaId": "media_001",
+        "platformName": "小红书",
+        "publishContentId": "publish_content_001",
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "小红书视频标题",
+          "description": "这是在小红书分享的一段精彩视频 #好物分享 #生活",
+          "createType": 1,
+          "visibleType": 0,
+          "declaration": 2
+        }
+      }
+    ]
+  }
+}
+```
+
+## 3. 复杂对象结构说明
+
+### 3.1 PlatformDataItem (位置)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 统一 ID |
+| `yixiaoerName` | `string` | **是** | 显示名称 |
+| `raw` | `object` | **是** | 平台原始数据 (必须完整透传) |
+
+### 3.2 Collection (合集)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 合集 ID |
+| `yixiaoerName` | `string` | **是** | 合集名称 |
+| `child` | `object[]` | 否 | 子级合集列表 |
+| `raw` | `object` | **是** | 平台原始数据 (透传) |
+
+### 3.3 Group (群聊)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 群聊 ID |
+| `yixiaoerName` | `string` | **是** | 群聊标题 |
+| `raw` | `object` | **是** | 平台原始数据 (透传) |
+
+### 3.4 LiveInfo (直播预告)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 直播预告 ID |
+| `yixiaoerName` | `string` | **是** | 直播预告标题 |
+| `raw` | `object` | **是** | 平台原始数据 (透传) |
+
+### 3.5 ShoppingCartItem (商品)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 商品 ID |
+| `yixiaoerName` | `string` | **是** | 商品名称 |
+| `yixiaoerImageUrl` | `string` | 否 | 商品图片 URL |
+| `yixiaoerDesc` | `string` | 否 | 商品说明 |
+| `price` | `number` | 否 | 商品价格（单位：分） |
+| `raw` | `object` | **是** | 平台原始数据 (透传) |
+
+## 相关接口
+
+| 目标字段 | 对应 Action | 文档参考 |
+| :--- | :--- | :--- |
+| `location` | `locations` | [获取位置信息](../../get-locations.md) |
+| `collection` | `collections` | [获取合集列表](../../get-collections.md) |
+| `group` | `groups` | [获取群聊列表](../../get-groups.md) |
+| `shopping_cart` | `goods` | [获取商品列表](../../get-goods.md) |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |