@yixiaoermail/cli 3.1.0

package/skills/yixiaoer/references/get-publish-activities.md

@@ -0,0 +1,40 @@
+# 获取征文活动列表 (Get Activities)
+
+获取各媒体平台（如百家号、企鹅号等）当前正在开展的征文任务或激励活动信息。
+
+## 触发场景 (Trigger)
+- **意图辨析**：当用户希望参加平台官方活动以获取额外流量激励或奖金，并需要获取活动 ID 进行发布挂载时触发。
+- **典型提示词**：
+  - “最近百家号有什么征文活动？”
+  - “帮我找一下适合这个视频参加的活动”
+  - “查看特定分类下的激励任务”
+
+## 参数定义 (Parameters)
+
+### 参数列表 (Payload Properties)
+
+| 字段名 | 类型 | 是否必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `action` | `string` | **是** | 固定值：`activities` |
+| `account_id` | `string` | **是** | 蚁小二账号 ID (ObjectId) |
+| `type` | `string` | 否 | 发布类型：`video` 或 `article` (默认) |
+| `categoryId` | `string` | 否 | 仅查询特定分类下的活动 |
+| `keyword` | `string` | 否 | 按关键字搜索 (别名: `keyWord`) |
+
+## 执行逻辑 (Logic Flow)
+1. **意图解析**：识别目标平台账号及活动所属类别。
+2. **关键词过滤**：提取用户提到的活动名称作为 `keyword`。
+3. **参数装配**：构造 `action: "activities"` 负载。
+4. **指令执行**：当前能力正在迁移到 `yxer` CLI，本文档不再推荐脚本直调。
+5. **挂载建议**：获取活动列表后，将 `activityId` 反馈给用户或自动准备发布 Payload。
+
+## 返回数据 (Response)
+
+返回包含活动对象的数组。参与活动时，请将对应的 `id` 填入发布表单。
+
+## 调用指令 (Command)
+
+```text
+当前版本尚未提供独立 `yxer` 子命令。
+本页仅保留字段结构说明，执行时应优先扩展 Go CLI，而不是寻找旧脚本入口。
+```

package/skills/yixiaoer/references/get-publish-categories.md

@@ -0,0 +1,62 @@
+# 获取发布分类/话题 (Get Categories)
+
+获取特定平台账号支持的文章分类、视频分类或话题标签列表。
+
+当前支持平台：百家号、爱奇艺、哔哩哔哩、企鹅号、网易号、一点号、知乎、蜂网、AcFun。
+
+## 触发场景 (Trigger)
+- **意图辨析**：在准备发布内容时，为了确保 `platformSettings` 中的分类/话题符合平台标准，不产生非法值，必须预先查询合法值。
+- **典型提示词**：
+  - “获取这个百家号的视频分类”
+  - “查看百家号支持的文章类别”
+  - “查询可以挂载的话题”
+
+## 参数定义 (Parameters)
+
+### 参数列表 (Payload Properties)
+
+| 字段名 | 类型 | 是否必填 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `action` | `string` | **是** | 固定值：`categories` |
+| `account_id` | `string` | **是** | 蚁小二账号 ID (ObjectId) |
+| `type` | `string` | 否 | 发布类型：`video` (默认) 或 `article` |
+
+## 执行逻辑 (Logic Flow)
+1. **身份锚定**：识别目标账号 `account_id`（通过 `accounts` action 获取）。
+2. **场景对齐**：根据发布内容决定 `type`。
+3. **参数装配**：构造 `action: "categories"` 负载。
+4. **指令执行**：调用 `yxer query categories <account_id> [--type video|article] [--json]`。
+5. **值注入**：将 CLI 返回的完整分类对象填入发布 Payload 的对应位置，不能只摘取 `id`、`name` 或局部 `raw` 字段。
+
+## 返回数据说明 (Response Details)
+
+返回包含分类对象（`Category` 结构）的树形或扁平结构。发布时必须使用 `yxer query categories` 返回的完整对象数据。
+- **Agent 手动铺平 (Flattening)**：若返回的数据包含嵌套的 `children` 数组，Agent **必须自行递归遍历**，以便在组装发布表单时能够获取任何层级的分类。
+- **层级路径组装 (Cascading Path)**：
+  - 对于要求多级分类的平台 (如 Bilibili)，Agent 在组装表单时，不能只填入最终选中的子分类。
+  - **必须组装一个数组**：包含从根节点到选中节点的所有路径对象。
+  - **包含 `raw` 对象**：路径中每一个对象除 `yixiaoerId` 和 `yixiaoerName` 外，**必须同步传入其对应的 `raw` 对象**（若存在）。
+
+### 复杂对象：CategoryItem
+- `yixiaoerId`: 内部分类 ID。
+- `yixiaoerName`: 分类名称。
+- `raw`: 原始平台返回的分类对象（组装表单时必须保留）。
+- `children`: 子分类数组（若存在，需递归处理）。
+  - **示例**：
+    - 父分类：`{"yixiaoerId": "18", "yixiaoerName": "动漫"}`
+    - 子分类：`{"yixiaoerId": "1", "yixiaoerName": "国产动漫"}`
+    - 最终处理后的 `category` 字段：
+      ```json
+      "category": [
+        { "yixiaoerId": "18", "yixiaoerName": "动漫", "raw": {} },
+        { "yixiaoerId": "1", "yixiaoerName": "国产动漫", "raw": {} }
+      ]
+      ```
+- `raw`: 原始平台返回的分类对象。
+
+## 调用指令 (Command)
+
+```bash
+yxer query categories YOUR_ACCOUNT_ID --type video --json
+```
+

