@yixiaoermail/cli 3.1.0

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

@@ -0,0 +1,135 @@
+# 微信公众号文章发布参数 (WeiXinGongZhongHao Article)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [文章发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Weixingongzhonghao”平台发布文章内容时触发。
+- **典型提示词**：
+  - “发布这篇文章到Weixingongzhonghao”
+  - “并在Weixingongzhonghao上同步更新”
+
+## 执行逻辑 (Logic Flow)
+1. **内容处理**：确保文章正文符合Weixingongzhonghao要求的格式。
+2. **参数装配**：提取标题、正文及封面信息至 `contentPublishForm`。
+3. **指令执行**：先执行 `yxer validate <platform> <type> <payload.json>`，再执行 `yxer publish <type> <platform> <payload.json> [clientId]`。
+
+> [!TIP]
+> 微信公众号仍推荐使用 `platformForms`；同时可以在 `publishArgs` 根级放共享封面或业务扩展字段。CLI 保持单平台执行模型。
+
+本平台文章发布推荐使用 `platformForms` 模式，以支持多账号共用单条图文包消息。
+
+## 1. 结构概览 (Structure)
+
+对于微信公众号，发布参数应位于 `publishArgs.platformForms["微信公众号"]` 中：
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `articles` | `Array` | **是** | 文章列表 (`WxGongZhongHaoContentFrom[]`, 1-8 篇) | - |
+| `notifySubscribers` | `number` | **是** | 是否群发: 0-不群发, 1-群发 | `0` |
+| `pubType` | `number` | **是** | 草稿: 0-草稿, 1-直接发布 | `1` |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `sex` | `number` | 否 | 群发性别: 0-全部, 1-男, 2-女 | `0` |
+| `country` | `string` | 否 | 群发国家 | - |
+| `province` | `string` | 否 | 群发省份 | - |
+| `city` | `string` | 否 | 群发城市 | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "article",
+  "platforms": ["微信公众号"],
+  "coverKey": "img_key_999",
+  "publishArgs": {
+    "cover": {
+      "key": "img_key_999",
+      "size": 102400,
+      "width": 800,
+      "height": 600
+    },
+    "coverKey": "img_key_999",
+    "accountForms": [
+      {
+        "platformAccountId": "ACC_ID_001",
+        "platformName": "微信公众号"
+      }
+    ],
+    "platformForms": {
+      "微信公众号": {
+        "articles": [
+          {
+            "title": "微信群发及原创设置教程",
+            "content": "<p>正文内容... <video-card name='视频号视频' /> ... </p>",
+            "authorName": "技术部",
+            "digest": "这是关于微信发布能力更新的说明。",
+            "type": 1,
+            "cover": {
+                "key": "img_key_999",
+                "raw": {}
+            },
+            "quickRepost": 1,
+            "quickPrivateMessage": 1,
+            "categories": [
+               { "yixiaoerId": "cat_001", "yixiaoerName": "科普", "raw": {} }
+            ]
+          }
+        ],
+        "notifySubscribers": 1,
+        "pubType": 1,
+        "sex": 0
+      }
+    }
+  }
+}
+```
+
+## 3. 复杂对象结构说明
+
+### 3.1 WxGongZhongHaoContentFrom (单篇文章)
+
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `title` | `string` | **是** | 文章标题 (最多 64 字) |
+| `content` | `string` | **是** | 正文 (HTML 字符串)。支持嵌自定义标签（见下方）。 |
+| `cover` | `Object` | **是** | 封面对象 (`Cover`) |
+| `type` | `number` | **是** | 原创申明: 0-不申明, 1-申明原创 |
+| `authorName` | `string` | 否 | 作者名称 (最多 8 个字)。申明原创时推荐填写。 |
+| `digest` | `string` | 否 | 文章摘要 (最多 129 字) |
+| `quickRepost` | `number` | 否 | 允许快捷转载: 0-否, 1-是 |
+| `categories` | `Array` | 否 | 申明原创时设置的文章分类 (`Category[]`) |
+| `quickPrivateMessage` | `number` | 否 | 快捷私信 (与留言互斥): 0-否, 1-是 |
+| `contentSourceUrl` | `string` | 否 | 原文地址链接 |
+
+#### 文章内嵌内容说明
+
+正文 `content` 支持以下自定义 HTML 标签进行卡片嵌入：
+- **公众号卡片**: 使用 `account-card`
+- **视频号卡片**: 使用 `video-card`
+- 其他多媒体（投票、卡片）直接嵌入对应位置。
+
+### 3.2 Cover & Category
+
+对于封面和分类对象，均需包含 `raw` 字段。
+
+| 字段名 (Cover) | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `key` | `string` | **是**: 资源资源 Key (优先使用) |
+| `pathOrUrl` | `string` | 否: 资源 URL 地址 (可选备用) |
+| `raw` | `object` | **是**: 平台原始数据 (必须透传) |
+
+| 字段名 (Category) | 类型 | 说明 |
+| :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是**: 分类 ID |
+| `yixiaoerName` | `string` | **是**: 分类名称 |
+| `raw` | `object` | **是**: 平台原始数据 (必须透传) |
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `cover.key` | `upload` | [资源上传](../../upload-resource.md) |
+| `authorName` | `accounts` | [查询账号列表](../../query-accounts.md) |

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

@@ -0,0 +1,75 @@
+# 新浪微博文章发布参数 (XinLangWeiBo Article)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [文章发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Xinlangweibo”平台发布文章内容时触发。
+- **典型提示词**：
+  - “发布这篇文章到Xinlangweibo”
+  - “并在Xinlangweibo上同步更新”
+
+## 执行逻辑 (Logic Flow)
+1. **内容处理**：确保文章正文符合Xinlangweibo要求的格式。
+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` | **是** | 文章标题 | - |
+| `content` | `string` | **是** | 文章内容 (HTML 格式) | - |
+| `covers` | `Array` | **是** | 文章封面列表 (`OldCover[]`) | - |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+
+## 2. 复杂对象结构说明
+
+### 2.1 OldCover
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `key` | `string` | **是** | OSS 资源 Key |
+| `size` | `number` | **是** | 文件大小 (Bytes) |
+| `width` | `number` | **是** | 宽度 |
+| `height` | `number` | **是** | 高度 |
+
+## 3. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "article",
+  "platforms": ["新浪微博"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_weibo_001",
+        "coverKey": "article_cover_key",
+        "cover": { "key": "article_cover_key", "size": 102400, "width": 800, "height": 600 },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "这是文章标题",
+          "content": "<h1>微博长文章</h1><p>内容正文支持 HTML 渲染。</p>",
+          "covers": [
+            { "key": "article_cover_key", "size": 102400, "width": 800, "height": 600 }
+          ],
+          "pubType": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `covers.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,73 @@
+# 雪球号文章发布参数 (XueQiuHao Article)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [文章发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Xueqiuhao”平台发布文章内容时触发。
+- **典型提示词**：
+  - “发布这篇文章到Xueqiuhao”
+  - “并在Xueqiuhao上同步更新”
+
+## 执行逻辑 (Logic Flow)
+1. **内容处理**：确保文章正文符合Xueqiuhao要求的格式。
+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` | **是** | 文章标题 (长度: 9-100) | - |
+| `content` | `string` | **是** | 文章内容 (HTML 格式) | - |
+| `covers` | `Array` | 否 | 文章封面列表 (`OldCover[]`) | - |
+| `visibleType` | `number` | **是** | 可见类型: 0-公开, 1-私密 | 0 |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
+| `declaration` | `number` | 否 | 内容申明: 0-不申明, 1-包含 AI 内容 | 0 |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+
+## 2. 复杂对象结构说明
+
+### 2.1 OldCover
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `key` | `string` | **是** | OSS 资源 Key |
+| `size` | `number` | **是** | 文件大小 (Bytes) |
+| `width` | `number` | **是** | 宽度 |
+| `height` | `number` | **是** | 高度 |
+
+## 3. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "article",
+  "platforms": ["雪球号"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_xq_001",
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "这是财经文章标题示例",
+          "content": "<h1>雪球号财经文章</h1><p>内容正文...</p>",
+          "visibleType": 0,
+          "pubType": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `covers.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,92 @@
+# 易车号文章发布参数 (YiCheHao Article)
+
+> [!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]`。
+
+
+本平台文章发布通过 `contentPublishForm` 承载以下参数。
+
+## 1. contentPublishForm 参数定义
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定值: `task` | `task` |
+| `title` | `string` | **是** | 文章标题 (最多 28 字符) | - |
+| `content` | `string` | **是** | 文章内容 (HTML 格式) | - |
+| `covers` | `Array` | **是** | 文章封面列表 (`OldCover[]`) | - |
+| `verticalCovers` | `Array` | **是** | 文章竖版封面列表 (`OldCover[]`) | - |
+| `declaration` | `number` | 否 | 创作申明: 0-不申明, 1-个人观点, 2-内容来源网络, 3-AI生成, 4-引用站内 | - |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+| `allowForward` | `boolean` | 否 | 允许转发 | `false` |
+| `allowAbstract` | `boolean` | 否 | 允许生成摘要 | `false` |
+| `topics` | `Array` | 否 | 话题列表 (`Category[]`) | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "article",
+  "platforms": ["易车号"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_ych_001",
+        "coverKey": "article_cover_key",
+        "cover": { "key": "article_cover_key", "size": 102400, "width": 800, "height": 600 },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "这是文章标题",
+          "content": "<h1>文章标题</h1><p>正文内容...</p>",
+          "covers": [
+            { "key": "article_cover_key", "size": 102400, "width": 800, "height": 600 }
+          ],
+          "verticalCovers": [
+            { "key": "v_cover_key", "size": 102400, "width": 600, "height": 800 }
+          ],
+          "declaration": 0,
+          "pubType": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 3. 复杂对象结构说明
+
+### 3.1 OldCover
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `key` | `string` | **是** | OSS 资源 Key |
+| `size` | `number` | **是** | 文件大小 (Bytes) |
+| `width` | `number` | **是** | 宽度 |
+| `height` | `number` | **是** | 高度 |
+
+### 3.2 Category (用于话题)
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `yixiaoerId` | `string` | **是** | 话题 ID |
+| `yixiaoerName` | `string` | **是** | 话题名称 |
+| `raw` | `object` | **是** | 平台原始数据 (必须完整透传) |
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `covers.key` | `upload` | [资源上传](../../upload-resource.md) |
+| `topics` | `categories` | [获取账号分类/话题](../../get-publish-categories.md) |

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

@@ -0,0 +1,76 @@
+# 一点号文章发布参数 (YiDianHao Article)
+
+> [!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]`。
+
+
+本平台文章发布通过 `contentPublishForm` 承载以下参数。
+
+## 1. contentPublishForm 参数定义
+
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `formType` | `string` | **是** | 固定值: `task` | `task` |
+| `title` | `string` | **是** | 文章标题 (长度: 5-64) | - |
+| `content` | `string` | **是** | 文章内容 (HTML 格式) | - |
+| `covers` | `Array` | **是** | 文章封面列表 (`OldCover[]`) | - |
+| `declaration` | `number` | 否 | 创作声明: 3-取材网络, 4-AI 生成, 5-虚构情节 | - |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "article",
+  "platforms": ["一点号"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_yd_001",
+        "coverKey": "article_cover_key",
+        "cover": { "key": "article_cover_key", "size": 102400, "width": 800, "height": 600 },
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "这是文章标题",
+          "content": "<h1>文章标题</h1><p>正文内容...</p>",
+          "covers": [
+            { "key": "article_cover_key", "size": 102400, "width": 800, "height": 600 }
+          ],
+          "pubType": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 3. 复杂对象结构说明
+
+### 3.1 OldCover
+| 字段名 | 类型 | 必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `key` | `string` | **是** | OSS 资源 Key |
+| `size` | `number` | **是** | 文件大小 (Bytes) |
+| `width` | `number` | **是** | 宽度 |
+| `height` | `number` | **是** | 高度 |
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `covers.key` | `upload` | [资源上传](../../upload-resource.md) |

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

@@ -0,0 +1,75 @@
+# 知乎文章发布参数 (ZhiHu Article)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [文章发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“知乎”平台发布长文章或专栏内容，且需要配置如“多话题挂载”、“自定义封面列表”、“申明 AI 创作”或“存为知乎草稿”等知乎特有功能时触发。
+- **典型提示词**：
+  - “把这篇干货文章发布到知乎”
+  - “知乎发布，加上‘科技’、‘教育’话题”
+  - “声明这篇文章是 AI 辅助创作的”
+  - “帮我同步这个内容到知乎草稿箱”
+
+## 执行逻辑 (Logic Flow)
+1. **内容纯化**：知乎对 HTML 格式支持有特定要求，建议确保 `content` 包含基础层级标签。
+2. **辅助话题检索**：调用 `challenges` 接口获取知乎支持的 Topic 列表（限制最多 3 个）。
+3. **申明装配**：根据文章属性注入 `declaration` 枚举值（如 5-AI辅助）。
+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` | **是** | 文章标题 (9-100 字符) | - |
+| `content` | `string` | **是** | 文章内容 (9-10000 字符，HTML 格式) | - |
+| `covers` | `Array` | 否 | 文章封面列表 (`OldCover[]`) | - |
+| `topics` | `Array` | 否 | 话题列表 (`Category[]`, 最多3个) | - |
+| `declaration` | `number` | 否 | 创作申明: 0-无申明, 1-剧透, 2-医疗建议, 3-虚构创作, 4-理财内容, 5-AI辅助 | 0 |
+| `pubType` | `number` | **是** | 发布类型: 0-草稿, 1-直接发布 | 1 |
+| `scheduledTime` | `number` | 否 | 定时发布时间 (13 位 Unix 时间戳，单位: 毫秒) | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "article",
+  "platforms": ["知乎"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "ZH_ACC_ID",
+        "contentPublishForm": {
+          "formType": "task",
+          "title": "深度分析 AI 在 2026 年的发展",
+          "content": "<h1>深度分析</h1><p>内容正文...</p>",
+          "topics": [
+            { "yixiaoerId": "cat_001", "yixiaoerName": "人工智能", "raw": {} }
+          ],
+          "declaration": 5,
+          "pubType": 1
+        }
+      }
+    ]
+  }
+}
+```
+
+## 3. 复杂对象结构说明
+
+### 3.1 OldCover
+包含 `key`, `size`, `width`, `height`。
+
+### 3.2 Category (用于话题)
+包含 `yixiaoerId`, `yixiaoerName`, `raw` (必须完整透传)。
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `topics`    | `challenges` | [获取话题/挑战](../../get-challenges.md) |
+| `covers.key`| `upload`     | [资源上传](../../upload-resource.md) |

package/skills/yixiaoer/references/platforms/get-locations.md

@@ -0,0 +1,5 @@
+# 获取地理位置 (Platform Alias)
+
+本页是平台目录下的兼容跳转页，用于承接历史误写的相对路径。
+
+请改读 [`../get-locations.md`](../get-locations.md)。

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

@@ -0,0 +1,91 @@
+# 百家号图文发布参数 (BaiJiaHao Image-Text)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [图文发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Baijiahao”平台发布图文动态时触发。
+- **典型提示词**：
+  - “发几张图到Baijiahao”
+  - “同步这条动态到Baijiahao”
+
+## 执行逻辑 (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-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 时间戳，单位: 毫秒) | - |
+
+## 2. 复杂对象结构说明
+
+### 复杂对象：OldCover
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `width` | `number` | **是** | 图片宽度 | - |
+| `height` | `number` | **是** | 图片高度 | - |
+| `size` | `number` | **是** | 文件大小 (Bytes) | - |
+| `key` | `string` | **是** | 资源 Key (通过上传接口获取) | - |
+
+### 复杂对象：PlatformDataItem
+| 字段名 | 类型 | 必填 | 说明 | 默认值 |
+| :--- | :--- | :--- | :--- | :--- |
+| `id` | `string` | **是** | 位置 ID | - |
+| `text` | `string` | **是** | 项名称/文本 | - |
+| `raw` | `object` | 否 | 原始数据对象 | - |
+
+## 3. 依赖接口说明
+
+若字段值需通过查询获得，需注明：
+- **位置 (location)**: 需通过 `[获取位置](../../get-locations.md)` 获得对应的 `PlatformDataItem`。
+- **话题 (topic)**: 在 `description` 中使用 `<topic>` 标签时，话题数据需通过 `[获取话题](../../get-topics.md)` 获得。
+
+## 4. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "imageText",
+  "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
+        }
+      }
+    ]
+  }
+}
+```
+
+## 相关接口
+
+| 目标数据 | 对应 Action | 相关文档 |
+| :--- | :--- | :--- |
+| `images.key` | `upload` | [资源上传](../../upload-resource.md) |