@yixiaoermail/cli 3.1.0

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

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

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

@@ -0,0 +1,89 @@
+# 大鱼号视频发布参数 (DaYuHao Video)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Dayuhao”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Dayuhao”
+  - “同步视频到Dayuhao”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Dayuhao。
+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` | **是** | 视频标题 (最多 50 字符) | - |
+| `description` | `string` | **是** | 视频描述 (最多 1000 字符) | - |
+| `tags` | `string[]` | **是** | 视频标签 (1-6 个) | - |
+| `category` | `Array` | 否 | 视频分类，使用 `CascadingPlatformDataItem[]` | - |
+| `createType` | `number` | 否 | 创作类型: 0-非原创, 1-原创 | 0 |
+| `declaration` | `number` | 否 | 声明字段: 0-无需申明, 3-虚构演绎, 4-AI 生成 | 0 |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
+| `scheduledTime` | `number` | 否 | 定时发布时间戳 (13 位 Unix 时间戳，单位: 毫秒) | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "video",
+  "platforms": ["大鱼号"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_dy_vid_001",
+        "video": {
+          "key": "video_oss_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "coverKey": "video_cover_key",
+        "cover": { "key": "video_cover_key", "size": 102400, "width": 800, "height": 600 },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "大鱼号视频发布标题",
+          "description": "这是关于此视频的详细描述内容。",
+          "tags": ["生活", "摄影"],
+          "category": [
+            { "yixiaoerId": "cat_001", "yixiaoerName": "生活", "raw": {} }
+          ],
+          "createType": 1,
+          "declaration": 0,
+          "pubType": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 3. 复杂对象结构说明
+
+### 3.1 CascadingPlatformDataItem (分类对象)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 级联 ID |
+| `yixiaoerName` | `string` | **是** | 级联显示的名称 |
+| `children` | `Array` | 否 | 子级对象列表 |
+| `raw` | `object` | **是** | 平台原始对象 (必须透传) |
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |
+| `category` | `categories` | [获取发布分类](../../get-publish-categories.md) |

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

@@ -0,0 +1,80 @@
+# 得物 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Dewu”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Dewu”
+  - “同步视频到Dewu”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Dewu。
+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[]` 结构 | - |
+| declaration | number | 是 | 创作者申明：0-不添加自主声明, 1-内容由AI生成, 2-内容不含营销推广属性, 3-内容涉及专业运动, 4-剧情演绎仅供娱乐 | 0 |
+
+## 2. 复杂对象结构
+
+### CascadingPlatformDataItem
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | string | 是 | 选项ID |
+| text | string | 是 | 选项文本 |
+| children | object[] | 否 | 子级选项列表 (CascadingPlatformDataItem[]) |
+| raw | object | 是 | 平台原始数据 |
+
+## 3. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["Dewu"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "DEWU_ACC_ID",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "得物穿搭视频示例",
+          "description": "这是一段关于得物穿搭分享的视频描述。",
+          "category": [
+            {
+              "id": "1",
+              "text": "穿搭",
+              "raw": {}
+            }
+          ],
+          "declaration": 2
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,143 @@
+# 抖音视频发布参数 (DouYin Video)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“抖音”平台发布视频，且需要配置如“地点挂载”、“合集关联”、“添加背景音乐”、“关联小程序/游戏”等抖音特有社交与变现功能时触发。
+- **典型提示词**：
+  - “把这个视频发布到抖音，并带上 #风景 话题”
+  - “在抖音发布时挂载这个小游戏”
+  - “查询抖音热门音乐并添加”
+  - “声明这个抖音视频是由 AI 生成的”
+
+## 执行逻辑 (Logic Flow)
+1. **意图细化**：识别抖音特有的增强功能需求（如地点、音乐、合集）。
+2. **辅助查询**：对于 `location`, `music`, `challenge` 等字段，必须先调用对应的 `get-*` action 获取标准 ID 及 `raw` 数据。
+3. **参数装配**：将细化参数封装至 `accountForms[i].contentPublishForm`。
+4. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+> [!TIP]
+> 抖音视频如涉及话题，请先读取 [`../../topic-tags.md`](../../topic-tags.md)。标准做法是直接传平台字段定义的最终结构，不依赖 CLI 从 `tags` 自动改写 `description`。
+
+> [!TIP]
+> 示例优先使用“标准请求体”格式：共享资源放在 `publishArgs` 根级，账号差异字段放在 `accountForms[]`。CLI 会在校验阶段自动补齐缺失资源字段。
+
+> 说明：仓库当前不再把 `syncComment` 作为公开 schema 字段暴露，因为现有文档、查询命令和工作流里都没有它的稳定来源或获取流程。
+
+## 1. contentPublishForm 参数定义
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定为 `task` | `task` |
+| `title` | `string` | **是** | 抖音视频标题 (1-30 字) | - |
+| `description` | `string` | **是** | 抖音视频描述 (1-30 字) | - |
+| `horizontalCover` | `object` | 否 | 抖音视频横板封面，使用 `OldCover` 结构 | - |
+| `declaration` | `number` | 否 | 声明: 3-内容从 AI 生成, 4-可能引人不适, 5-虚构演绎, 6-危险行为 | - |
+| `location` | `object` | 否 | 抖音视频位置，使用 `PlatformDataItem` 结构 | - |
+| `scheduledTime` | `number` | 否 | 定时发布时间戳 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `allow_save` | `number` | 否 | 保存权限: 0-不允许, 1-允许 | 0 |
+| `shopping_cart` | `object[]` | 否 | 购物车列表，使用 `ShoppingCart` 结构；旧字段 `shoppingCart` 会在预检阶段自动归一化 | - |
+| `groupShopping` | `object` | 否 | 团购信息，使用 `ShoppingCart` 结构 | - |
+| `collection` | `object` | 否 | 合集信息，使用 `Category` 结构 | - |
+| `sub_collection` | `object` | 否 | 合集选集，使用 `Category` 结构 | - |
+| `sync_apps` | `object[]` | 否 | 同时发布应用，使用 `Category[]` | - |
+| `hot_event` | `object` | 否 | 热点事件，使用 `Category` 结构 | - |
+| `challenge` | `object` | 否 | 挑战/话题，使用 `Category` 结构 | - |
+| `mini_app` | `object` | 否 | 挂载小程序 (与购物车互斥)，使用 `MiniApp` 结构 | - |
+| `music` | `object` | 否 | 背景音乐信息，使用 `MusicItem` 结构 | - |
+| `cooperation_info` | `object` | 否 | 共创信息 | - |
+| `game` | `object` | 否 | 游戏挂载信息，使用 `GameItem` 结构 | - |
+
+## 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": "DOUYIN_ACC_ID",
+        "mediaId": "media_001",
+        "platformName": "抖音",
+        "publishContentId": "publish_content_001",
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "记录美好生活",
+          "description": "这是我在抖音的第一条视频 #美好生活 #见闻",
+          "declaration": 3,
+          "location": {
+            "yixiaoerId": "123",
+            "yixiaoerName": "上海市",
+            "raw": {}
+          }
+        }
+      }
+    ]
+  }
+}
+```
+
+## 3. 复杂对象结构说明
+
+### 3.1 OldCover
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `key` | `string` | **是** | OSS 资源 Key |
+| `size` | `number` | **是** | 文件大小 (Bytes) |
+| `width` | `number` | **是** | 宽度 |
+| `height` | `number` | **是** | 高度 |
+
+### 3.2 PlatformDataItem / Category / MiniApp / GameItem
+所有统一的基础结构必须包含 `yixiaoerId`, `yixiaoerName`, `raw`。
+- `raw`: 平台原始数据。如果在获取时该字段存在，发布表单中必须携带并完整透传。
+
+### 3.3 ShoppingCart (购物车/团购)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `sale_title` | `string` | **是** | 推广标题 (最多 10 字) |
+| `images` | `string[]` | **是** | 商品图片数组 |
+| `data` | `object` | **是** | 核心商品数据对象 |
+
+`data` 内部必须包含以下字段：
+
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 商品 ID |
+| `yixiaoerName` | `string` | **是** | 商品名称 |
+| `raw` | `object` | **是** | 平台原始数据 (透传) |
+
+### 3.4 MusicItem (音乐)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 内部 ID |
+| `yixiaoerName` | `string` | **是** | 歌曲名称 |
+| `duration` | `number` | **是** | 时长 (秒) |
+| `raw` | `object` | **是** | 原始数据 (透传) |
+
+## 相关接口
+
+| 目标字段 | 对应 Action | 文档参考 |
+| :--- | :--- | :--- |
+| `location` | `locations` | [获取位置信息](../../get-locations.md) |
+| `collection` | `collections` | [获取合集列表](../../get-collections.md) |
+| `shopping_cart` | `goods` | [获取商品列表](../../get-goods.md) |
+| ... | ... | ... |

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

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

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

@@ -0,0 +1,81 @@
+# 凤凰网 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Fengwang”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Fengwang”
+  - “同步视频到Fengwang”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Fengwang。
+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[]` 结构 | - |
+| scheduledTime | number | 否 | 定时发布时间戳（13 位 Unix 时间戳，单位：毫秒） | - |
+
+## 2. 复杂对象结构
+
+### CascadingPlatformDataItem
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | string | 是 | 选项ID |
+| text | string | 是 | 选项文本 |
+| children | object[] | 否 | 子级选项列表 (CascadingPlatformDataItem[]) |
+| raw | object | 是 | 平台原始数据 |
+
+## 3. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["Fengwang"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "FENGWANG_ACC_ID",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "凤凰网资讯视频标题",
+          "description": "这是凤凰网平台的一则重要资讯视频内容。",
+          "tags": ["资讯", "社会"],
+          "category": [
+            {
+              "id": "1",
+              "text": "社会",
+              "raw": {}
+            }
+          ]
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |