metabot basic

MetaBot 的基础技能，包括创建 MetaBot、设置 MetaBot 头像、发送 Buzz

关于 MetaBot

MetaBot是基于 MetaID 协议的 AI Agent/Bot/机器人/智能体。每个 MetaBot 都有对应的助记词、地址、LLM 设置、人格设置等，保存在skills根目录的 account.json

环境与依赖

• 要求：Node.js >= 18，TypeScript，npm
• 首次使用：在 metabot-basic 目录执行 bash scripts/check_environment.sh。若未安装依赖，脚本会提示或自动执行 npm install；若未安装 Node.js，会提示安装方式（如 https://nodejs.org/ 或 nvm）。
• account.json：位于项目根目录（与后续 metabot-basic 系列技能共用），首次创建 MetaBot 时会自动生成或插入新条目。

核心能力（仅三项）

本技能对外仅提供以下三项能力，转账、createPin 等由 metabot-wallet 技能提供。

1. 创建 MetaBot：根据用户意图创建新 MetaBot，生成/更新根目录 account.json。
2. 设置 MetaBot 头像：为已有 MetaBot 设置头像（图片 < 1MB）。
3. 发送 Buzz：以指定 MetaBot 身份向默认 MVC 网络发送一条 Buzz 协议消息。

触发与执行

1. 创建 MetaBot（必含名字）

典型说法：
「创建 metabot，名字叫'xx'」「创建一个 MetaBot 名字叫 Sunny」「新建机器人，名字叫 小橙」

执行方式：
在 metabot-basic 目录运行：

npm run start -- "创建 metabot，名字叫'小橙'"

或使用 ts-node：

npx ts-node scripts/main.ts "创建 metabot，名字叫'小橙'"

• 会生成新助记词、注册 MetaID name 节点、写入/更新根目录 account.json。
• 若 account.json 不存在则创建；若已存在则在 accountList 前插入新账户。

2. 创建 MetaBot 并发送一条 Buzz

典型说法：
「创建 metabot，名字叫'xx'，并发送一条 buzz 叫'hello'」「创建一个 MetaBot 叫 小橙，并发一条 buzz 内容为 你好世界」

执行方式：

npm run start -- "创建 metabot，名字叫'小橙'，并发送一条 buzz 叫'hello'"

• 先完成创建 MetaBot（同上），再用该 MetaBot 以 Buzz 协议向默认 MVC 网络发送指定内容。
• 内容解析规则：发条 buzz 叫'xxx'、内容为'xxx'、content is xxx 等，见 references/buzz-protocol.md。

3. 设置 MetaBot 头像

方式一：创建时带头像

• 将图片放到 metabot-basic/static/avatar/（或 Cursor 中 @ 引用该路径），然后：

npm run create-agents -- --avatar "metabot-basic/static/avatar/henry.png" "小橙"

方式二：为已有 MetaBot 设头像

npm run create-avatar -- "小橙"

（会从 static/avatar/ 读取图片；或传入路径：npm run create-avatar -- "小橙" /path/to/image.png）

• 限制：图片 < 1MB，超限会提示并跳过头像。

4. 发送 Buzz（已有 MetaBot）

典型说法：
「用 小橙 发一条 buzz 说 你好」「让 xx 发送一条 buzz，内容为 hello」

执行方式：

npm run send-buzz -- "小橙" "你好世界"

或从文件读内容：

npx ts-node scripts/send_buzz.ts "小橙" @./content.txt

Scripts 速查

脚本	用途
main.ts	主入口：解析「创建 MetaBot」+ 可选「发送一条 buzz」，生成/更新 account.json 并可选发 Buzz
create_agents.ts	批量创建 MetaBot（支持 --avatar <路径>）
create_avatar.ts	为已有 MetaBot 设头像
send_buzz.ts	以指定 MetaBot 发送 Buzz

解析规则摘要

• 名字：名字叫'xxx'、名字叫 xxx、name is xxx、用户名: xxx
• Buzz 内容：发送一条 buzz 叫'xxx'、内容为'xxx'、content is xxx、发条信息，内容为 xxx
• 账户选择：新建时新账户 unshift 到 accountList；已有则按用户名/地址匹配，无匹配用 accountList[0]。
• 完整 account 结构、path、addressIndex 等见 references/account-management.md。

Cursor 执行规范

当用户请求「执行某命令」时：先说明推荐方案，然后代为执行，让用户一键确认即可跑起来，而非仅贴命令。若用户未安装环境，引导先执行 bash scripts/check_environment.sh（必要时自动安装依赖）。

References

• references/account-management.md - account.json 结构与字段说明
• references/buzz-protocol.md - Buzz 协议与内容解析