package/skills/yixiaoer/references/get-sync-apps.md

@@ -0,0 +1,14 @@
+# 获取同步发布应用列表 (Get Sync Apps)
+
+获取发布当前作品时，可同时同步到的其他平台或应用列表（如抖音发布时同步到今日头条）。
+
+## 1. 调用指令
+
+```text
+当前版本尚未提供独立 `yxer` 子命令。
+本页仅保留字段结构说明，执行时应优先扩展 Go CLI，而不是寻找旧脚本入口。
+```
+
+## 2. 返回数据结构
+
+返回 `Category` 数组。如果在获取时 `raw` 字段有值，发布表单中必须完整保留并透传。

package/skills/yixiaoer/references/get-topics.md

@@ -0,0 +1,13 @@
+# 获取话题列表 (Get Topics)
+
+本页是历史别名，兼容旧平台文档中的 `get-topics.md` 引用。
+
+## 当前建议
+
+- 通用话题/挑战赛场景：优先读取 [`./get-challenges.md`](./get-challenges.md)
+- 平台热点/活动话题场景：按需补读 [`./get-hot-events.md`](./get-hot-events.md)
+
+## CLI 优先级
+
+- 如平台提供 `yxer query challenges <account_id> [--query 关键词]`，优先使用该命令
+- 如平台文档明确要求活动对象，再按平台规则使用活动或热点数据

package/skills/yixiaoer/references/go-live-process.md

