@yixiaoermail/cli 3.1.0

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

@@ -0,0 +1,92 @@
+# 小红书店铺 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Xiaohongshushop”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Xiaohongshushop”
+  - “同步视频到Xiaohongshushop”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Xiaohongshushop。
+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 | 是 | 视频描述 | - |
+| location | object | 否 | 视频位置，使用 `PlatformDataItem` 结构，查询见 [`../../get-locations.md`](../../get-locations.md) | - |
+| scheduledTime | number | 否 | 定时发布时间戳（13 位 Unix 时间戳，单位：毫秒） | - |
+| shoppingCart | object[] | 否 | 关联商品列表，使用 `ShoppingCartItem` 结构数组 | - |
+
+## 2. 复杂对象结构
+
+### PlatformDataItem
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | string | 是 | ID |
+| text | string | 是 | 文本内容 |
+| raw | object | 是 | 平台原始数据 |
+
+### ShoppingCartItem
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| yixiaoerId | string | 是 | 商品 ID |
+| yixiaoerName | string | 是 | 商品名称 |
+| yixiaoerDesc | string | 否 | 商品规格说明 |
+| yixiaoerImageUrl | string | 否 | 商品图片 URL |
+| price | number | 否 | 商品价格（单位：分） |
+| earnPrice | number | 否 | 预估佣金（单位：分） |
+
+
+
+## 3. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["Xiaohongshushop"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "XHS_SHOP_ACC_ID",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1080,
+          "height": 1440,
+          "duration": 30
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "小红书店铺新品推荐",
+          "description": "这是关于店铺新品发布的推广视频。",
+          "shoppingCart": [
+            {
+              "goods_id": "112233",
+              "price": 99.9
+            }
+          ]
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标字段 | 对应 Action | 文档参考 |
+| :--- | :--- | :--- |
+| `location` | `locations` | [获取位置信息](../get-locations.md) |
+| `shoppingCart` | `goods` | [获取商品列表](../../get-goods.md) |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,79 @@
+# 新浪微博 视频发布
+
+> [!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]`。
+
+
+## 1. contentPublishForm 数据结构
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| formType | string | 是 | 固定为 `task` | `task` |
+| title | string | 是 | 视频标题 | - |
+| description | string | 是 | 视频描述 | - |
+| type | number | 否 | 内容类型：1-原创, 2-转载内容, 3-二次创作内容 | 1 |
+| location | object | 否 | 视频位置，使用 `PlatformDataItem` 结构 | - |
+| scheduledTime | number | 否 | 定时发布时间戳（13 位 Unix 时间戳，单位：毫秒） | - |
+| collection | object | 否 | 合集信息 | - |
+
+## 2. 复杂对象结构
+
+### PlatformDataItem
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | string | 是 | ID |
+| text | string | 是 | 文本内容 |
+| raw | object | 是 | 平台原始数据 |
+
+## 3. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["新浪微博"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "WEIBO_ACC_ID",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "微博视频发布标题",
+          "description": "这是发布在微博的一段视频详情内容 #记录生活",
+          "type": 1,
+          "location": {
+            "id": "loc_123",
+            "text": "上海市",
+            "raw": {}
+          }
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,61 @@
+# 易车号 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Yichehao”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Yichehao”
+  - “同步视频到Yichehao”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Yichehao。
+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": ["Yichehao"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "YICHE_ACC_ID",
+        "video": {
+          "key": "v_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "易车网汽车评测视频",
+          "description": "这是一段关于新款汽车性能评测的详细视频内容。"
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,85 @@
+# 一点号 视频发布
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [视频发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Yidianhao”平台分发视频内容时触发。
+- **典型提示词**：
+  - “把这个视频发布到Yidianhao”
+  - “同步视频到Yidianhao”
+
+## 执行逻辑 (Logic Flow)
+1. **意图确认**：确认目标平台为Yidianhao。
+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 | 否 | 声明：3-内容取材网络, 4-内容由AI生成, 5-虚构情节内容 | - |
+| type | number | 是 | 视频原创类型：0-非原创, 1-原创 | 0 |
+| scheduledTime | number | 否 | 定时发布时间戳（13 位 Unix 时间戳，单位：毫秒） | - |
+
+## 2. 复杂对象结构
+
+### CascadingPlatformDataItem
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| id | string | 是 | 选项ID |
+| text | string | 是 | 选项文本 |
+| children | object[] | 否 | 子级选项列表 (CascadingPlatformDataItem[]) |
+| raw | object | 是 | 平台原始数据 |
+
+## 3. JSON 示例
+
+```json
+{
+  "publishType": "video",
+  "platforms": ["Yidianhao"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "YIDIAN_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": {}
+            }
+          ],
+          "type": 1,
+          "declaration": 4
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `video.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,85 @@
+# 知乎视频发布参数 (ZhiHu 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]`。
+
+
+在本平台视频发布通过 `contentPublishForm` 承载以下参数。
+
+## 1. contentPublishForm 参数定义
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定为 `task` | `task` |
+| `title` | `string` | 否 | 视频标题 (1-50 字符) | - |
+| `description` | `string` | **是** | 视频描述 (1-500 字符) | - |
+| `category` | `Array` | **是** | 视频分类，使用 `CascadingPlatformDataItem[]` 结构 | - |
+| `declaration` | `number` | 否 | 视频创作申明: 0-不声明, 2-图片/视频由AI生成 | 0 |
+| `createType` | `number` | **是** | 内容类型: 1-原创, 2-转载 | 1 |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
+| `scheduledTime` | `number` | 否 | 定时发布时间戳 (13 位 Unix 时间戳，单位: 毫秒) | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "video",
+  "platforms": ["知乎"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "ZHIHU_ACC_ID",
+        "video": {
+          "key": "video_oss_key",
+          "size": 1024000,
+          "width": 1920,
+          "height": 1080,
+          "duration": 60
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "知乎精选视频标题",
+          "description": "这是关于知乎深度内容的视频分享描述内容。",
+          "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/proxy-management.md

@@ -0,0 +1,68 @@
+# 代理管理 (Proxy Management)
+
+获取租户下的代理列表，并为特定账号配置代理。云发布时，代理配置是确保发布成功率的核心要素。
+
+## 触发场景 (Trigger)
+- **意图辨析**：
+  - **查询代理**：用户反馈发布由于 IP 问题失败，或需要查看可用网络资源时。
+  - **配置代理**：新绑定账号后，或需要切换账号出口 IP（保护账号权重/避免封封）时。
+- **典型提示词**：
+  - “我的抖音号发布报错了，是不是 IP 不对？”
+  - “帮我查查有哪些上海的代理”
+  - “把这个账号绑定到团队代理 A 上”
+
+## 1. 查询代理列表 (List Proxies)
+
+获取当前团队下所有已配置的代理。
+
+### 参数定义 (Parameters)
+| 字段名 | 类型 | 是否必填 | 描述 |
+| :--- | :--- | :--- | :--- |
+| `action` | `string` | **是** | 固定值：`proxies` |
+| `size` | `number` | 否 | 每页数量，默认 `9999`。 |
+
+### 执行逻辑 (Logic Flow)
+1. **指令构造**：组装 `action: "proxies"`。
+2. **指令执行**：当前能力正在迁移到 `yxer` CLI，本文档不再推荐脚本直调。
+3. **数据呈现**：展示代理名称、IP 及启用状态。
+
+---
+
+## 2. 查询内置代理地区列表 (List Default Proxy Areas)
+
+### 参数定义 (Parameters)
+| 字段名 | 类型 | 是否必填 | 描述 |
+| :--- | :--- | :--- | :--- |
+| `action` | `string` | **是** | 固定值：`proxy-areas` |
+
+### 执行逻辑 (Logic Flow)
+1. **意图获取**：当用户希望使用“内置地区代理”而非独立服务器时触发。
+2. **列表拉取**：执行 `action: "proxy-areas"`。
+3. **编码匹配**：获取接口返回的 `code`。
+    - **直辖市**（如北京、上海）：直接使用第一层级的 `code`（例如：北京 `11`，上海 `31`）。
+    - **其他城市**（如长沙）：必须进入 `cities` 数组中获取对应的 `code`（例如：长沙 `430100`）。
+
+---
+
+## 3. 更新账号代理 (Update Account Proxy)
+
+为指定账号设置代理信息。
+
+### 参数定义 (Parameters)
+| 字段名 | 类型 | 是否必填 | 描述 |
+| :--- | :--- | :--- | :--- |
+| `action` | `string` | **是** | 固定值：`update-account` |
+| `account_id` | `string` | **是** | 平台的账号 ID |
+| `proxyId` | `string` | 否 | 团队代理 ID |
+| `kuaidailiArea` | `string` | 否 | 内置代理地区编码。直辖市取一级 `code`，普通城市取 `cities` 下的 `code`。 |
+| `remark` | `string` | 否 | 账号备注 |
+| `groups` | `string[]` | 否 | 分组 ID 列表 |
+
+### 执行逻辑 (Logic Flow)
+1. **前置查询**：必须先获得目标 `account_id` 及代理 `id`/`code`。
+2. **更新执行**：调用 `action: "update-account"`，携带对应 ID 进行绑定。
+3. **验证反馈**：确认账号代理详情已变更。
+
+## 注意事项
+- 云发布环境下，未设置代理的账号可能会导致任务执行失败。
+- **二选一**：`proxyId` 与 `kuaidailiArea` 通常建议只配置其中一个。

package/skills/yixiaoer/references/query-accounts.md

@@ -0,0 +1,85 @@
+# 查询账号列表 (Query Account List)
+
+获取当前租户下绑定的自媒体平台账号列表及其 UID 信息。
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户需要获取、筛选或确认其在蚁小二平台上绑定的自媒体账号信息（如 UID、昵称、登录状态、分组等）时触发。
+- **典型提示词**：
+  - “列出我所有的抖音号”
+  - “看看我有哪些账号登录失效了”
+  - “查询分组 A 下的账号”
+  - “确认一下视频号的作者 ID”
+
+## 参数定义 (Parameters)
+
+### 参数列表 (Payload Properties)
+
+| 字段名 | 类型 | 是否必填 | 描述 |
+| :--- | :--- | :--- | :--- |
+| `action` | `string` | **是** | 固定值：`accounts` |
+| `platform` | `string` | 否 | 指定展示某个平台，必须传平台中文名，如 `抖音`。见 [平台定义](./platform.md)。 |
+| `name` | `string` | 否 | 按账号昵称模糊查询。 |
+| `group` | `string` | 否 | 按分组名称查询。 |
+| `page` | `number` | 否 | 当前页码，默认 `1`。 |
+| `size` | `number` | 否 | 每页数量，默认 `20`，最大 `1000`。 |
+| `platforms` | `string[]` | 否 | 平台批量查询，支持多个。见 [平台定义](./platform.md)。 |
+| `platformType` | `number[]` | 否 | 平台类型批量查询。见 [平台定义-平台类型](./platform.md#平台类型枚举-platformtype)。 |
+| `loginStatus` | `number` | 否 | 账号登录状态查询。见下方【登录状态枚举】。 |
+| `isolation` | `string` | 否 | 是否显示隔离数据，`true`|`false`，默认 `false`。 |
+| `parentId` | `string` | 否 | 父级ID，用于查询子账号列表。 |
+| `time` | `number` | 否 | 查询此时间戳之后是否有新消息（unix ms）。 |
+
+### 枚举定义 (Enumerations)
+
+#### 登录状态 (LoginStatus)
+| 值 | 定义 | 说明 |
+| :--- | :--- | :--- |
+| `0` | `Never` | 未曾登录/待登录 |
+| `1` | `Succesed` | 登录成功 |
+| `2` | `Expired` | 登录过期/失效。**提示：在查询时传 2 会同时匹配 2(过期), 3(失败), 4(取消授权)** |
+| `3` | `Failed` | 登录失败 |
+| `4` | `CancelAuth` | 取消授权 |
+
+
+## 执行逻辑 (Logic Flow)
+1. **意图解析**：识别查询意图，提取关键词（如平台名称、分组名、昵称片段）。
+2. **状态前置**：若涉及“失效账号查询”，自动注入 `loginStatus: 2` 参数。
+3. **参数装配**：构造 `action: "accounts"` 及其余过滤参数（如 `page`, `size`）。
+4. **指令执行**：调用 `yxer accounts [platform] [--name 关键词] [--status 1] [--json]`。
+5. **分页处理**：CLI 默认查询第 `1` 页、每页 `20` 条；可通过 `--page`、`--size` 控制单页查询，通过 `--all` 按接口返回的分页信号继续汇总后续页。
+6. **结果解析**：处理返回的 `PlatformAccountDTO` 列表，重点提取 `id` 和 `status` 供后续操作。
+
+## 返回结果说明 (Response Details)
+
+脚本返回标准的 JSON 数组或对象。每一个账号对象 (`PlatformAccountDTO`) 包含：
+
+| 字段 | 类型 | 描述 |
+| :--- | :--- | :--- |
+| `id` | `string` | 平台内部账号 ID |
+| `platformAccountName` | `string` | 账号昵称 |
+| `platformName` | `string` | 平台名称（如：抖音、百家号） |
+| `platformAvatar` | `string` | 账号头像地址 |
+| `platformAuthorId` | `string` | 平台方的 UID / 作者 ID |
+| `status` | `number` | 登录状态（见上方枚举） |
+| `platformType` | `number` | 平台类型（见上方枚举） |
+| `parentId` | `string` | 父账号 ID（针对微信视频号等子账号结构） |
+| `groups` | `string[]` | 账号所属的分组 ID 列表 |
+| `proxyId` | `string` | 绑定的团队代理 ID (如果有) |
+| `kuaidailiArea` | `string` | 绑定的内置代理地区编码 (如果有) |
+| `favorites` | `Object[]` | 账号收藏夹列表。包含 `id`, `name`, `websiteUrl` |
+| `isOperate` | `boolean` | 当前用户是否拥有该账号的运营权限 |
+| `isFreeze` | `boolean` | 账号是否被冻结 |
+| `createdAt` | `number` | 账号创建时间戳 |
+
+## 调用指令 (Command)
+
+```bash
+yxer accounts 抖音 --name 昵称 --json
+yxer accounts list 抖音 --page 2 --size 20 --json
+yxer accounts list 小红书 --all --status 1 --json
+```
+
+## 注意事项
+- 请确保环境变量 `YIXIAOER_API_KEY` 已设置。
+- **账号有效性提示**：发布前应校验账号 `status` 是否为 `1`。
+- **分页约定**：不要根据“当前页条数已满”猜测还有下一页；只有显式传 `--all` 时，CLI 才会按接口返回的分页字段继续翻页。

package/skills/yixiaoer/references/save-draft.md

@@ -0,0 +1,75 @@
+# 草稿管理 (Draft Management)
+
+在蚁小二生态中，存在两种“草稿”能力，需按目标选择：
+- 保存到**蚁小二草稿箱**（`action: save-draft`）
+- 保存到**目标平台草稿箱**（`action: publish` + `pubType: 0`）
+
+## 触发场景 (Trigger)
+- **意图辨析**：
+  - **蚁小二草稿**：当用户希望先录入内容，待以后手动检查或由他人审核，不希望立即启动任何平台推送流程时。
+  - **平台草稿**：当内容已比较完善，但由于平台规则（如视频号必须在手机端二次确认）或用户希望在平台后台进行最后的 SEO、话题优化时。
+- **典型提示词**：
+  - **蚁小二草稿**：“帮我把这个视频存为蚁小二的草稿”、“暂时不发布，先存草稿”、“存为 YXE 草稿”。
+  - **平台草稿**：“把内容推送到抖音的草稿箱里”、“存为小红书草稿”、“推送到平台草稿箱”。
+- **强制约束**：
+  - 若用户说“存草稿”但未说明位置，Agent **必须询问用户** 明确意图（是存为“蚁小二草稿”还是“平台草稿”），严禁自行猜测或默认选择。
+  - **蚁小二草稿**不消耗发布配额。
+  - **平台草稿**消耗一次云发布/本机发布配额。
+
+## 执行逻辑 (Logic Flow)
+1. **意图深度研判**：根据提示词关键字选取模式。
+2. **蚁小二草稿模式 (`action: save-draft`)**：
+   - 构造 `action: "save-draft"`。
+   - `contentPublishForm.pubType` 可设为 1 (发布) 或 0 (草稿)，后端仅做云端存储。
+3. **平台草稿模式 (`action: publish` + `pubType: 0`)**：
+   - 根级别注入 `action: "publish"`。
+   - `accountForms` 内每个账号的 `contentPublishForm.pubType` 必须设为 `0`。
+4. **指令执行**：调用 `yxer draft save <payload.json>` 保存蚁小二草稿；平台草稿仍走 `yxer publish`。
+5. **状态反馈**：告知用户草稿保存位置及对应的 `taskSetId`。
+
+## 快速区分 (Draft Types)
+
+| 类型 | 蚁小二草稿 (YiXiaoEr Draft) | 平台草稿 (Platform Draft) |
+| :--- | :--- | :--- |
+| **定义** | 仅保存在蚁小二系统数据库中 | 发送到目标平台（如抖音、B站）的草稿箱 |
+| **是否触发任务** | 否 (仅存储) | 是 (执行推送流程) |
+| **调用 Action** | `save-draft` | `publish` |
+| **核心参数** | `action: "save-draft"` | `contentPublishForm.pubType: 0` |
+| **主要用途** | 跨端同步编辑、团队预审 | 将内容预推送到平台后台，方便手动二次微调 |
+
+---
+
+## 存为蚁小二草稿 (`isDraft: true`)
+
+当需要将任务暂存到蚁小二系统的草稿列表，而不启动发布流程时使用。
+
+### 参数列表 (Key Parameters)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `action` | `string` | **是** | 固定值：`save-draft` |
+| `publishType` | `string` | **是** | `video` (视频) 或 `article` (文章) |
+
+### 调用指令 (Command)
+
+```bash
+yxer draft save draft-payload.json
+```
+
+`draft-payload.json` 中应包含原始发布结构，例如 `publishType`、`platforms`、`publishArgs`、`accountForms` 等字段；CLI 会自动按草稿模式提交。
+
+若使用“标准请求体”格式，仍建议把共享资源放在 `publishArgs` 根级，例如 `cover`、`coverKey`、`content` / `video`，CLI 会在校验阶段自动补齐到对应 `accountForms[]`。
+
+---
+
+## 存为平台草稿 (`pubType: 0`)
+
+当需要启动发布流程，但最终结果是在第三方平台后台看到草稿时使用。
+
+### 调用指令 (Command)
+
+```bash
+# 平台草稿仍应收口到 yxer publish 流程
+# 例如：yxer publish video 抖音 publish-payload.json
+```
+
+平台草稿同样支持标准请求体输入格式；但命令层仍是单平台执行，且平台草稿仍需在 `contentPublishForm.pubType` 中表达，而不是依赖顶层 `isDraft=true`。