@yixiaoermail/cli 3.1.0

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

@@ -0,0 +1,111 @@
+# 抖音图文发布参数 (Douyin Image-Text)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [图文发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Douyin”平台发布图文动态时触发。
+- **典型提示词**：
+  - “发几张图到Douyin”
+  - “同步这条动态到Douyin”
+
+## 执行逻辑 (Logic Flow)
+1. **资源校验**：确保所有图片均已上传并获得 Key。
+2. **参数装配**：填充描述及图片列表至 `contentPublishForm`。
+3. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+> [!TIP]
+> 抖音图文如涉及话题，请先读取 [`../../topic-tags.md`](../../topic-tags.md)。如果要使用 `<topic>`，Agent 必须直接写入最终 `description` HTML。
+
+
+本平台图文发布通过 `contentPublishForm` 承载以下参数。
+
+## 1. contentPublishForm 参数定义
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定值: `task` | `task` |
+| `title` | `string` | 否 | 标题 (最多 20 字) | - |
+| `description` | `string` | 否 | 图文描述，支持 HTML (`<p>`, `<topic>`)。最多 30 字符。 | - |
+| `images` | `Array` | **是** | 图片数组 (`OldImage[]`) | - |
+| `location` | `Object` | 否 | 地址信息 (`PlatformDataItem`) | - |
+| `music` | `Object` | 否 | 音乐信息 (`MusicItem`) | - |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `collection` | `Object` | 否 | 合集信息 (`Category`) | - |
+| `sub_collection` | `Object` | 否 | 合集选集信息 (`Category`) | - |
+
+## 2. 复杂对象结构说明
+
+### OldImage
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `width` | `number` | **是** | 图片宽度 |
+| `height` | `number` | **是** | 图片高度 |
+| `size` | `number` | **是** | 文件大小 (Bytes) |
+| `key` | `string` | **是** | 资源 Key (通过上传接口获取) |
+| `format` | `string` | **是** | 文件格式 (e.g., `jpg`, `png`) |
+
+### Category (用于合集等)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 蚁小二内部 ID |
+| `yixiaoerName` | `string` | **是** | 显示名称 |
+| `raw` | `object` | 否 | 平台原始数据。如果在获取时该字段存在，发布表单中必须携带并完整透传 |
+
+### MusicItem (音乐)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | 是 | 蚁小二端统一音乐 ID |
+| `yixiaoerName` | `string` | 是 | 歌曲名称 |
+| `duration` | `number` | 是 | 音乐时长（秒） |
+| `playUrl` | `string` | 是 | 试听/播放链接 |
+| `artist` | `string` | 否 | 歌手/作者名 |
+| `raw` | `object` | 否 | 平台原始数据。如果在音乐列表获取时该字段存在，发布表单中必须携带并完整透传 |
+
+### PlatformDataItem (基础结构)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | 是 | 统一 ID |
+| `yixiaoerName` | `string` | 是 | 显示名称 |
+| `raw` | `object` | 是 | 平台原始数据。如果在获取时该字段存在，发布表单中必须携带并完整透传 |
+
+
+
+## 3. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "imageText",
+  "platforms": ["抖音"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "DY_ACC_ID",
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "抖音图文标题",
+          "description": "<p>内容描述 <topic text='合拍' raw='{\"id\":\"xxx\",\"name\":\"合拍\"}'>#合拍</topic></p>",
+          "images": [
+            { "key": "img_1", "size": 1024, "width": 1080, "height": 1440, "format": "jpg" },
+            { "key": "img_2", "size": 1024, "width": 1080, "height": 1440, "format": "jpg" }
+          ],
+          "location": { "yixiaoerId": "loc_123", "yixiaoerName": "某商位", "raw": {} }
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标字段 | 对应 Action | 文档参考 |
+| :--- | :--- | :--- |
+| `location` | `locations` | [获取位置信息](../../get-locations.md) |
+| `collection` | `collections` | [获取合集列表](../../get-collections.md) |
+| `music` | `music` | [获取背景音乐](../../get-music.md) |
+| `tags` | `challenges` | [获取话题/挑战](../../get-challenges.md) |
+| `images.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,116 @@
+# 图文发布 (Image-Text Publish)
+
+> [!CAUTION]
+> **阅读规范 (Reading Protocol)**:
+> 本文档是 **所有平台** 图文发布的 **唯一入口** 和 **基础 DTO 定义**。
+> 在查阅具体的平台文档（如 `xiaohongshu.md`）之前，你 **必须** 首先查阅本文档以理解 Payload 的根结构，否则将导致生成的 JSON 无法通过校验。
+
+## 触发场景 (Trigger)
+- **意图辨析**：发布短小精悍的图文动态（类似小红书笔记、微博动态、朋友圈风格）时触发。特点是多图 + 简短描述。
+- **典型提示词**：
+  - “帮我把这几张图发到小红书”
+  - “发布一条带图片的微博动态”
+  - “这个产品的宣传图，同步到抖音和推文”
+
+## 执行逻辑 (Logic Flow)
+1. **多图处理**：
+   - 遍历所有待发图片，循环调用 `upload` action 获得多个资源 Key。
+   - 严禁缺失任何图片的 Key。
+2. **账号确权**：获取目标账号对应的 `platformAccountId`。
+3. **平台细化**：针对小红书等平台，查阅对应文档补齐“话题”、“地点”等字段。
+4. **Payload 装配**：按照 1.1 - 1.3 节结构，构造包含 `action: "publish"` 的 JSON。
+5. **指令交付**：先执行 `yxer validate <platform> imageText <payload.json>`，再执行 `yxer publish imageText <platform> <payload.json> [clientId]`。
+
+## 1. 数据结构 (Data Structure)
+
+接口要求传入 `CloudTaskPushRequest` 结构。
+
+### 1.1 基础结构 (Base Structure)
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `action` | `string` | **是** | 固定值：`publish` | - |
+| `publishType` | `string` | **是** | 固定为 `imageText` | - |
+| `platforms` | `string[]` | **是** | 目标平台枚举数组，详见下方平台列表 | - |
+| `coverKey` | `string` | **是** | 任务封面资源 Key | - |
+| `publishArgs` | `Object` | **是** | 发布参数核心容器 | - |
+| `taskSetId` | `string` | 否 | 任务集唯一标识 (草稿发布时必填) | - |
+| `desc` | `string` | 否 | 任务描述/摘要 | - |
+| `publishChannel` | `string` | 否 | `cloud` (云端) 或 `local` (本机) | `cloud` |
+| `clientId` | `string` | 否 | 客户端连接 ID (`local` 发布时必填) | - |
+| `isDraft` | `boolean` | 否 | 是否仅保存为草稿 (蚁小二草稿) | `false` |
+
+### 1.2 草稿模式选取 (Draft Selection)
+
+| 场景 | 蚁小二草稿箱 | 目标平台草稿箱 |
+| :--- | :--- | :--- |
+| **位置** | `Payload` 根路径 | `accountForms` -> `contentPublishForm` |
+| **参数** | `"isDraft": true` | `"pubType": 0` (若平台不支持，见下方说明) |
+| **效果** | 仅保存在蚁小二系统，不发起平台推送 | 执行推送流程，但最终结果为平台端的草稿态 |
+| **用户话术** | “存为蚁小二草稿”、“暂不发布” | “存到抖音草稿箱”、“推送到小红书草稿盒” |
+
+> [!TIP]
+> **字段兼容性补丁 (Draft Fallback Rule)**:
+> Agent 在处理“存为平台草稿”时必须遵循以下优先级：
+> 1.  **首选 (pubType)**：若目标平台文档定义了 `pubType` 字段，必须设置 `"pubType": 0`。
+> 2.  **次选 (visibleType)**：若无 `pubType` 但定义了 `visibleType` 或 `privacy` 等字段，将其设置为 **`1` (私密)**。对应的，`0` 为公开。
+> 3.  **不支持**：若上述字段均未在平台文档中定义，说明该平台不支持草稿或私密保存，Agent 应向用户说明情况并引导其选择公开推送或存为蚁小二内部草稿。
+
+
+### 1.3 发布参数 (publishArgs)
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `content` | `string` | **是** | **图文描述**: 纯文本格式 | - |
+| `accountForms` | `Array` | **是** | 账号发布表单列表 | - |
+
+### 1.4 账号表单项 (accountForms Item)
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `platformAccountId` | `string` | **是** | 蚁小二平台账号唯一 ID | - |
+| `images` | `Array` | **是** | **ImageFormItem[]**: 图文图片列表 (`key`, `width`, `height`, `size`) | - |
+| `cover` | `Object` | **是** | **ImageFormItem**: 主封面对象 | - |
+| `contentPublishForm`| `Object` | **是** | **透传层**: `{}` | - |
+| `coverKey` | `string` | **是** | 账号级封面 Key (必须与 `cover.key` 一致) | - |
+
+## 2. 发布示例 (Payload Example)
+
+```json
+{
+  "action": "publish",
+  "publishType": "imageText",
+  "platforms": ["小红书"],
+  "coverKey": "img_key_1",
+  "publishArgs": {
+    "content": "这是一个图文发布的描述内容。 #演示",
+    "accountForms": [
+      {
+        "platformAccountId": "acc_img_002",
+        "images": [
+          { "key": "img_key_1", "width": 1080, "height": 1440, "size": 200000 }
+        ],
+        "coverKey": "img_key_1",
+        "cover": { "key": "img_key_1", "width": 1080, "height": 1440, "size": 200000 }
+      }
+    ]
+  }
+}
+```
+
+## 4. 通用规则 (Common DTO Rules)
+
+### 4.1 级联分类组装 (Cascading Categories)
+许多平台要求传入由父及子的完整分类对象数组。
+- **组装逻辑**：Agent 从 `categories` 接口获取数据后，若存在层级关系，**必须自行构造** 路径数组。
+- **填表规范**：对于每一级，必须包含 `yixiaoerId`, `yixiaoerName` 以及对应的 **`raw`** 对象。
+- **层级示例**：
+  - 父分类：`{"yixiaoerId": "18", "yixiaoerName": "动漫", "raw": {...}}`
+  - 子分类：`{"yixiaoerId": "1", "yixiaoerName": "国产动漫", "raw": {...}}`
+  - **最终 Payload 形式**（Agent 需手动装配成此数组）：
+    ```json
+    "category": [
+      { "yixiaoerId": "18", "yixiaoerName": "动漫", "raw": {...} },
+      { "yixiaoerId": "1", "yixiaoerName": "国产动漫", "raw": {...} }
+    ]
+    ```

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

@@ -0,0 +1,106 @@
+# 快手图文发布参数 (Kuaishou Image-Text)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [图文发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的 platform 差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Kuaishou”平台发布图文动态时触发。
+- **典型提示词**：
+  - “发几张图到Kuaishou”
+  - “同步这条动态到Kuaishou”
+
+## 执行逻辑 (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` | `OldImage[]` | **是** | 图片数组 | - |
+| `location` | `PlatformDataItem` | **否** | 位置信息 | - |
+| `music` | `PlatformDataItem` | **否** | 音乐信息 | - |
+| `visibleType` | `number` | **是** | 可见类型: 0-公开, 1-私密, 3-好友可见 | 0 |
+| `scheduledTime` | `number` | **否** | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `collection` | `Category` | **否** | 合集信息 | - |
+
+## 2. 复杂对象结构说明
+
+### OldImage
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `key` | `string` | **是** | OSS 资源 Key |
+| `size` | `number` | **是** | 文件大小 (Bytes) |
+| `width` | `number` | **是** | 宽度 |
+| `height` | `number` | **是** | 高度 |
+| `format` | `string` | **是** | 文件格式 (如 `jpg`, `png`) |
+
+### Category
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 蚁小二内部 ID |
+| `yixiaoerName` | `string` | **是** | 显示名称 |
+| `raw` | `object` | **是** | 平台原始数据 (如果接口返回，必须原样回传) |
+
+### PlatformDataItem
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 统一 ID |
+| `yixiaoerName` | `string` | **是** | 显示名称 |
+| `raw` | `object` | **是** | 平台原始数据 (如果接口返回，必须原样回传) |
+
+### MusicItem (音乐)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 蚁小二端统一音乐 ID |
+| `yixiaoerName` | `string` | **是** | 歌曲名称 |
+| `duration` | `number` | **是** | 音乐时长（秒） |
+| `playUrl` | `string` | **是** | 试听/播放链接 |
+| `artist` | `string` | **否** | 歌手/作者名 |
+| `raw` | `object` | **是** | 平台原始数据 (如果接口返回，必须原样回传) |
+
+## 3. 依赖接口说明
+
+若字段值需通过查询获得，需注明：
+- **位置 (location)**: 需通过 `[获取地理位置](../../get-locations.md)` 获得对应的 `PlatformDataItem`。
+- **音乐 (music)**: 需通过 `[获取音乐](../../get-music.md)` 获得对应的 `PlatformDataItem`。
+- **话题 (topic)**: 在 `description` 中使用 `<topic>` 标签时，话题数据需通过 `[获取话题](../../get-topics.md)` 获得。
+- **合集 (collection)**: 需通过 `[获取合集](../../get-collections.md)` 获得对应的 `Category`。
+
+## 4. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "imageText",
+  "platforms": ["快手"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_ks_it_001",
+        "contentPublishForm": {
+          "formType": "task",
+          "description": "<p>快手动态内容 <topic text='快手' raw='{\"id\":\"xxx\",\"name\":\"快手\"}'>#快手</topic></p>",
+          "images": [
+            { "key": "img_ks_01", "size": 1024, "width": 1080, "height": 1440, "format": "jpg" }
+          ],
+          "visibleType": 0
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `images.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,125 @@
+# 视频号图文发布参数 (Shipinhao Image-Text)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [图文发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“视频号 / 微信视频号 / shipinhao”平台发布图文动态时触发。
+- **典型提示词**：
+  - “发几张图到视频号”
+  - “同步这条动态到微信视频号”
+  - “用 shipinhao 发图文”
+
+## 执行逻辑 (Logic Flow)
+1. **资源校验**：确保所有图片均已上传并获得 Key。
+2. **参数装配**：填充描述及图片列表至 `contentPublishForm`，并把首图同步到账号层 `cover` / `coverKey`。
+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>`, `<topic>`)。最多 1000 字符。 | - |
+| `images` | `Array` | **是** | 图片数组 (`OldImage[]`) | - |
+| `location` | `Object` | 否 | 位置对象 (`PlatformDataItem`) | - |
+| `music` | `Object` | 否 | 音乐对象 (`MusicItem`) | - |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `collection` | `Object` | 否 | 合集信息，使用 `Collection` 结构 | - |
+| `pubType` | `number` | **是** | 发布类型: 0-平台草稿, 1-直接发布 | 1 |
+
+## 1.1 账号层必填封面
+
+视频号图文除 `contentPublishForm.images` 外，还要求在 `publishArgs.accountForms[]` 层提供：
+
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `cover` | `Object` | **是** | 账号级封面对象，通常直接复用首图资源对象 |
+| `coverKey` | `string` | **是** | 账号级封面 Key，必须与 `cover.key` 一致 |
+
+## 2. 复杂对象结构说明
+
+### OldImage
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `width` | `number` | **是** | 图片宽度 |
+| `height` | `number` | **是** | 图片高度 |
+| `size` | `number` | **是** | 文件大小 (Bytes) |
+| `key` | `string` | **是** | 资源 Key (通过上传接口获取) |
+| `format` | `string` | **是** | 文件格式 (e.g., `jpg`, `png`) |
+
+### PlatformDataItem (基础结构)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | 是 | 统一 ID |
+| `yixiaoerName` | `string` | 是 | 显示名称 |
+| `raw` | `object` | 是 | 平台原始数据 |
+
+### Collection
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | 是 | 合集 ID |
+| `yixiaoerName` | `string` | 是 | 合集名称 |
+| `raw` | `object` | 否 | 平台原始数据 |
+
+### MusicItem (音乐)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | 是 | 蚁小二端统一音乐 ID |
+| `yixiaoerName` | `string` | 是 | 歌曲名称 |
+| `duration` | `number` | 是 | 音乐时长（秒） |
+| `playUrl` | `string` | 是 | 试听/播放链接 |
+| `artist` | `string` | 否 | 歌手/作者名 |
+| `raw` | `object` | 否 | 平台原始数据。如果在音乐列表获取时该字段存在，发布表单中必须携带并完整透传 |
+
+
+
+## 3. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "imageText",
+  "platforms": ["视频号"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "SPH_ACC_ID",
+        "coverKey": "img_sph_01",
+        "cover": {
+          "key": "img_sph_01",
+          "size": 1024,
+          "width": 1080,
+          "height": 1440,
+          "format": "jpg"
+        },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "视频号动态标题",
+          "description": "<p>视频号图文内容 <topic text='微信' raw='{\"id\":\"xxx\",\"name\":\"微信\"}'>#微信</topic></p>",
+          "pubType": 0,
+          "images": [
+            { "key": "img_sph_01", "size": 1024, "width": 1080, "height": 1440, "format": "jpg" }
+          ]
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标字段 | 对应 Action | 文档参考 |
+| :--- | :--- | :--- |
+| `location` | `locations` | [获取位置信息](../../get-locations.md) |
+| `collection` | `collections` | [获取合集列表](../../get-collections.md) |
+| `music` | `music` | [获取背景音乐](../../get-music.md) |
+| `tags` | `challenges` | [获取话题/挑战](../../get-challenges.md) |
+| `images.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,76 @@
+# 头条号图文发布参数 (TouTiaoHao 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` |
+| `description` | `string` | **是** | 图文描述，支持 HTML 和话题标签 (`<topic>`)。最多 1000 字符。 | - |
+| `images` | `Array` | **是** | 图片数组 (`OldImage[]`) | - |
+| `declaration` | `number` | 否 | 创作类型 1:自行拍摄 2:取自站外 3:AI生成 6:虚构演绎,故事经历 7:投资观点,仅供参考 8:健康医疗分享,仅供参考 | - |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | - |
+
+## 2. 复杂对象结构说明
+
+### 复杂对象：OldImage
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `width` | `number` | **是** | 图片宽度 | - |
+| `height` | `number` | **是** | 图片高度 | - |
+| `size` | `number` | **是** | 文件大小 (Bytes) | - |
+| `key` | `string` | **是** | 资源 Key (通过上传接口获取) | - |
+| `format` | `string` | **是** | 文件格式 (e.g., `jpg`, `png`) | - |
+
+## 3. 依赖接口说明
+
+若字段值需通过查询获得，需注明：
+- **话题 (topic)**: 在 `description` 中使用 `<topic>` 标签时，话题数据需通过 `[获取话题](../../get-topics.md)` 获得。
+
+## 4. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "imageText",
+  "platforms": ["头条号"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_tt_it_001",
+        "contentPublishForm": {
+          "formType": "task",
+          "description": "<p>今日头条内容 <topic text='头条' raw='{\"yixiaoerId\":\"123\",\"yixiaoerName\":\"头条\",\"raw\":{\"id\":\"xxx\",\"topic\":\"头条\"}}'>#头条</topic></p>",
+          "images": [
+            { "key": "img_resource_key", "size": 1024000, "width": 1080, "height": 1440, "format": "jpg" }
+          ],
+          "pubType": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `images.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,7 @@
+# 视频号图文发布参数 (Alias)
+
+`Weixinshipinhao` 旧别名已统一到 `shipinhao`。
+
+- 当前推荐平台键：`shipinhao`
+- 当前推荐中文名：`视频号` / `微信视频号`
+- 请改读同目录下的 `shipinhao.md`

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

@@ -0,0 +1,88 @@
+# 小红书图文发布参数 (Xiaohongshu Image-Text)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [图文发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“小红书”平台发布图文笔记，且需要配置如“标记话题”、“地点挂载”、“多级分类挂载”或“定时发布”等功能时触发。
+- **典型提示词**：
+  - “帮我发一篇小红书笔记，带上 #穿搭 话题”
+  - “小红书发布，地点选在上海东方明珠”
+  - “把这两张图存为小红书草稿，设置仅好友可见”
+  - “查询小红书的分类并设置”
+
+## 执行逻辑 (Logic Flow)
+1. **内容识别**：识别笔记标题、正文及内嵌话题（小红书正文支持 HTML 话题标签）。
+2. **辅助检索**：
+   - 话题：调用 `challenges` 获取标准话题 DTO。
+   - 地点：调用 `locations` 获取 POI 数据。
+   - 音乐：若需要，调用 `music` 获取。
+3. **参数装配**：将处理后的字段填入 `accountForms[i].contentPublishForm`。
+4. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+## 1. contentPublishForm 参数 definition
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定值: `task` | `task` |
+| `title` | `string` | 否 | 标题 (笔记标题，最多 20 字) | - |
+| `description` | `string` | **是** | 笔记描述，支持 HTML (`<p>`, `<topic>`)。最多 1000 字符。 | - |
+| `images` | `Array` | **是** | 图片数组 (`OldImage[]`) | - |
+| `location` | `Object` | 否 | 位置对象 (`PlatformDataItem`) | - |
+| `music` | `Object` | 否 | 音乐对象 (`MusicItem`) | - |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `collection` | `Object` | 否 | 合集信息，使用 `Collection` 结构 | - |
+| `visibleType` | `number` | **是** | 可见类型: 0-公开, 1-私密, 3-好友可见 | 0 |
+
+## 2. 复杂对象结构说明
+
+### OldImage
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `width` | `number` | **是** | 图片宽度 |
+| `height` | `number` | **是** | 图片高度 |
+| `size` | `number` | **是** | 文件大小 (Bytes) |
+| `key` | `string` | **是** | 资源 Key (通过上传接口获取) |
+| `format` | `string` | **是** | 文件格式 (e.g., `jpg`, `png`) |
+
+### PlatformDataItem (基础结构)
+包含 `yixiaoerId`, `yixiaoerName`, `raw`。
+
+### MusicItem (音乐)
+包含 `yixiaoerId`, `yixiaoerName`, `duration`, `playUrl`, `raw` 等。
+
+## 3. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "imageText",
+  "platforms": ["小红书"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "XHS_ACC_ID",
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "今日穿搭",
+          "description": "<p>今日穿搭分享 <topic text='穿搭' raw='{\"id\":\"xxx\",\"name\":\"穿搭\"}'>#穿搭</topic></p>",
+          "images": [
+            { "key": "img_xhs_01", "size": 1024, "width": 1080, "height": 1440, "format": "jpg" }
+          ],
+          "visibleType": 0
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标字段 | 对应 Action | 文档参考 |
+| :--- | :--- | :--- |
+| `location` | `locations` | [获取位置信息](../../get-locations.md) |
+| `collection` | `collections` | [获取合集列表](../../get-collections.md) |
+| `tags/topic`| `challenges` | [获取话题/挑战](../../get-challenges.md) |
+| `images.key`| `upload` | [资源上传](../../upload-resource.md) |