@@ -0,0 +1,168 @@
+# yxer 上线流程
+
+本文档用于说明 `yxer` CLI 和 `yixiaoer` skill 的标准上线流程，适合研发、测试、运维和实施同学协作使用。
+
+## 1. 上线目标
+
+本项目上线交付物包含两部分：
+
+- `yxer` CLI：实际执行账号查询、资源上传、校验和发布
+- `skills/yixiaoer`：提供给 AI agent 读取的技能规则和工作流
+
+上线时必须保证两者版本一致，避免出现 CLI 已升级、skill 未同步的问题。
+
+## 2. 发布前检查
+
+上线前至少完成以下检查：
+
+- `go test ./...`
+- `go build -o bin/yxer.exe .`
+- `bin\\yxer.exe --version`
+- `bin\\yxer.exe skill show`
+- `bin\\yxer.exe doctor`
+
+建议同时人工检查以下内容：
+
+- `README.md` 是否已更新
+- `skills/yixiaoer/SKILL.md` 是否已同步当前版本说明
+- `references/cli/`、`references/workflows/` 是否与本次功能一致
+- `schemas/` 是否覆盖本次变更涉及的平台字段
+
+## 3. 标准上线步骤
+
+### 步骤 1：代码冻结
+
+- 合并本次要上线的功能、文档和 schema
+- 确认没有未评审的临时调试代码
+- 确认 `git status` 干净或仅保留已知发布文件
+
+### 步骤 2：执行测试
+
+在项目根目录执行：
+
+```bash
+go test ./...
+```
+
+如测试失败，不进入后续上线步骤。
+
+### 步骤 3：构建 CLI
+
+```bash
+go build -o bin/yxer.exe .
+```
+
+如需要给其他环境发包，建议同时生成版本目录，例如：
+
+```text
+release/
+  yxer-windows-amd64/
+    yxer.exe
+    README.md
+    skills/yixiaoer/references/
+```
+
+### 步骤 4：冒烟验证
+
+至少验证以下命令：
+
+```bash
+bin\yxer.exe --version
+bin\yxer.exe skill show
+bin\yxer.exe update --check
+bin\yxer.exe doctor
+```
+
+如有可用测试账号，建议再补一轮无副作用验证：
+
+```bash
+bin\yxer.exe accounts list 抖音 --json
+bin\yxer.exe prepare 抖音 video
+bin\yxer.exe schema get 抖音 video
+bin\yxer.exe validate 抖音 video .\tests\fixtures\cli\test-cli-payload.json
+bin\yxer.exe publish video 抖音 .\tests\fixtures\cli\test-cli-payload.json --dry-run
+```
+
+说明：
+
+- `doctor` 用于检查配置和 skill 漂移
+- `skill show` 用于确认技能目录和同步命令
+- `update --check` 用于确认当前版本状态
+
+### 步骤 5：同步 Skill
+
+在发布包对应目录执行：
+
+```bash
+bin\yxer.exe skill sync
+```
+
+如需全局安装 skill：
+
+```bash
+bin\yxer.exe skill sync --global
+```
+
+### 步骤 6：发布交付物
+
+建议至少交付以下内容：
+
+- `yxer.exe`
+- `README.md`
+- `skills/yixiaoer/references/go-live-process.md`
+- `skills/yixiaoer/references/cli-install-uninstall.md`
+- `skills/yixiaoer/references/usage-workflow.md`
+- `skills/yixiaoer/references/keyword-reference.md`
+- `skills/yixiaoer/SKILL.md`
+- `references/cli/`
+- `references/workflows/`
+- `schemas/`
+
+## 4. 建议交付方式
+
+当前仓库尚未提供自动下载新版 CLI 二进制的能力，因此推荐以下两种方式之一：
+
+### 方式 A：源码构建交付
+
+适用于研发或内测环境：
+
+1. 拉取指定版本代码
+2. 执行 `go build -o bin/yxer.exe .`
+3. 按文档安装 skill
+
+### 方式 B：制品包交付
+
+适用于正式上线或给业务同学分发：
+
+1. 由发布人员构建 `yxer.exe`
+2. 打包 `yxer.exe + skills/yixiaoer + references + docs + schemas`
+3. 上传到内部制品库、网盘或发布平台
+4. 给使用方发固定版本下载地址
+
+## 5. 回滚流程
+
+若上线后发现问题，按以下顺序回滚：
+
+1. 停止分发新版本 `yxer.exe`
+2. 恢复上一个稳定版本的 CLI 包
+3. 重新执行对应版本的 `yxer skill sync`
+4. 用 `yxer doctor` 检查 skill 是否与 CLI 重新对齐
+
+如果只是 skill 文档漂移，但 CLI 本体无问题，可只回滚 skill 包并重新同步。
+
+## 6. 上线验收标准
+
+满足以下条件即可判定可上线：
+
+- 单元测试通过
+- `yxer.exe` 可正常运行并输出版本
+- `yxer skill show` 可正确识别技能目录
+- `yxer doctor` 无阻断性错误
+- 安装、同步、使用流程文档齐全
+- CLI 与 skill 版本一致
+
+## 7. 风险提示
+
+- 当前项目没有“自动下载最新 CLI”的能力，版本升级仍以源码构建或制品分发为主
+- Skill 的实际执行依赖外部 `npx skills add` 工具，目标环境必须具备 Node.js 和 `npx`
+- 若只替换 `yxer.exe` 但未同步 skill，AI agent 可能继续使用旧规则

