metabot-basic

name: metabot-basic description: MetaBot 的基础身份与资产管理核心。负责创建 MetaBot 实体（钱包+MetaID）、管理链上资产（MVC/DOGE）、发布基础 Buzz 消息及设置头像。

MetaBot 生态的基础设施 Skill。管理 MetaBot 的身份 (MetaID)、钱包 (Wallet) 和资产 (Assets)。

当用户指令涉及“创建 MetaBot”、“注册 MetaID”、“新建机器人/钱包”时，必须直接执行以下脚本。

脚本: npx ts-node scripts/create_agents.ts，必须用以下两种方式之一传入 Agent 名称，否则会报错：
- 推荐（单个）: npx ts-node scripts/create_agents.ts --name "<AgentName>"
  仅创建一个名为 <AgentName> 的 MetaBot。<AgentName> 为占位，替换为用户要求的名字（如 xai、Alice）。不要把 --name 当作名字，只把其后的一个参数当作名字。
- 批量: npx ts-node scripts/create_agents.ts "<name1>" "<name2>"
  创建多个 MetaBot，每个参数一个名字；参数中不要包含 --name。
功能: 生成助记词 -> 派生地址 -> 注册 MetaID (自动申请 Gas 补贴) -> 初始化 account.json。
头像选项 (Avatar):
- 自动识别: 若用户未指定，默认检查 static/avatar/ 目录下是否有图片。
- 指定路径: 在名称后加 --avatar "path/to/image.png"，例如 npx ts-node scripts/create_agents.ts --name "MyBot" --avatar "./avatar.png"。
- 独立设置: 若 MetaBot 已存在但需补设头像，执行 npx ts-node scripts/create_avatar.ts "MetaBotName" "path/to/image.png"。

管理 MetaBot 的链上资金。执行前必须请求用户二次确认金额与地址。

MVC 转账 (Space):
- 脚本: npx ts-node scripts/send_space.ts
- 注意: 金额单位为 sats (1 Space = 10^8 sats)。
DOGE 转账:
- 脚本: npx ts-node scripts/send_doge.ts
- 限制: 最小转账金额 0.01 DOGE。

MetaBot 在链上发布基础数据或协议节点。

发布 Buzz: npx ts-node scripts/send_buzz.ts "<agentName>" "<content>" (基于 simpleBuzz 协议)。
发布带图片附件的 Buzz: 当用户要求将本地图片作为附件发 buzz，或使用已有 pinId 作为图片附件发 buzz 时，使用 send_buzz_with_image.ts。流程：先上链得 pinId（若为本地图片则调用 metabot-file 上传）→ 组装 simplebuzz attachments: ["metafile://<pinId>.png"] → 发送。
- 本地图片: npx ts-node scripts/send_buzz_with_image.ts "<agentName>" "<content>" --image <path>
- 已有 pinId: npx ts-node scripts/send_buzz_with_image.ts "<agentName>" "<content>" --pinid <pinid> [--ext .png]
通用 PIN 创建: npx ts-node scripts/metaid.ts createPin ... (用于自定义协议数据上链)。
初始化聊天密钥: npx ts-node scripts/create_chatpubkey.ts (为 metabot-chat 准备)。

位置: 项目根目录。
作用: 存储所有 MetaBot 的助记词、地址 (MVC/BTC/DOGE) 和 MetaID 信息。
读取规则:
- 默认: 使用 accountList[0]。
- 指定: 通过 MetaBot 名称 (userName) 或地址匹配。
- 新增: 新创建的 MetaBot 会自动插入到列表头部 (unshift)。

脚本在 scripts 目录下，所有脚本均为 TypeScript 实现。

脚本	核心功能	参数说明
`create_agents.ts`	创建/注册	单个：`--name "<AgentName>"`；批量：`"<name1>" "<name2>"`；可选 `--avatar "<path>"`。
`create_avatar.ts`	头像管理	`[AgentName] [FilePath]`。限制 < 1MB。
`create_chatpubkey.ts`	聊天初始化	上链 Chat 公钥，启用加密通讯。
`send_space.ts`	MVC 转账	交互式或参数调用。单位：Satoshis。
`send_buzz.ts`	发送文字 buzz	`<agentName>` `<content>`
`send_doge.ts`	DOGE 转账	交互式或参数调用。
`send_buzz_with_image.ts`	带图 Buzz	`<agentName>` `<content>`，`--image <path>` 或 `--pinid <pinid>`，可选 `--ext`。
`metaid.ts`	底层操作	提供 `createPin`, `pay` 等原子操作。
`wallet.ts`	钱包工具	提供 `signTransaction` (供其他 Skill 调用)。

执行优先: 当用户要求“创建一个叫 Alice 的 MetaBot”时，不要返回操作指南，直接生成并运行对应的 create_agents.ts 命令。
创建命令格式: 创建单个 MetaBot 时必须使用 --name "名字" 形式，且只有一个名字（即 --name 后的那一个参数）。例如创建名为 Alice 的 MetaBot：npx ts-node scripts/create_agents.ts --name "Alice"。禁止把 --name 或其它 -- 开头的参数当作 Agent 名字。
路径智能: 处理头像路径时，若用户提供了 @引用 AI 需自动将其解析为系统绝对路径传入脚本。
余额单位: 涉及 MVC 转账时，必须将用户口语中的 "Space" 转换为 "sats" (乘以 10^8) 传入脚本。
带图 Buzz: 当用户说「将 xx 作为附件发送 buzz」「用 pinid 发送带图 buzz」等时，使用 send_buzz_with_image.ts，传入对应 agent、文字内容及 --image <path> 或 --pinid <pinid>。