@yixiaoermail/cli 3.1.0 → 3.1.2

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

@@ -0,0 +1,104 @@
+{
+  "title": "知乎文章发布表单 (Zhihu Article)",
+  "type": "object",
+  "required": [
+    "formType",
+    "title",
+    "content",
+    "pubType"
+  ],
+  "properties": {
+    "formType": {
+      "type": "string",
+      "const": "task"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 9,
+      "maxLength": 100
+    },
+    "content": {
+      "type": "string",
+      "minLength": 9,
+      "maxLength": 10000
+    },
+    "covers": {
+      "type": "array",
+      "maxItems": 20,
+      "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
+          }
+        }
+      }
+    },
+    "topics": {
+      "type": "array",
+      "maxItems": 3,
+      "items": {
+        "type": "object",
+        "required": [
+          "yixiaoerId",
+          "yixiaoerName",
+          "raw"
+        ],
+        "properties": {
+          "yixiaoerId": {
+            "type": "string"
+          },
+          "yixiaoerName": {
+            "type": "string"
+          },
+          "raw": {
+            "type": "object"
+          }
+        }
+      }
+    },
+    "declaration": {
+      "type": "number",
+      "enum": [
+        0,
+        1,
+        2,
+        3,
+        4,
+        5
+      ],
+      "default": 0
+    },
+    "pubType": {
+      "type": "number",
+      "enum": [
+        0,
+        1
+      ],
+      "default": 1
+    },
+    "scheduledTime": {
+      "type": "number",
+      "minimum": 0
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/platforms/zhihu.imageText.schema.json

@@ -0,0 +1,61 @@
+{
+  "title": "Zhihu Image-Text Publish Form (Strict Standards)",
+  "type": "object",
+  "required": [
+    "formType",
+    "description"
+  ],
+  "properties": {
+    "formType": {
+      "type": "string",
+      "const": "task"
+    },
+    "title": {
+      "type": "string",
+      "maxLength": 50
+    },
+    "description": {
+      "type": "string",
+      "minLength": 2
+    },
+    "images": {
+      "type": "array",
+      "maxItems": 9,
+      "items": {
+        "type": "object",
+        "required": [
+          "key",
+          "size",
+          "width",
+          "height",
+          "format"
+        ],
+        "properties": {
+          "key": {
+            "type": "string"
+          },
+          "size": {
+            "type": "integer"
+          },
+          "width": {
+            "type": "integer"
+          },
+          "height": {
+            "type": "integer"
+          },
+          "format": {
+            "type": "string",
+            "enum": [
+              "jpg",
+              "jpeg",
+              "png",
+              "gif",
+              "webp"
+            ]
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,144 @@
+{
+  "title": "知乎视频发布表单 (Zhihu Video)",
+  "type": "object",
+  "required": [
+    "formType",
+    "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
+    },
+    "declaration": {
+      "type": "number",
+      "enum": [
+        0,
+        2
+      ],
+      "default": 0
+    },
+    "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
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/publish.schema.json

@@ -0,0 +1,26 @@
+{
+  "title": "YiXiaoEr Publish Schema Root",
+  "type": "object",
+  "required": [
+    "formType"
+  ],
+  "properties": {
+    "formType": {
+      "type": "string",
+      "const": "task"
+    },
+    "title": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "desc": {
+      "type": "string"
+    },
+    "content": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": true
+}

package/skills/yixiaoer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: yixiaoer
-version: 3.1.0
+version: 3.1.2
 description: "通过 yxer CLI 操作蚁小二多平台内容分发：账号查询、资源上传、发布前准备、payload 校验、云发布/本机发布、草稿保存、素材登记、发布记录排查与技能同步。"
 metadata:
   category: "productivity"

package/skills/yixiaoer/plugin.json

@@ -2,7 +2,7 @@
   "id": "yixiaoer",
   "name": "yixiaoer",
   "displayName": "蚁小二",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "description": "蚁小二多平台内容分发链接应用",
   "skills": "./",
   "interface": {

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

@@ -4,20 +4,20 @@
 > **前提条件 (Prerequisite)**:
 > 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [文章发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
 
-## 触发场景 (Trigger)
-- **意图辨析**：用户指定在“今日头条 (头条号)”发布长文章或新闻资讯，且需要配置如“广告收益 (Advertisement)”、“头条首发”、“地点挂载”或“创作者申明”等头条特有商业与分发逻辑时。
-- **典型提示词**：
-  - “发一篇今日头条的文章，开启广告收益模式”
-  - “头条文章发布，声明是我的原创首发内容”
-  - “在头条文章里加上我所在的物理位置”
-  - “帮我同步这个图文到头条号并存为草稿”
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“今日头条 (头条号)”发布长文章或新闻资讯，且需要配置如“广告收益 (Advertisement)”、“头条首发”、“地点挂载”或“创作者申明”等头条特有商业与分发逻辑时。
+- **典型提示词**：
+  - “发一篇今日头条的文章，开启广告收益模式”
+  - “头条文章发布，声明是我的原创首发内容”
+  - “在头条文章里加上我所在的物理位置”
+  - “帮我同步这个图文到头条号并存为草稿”
 
-## 执行逻辑 (Logic Flow)
-1. **封面适配**：头条号对封面 (`covers`) 数量有严格要求（1 张或 3 张）。
-2. **位置检索**：若需精准挂载位置，调用 `locations` 接口获取 DTO。
-3. **收益装配**：根据意图注入 `advertisement: 3`（赚取收益）或 `2`（不投放广告）。
-4. **参数装配**：构造 `accountForms[i].contentPublishForm`。
-5. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+## 执行逻辑 (Logic Flow)
+1. **封面适配**：头条号对封面 (`covers`) 数量有严格要求（1 张或 3 张）。
+2. **位置检索**：若需精准挂载位置，调用 `locations` 接口获取 DTO。
+3. **收益装配**：根据意图注入 `advertisement: 3`（赚取收益）或 `2`（不投放广告）。
+4. **参数装配**：构造 `accountForms[i].contentPublishForm`。
+5. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
 
 ## 1. contentPublishForm 参数定义
 
@@ -27,12 +27,12 @@
 | `title` | `string` | **是** | 文章标题 (1-50 字符) | - |
 | `content` | `string` | **是** | 文章内容 (HTML 字符串，最多 50000 字符) | - |
 | `covers` | `Array` | **是** | 文章封面列表 (`OldCover[]`, 1-9 张) | - |
-| `isFirst` | `boolean` | 否 | 是否头条首发 | `false` |
-| `location` | `Object` | 否 | 位置对象 (`PlatformDataItem`) | - |
-| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
-| `advertisement` | `number` | 否 | 广告投放收益: 2-无收益, 3-投放广告赚收益 | `3` |
-| `declaration`| `number` | 否 | 创作类型 1:自行拍摄 2:取自站外 3:AI生成 6:虚构演绎 7:投资观点 8:健康医疗 | - |
-| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
+| `isFirst` | `boolean` | 否 | 是否头条首发 | `false` |
+| `location` | `Object` | 否 | 位置对象 (`PlatformDataItem`) | - |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `advertisement` | `number` | 否 | 广告投放收益: 2-无收益, 3-投放广告赚收益 | `3` |
+| `declaration`| `number` | 否 | 创作类型 1:自行拍摄 2:取自站外 3:AI生成 6:虚构演绎 7:投资观点 8:健康医疗 | - |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
 
 ## 2. Payload 完整示例
 
@@ -52,11 +52,11 @@
           "covers": [
             { "key": "cover_key_001", "width": 800, "height": 600, "size": 150000 }
           ],
-          "advertisement": 3,
-          "isFirst": true,
-          "pubType": 1
-        }
-      }
+          "advertisement": 3,
+          "isFirst": true,
+          "pubType": 1
+        }
+      }
     ]
   }
 }
@@ -67,12 +67,12 @@
 ### 3.1 OldCover
 包含 `key`, `size`, `width`, `height`。
 
-### 3.2 PlatformDataItem (位置信息)
-包含 `yixiaoerId`, `yixiaoerName`, `raw` (必须完整透传)。
+### 3.2 PlatformDataItem (位置信息)
+包含 `yixiaoerId`, `yixiaoerName`, `raw` (必须完整透传)。
 
 ## 相关接口
 
 | 目标字段 | 对应 Action | 文档参考 |
 | :--- | :--- | :--- |
-| `location`  | `locations` | [获取位置信息](../../get-locations.md) |
-| `covers.key`| `upload`    | [资源上传](../../upload-resource.md) |
+| `location`  | `locations` | [获取位置信息](../../get-locations.md) |
+| `covers.key`| `upload`    | [资源上传](../../upload-resource.md) |

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

@@ -12,8 +12,8 @@
   - “同步这条动态到Baijiahao”
 
 ## 执行逻辑 (Logic Flow)
-1. **资源校验**：确保所有图片均已上传并获得 Key。
-2. **参数装配**：填充描述及图片列表至 `contentPublishForm`。
+1. **资源校验**：确保所有图片均已上传并获得 Key。
+2. **参数装配**：图文内容使用 `contentPublishForm.images` 传图；账号层仍需同步提供 `cover` 和 `coverKey`。
 3. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
 
 本平台图文发布通过 `contentPublishForm` 承载以下参数。
@@ -25,21 +25,22 @@
 | `formType` | `string` | **是** | 固定值: `task` | `task` |
 | `title` | `string` | **是** | 标题 (1-20 字符) | - |
 | `description` | `string` | **是** | 图文描述，支持 HTML (`<p>`, `<topic>`)。 (1-1000 字符) | - |
-| `cover` | `Object` | **是** | 封面图对象 (`OldCover`) | - |
-| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | - |
-| `declaration` | `number` | **是** | 创作声明: 0-不声明, 1-内容由 AI 生成 | - |
-| `location` | `Object` | 否 | 位置信息 (`PlatformDataItem`) | - |
-| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `images` | `Array` | **是** | 图片数组 (`OldImage[]`, 至少 1 张) | - |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | - |
+| `declaration` | `number` | **是** | 创作声明: 0-不声明, 1-内容由 AI 生成 | - |
+| `location` | `Object` | 否 | 位置信息 (`PlatformDataItem`) | - |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
 
 ## 2. 复杂对象结构说明
 
-### 复杂对象：OldCover
-| 字段名 | 类型 | 必填 | 说明 | 默认值 |
-| :--- | :--- | :--- | :--- | :--- |
-| `width` | `number` | **是** | 图片宽度 | - |
-| `height` | `number` | **是** | 图片高度 | - |
-| `size` | `number` | **是** | 文件大小 (Bytes) | - |
-| `key` | `string` | **是** | 资源 Key (通过上传接口获取) | - |
+### 复杂对象：OldImage
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `width` | `number` | **是** | 图片宽度 | - |
+| `height` | `number` | **是** | 图片高度 | - |
+| `size` | `number` | **是** | 文件大小 (Bytes) | - |
+| `key` | `string` | **是** | 资源 Key (通过上传接口获取) | - |
+| `format` | `string` | 否 | 文件格式 (`jpg/png/webp` 等) | - |
 
 ### 复杂对象：PlatformDataItem
 | 字段名 | 类型 | 必填 | 说明 | 默认值 |
@@ -63,21 +64,31 @@
   "platforms": ["百家号"],
   "publishArgs": {
     "accountForms": [
-      {
-        "platformAccountId": "acc_bjh_it_001",
-        "contentPublishForm": {
-          "formType": "task",
-          "title": "百家号图文标题",
-          "description": "<p>内容摘要 <topic text='科技' raw='{\"yixiaoerId\":\"123\",\"yixiaoerName\":\"科技\",\"raw\":{\"id\":\"xxx\",\"topic\":\"科技\"}}'>#科技</topic></p>",
-          "cover": { 
-            "key": "img_key_123", 
-            "size": 102400, 
-            "width": 800, 
-            "height": 600 
-          },
-          "pubType": 1,
-          "declaration": 0
-        }
+      {
+        "platformAccountId": "acc_bjh_it_001",
+        "cover": {
+          "key": "img_key_123",
+          "size": 102400,
+          "width": 800,
+          "height": 600
+        },
+        "coverKey": "img_key_123",
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "百家号图文标题",
+          "description": "<p>内容摘要 <topic text='科技' raw='{\"yixiaoerId\":\"123\",\"yixiaoerName\":\"科技\",\"raw\":{\"id\":\"xxx\",\"topic\":\"科技\"}}'>#科技</topic></p>",
+          "images": [
+            {
+              "key": "img_key_123",
+              "size": 102400,
+              "width": 800,
+              "height": 600,
+              "format": "jpg"
+            }
+          ],
+          "pubType": 1,
+          "declaration": 0
+        }
       }
     ]
   }
@@ -88,4 +99,4 @@
 
 | 目标数据 | 对应 Action | 相关文档 |
 | :--- | :--- | :--- |
-| `images.key` | `upload` | [资源上传](../../upload-resource.md) |
+| `images.key` / `coverKey` | `upload` | [资源上传](../../upload-resource.md) |