package/skills/yixiaoer/references/keyword-reference.md

@@ -0,0 +1,113 @@
+# yxer 关键词文档
+
+本文档用于统一业务沟通、实施交付和 AI 调用时的关键词口径。
+
+## 1. 产品与组件关键词
+
+| 关键词 | 含义 |
+| --- | --- |
+| `yxer` | 蚁小二 CLI，可执行入口 |
+| `yixiaoer skill` | 给 AI agent 读取的技能包 |
+| `CLI` | 命令行工具，当前项目即 `yxer` |
+| `skill` | AI 技能规则，不直接执行 API |
+| `linked app` | 宿主可识别的链接应用状态 |
+
+## 2. 安装与运维关键词
+
+| 关键词 | 推荐理解 |
+| --- | --- |
+| 下载 CLI | 获取 `yxer.exe`，来源可以是源码构建或制品包 |
+| 安装 CLI | 放置 `yxer.exe` 到本地目录并加入 `PATH` |
+| 安装 skill | 执行 `npx skills add "<repo>\\skills\\yixiaoer" -y` |
+| 同步 skill | 执行 `yxer skill sync`，让 skill 版本与 CLI 对齐 |
+| 升级 CLI | 重新构建或替换新版 `yxer.exe` |
+| 卸载 CLI | 删除 `yxer.exe`、移除 `PATH`、按需清理 `.yxer` 配置 |
+| 卸载 skill | 删除 AI 宿主中的 `yixiaoer` 技能安装，并清理 `skills.stamp` |
+
+## 3. 发布能力关键词
+
+| 关键词 | 含义 |
+| --- | --- |
+| `publish` | 正式发布 |
+| `validate` | 发布前校验 payload |
+| `dry-run` | 只预演，不正式提交 |
+| `prepare` | 获取平台发布表单定义 |
+| `schema get` | 获取标准 schema |
+| `upload` | 上传图片、视频等资源 |
+
+## 4. 内容类型关键词
+
+| 关键词 | 含义 |
+| --- | --- |
+| `video` | 视频发布 |
+| `imageText` | 图文发布 |
+| `article` | 文章发布 |
+
+说明：
+
+- 当前推荐发布类型只使用这三种
+- 文档、命令、payload 中都应保持这三个标准写法
+
+## 5. 发布通道关键词
+
+| 关键词 | 含义 |
+| --- | --- |
+| `cloud` | 云发布，默认模式 |
+| `local` | 本机发布 / 本地发布 / 客户端发布 |
+| `clientId` | 本机发布时必须提供的客户端标识 |
+
+同义词归并建议：
+
+- 本机发布 = 本地发布 = 客户端发布 = `publishChannel=local`
+- 云发布 = 线上代理发布 = `publishChannel=cloud`
+
+## 6. Payload 结构关键词
+
+| 关键词 | 含义 |
+| --- | --- |
+| `publishArgs` | 标准发布请求体主体 |
+| `accountForms` | 账号维度表单数组，必须位于 `publishArgs` 下 |
+| `contentPublishForm` | 单账号的平台业务表单 |
+| `platformAccountId` | 平台账号 ID |
+| `platforms` | 本次目标平台列表 |
+
+统一约束：
+
+- 顶层必须包含 `publishArgs`
+- `accountForms` 只能放在 `publishArgs.accountForms`
+- 平台字段默认放在 `contentPublishForm`
+
+## 7. 查询类关键词
+
+| 关键词 | 含义 |
+| --- | --- |
+| `accounts list` | 查询账号 |
+| `categories` | 查询分类 |
+| `locations` | 查询地点 |
+| `music` | 查询音乐 |
+| `goods` | 查询商品 |
+| `collections` | 查询合集 |
+| `challenges` | 查询话题 |
+| `records list` | 查询发布记录 |
+
+## 8. 使用场景关键词
+
+| 用户说法 | 标准动作 |
+| --- | --- |
+| 查账号 | `yxer accounts list` |
+| 发视频 | `yxer publish video` |
+| 发图文 | `yxer publish imageText` |
+| 发文章 | `yxer publish article` |
+| 先试一下 | `--dry-run` |
+| 本机发 | `--publish-channel local` |
+| 云端发 | 默认 `cloud` |
+| 看字段 | `yxer prepare` + `yxer schema get` |
+
+## 9. 推荐培训口径
+
+对外说明时，建议统一这样表述：
+
+- `yxer` 是实际执行工具
+- `yixiaoer skill` 是给 AI 读的规则包
+- 发布前必须先 `prepare`、`schema get`、`validate`
+- 资源必须先上传，不能直接在 payload 里乱填外链

