yixiaoer
蚁小二 (YiXiaoEr) 核心技能:支持多账号矩阵管理、账号查询 (accounts)、图文视频分发发布 (publish)、一键发布、保存草稿 (draft)、资源上传 (upload)、素材库 (material/library)、发布记录查询 (records) 及运营数据统计 (overviews)。适配 50+ 平台,助力高效运营新媒体矩阵。
- License 许可
- AGPL-3.0
- 最近更新
- 2026-09-07
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- yixiaoer
- author
- wangzhengjiao
- version
- 1.6.4
- description
- 蚁小二 (YiXiaoEr) 核心技能:支持多账号矩阵管理、账号查询 (accounts)、图文视频分发发布 (publish)、一键发布、保存草稿 (draft)、资源上传 (upload)、素材库 (material/library)、发布记录查询 (records) 及运营数据统计 (overviews)。适配 50+ 平台,助力高效运营新媒体矩阵。
02 资源文件 90
- 参考文档docs/execution-standard.md10.4 KB
- 参考文档docs/get-account-overviews.md2.5 KB
- 参考文档docs/get-challenges.md323 B
- 参考文档docs/get-collections.md1.0 KB
- 参考文档docs/get-content-overviews.md2.8 KB
- 参考文档docs/get-games.md1.7 KB
- 参考文档docs/get-goods.md1.3 KB
- 参考文档docs/get-groups.md1.2 KB
- 参考文档docs/get-hot-events.md314 B
- 参考文档docs/get-locations.md1.8 KB
- 参考文档docs/get-miniapps.md1.6 KB
- 参考文档docs/get-music-categories.md1.2 KB
- 参考文档docs/get-music.md2.8 KB
- 参考文档docs/get-publish-activities.md1.7 KB
- 参考文档docs/get-publish-categories.md2.8 KB
- 参考文档docs/get-publish-records.md2.0 KB
- 参考文档docs/get-sync-apps.md444 B
- 参考文档docs/material-resource.md2.7 KB
- 参考文档docs/platform.md1.9 KB
- 参考文档docs/proxy-management.md2.9 KB
- 参考文档docs/publish/article/acfun.md3.3 KB
- 参考文档docs/publish/article/aiqiyi.md1.8 KB
- 参考文档docs/publish/article/baijiahao.md3.7 KB
- 参考文档docs/publish/article/bilibili.md3.3 KB
- 参考文档docs/publish/article/chejiahao.md2.9 KB
- 参考文档docs/publish/article/csdn.md3.2 KB
- 参考文档docs/publish/article/dayuhao.md2.8 KB
- 参考文档docs/publish/article/douban.md2.1 KB
- 参考文档docs/publish/article/douyin.md3.7 KB
- 参考文档docs/publish/article/index.md6.2 KB
- 参考文档docs/publish/article/jianshu.md1.9 KB
- 参考文档docs/publish/article/kuaichuanhao.md2.8 KB
- 参考文档docs/publish/article/qiehao.md2.7 KB
- 参考文档docs/publish/article/souhuhao.md2.7 KB
- 参考文档docs/publish/article/toutiaohao.md3.3 KB
- 参考文档docs/publish/article/wangyihao.md2.9 KB
- 参考文档docs/publish/article/weixingongzhonghao.md4.7 KB
- 参考文档docs/publish/article/xinlangweibo.md2.7 KB
- 参考文档docs/publish/article/xueqiuhao.md2.6 KB
- 参考文档docs/publish/article/yichehao.md3.5 KB
- 参考文档docs/publish/article/yidianhao.md2.7 KB
- 参考文档docs/publish/article/zhihu.md3.1 KB
- 参考文档docs/publish/image-text/baijiahao.md3.5 KB
- 参考文档docs/publish/image-text/douyin.md4.4 KB
- 参考文档docs/publish/image-text/index.md5.6 KB
- 参考文档docs/publish/image-text/kuaishou.md4.3 KB
- 参考文档docs/publish/image-text/toutiaohao.md3.0 KB
- 参考文档docs/publish/image-text/weixinshipinhao.md4.1 KB
- 参考文档docs/publish/image-text/xiaohongshu.md3.7 KB
- 参考文档docs/publish/image-text/xinlangweibo.md2.9 KB
- 参考文档docs/publish/image-text/zhihu.md3.6 KB
- 参考文档docs/publish/video/acfun.md2.8 KB
- 参考文档docs/publish/video/aiqiyi.md3.3 KB
- 参考文档docs/publish/video/baijiahao.md3.2 KB
- 参考文档docs/publish/video/bilibili-open.md2.9 KB
- 参考文档docs/publish/video/bilibili.md3.6 KB
- 参考文档docs/publish/video/chejiahao.md1.9 KB
- 参考文档docs/publish/video/dayuhao.md3.2 KB
- 参考文档docs/publish/video/dewu.md2.5 KB
- 参考文档docs/publish/video/douyin.md5.1 KB
- 参考文档docs/publish/video/duoduoshipin.md1.9 KB
- 参考文档docs/publish/video/fengwang.md2.5 KB
- 参考文档docs/publish/video/index.md6.4 KB
- 参考文档docs/publish/video/kuaishou-open.md2.0 KB
- 参考文档docs/publish/video/kuaishou.md3.4 KB
- 参考文档docs/publish/video/meipai.md2.4 KB
- 参考文档docs/publish/video/meiyou.md1.7 KB
- 参考文档docs/publish/video/pipixia.md1.6 KB
- 参考文档docs/publish/video/qiehao.md3.1 KB
- 参考文档docs/publish/video/shipinghao.md3.7 KB
- 参考文档docs/publish/video/souhuhao.md3.2 KB
- 参考文档docs/publish/video/souhushipin.md2.0 KB
- 参考文档docs/publish/video/tengxunshipin.md2.0 KB
- 参考文档docs/publish/video/toutiaohao.md2.9 KB
- 参考文档docs/publish/video/wangyihao.md3.2 KB
- 参考文档docs/publish/video/weishi.md1.8 KB
- 参考文档docs/publish/video/xiaohongshu.md4.5 KB
- 参考文档docs/publish/video/xiaohongshushop.md2.9 KB
- 参考文档docs/publish/video/xinlangweibo.md2.4 KB
- 参考文档docs/publish/video/yichehao.md1.8 KB
- 参考文档docs/publish/video/yidianhao.md2.7 KB
- 参考文档docs/publish/video/zhihu.md3.0 KB
- 参考文档docs/query-accounts.md4.0 KB
- 参考文档docs/save-draft.md3.9 KB
- 参考文档docs/scripts/api-guide.md2.6 KB
- 参考文档docs/troubleshooting-guide.md6.3 KB
- 参考文档docs/upload-resource.md3.0 KB
- 参考文档references/ATTRIBUTION.md493 B
- 参考文档references/pilotdeck-setup.md3.2 KB
- 脚本scripts/api.ts19.7 KB
03 SKILL.md 正文
PilotDeck 执行速查(必读)
优先使用内置工具
yixiaoer_api(无需 bash、无需找 api.ts)。查正常抖音/小红书账号示例:{"action":"accounts","platforms":["抖音","小红书"],"loginStatus":1,"page":1,"size":100}禁止:在
Documents/yixiaoer-docs等目录搜索api.ts;禁止dir /s/find/head。备选(仅当
yixiaoer_api不可用时):node "%PILOTDECK_YIXIAOER_API%" --payload-file payload.jsonWindows PowerShell:先把 JSON 写入文件,再执行上面命令(不要用单引号 JSON 在 cmd 里硬拼)。
查账号(如「有哪些抖音/小红书号、只要正常的」):
read_file→{PILOTDECK_YIXIAOER_SKILL_DIR}/docs/query-accounts.md(或skills/yixiaoer/docs/query-accounts.md)- 写入 payload 文件,例如:
{"action":"accounts","platforms":["抖音","小红书"],"loginStatus":1,"page":1,"size":100}- 执行
node "%PILOTDECK_YIXIAOER_API%" --payload-file 该文件- 解析 JSON:
status===1为登录正常;无需蚁小二桌面客户端(默认云发布)详细约定:
references/pilotdeck-setup.md
OpenClaw 龙虾技能 (OpenClaw Skill)
本项目采用 DTO 驱动 (Interface-Driven) 的架构模式。所有的功能均可通过 api.ts 配合标准化的 DTO Payload 进行调用。
核心原则 (Core Principles)
- 接口即标准: 所有的功能调用严格基于后端 API 的 Request DTO 设计。
- 文档即指引:
docs/下的 Markdown 文档用于解释对应接口的参数规则、必填项与约束。 - 分级阅读原则: 所有的发布任务文档采用“内容类型首页 (Index) + 平台详情页 (Platform)”的二级结构。
- 零映射透传: 鼓励调用者使用
api.ts透明地提交符合 DTO 要求的 JSON Payload。 - AI 场景化驱动: 所有的文档均包含
Trigger(触发场景) 和Logic Flow(执行逻辑) 模块,旨在通过自然语言语义引导 Agent 进行精确的意图识别与参数构造。
[!IMPORTANT] 严格合规性与执行标准 (Strict Compliance & Standard):
- 执行标准: 所有 Agent 的调用行为、版本校验、错误处理必须遵循 yixiaoer-skill 严格执行标准。
- 首选排错指南: 在遇到任何脚本报错、发布失败或逻辑异常时,必须优先查阅 蚁小二 Skill 避坑与故障排查手册。该手册汇总了 90% 以上常见失败场景的解决方案。
- 文档检索顺序: 针对
publish行为,查询文档时必须首先查阅对应内容类型的index.md(如docs/publish/article/index.md),以获取基础 JSON 结构。严禁跳过 Index 直接访问平台级文档(如douyin.md),否则可能导致 Payload根结构缺失。- 所有接口调用必须严格遵守各文档中定义的必填字段 (
必填: 是) 以及对应的数据格式要求。- 资源引用规范: 所有的封面图 (cover)、图文图片 (images) 以及 视频文件 (video) 必须先通过资源上传接口上传至系统并获得唯一的
key。禁止填入非系统内的网络 URL 或随意留空,否则会导致发布任务执行失败。- 素材库入库流程: 涉及“上传到素材库”时,必须执行两步逻辑:先
upload(资源入存储) -> 后material(登记入库)。严禁省略第二步。
平台支持 (Platform Support)
API 调用时涉及的平台名称必须使用蚁小二定义的中文枚举或 Code。
- 平台枚举列表: docs/platform.md
统一执行指令 (Unified Execution)
所有的 API 功能统一通过 api.ts 脚本执行。调用时需通过 --payload 参数传入 JSON,且 action 字段为必填项,用于指定具体功能。
| action 值 | 对应的能力描述 | 相关文档 |
|---|---|---|
publish |
图文、视频、文章分发发布。支持发布到平台或保存为平台草稿。 | 文章, 图文, 视频, 草稿指南 |
save-draft |
保存内容到蚁小二草稿箱。仅云端存储,不触发推送。 | 草稿指南 |
accounts |
查询已绑定的账号列表 | query-accounts.md |
upload |
上传本地或 URL 图片/视频 | upload-resource.md |
material |
将已上传资源登记到蚁小二素材库 | material-resource.md |
records |
查询发布任务概览列表 | get-publish-records.md |
details |
查询特定任务的执行详情 | get-publish-records.md |
categories |
获取账号分类/话题列表 | get-publish-categories.md |
activities |
获取征文活动列表 | get-publish-activities.md |
locations |
获取 POI 物理位置列表 | get-locations.md |
music |
获取抖音/快手可选背景音乐 | get-music.md |
music-category |
获取音乐分类列表 | get-music-categories.md |
collections |
获取账号已创建的合集列表 | get-collections.md |
groups |
获取账号可绑定的群聊列表 | get-groups.md |
goods |
获取账号可绑定的商品列表 | get-goods.md |
hot-events |
获取平台实时热点列表 | get-hot-events.md |
challenges |
获取平台话题/挑战列表 | get-challenges.md |
miniapps |
获取可挂载的小程序列表 | get-miniapps.md |
syncapps |
获取可同步发布的关联账号 | get-sync-apps.md |
games |
获取可挂载的游戏列表 | get-games.md |
proxies |
获取团队可用代理列表 | proxy-management.md |
proxy-areas |
获取默认代理地区编码列表 | proxy-management.md |
account-overviews |
账号表现汇总 (V2) | get-account-overviews.md |
content-overviews |
查看发布作品数据统计 | get-content-overviews.md |
update-account |
更新账号信息 (如设置代理) | proxy-management.md |
drafts |
(Read-only) 草稿列表管理指南 | save-draft.md |
草稿识别标准 (Draft Recognition Standard)
当用户意图涉及“保存”、“草稿”或“以后再发”时,Agent 必须进行次级研判:
- 蚁小二草稿 (YXE Draft):
- 逻辑:内容仅存储在蚁小二云端,不触发任何平台推送。
- Trigger: “存为蚁小二草稿”、“暂存到草稿箱”、“存为 YXE 草稿”。
- Action:
save-draft
- 平台草稿 (Platform Draft):
- 逻辑:内容会被推送到对应平台(如抖音、小红书)的草稿箱,用户可在 App 端二次编辑。
- Trigger: “存为抖音草稿”、“推送到平台草稿箱”、“存为小红书草稿”。
- Action:
publish(并在accountForms内每项设置"contentPublishForm": { "pubType": 0 })
⚠️ 歧义处理:若用户仅提及“存草稿”而未明确指出是“蚁小二草稿”还是“平台草稿”,Agent 必须立刻询问用户以明确意图,严禁自行默认或猜测。
调用示例 (Example)
# 查询账号列表 (action: accounts)
node scripts/api.ts --payload='{"action": "accounts", "platform": "抖音"}'
开发指南 (Development Guide)
为了简化 API 的调用与脚本开发,我们提供了通用的 API 助手模块:
- API 助手模块:
scripts/api.ts - 开发指引文档: API 助手使用指南
在开发新功能或修改现有脚本时,请务必参考此指引。
[!NOTE] 所有的敏感信息应通过环境变量
YIXIAOER_API_KEY注入。 如果用户没有发送clientId,则默认使用云发布,publishChannel: cloud故障诊断与常见问题 (Troubleshooting FAQ):
请立即参阅最权威的避坑指南:🛡️ 蚁小二 Skill 避坑与故障排查手册
更多详情请参阅:YiXiaoEr Skill 严格执行标准
04 同仓库更多 Skills
wireframe-mobile-flow
A lo-fi multi-screen MOBILE flow wireframe — three or four phone frames laid out in a row on a board, showing a connected user flow (Onboarding → Home feed → Item detail → Confirm). Grey-box content inside each device, dashed connector arrows + numbered step labels between screens, and a couple of annotation callouts. Reads like an app flow pinned to a whiteboard before any pixels are committed. Use when the brief asks for "mobile wireframe", "app flow", "user flow wireframe", "lo-fi mobile", "low fidelity", "线框图", "移动端线框", or "App 流程".
web-prototype
General-purpose desktop web prototype. Single self-contained HTML file built by copying the seed `assets/template.html` and pasting section layouts from `references/layouts.md`. Default for any landing / marketing / docs / SaaS page when no more specific skill matches.
waitlist-page
Minimal pre-launch landing with email capture, brand logo, and optional decorative layer. Reads DESIGN.md for colors, typography, and layout rules. Best for: product launches, beta signups, early access programs, indie projects.
team-okrs
OKR tracker page — quarter banner, three objectives with their key results as progress bars, owner avatars, status pills, and a "this quarter at a glance" sidebar. Use when the brief mentions "OKRs", "key results", "objectives", or "目标".
pricing-page
A standalone pricing page — header, plan tiers, feature comparison table, and an FAQ. Use when the brief asks for "pricing", "plans", "subscription tiers", or a "compare plans" page.
pm-spec
Product spec / PRD as a single page — problem, success metrics, scope, user stories, design notes, rollout plan, open questions. Use when the brief mentions "PRD", "spec", "product spec", "feature brief", or "需求文档".