| name | metabot-omni-caster |
| description | MetaBot 的全能链上协议编织者 (Omni-Caster)。当用户需要执行 MetaID 生态的各种交互（点赞、评论、加群、发长文等），或者表达需要数据上链时，且没有其他专用技能时，统一调用此通用技能。 |
| official | true |
MetaBot Omni-Caster (全能链上协议网关)
这是 MetaBot 最强大的通用能力。通过查阅预置的 MetaID 协议标准，本技能可以将用户的几乎任何意图转化为符合规范的 7 元组数据并广播上链。理论上可以完成一切和 MetaID数据上链相关的功能
🧠 执行逻辑 (Agent Workflow)
当用户的意图涉及上链、社交互动、群组管理等，且你不知道具体的协议格式时，必须严格遵循以下步骤：
- 查阅字典：静默读取本项目
references/ 目录下的 Markdown 协议文档（如 00-metaid-concepts.md,01-social.md, 02-content-app.md, 03-group-management.md, 04-chat-messaging.md）。
references/00-metaid-concepts.md：在这里你可以查看到 metaid 协议的基础概念，PIN 和 PINID 概念，以及如何文件上链以及 metafile://协议说明。references/01-social.md：关于发 buzz、点赞、评论、转发、引用、打赏等可查看这个文档。references/02-content-app.md：关于链上笔记（simplenote协议），相册分类协议，MetaApp 应用封装协议，MetaProtocols 协议封装协议，MetaBot 技能封装协议等可以看这文档。references/03-group-management.md：群聊管理相关的，比如创建群聊、加入群聊、以及设置管理，拉入黑名单等和群聊相关的功能都可以看这文档。references/04-chat-messaging.md：发送群聊私聊信息相关的都可以看这个文档，包括群聊信息协议，私聊信息协议等。
- 定位协议：找到与用户意图匹配的协议（例如：点赞对应
PayLike Path /protocols/paylike，文件上链 Path 为 /file）。
- 构造 Payload：JSON 协议：按文档 Payload Schema 构建 JSON 字符串；文件上链：使用
--payload-file 指定本地文件路径，脚本自动转为 base64 并设置 encoding: base64。
- 执行命令：调用底层的
omni-caster.js 脚本完成上链。
💻 命令语法 (Command)
JSON/文本协议：
node "$SKILLS_ROOT/metabot-omni-caster/scripts/omni-caster.js" \
--path "<协议的逻辑路径>" \
--payload '<JSON 字符串或文本内容>' \
[--operation "<操作类型>"] \
[--content-type "<MIME 类型>"] \
[--network mvc|doge|btc]
文件（二进制）上链：
node "$SKILLS_ROOT/metabot-omni-caster/scripts/omni-caster.js" \
--path "/file" \
--payload-file <本地文件路径> \
[--content-type "<MIME 类型>"] \
[--network mvc|doge|btc]
参数说明：
| 参数 | 说明 | 默认值 |
|---|
--path | (必填) 协议的路径，例如 /protocols/paylike；文件上链为 /file。 | 无 |
--payload | 协议内容。JSON 协议为合法 JSON 字符串；二进制可传 base64 字符串（配合 --encoding base64）。 | 与 --payload-file 二选一 |
--payload-file | 本地文件路径，读取后转为 base64 上链，自动设置 encoding: base64。 | 与 --payload 二选一 |
--operation | (可选) 动作类型：create, modify, revoke。 | create |
--content-type | (可选) MIME 类型。JSON 多为 application/json；文件为 image/jpeg 等。 | application/json |
--encoding | (可选) 当 --payload 为 base64 字符串时，传 base64。 | 依 content-type 自动推断 |
--network | (可选) 目标网络：mvc、doge、btc。用户说"发到 doge 网络"即传 --network doge。 | mvc |
⚠️ AI 行为底线与转义规范 (Strict Constraints)
- JSON 字符串化：使用
--payload 传 JSON 时，建议用单引号 ' 包裹整个 JSON，内部键和字符串值用双引号 "，避免 Bash 解析错误。文件上链使用 --payload-file 指定本地路径即可。
正确示范：--payload '{"isLike": 1, "likeTo": "abc...i0"}'；文件上链：--path /file --payload-file ./photo.png --content-type image/png
2. 无需询问私钥：底层 RPC 网关会自动处理你的专属 MetaBot 身份签名，你只需专心构造正确的业务 JSON。
3. 未卜先知：如果上下文或用户指令中缺少必填字段（例如让你点赞，但没告诉你目标帖子的 PINID），请直接回复用户询问缺失的信息，不要随意捏造虚假的 PINID 上链。
4. 网络参数：当用户指定了目标网络（如"发到 doge 网络"），必须加上 --network doge。未指定时默认 mvc。