package/skills/yixiaoer/references/material-resource.md

@@ -0,0 +1,89 @@
+# 上传到素材库 (Material Library Save)
+
+将资源上传并登记到素材库，生成可在素材管理中复用的视频或图片记录。
+
+## 触发场景 (Trigger)
+- **意图辨析**：当用户希望将已上传的临时资源“持久化”或“资产化”，以便后续多次复用、团队共享或在网页端素材库中进行统一管理时触发。
+- **典型提示词**：
+  - “把这个视频存进素材库方便以后调用”
+  - “我的宣传片已经传好了，帮我入库”
+  - “将这个 Key 对应的图片登记到素材管理中”
+
+> [!TIP]
+> **推荐命令 (Recommended Command)**:
+> 当用户意图是“把文件放进素材库”，优先直接使用：
+>
+> ```bash
+> yxer material add --file ./demo.mp4
+> ```
+>
+> 该命令会自动完成：
+> 1. 上传到 `material-library`
+> 2. 素材登记入库
+
+## 参数定义 (Parameters)
+
+### 参数列表 (Payload Properties)
+
+| 字段名 | 类型 | 是否必填 | 描述 |
+| :--- | :--- | :--- | :--- |
+| `action` | `string` | **是** | 固定值: `material` |
+| `filePath` | `string` | **是** | 已上传到蚁小二 OSS 的资源 `key`（通过 `upload` 获取） |
+| `fileName` | `string` | **是** | 展示用文件名，建议保留扩展名 |
+| `width` | `number` | **是** | 素材宽度 |
+| `height` | `number` | **是** | 素材高度 |
+| `type` | `string` | **是** | 素材类型。常用值为 `video` 或 `image` |
+| `thumbPath` | `string` | 否 | 缩略图资源 `key`。视频建议传封面，图片可不传 |
+
+## 执行逻辑 (Logic Flow)
+1. **链路检查**：确认资源是否已通过 `upload` 动作上传（建议使用 `bucket: "material-library"`）。
+2. **元数据提取**：识别文件的真实名称、宽高及类型。
+3. **参数装配**：构造 `action: "material"` 及完整元数据。
+4. **指令执行**：优先调用 `yxer material add --file ...`；只有高级定制时再拆分成 `upload + material create`。
+5. **入库反馈**：向用户确认素材 ID 及入库成功状态。
+
+## 推荐链路 (Recommended Flow)
+
+1. 优先使用：
+
+```bash
+yxer material add --file ./demo.mp4
+```
+
+2. 如需手工控制资源 key 或缩略图，再拆分成：
+- `yxer upload ./demo.mp4 --bucket material-library`
+- `yxer material create material-payload.json`
+
+## 调用指令 (Command)
+
+```bash
+yxer material create material-payload.json
+```
+
+推荐优先执行：
+
+```bash
+yxer material add --file ./demo.mp4
+```
+
+兼容旧模式时，先执行：
+
+```bash
+yxer upload ./demo.mp4 --bucket material-library
+```
+
+再将返回的 `key` 组装进 `material-payload.json`：
+
+```json
+{
+  "filePath": "uploaded/demo.mp4",
+  "fileName": "demo.mp4",
+  "width": 1080,
+  "height": 1920,
+  "type": "video"
+}
+```
+
+## 注意事项
+- **Bucket 匹配**：若目标是素材库，请在上传步骤显式使用 `bucket: "material-library"`。
+- **重复校验**：若相同资源已入库，后端可能返回已有记录。

