@yixiaoermail/cli 3.1.0

package/skills/yixiaoer/references/workflows/publish-video.md

@@ -0,0 +1,65 @@
+# 视频发布工作流
+
+> 适用范围：抖音视频、快手视频、B 站视频、视频号视频、微博视频等。
+> 阅读本文档前，请先阅读 [common-rules.md](./common-rules.md)。
+
+---
+
+## 推荐入口
+
+仅支持 `payload.json` 模式。发布前先获取表单字段和 schema：
+
+```bash
+yxer prepare <platform> video
+yxer schema fields <platform> video
+yxer schema get <platform> video
+```
+
+开始前，先补读：
+
+- [`account-selection.md`](./account-selection.md)
+- [`local-vs-cloud.md`](./local-vs-cloud.md)
+- [`payload-sourcing.md`](./payload-sourcing.md)
+- 涉及话题/标签时：[`../topic-tags.md`](../topic-tags.md)
+
+## 执行顺序
+
+1. 查询账号：`yxer accounts list [platform] [--status 1] [--json]`
+2. 获取前置数据：`yxer prepare <platform> video`
+3. 先获取字段视图：`yxer schema fields <platform> video`；需要 payload 骨架时再执行 `yxer schema get <platform> video`
+4. 上传视频：`yxer upload <视频路径或URL>`
+5. 上传封面：`yxer upload <封面路径或URL>`
+6. 按需查询分类、位置、音乐、合集、话题、商品
+7. 根据前置数据、schema 和字段来源纪律填写 `payload.json`
+8. 查阅对应平台文档：`../platforms/video/`
+9. 执行校验：`yxer validate <platform> video <payload.json>`
+10. 正式发布：`yxer publish video <platform> <payload.json>`
+
+## 关键规则
+
+- 发布前必须确认目标账号 `status=1`
+- 视频只能有一个，封面必须单独上传
+- 用户未提供封面时，必须补问，不要自动截帧
+- 可选复杂对象必须通过查询命令取得完整对象后再填入
+- 话题/标签必须直接按 `../topic-tags.md` 的目标格式传入；不要依赖 CLI 从 `description` 自动改写
+- 发布前先看 `prepare` 和 `schema fields` 返回的字段；只有要确认完整骨架时再看 `schema get`
+- `payload.json` 必须使用统一标准结构：顶层 `publishArgs`，业务字段放在 `publishArgs.accountForms[].contentPublishForm`
+- 用户明确要求本机发布时，必须显式传 `--publish-channel local` 和 `--client-id`
+
+## 发布示例
+
+```bash
+yxer validate 抖音 video .\payload.json
+yxer publish video 抖音 .\payload.json
+```
+
+## 本机发布示例
+
+```bash
+yxer publish video 抖音 .\payload.json --publish-channel local --client-id <clientId>
+```
+
+## 平台文档入口
+
+- 索引：`../platforms/video/index.md`
+- 平台细节：`../platforms/video/*.md`

package/skills/yixiaoer/references/yixiaoer-shared.md

@@ -0,0 +1,95 @@
+# yxer 共享规则
+
+本文件是 `yxer` skill 的共享前置规则。只要任务涉及发布、草稿、素材、账号、排查、payload 修订，就应先读取本文件。
+
+**CRITICAL - 本文档是共享规则唯一真源。若 QUICKSTART、domain 文档、workflow 文档和本文存在表述差异，以本文和对应 workflow 为准。**
+
+## 唯一执行入口
+
+- 真正执行一律走 `yxer` CLI
+- 不要假设存在旧 Node 脚本入口
+- 不要绕过 CLI 直连隐式 API
+
+## 初始化与环境检查
+
+首次使用、环境不明、或刚完成一次失败排查后，优先执行：
+
+```bash
+yxer doctor
+yxer config get
+```
+
+如果当前环境尚未完成配置，再执行：
+
+```bash
+yxer config init --api-key <apiKey>
+```
+
+规则：
+
+- `doctor` 失败时，先修环境，再继续业务流程
+- 不要在环境异常时继续组装 payload
+
+## 云发布与本机发布
+
+- 用户未明确指定时，默认云发布
+- 用户明确说“本机发布”“本地发布”“客户端发布”时，必须切到本机发布
+- 本机发布前，应优先确认默认 `clientId` 是否已配置：
+
+```bash
+yxer config set-local-client-id <clientId>
+```
+
+规则：
+
+- `validate`、`publish --dry-run`、正式 `publish` 必须使用同一套发布通道参数
+- 云发布返回代理相关错误时，可建议切到本机发布
+- 本机发布提示客户端不在线时，应提示用户启动并登录蚁小二客户端，或改回云发布
+
+## 技能同步
+
+```bash
+yxer skill show
+yxer skill sync
+yxer skill sync --global
+```
+
+以下情况应提示重新同步：
+
+- `yxer --version` 升级后
+- 当前 skill 包中的 `SKILL.md` 更新后
+- `skills/yixiaoer/references/` 中影响 Agent 行为的文档更新后
+- `yxer doctor` 返回 `_notice.skills`
+
+## 输出协议
+
+### 账号候选
+
+- 如果只有一个可用账号，可自动选择并明确告知用户
+- 如果命中多个账号，必须结构化列出候选项，再让用户确认
+- 如果没有 `status=1` 的账号，不要继续发布流程
+
+### 校验与 dry-run
+
+- `validate` 失败时，先展示错误要点，再回到 `prepare` / `schema get` / 查询结果修字段
+- `publish --dry-run` 成功时，再进入正式发布
+- 不要跳过 `validate` 或 `publish --dry-run`
+
+### 发布结果
+
+- 成功时给出平台、类型、通道和关键结果
+- 失败时给出错误摘要、当前阶段和下一步处理建议
+
+## 危险动作协议
+
+- 真正发布前，固定顺序是：
+  1. `yxer doctor`
+  2. `yxer accounts list`
+  3. `yxer prepare`
+  4. `yxer schema fields`
+  5. 只有需要 payload 骨架时再补 `yxer schema get`
+  6. `yxer validate`
+  7. `yxer publish --dry-run`
+  8. `yxer publish`
+- 不允许跳过 `validate`
+- 不允许把正式 `publish` 当成试错手段