@yixiaoermail/cli 3.1.1 → 3.1.2

package/references/workflows/publish-video.md

@@ -0,0 +1,63 @@
+# 视频发布工作流
+
+> 适用范围：抖音视频、快手视频、B 站视频、视频号视频、微博视频等。
+> 阅读本文档前，请先阅读 [common-rules.md](./common-rules.md)。
+
+---
+
+## 推荐入口
+
+仅支持 `payload.json` 模式。发布前先获取表单字段和 schema：
+
+```bash
+yxer prepare <platform> video
+yxer schema fields <platform> video
+yxer schema get <platform> video
+```
+
+开始前，先补读：
+
+- [`account-selection.md`](./account-selection.md)
+- [`local-vs-cloud.md`](./local-vs-cloud.md)
+- [`payload-sourcing.md`](./payload-sourcing.md)
+
+## 执行顺序
+
+1. 查询账号：`yxer accounts list [platform] [--status 1] [--json]`
+2. 获取前置数据：`yxer prepare <platform> video`
+3. 先获取字段视图：`yxer schema fields <platform> video`；需要 payload 骨架时再执行 `yxer schema get <platform> video`
+4. 上传视频：`yxer upload <视频路径或URL>`
+5. 上传封面：`yxer upload <封面路径或URL>`
+6. 按需查询分类、位置、音乐、合集、话题、商品
+7. 根据前置数据、schema 和字段来源纪律填写 `payload.json`
+8. 查阅对应平台文档：`skills/yixiaoer/references/platforms/video/`
+9. 执行校验：`yxer validate <platform> video <payload.json>`
+10. 正式发布：`yxer publish video <platform> <payload.json>`
+
+## 关键规则
+
+- 发布前必须确认目标账号 `status=1`
+- 视频只能有一个，封面必须单独上传
+- 用户未提供封面时，必须补问，不要自动截帧
+- 可选复杂对象必须通过查询命令取得完整对象后再填入
+- 发布前先看 `prepare` 和 `schema fields` 返回的字段；只有要确认完整骨架时再看 `schema get`
+- `payload.json` 必须使用统一标准结构：顶层 `publishArgs`，业务字段放在 `publishArgs.accountForms[].contentPublishForm`
+- 用户明确要求本机发布时，必须显式传 `--publish-channel local` 和 `--client-id`
+
+## 发布示例
+
+```bash
+yxer validate 抖音 video .\payload.json
+yxer publish video 抖音 .\payload.json
+```
+
+## 本机发布示例
+
+```bash
+yxer publish video 抖音 .\payload.json --publish-channel local --client-id <clientId>
+```
+
+## 平台文档入口
+
+- 索引：`skills/yixiaoer/references/platforms/video/index.md`
+- 平台细节：`skills/yixiaoer/references/platforms/video/*.md`

package/schemas/account.schema.json