package/skills/yixiaoer/references/platform-doc-maintenance.md

@@ -0,0 +1,33 @@
+# 平台文档维护规范
+
+本文档定义 `skills/yixiaoer/references/platforms/` 与根目录历史文档副本的角色分工，避免平台文档长期双轨漂移。
+
+## 目录角色
+
+- `skills/yixiaoer/references/platforms/`
+  - skill 运行时唯一有效的平台文档入口
+  - Agent 读取平台差异时，必须优先读取这里
+  - 这里的内容优先级最高
+- 根目录历史平台文档副本
+  - 仅供仓库人工查阅、比对和批量编辑
+  - 不再作为 skill 或 agent 主入口
+
+## 维护原则
+
+1. 平台文档发生变更时，先更新 `skills/yixiaoer/references/platforms/`
+2. 如果仍保留根目录副本，同一轮变更内必须同步更新
+3. 若两处内容冲突，以 `skills/yixiaoer/references/platforms/` 为准
+4. 新增平台或新增字段时，所有引用路径应指向 skill 内平台目录
+
+## 引用规范
+
+- skill 入口：`skills/yixiaoer/SKILL.md`
+- 任务分域：`skills/yixiaoer/references/domains/`
+- 平台索引：`skills/yixiaoer/references/platforms/*/index.md`
+- 平台细节：`skills/yixiaoer/references/platforms/<type>/<platform>.md`
+
+## 禁止事项
+
+- 不要再把历史平台副本写成“唯一入口”
+- 不要在 workflow 中把根目录历史副本作为 agent 默认跳转路径
+- 不要只修改历史副本而遗漏 skill 内平台文档

package/skills/yixiaoer/references/platform.md

