| name | metabot-omni-reader |
| description | MetaBot 的链上数据读取能力（Omni-Reader）。当用户需要查询 MetaID/MetaWeb 链上信息（用户信息、Buzz/社交、PIN 列表、文件索引、通知等）时，通过查阅 references 下的接口文档并用 curl 请求对应 API 获取 JSON，再根据返回字段向用户作答。 |
| official | true |
MetaBot Omni-Reader（链上数据读取）
本技能是 MetaBot 的「链上数据之眼」：通过查阅预置的接口文档，用 curl 调用 manapi.metaid.io、file.metaid.io/metafile-indexer、Show.Now、MAN 等服务的 HTTP API，获取实时 JSON 数据，再根据返回字段含义用自然语言回答用户。不依赖专用脚本，接口定义与扩展均以 references/ 下的 Markdown 文档为准。
执行逻辑 (Agent Workflow)
当用户询问链上信息（某人的名字/地址、最新 Buzz、某条帖子详情、通知、文件列表、搜索用户等）时，必须严格按以下步骤：
- 确定查询类型：根据用户意图，选择对应的参考文档：
- 用户信息（昵称、头像、地址、chatpubkey、按关键词搜用户）→ 阅读
references/00-user.md
- 社交与互动（最新/推荐/热门 Buzz、评论点赞、通知、关注列表等）→ 阅读
references/01-social.md
- PIN 与链数据（PIN 详情、按 path/metaiD/地址列 PIN、区块/内存池、通知列表、原始内容等）→ 阅读
references/02-PIN.md
- 文件类（文件元数据、按创作者/metaiD/扩展名列文件、最新版本等）→ 阅读
references/03-file.md
- 若后续新增能力（如 04-xxx.md），同样先读对应文档再选接口。
- 查阅文档：打开上述文档，找到与用户问题匹配的接口（base_url + 路径、必填/可选参数）。
- 构造 URL：按文档中的 Inputs 将 path/query 参数拼成完整 URL（注意保留文档中的拼写，如
notifcation）。
- 用 curl 请求：在终端执行
curl -s "<完整URL>"（或 curl -sL 如需跟随重定向），获取 JSON 响应。
- 解读并作答：根据文档说明与实际返回的 JSON 字段名理解含义，用自然语言总结回答；勿直接粘贴大段原始 JSON，除非用户明确要求。
命令方式 (How to Call APIs)
统一用 curl（Windows / macOS 均可用）：
curl -s "https://<base>/<path>?<query>"
- 将文档中的 base_url 与路径、参数拼成完整 URL。
-s 静默模式，不输出进度；需要时可用 -sL 跟随重定向。- 返回体一般为 JSON；字段含义以各 reference 文档说明及实际键名为准，不在此一一约定。
示例（仅作格式参考，具体以 references 为准）：
- 按 metaId 查用户：
curl -s "https://manapi.metaid.io/api/info/metaid/0d16...i0"
- 最新 10 条 Buzz（Show.Now）：见
01-social.md 中的示例 URL。
参考文档索引 (Reference Index)
| 文档 | 适用场景 |
|---|
references/00-user.md | 用户信息：按 metaId/地址/globalMetaID 查用户、按关键词搜索用户、用户列表 |
references/01-social.md | 社交互动：最新/推荐/热门 Buzz、搜索 Buzz、Buzz 详情与评论点赞、通知、关注者/正在关注 |
references/02-PIN.md | 通用 PIN：PIN 详情与版本、按 path/metaiD/地址列 PIN、全局/区块/内存池、通知、原始内容、indexer 状态与统计 |
references/03-file.md | 文件：按 PinId/firstPinId 查文件、按创作者/metaiD/扩展名列文件、最新版本 |
（后续可增）references/04-xxx.md | 按实际新增文档的说明使用 |
扩展方式：新增能力时，在 references/ 下增加新的 NN-xxx.md，在本表与上文的「确定查询类型」中补充说明即可，无需改脚本或配置。
平台说明 (Windows / macOS)
- curl：Windows 10+ 与 macOS 均自带或可用
curl，本技能不区分平台，统一使用 curl -s "<URL>" 即可。
- 若环境无 curl，可改用等价 HTTP 工具（如 PowerShell
Invoke-RestMethod），只要能得到接口返回的 JSON 即可。
AI 行为规则 (Strict Constraints)
- 先读文档再请求：未确定用哪个接口时，必须先读对应的 reference 文档，再构造 URL 并 curl，禁止猜测路径或参数。
- 路径与拼写：URL 路径、参数名以文档为准（例如通知接口为
notifcation 时不要改成 notification）。
- 参数必填：文档标明必填的 path/query 必须带上，否则会 404 或空结果。
- 理解返回：各接口返回的 JSON 结构可能不同（有的在
data 下，有的为数组），根据文档说明与实际字段名理解含义后作答，勿机械转储 JSON。
- 总结作答：用自然语言回答用户；仅在用户明确要求时才提供原始 JSON。
