@yixiaoermail/cli 3.1.0

package/skills/yixiaoer/references/platforms/imageText/xinlangweibo.md

@@ -0,0 +1,77 @@
+# 新浪微博图文发布参数 (Sina Weibo Image-Text)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [图文发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Xinlangweibo”平台发布图文动态时触发。
+- **典型提示词**：
+  - “发几张图到Xinlangweibo”
+  - “同步这条动态到Xinlangweibo”
+
+## 执行逻辑 (Logic Flow)
+1. **资源校验**：确保所有图片均已上传并获得 Key。
+2. **参数装配**：填充描述及图片列表至 `contentPublishForm`。
+3. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+
+本平台图文发布通过 `contentPublishForm` 承载以下参数。
+
+## 1. contentPublishForm 参数定义
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定值: `task` | `task` |
+| `description` | `string` | **是** | 微博博文内容，支持 HTML (`<p>`, `<topic>`)。最多 1000 字符。 | - |
+| `images` | `Array` | **是** | 图片数组 (`OldImage[]`) | - |
+| `location` | `Object` | 否 | 位置信息 (`PlatformDataItem`) | - |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+
+## 2. 复杂对象结构说明
+
+### 复杂对象：OldImage
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `width` | `number` | **是** | 图片宽度 | - |
+| `height` | `number` | **是** | 图片高度 | - |
+| `size` | `number` | **是** | 文件大小 (Bytes) | - |
+| `key` | `string` | **是** | 资源 Key (通过上传接口获取) | - |
+| `format` | `string` | **是** | 文件格式 (e.g., `jpg`, `png`) | - |
+
+## 3. 依赖接口说明
+
+若字段值需通过查询获得，需注明：
+- **位置 (location)**: 需通过 `[获取地理位置](../../get-locations.md)` 获得对应的 `PlatformDataItem`。
+- **话题 (topic)**: 在 `description` 中使用 `<topic>` 标签时，话题数据需通过 `[获取话题](../../get-topics.md)` 获得。
+
+## 4. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "imageText",
+  "platforms": ["新浪微博"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "WB_ACC_ID",
+        "contentPublishForm": {
+          "formType": "task",
+          "description": "<p>微博动态内容 <topic text='微博' raw='{\"id\":\"xxx\",\"name\":\"微博\"}'>#微博</topic></p>",
+          "images": [
+            { "key": "img_wb_01", "size": 1024, "width": 1080, "height": 1440, "format": "jpg" }
+          ]
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `images.key` | `upload` | [资源上传](../../upload-resource.md) |

package/skills/yixiaoer/references/platforms/imageText/zhihu.md

@@ -0,0 +1,92 @@
+# 知乎图文发布参数 (Zhihu Image-Text)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [图文发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“知乎”平台发布图文动态时触发。
+- **典型提示词**：
+  - “发几张图到知乎”
+  - “同步这条动态到知乎”
+
+## 执行逻辑 (Logic Flow)
+1. **资源校验**：确保所有图片均已上传并获得 Key。
+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` | 否 | 标题 (1-50 字符) | - |
+| `description` | `string` | **是** | 图文内容，支持 HTML 格式及话题/好友/活动标签 | - |
+| `images` | `Array` | 否 | 图片数组 (`OldImage[]`, 1-9 张) | - |
+
+## 2. 复杂对象结构说明
+
+### 复杂对象：OldImage
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `width` | `number` | **是** | 图片宽度 | - |
+| `height` | `number` | **是** | 图片高度 | - |
+| `size` | `number` | **是** | 文件大小 (Bytes) | - |
+| `key` | `string` | **是** | 资源 Key (通过上传接口获取) | - |
+| `format` | `string` | **是** | 文件格式 (e.g., `jpg`, `png`) | - |
+
+### description 标签说明
+
+知乎图文描述支持 HTML 格式，内容应由 `<p>` 标签包裹。支持以下自定义标签：
+
+- **话题 (topic)**: 使用 `<topic text='名称' raw='{...}'>#名称</topic>`。最多 5 个。
+- **好友 (friend)**: 使用 `<friend raw='{...}'>@好友名</friend>`。
+- **活动 (activity)**: 使用 `<activity raw='{...}'>活动名</activity>`。
+
+> [!IMPORTANT]
+> 所有的 `raw` 属性必须存放完整的原始数据 JSON 序列化字符串（包含 `yixiaoerId`, `yixiaoerName` 及原始 `raw` 字段）。
+
+## 3. 依赖接口说明
+
+若字段值需通过查询获得，需注明：
+- **话题 (topic)**: 需通过 `[获取话题](../../get-topics.md)` 获得。
+- **好友 (friend)**: 需通过 `[获取好友/关注](../../get-friends.md)` 获得。
+- **活动 (activity)**: 需通过 `[获取征文活动列表](../../get-publish-activities.md)` 获得。
+
+## 4. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "imageText",
+  "platforms": ["知乎"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "ZH_ACC_ID",
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "知乎图文标题",
+          "description": "<p>知乎想法内容 <topic text='知识' raw='{\"yixiaoerId\":\"123\",\"yixiaoerName\":\"知识\",\"raw\":{}}'>#知识</topic> @<friend raw='{\"yixiaoerId\":\"456\",\"raw\":{\"nick\":\"张三\"}}'>张三</friend></p>",
+          "images": [
+            { "key": "img_zh_01", "size": 1024, "width": 1080, "height": 1440, "format": "jpg" }
+          ]
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `topic` | `challenges` | [获取话题/挑战](../../get-challenges.md) |
+| `images.key` | `upload` | [资源上传](../../upload-resource.md) |
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `images.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,20 @@
+# 平台参考索引
+
+平台字段和差异说明已收敛到 skill 包内部。Agent 应优先从本目录进入，而不是回到仓库根目录漫游。
+
+## 通用索引
+
+- 图文：`./imageText/index.md`
+- 视频：`./video/index.md`
+- 文章：`./article/index.md`
+
+## 使用原则
+
+1. 先走工作流和 `yxer` CLI。
+2. 只有在构造平台特有字段时，才继续查具体平台文档。
+3. 如果字段来源可以由 `yxer query categories`、`yxer query locations`、`yxer query music` 等命令获得，优先用命令，不要手写对象。
+
+## 维护约束
+
+- 平台文档的 skill 内副本应与仓库根目录维护态文档保持同步
+- skill 运行时优先读取本目录，不应再依赖任何根级历史平台副本

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

@@ -0,0 +1,82 @@
+# AcFun视频发布参数 (AcFun Video)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Acfun”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Acfun”
+  - “同步视频到Acfun”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Acfun。
+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` | **是** | 视频标题 | - |
+| `description` | `string` | 否 | 视频描述 (建议 HTML 格式用 `<p>` 包裹) | - |
+| `tags` | `string[]` | 否 | 视频标签 (最多 6 个) | - |
+| `category` | `Array` | **是** | 视频分类，使用 `CascadingPlatformDataItem[]` 结构 | - |
+| `type` | `number` | **是** | 内容类型: 1-原创, 0-非原创 | 0 |
+| `scheduledTime` | `number` | 否 | 定时发布时间戳 (13 位 Unix 时间戳，单位: 毫秒) | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "video",
+  "platforms": ["AcFun"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "AC_ACC_ID",
+        "video": {
+          "key": "video_oss_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "AcFun 视频发布标题",
+          "description": "<p>这是 AcFun 视频的描述内容</p>",
+          "tags": ["生活", "美食"],
+          "category": [
+            { "yixiaoerId": "cat_001", "yixiaoerName": "生活", "raw": {} }
+          ],
+          "type": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 3. 复杂对象结构说明
+
+### 3.1 CascadingPlatformDataItem (多级分类)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | ID |
+| `yixiaoerName` | `string` | **是** | 文本内容 |
+| `raw` | `object` | **是** | 平台原始数据 (必须完整透传) |
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |
+| `category` | `categories` | [获取发布分类](../../get-publish-categories.md) |

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

@@ -0,0 +1,89 @@
+# 爱奇艺视频发布参数 (AiQiYi Video)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Aiqiyi”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Aiqiyi”
+  - “同步视频到Aiqiyi”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Aiqiyi。
+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` | **是** | 视频标题 (长度: 1-50 字符) | - |
+| `description` | `string` | **是** | 视频描述 (长度: 1-500 字符) | - |
+| `tags` | `string[]` | **否** | 视频标签 (最多 10 个) | - |
+| `category` | `Array` | **是** | 视频分类，使用 `CascadingPlatformDataItem[]` 结构 | - |
+| `createType` | `number` | **是** | 内容类型：1-原创，2-转载 | 1 |
+| `pubType` | `number` | **是** | 发布类型：0-草稿，1-直接发布 | 1 |
+| `declaration` | `number` | **否** | 声明：0-无需申明，1-内容由 AI 生成, 2-虚构演绎, 3-取材网络 | 0 |
+| `scheduledTime` | `number` | **否** | 定时任务 (13 位 Unix 时间戳，单位: 毫秒) | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "video",
+  "platforms": ["爱奇艺"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_aqy_vid_001",
+        "video": {
+          "key": "video_oss_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 120
+        },
+        "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,
+          "pubType": 1,
+          "declaration": 0
+        }
+      }
+    ]
+  }
+}
+```
+
+## 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/baijiahao.md

@@ -0,0 +1,89 @@
+# 百家号视频发布参数 (BaiJiaHao Video)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Baijiahao”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Baijiahao”
+  - “同步视频到Baijiahao”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Baijiahao。
+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` | **是** | 视频标题 (1-30 字符) | - |
+| `description` | `string` | **是** | 视频描述 (1-100 字符) | - |
+| `tags` | `string[]` | **是** | 视频标签 (1-6 个) | - |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
+| `declaration` | `number` | 否 | 声明: 0-不声明, 1-内容由 AI 生成 | 0 |
+| `location` | `Object` | 否 | 位置信息，使用 `PlatformDataItem` 结构 | - |
+| `scheduledTime` | `number` | 否 | 定时发布时间戳 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `collection` | `Object` | 否 | 合集信息 (`yixiaoerId`, `yixiaoerName`, `raw`) | - |
+| `activity` | `Object` | 否 | 征文活动信息 (`yixiaoerId`, `yixiaoerName`, `raw`) | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "video",
+  "platforms": ["百家号"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_bjh_video_001",
+        "video": {
+          "key": "video_oss_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "百家号视频标题",
+          "description": "视频精彩描述内容...",
+          "tags": ["科技", "未来"],
+          "pubType": 1,
+          "declaration": 0,
+          "location": {
+            "yixiaoerId": "loc_001",
+            "yixiaoerName": "北京市",
+            "raw": {}
+          }
+        }
+      }
+    ]
+  }
+}
+```
+
+## 3. 复杂对象结构说明
+
+### 3.1 PlatformDataItem / Category
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 统一 ID |
+| `yixiaoerName` | `string` | **是** | 显示名称 |
+| `raw` | `object` | **是** | 平台原始数据 (必须完整透传) |
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |
+| `location` | `locations` | [获取位置信息](../../get-locations.md) |
+| `activity` | `activities` | [获取征文活动](../../get-publish-activities.md) |

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

@@ -0,0 +1,87 @@
+# 哔哩哔哩-Open 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Bilibili-open”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Bilibili-open”
+  - “同步视频到Bilibili-open”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Bilibili-open。
+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-理性适度消费, 6-个人观点 | 0 |
+| type | number | 是 | 类型：1-自制, 2-转载 | 1 |
+| scheduledTime | number | 否 | 定时发布时间戳（13 位 Unix 时间戳，单位：毫秒） | - |
+| contentSourceUrl | string | 否 | 原文url链接，当 `type` 为 2 (转载) 时必填 | - |
+| collection | object | 否 | 合集信息 | - |
+
+## 2. 复杂对象结构
+
+### CascadingPlatformDataItem
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | string | 是 | 选项ID |
+| text | string | 是 | 选项文本 |
+| children | object[] | 否 | 子级选项列表 (CascadingPlatformDataItem[]) |
+| raw | object | 是 | 平台原始数据 |
+
+## 3. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["BilibiliOpen"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "BILIBILI_OPEN_ACC_ID",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "B站Open视频标题示例",
+          "description": "这是关于B站Open版接入视频发布的描述内容。",
+          "tags": ["科技", "极客"],
+          "category": [
+            {
+              "id": "1",
+              "text": "生活",
+              "raw": {}
+            }
+          ],
+          "declaration": 0,
+          "type": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,80 @@
+# 哔哩哔哩视频发布参数 (BiLiBiLi Video)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“哔哩哔哩 (B站)”分发视频，且需要配置如“申明原创/转载”、“设置视频分区 (Category)”、“关联合集”或“打标签 (Tags)”等 B 站特有社区功能时触发。
+- **典型提示词**：
+  - “把这个视频投到 B 站的生活区”
+  - “B 站发布，申明是自制原创内容”
+  - “添加‘摄影’、‘数码’标签到 B 站投稿”
+  - “帮我同步这个视频到 B 站的 XXX 合集”
+
+## 执行逻辑 (Logic Flow)
+1. **分类预校验**：B 站投稿对分类 (Category) 要求极其严格，必须包含父子级 DTO。调用 `categories` 获取合法值。
+2. **标签装配**：识别用户提供的关键词，转换为 `tags` 字符串数组（B 站限制 1-10 个）。
+3. **申明判定**：根据 `createType`（自制/转载）自动匹配 `contentSourceUrl`。
+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` | **是** | 视频标题 (最多 80 字符) | - |
+| `description` | `string` | 否 | 视频描述 (最多 2000 字符) | - |
+| `tags` | `string[]` | **是** | 视频标签 (1-10 个，字符串数组) | - |
+| `category` | `Array` | **是** | 视频分类，使用 `CascadingPlatformDataItem[]` 结构 | - |
+| `declaration` | `number` | 否 | 创作者申明：0-不申明, 1-AI合成, 2-危险行为, 3-仅供娱乐, 4-引人不适, 5-理性适度消费, 6-个人观点 | 0 |
+| `createType` | `number` | **是** | 类型：1-自制, 2-转载 | 1 |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
+| `scheduledTime` | `number` | 否 | 定时发布时间戳 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `contentSourceUrl` | `string` | 否 | 原文 URL 链接 (当 `createType` 为 2 时必填) | - |
+| `collection` | `object` | 否 | 合集信息，使用 `Collection` 结构 | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "video",
+  "platforms": ["哔哩哔哩"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "BILIBILI_ACC_ID",
+        "video": { "key": "v_key", "size": 1024000, "width": 1920, "height": 1080, "duration": 60 },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "我的第一条 B 站投稿",
+          "tags": ["生活", "摄影"],
+          "category": [
+            { "yixiaoerId": "cat_001", "yixiaoerName": "生活", "raw": {} }
+          ],
+          "createType": 1,
+          "pubType": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 3. 复杂对象结构说明
+
+### 3.1 CascadingPlatformDataItem (多级分类)
+包含 `yixiaoerId`, `yixiaoerName`, `raw`。
+
+### 3.2 Collection (合集)
+包含 `yixiaoerId`, `yixiaoerName`。
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |
+| `category`  | `categories` | [获取发布分类](../../get-publish-categories.md) |
+| `collection`| `collections` | [获取合集列表](../../get-collections.md) |