@@ -0,0 +1,19 @@
+{
+  "title": "YiXiaoEr Account Schema Root",
+  "type": "object",
+  "required": [
+    "platformAccountId"
+  ],
+  "properties": {
+    "platformAccountId": {
+      "type": "string"
+    },
+    "status": {
+      "type": "number"
+    },
+    "nickname": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/platforms/acfun.article.schema.json

@@ -0,0 +1,117 @@
+{
+  "title": "AcFun 文章发布表单 (AcFun Article)",
+  "type": "object",
+  "required": [
+    "formType",
+    "title",
+    "content",
+    "covers",
+    "category",
+    "type"
+  ],
+  "properties": {
+    "formType": {
+      "type": "string",
+      "const": "task"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 50
+    },
+    "content": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 50000
+    },
+    "covers": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "key",
+          "size",
+          "width",
+          "height"
+        ],
+        "properties": {
+          "key": {
+            "type": "string"
+          },
+          "size": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "width": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "height": {
+            "type": "integer",
+            "minimum": 1
+          }
+        }
+      }
+    },
+    "category": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "yixiaoerId",
+          "yixiaoerName",
+          "raw"
+        ],
+        "properties": {
+          "yixiaoerId": {
+            "type": "string"
+          },
+          "yixiaoerName": {
+            "type": "string"
+          },
+          "raw": {
+            "type": "object"
+          }
+        }
+      }
+    },
+    "type": {
+      "type": "number",
+      "enum": [
+        0,
+        1
+      ],
+      "default": 0
+    },
+    "desc": {
+      "type": "string",
+      "maxLength": 200
+    },
+    "tags": {
+      "type": "array",
+      "maxItems": 1,
+      "items": {
+        "type": "string"
+      }
+    },
+    "contentSourceUrl": {
+      "type": "string",
+      "format": "uri"
+    },
+    "pubType": {
+      "type": "number",
+      "enum": [
+        0,
+        1
+      ],
+      "default": 1
+    },
+    "scheduledTime": {
+      "type": "number",
+      "minimum": 0
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/platforms/acfun.video.schema.json

@@ -0,0 +1,139 @@
+{
+  "title": "AcFun 视频发布表单 (AcFun Video)",
+  "type": "object",
+  "required": [
+    "formType",
+    "title",
+    "category",
+    "type"
+  ],
+  "properties": {
+    "formType": {
+      "type": "string",
+      "const": "task"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "category": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "yixiaoerId",
+          "yixiaoerName",
+          "raw"
+        ],
+        "properties": {
+          "yixiaoerId": {
+            "type": "string"
+          },
+          "yixiaoerName": {
+            "type": "string"
+          },
+          "raw": {
+            "type": "object"
+          }
+        }
+      }
+    },
+    "type": {
+      "type": "number",
+      "enum": [
+        0,
+        1
+      ],
+      "default": 0
+    },
+    "description": {
+      "type": "string"
+    },
+    "tags": {
+      "type": "array",
+      "maxItems": 6,
+      "items": {
+        "type": "string"
+      }
+    },
+    "video": {
+      "type": "object",
+      "required": [
+        "key",
+        "size",
+        "width",
+        "height"
+      ],
+      "properties": {
+        "key": {
+          "type": "string"
+        },
+        "size": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "width": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "height": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "duration": {
+          "type": "number",
+          "minimum": 1
+        },
+        "format": {
+          "type": "string",
+          "enum": [
+            "mp4",
+            "mov",
+            "flv",
+            "avi"
+          ]
+        }
+      }
+    },
+    "cover": {
+      "type": "object",
+      "required": [
+        "key",
+        "size",
+        "width",
+        "height"
+      ],
+      "properties": {
+        "key": {
+          "type": "string"
+        },
+        "size": {
+          "type": "integer"
+        },
+        "width": {
+          "type": "integer"
+        },
+        "height": {
+          "type": "integer"
+        }
+      }
+    },
+    "coverKey": {
+      "type": "string"
+    },
+    "scheduledTime": {
+      "type": "number",
+      "minimum": 0
+    },
+    "pubType": {
+      "type": "number",
+      "enum": [
+        0,
+        1
+      ],
+      "default": 1
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/platforms/aiqiyi.article.schema.json

@@ -0,0 +1,29 @@
+{
+  "title": "爱奇艺文章发布表单 (AiQiYi Article)",
+  "type": "object",
+  "required": [
+    "formType",
+    "title",
+    "pubType"
+  ],
+  "properties": {
+    "formType": {
+      "type": "string",
+      "const": "task"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 50
+    },
+    "pubType": {
+      "type": "number",
+      "enum": [
+        0,
+        1
+      ],
+      "default": 1
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/platforms/aiqiyi.video.schema.json

@@ -0,0 +1,154 @@
+{
+  "title": "爱奇艺视频发布表单 (AiQiYi Video)",
+  "type": "object",
+  "required": [
+    "formType",
+    "title",
+    "description",
+    "category",
+    "createType",
+    "pubType"
+  ],
+  "properties": {
+    "formType": {
+      "type": "string",
+      "const": "task"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 50
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 500
+    },
+    "category": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "yixiaoerId",
+          "yixiaoerName",
+          "raw"
+        ],
+        "properties": {
+          "yixiaoerId": {
+            "type": "string"
+          },
+          "yixiaoerName": {
+            "type": "string"
+          },
+          "raw": {
+            "type": "object"
+          }
+        }
+      }
+    },
+    "createType": {
+      "type": "number",
+      "enum": [
+        1,
+        2
+      ],
+      "default": 1
+    },
+    "pubType": {
+      "type": "number",
+      "enum": [
+        0,
+        1
+      ],
+      "default": 1
+    },
+    "tags": {
+      "type": "array",
+      "maxItems": 10,
+      "items": {
+        "type": "string",
+        "maxLength": 20
+      }
+    },
+    "declaration": {
+      "type": "number",
+      "enum": [
+        0,
+        1,
+        2,
+        3
+      ]
+    },
+    "video": {
+      "type": "object",
+      "required": [
+        "key",
+        "size",
+        "width",
+        "height"
+      ],
+      "properties": {
+        "key": {
+          "type": "string"
+        },
+        "size": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "width": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "height": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "duration": {
+          "type": "number",
+          "minimum": 1
+        },
+        "format": {
+          "type": "string",
+          "enum": [
+            "mp4",
+            "mov",
+            "flv",
+            "mkv"
+          ]
+        }
+      }
+    },
+    "cover": {
+      "type": "object",
+      "required": [
+        "key",
+        "size",
+        "width",
+        "height"
+      ],
+      "properties": {
+        "key": {
+          "type": "string"
+        },
+        "size": {
+          "type": "integer"
+        },
+        "width": {
+          "type": "integer"
+        },
+        "height": {
+          "type": "integer"
+        }
+      }
+    },
+    "coverKey": {
+      "type": "string"
+    },
+    "scheduledTime": {
+      "type": "number",
+      "minimum": 0
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/platforms/baijiahao.article.schema.json

@@ -0,0 +1,160 @@
+{
+  "title": "百家号文章发布表单 (BaijiaHao Article)",
+  "type": "object",
+  "required": [
+    "formType",
+    "title",
+    "content",
+    "covers",
+    "pubType"
+  ],
+  "properties": {
+    "formType": {
+      "type": "string",
+      "const": "task"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64
+    },
+    "content": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 50000
+    },
+    "covers": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 3,
+      "items": {
+        "type": "object",
+        "required": [
+          "key",
+          "size",
+          "width",
+          "height"
+        ],
+        "properties": {
+          "key": {
+            "type": "string"
+          },
+          "size": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "width": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "height": {
+            "type": "integer",
+            "minimum": 1
+          }
+        }
+      }
+    },
+    "coverKey": {
+      "type": "string"
+    },
+    "thumbMediaId": {
+      "type": "string"
+    },
+    "category": {
+      "type": "array",
+      "minItems": 2,
+      "maxItems": 2,
+      "items": {
+        "type": "object",
+        "required": [
+          "yixiaoerId",
+          "yixiaoerName"
+        ],
+        "properties": {
+          "yixiaoerId": {
+            "type": "string"
+          },
+          "yixiaoerName": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "original": {
+      "type": "boolean",
+      "default": false
+    },
+    "originalType": {
+      "type": "number",
+      "enum": [
+        0,
+        1,
+        2
+      ]
+    },
+    "originalUrl": {
+      "type": "string",
+      "format": "uri"
+    },
+    "reprintType": {
+      "type": "number",
+      "enum": [
+        0,
+        1
+      ]
+    },
+    "declaration": {
+      "type": "number",
+      "enum": [
+        0,
+        1
+      ],
+      "default": 0
+    },
+    "activity": {
+      "type": "object",
+      "required": [
+        "yixiaoerId",
+        "yixiaoerName",
+        "raw"
+      ],
+      "properties": {
+        "yixiaoerId": {
+          "type": "string"
+        },
+        "yixiaoerName": {
+          "type": "string"
+        },
+        "raw": {
+          "type": "object"
+        }
+      }
+    },
+    "pubType": {
+      "type": "number",
+      "enum": [
+        0,
+        1
+      ],
+      "default": 1
+    },
+    "scheduledTime": {
+      "type": "number",
+      "minimum": 0
+    },
+    "publishTime": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "statement": {
+      "type": "number",
+      "enum": [
+        1,
+        2,
+        3
+      ]
+    }
+  },
+  "additionalProperties": false
+}