@@ -0,0 +1,61 @@
+# 平台定义 (Platform Definitions)
+如无特殊声明，API 接口中 `platforms` 数组中需要填写的名称为**平台中文名**。
+
+详细的发布接口结构请参考: [平台参考索引](./platforms/index.md)
+
+## 平台标识枚举 (Platform Codes)
+
+| 平台标识 (Code) | 平台中文名 (Name) |
+| :--- | :--- |
+| `DouYin` | `抖音` |
+| `KuaiShou` | `快手` |
+| `ShiPinHao` | `视频号` |
+| `BiLiBiLi` | `哔哩哔哩` |
+| `XiaoHongShu` | `小红书` |
+| `BaiJiaHao` | `百家号` |
+| `TouTiaoHao` | `头条号` |
+| `XiGuaShiPin` | `西瓜视频` |
+| `ZhiHu` | `知乎` |
+| `QiEHao` | `企鹅号` |
+| `XinLangWeiBo` | `新浪微博` |
+| `SouHuHao` | `搜狐号` |
+| `YiDianHao` | `一点号` |
+| `DaYuHao` | `大鱼号` |
+| `WangYiHao` | `网易号` |
+| `AiQiYi` | `爱奇艺` |
+| `TengXunWeiShi` | `腾讯微视` |
+| `WeiXinGongZhongHao` | `微信公众号` |
+| `WeiXin` | `微信` |
+| `Tiktok` | `TikTok` |
+| `Youtube` | `Youtube` |
+| `Twitter` | `X` |
+| `Facebook` | `Facebook` |
+| `Instagram` | `Instagram` |
+| `Other` | `其他账号` |
+| `SouHuShiPin` | `搜狐视频` |
+| `PiPiXia` | `皮皮虾` |
+| `TengXunShiPin` | `腾讯视频` |
+| `DuoDuoShiPin` | `多多视频` |
+| `MeiPai` | `美拍` |
+| `AcFun` | `AcFun` |
+| `KuaiChuanHao` | `快传号` |
+| `XueQiuHao` | `雪球号` |
+| `CheJiaHao` | `车家号` |
+| `XiaoHongShuShangJiaHao` | `小红书商家号` |
+| `YiCheHao` | `易车号` |
+| `FengWang` | `蜂网` |
+| `DouBan` | `豆瓣` |
+| `CSDN` | `CSDN` |
+| `DeWu` | `得物` |
+| `JianShu` | `简书` |
+| `MeiYou` | `美柚` |
+| `WeiXinGongZhongHao-Open` | `微信公众号-Open` |
+| `BiLiBiLi-Open` | `哔哩哔哩-Open` |
+
+## 平台类型枚举 (PlatformType)
+
+| 值 (Value) | 定义 | 说明 |
+| :--- | :--- | :--- |
+| `0` | `Crawler` | 其他/爬虫账号 |
+| `1` | `OpenPlatform` | 开放平台账号 |
+| `2` | `Overseas` | 海外平台账号 |

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

@@ -0,0 +1,90 @@
+# AcFun文章发布参数 (AcFun Article)
+
+> [!IMPORTANT]
+> **前提条件 (Prerequisite)**:
+> 在使用本平台的特定参数之前，你 **必须** 已经阅读并理解了 [文章发布首页 (Index)](./index.md) 中定义的 Payload 根结构。本页仅描述 `contentPublishForm` 内部的平台差异化字段。
+
+
+## 触发场景 (Trigger)
+- **意图辨析**：用户指定在“Acfun”平台发布文章内容时触发。
+- **典型提示词**：
+  - “发布这篇文章到Acfun”
+  - “并在Acfun上同步更新”
+
+## 执行逻辑 (Logic Flow)
+1. **内容处理**：确保文章正文符合Acfun要求的格式。
+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) | - |
+| `content` | `string` | **是** | 文章内容 (HTML 格式，最多 50000 字符) | - |
+| `desc` | `string` | 否 | 文章摘要/描述 (最多 200 字) | - |
+| `covers` | `Array` | **是** | 文章封面列表 (`OldCover[]`, 至少 1 张) | - |
+| `tags` | `string[]` | 否 | 话题标签 (最多 1 个) | - |
+| `category` | `Array` | **是** | 文章分类 (`Category[]`, 1-2 个) | - |
+| `type` | `number` | **是** | 创作类型: 0-不申明, 1-申明原创 | - |
+| `contentSourceUrl` | `string` | 否 | 原文链接 (转载时必填) | - |
+
+## 2. Payload 完整示例
+
+```json
+{
+  "action": "publish",
+  "publishType": "article",
+  "platforms": ["AcFun"],
+  "publishArgs": {
+    "accountForms": [
+      {
+        "platformAccountId": "acc_ac_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 }
+          ],
+          "tags": ["综合"],
+          "type": 1,
+          "category": [
+            { "yixiaoerId": "cat_001", "yixiaoerName": "综合", "raw": {} }
+          ]
+        }
+      }
+    ]
+  }
+}
+```
+
+## 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) |
+| `category` | `categories` | [获取发布分类](../../get-publish-categories.md) |