بنقرة واحدة
metabot-file
MetaBot 专属链上文件系统 (MetaID File System) 交互模块。提供智能文件上链(自动识别大小/分块)、余额预检、交易监控,以及基于 MetaID 的用户资料与文件内容索引查询。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
القائمة
MetaBot 专属链上文件系统 (MetaID File System) 交互模块。提供智能文件上链(自动识别大小/分块)、余额预检、交易监控,以及基于 MetaID 的用户资料与文件内容索引查询。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
MetaBot 专属的 MetaApp 开发与交付套件。基于 IDFramework (No-Build, MVC) 架构,支持从零构建链上前端应用、编写业务指令 (Commands)、组件开发 (Web Components) 以及最终的打包交付 (Zip)。
MetaBot 的基础身份与资产管理核心。负责创建 MetaBot 实体(钱包+MetaID)、管理链上资产(MVC/DOGE)、发布基础 Buzz 消息及设置头像。
MetaID/MetaWeb 协议下的私聊/群聊管理核心模块。专为 MetaBot 设计,支持其在链上进行无许可沟通、协作与进化。功能包括:私聊消息加密/解密、群聊监听(Socket/HTTP)、LLM 智能回复。
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
| name | metabot-file |
| description | MetaBot 专属链上文件系统 (MetaID File System) 交互模块。提供智能文件上链(自动识别大小/分块)、余额预检、交易监控,以及基于 MetaID 的用户资料与文件内容索引查询。 |
| dependencies | metabot-basic, node >= 18.x, python >= 3.7 (requests), crypto-js |
赋予 MetaBot 读取、存储和索引链上数据的能力。支持将任何文件(图片/视频/文档)永久存储在 MVC 区块链上,并关联到 MetaBot 的 MetaID。
metabot-basic 检查 MVC 余额,避免因 Gas 不足导致 UTXO 锁定或任务失败。当用户指令涉及“上传文件”、“文件上链”、“存图片”时,MetaBot 必须优先使用以下一键脚本。该脚本封装了余额检查、方式选择、上传执行和进度监控。
./scripts/upload_with_balance_check.sh <file_path> [options]<file_path>: 文件路径 (推荐放在 res/file/)。--agent "Name": (可选) 指定使用哪个 MetaBot 账号 (匹配 account.json 中的 userName)。--account-index N: (可选) 指定账户索引。bash .claude/skills/metabot-file/scripts/upload_with_balance_check.sh res/file/photo.jpg --agent "MetaBot Eason"curl 请求发送 JSON body 上传,后端仅接受 multipart/form-data 且需要复杂的本地签名逻辑 (PreTx构建),必须依赖 TS 脚本。查询 MetaBot 信息或链上文件状态。
python3 scripts/query_indexer.py <type> [args]user --address <mvc_address>user --metaid <metaid>user --globalmetaid <gid>file --pinid <pin_id> (返回元数据、下载链接、预览链接)../metabot-basic/node_modules)。本 Skill 直接复用其 account.json 和钱包签名逻辑。pip install requests (用于监控和查询脚本)。res/file/。MetaBot 在执行复杂任务时可直接调用底层 TS/Python 脚本:
| 脚本 | 功能 | 关键说明 |
|---|---|---|
upload_with_balance_check.sh | 入口 | 推荐。自动编排余额检查 -> 方式选择 -> 上传 -> 监控。 |
metafs_direct_upload.ts | 核心 | 处理 <5MB 文件。本地构建 Tx -> 签名 -> DirectUpload API。 |
metafs_chunked_upload.ts | 核心 | 处理 >5MB 文件。OSS 分片 -> Merge Tx 签名 -> 提交 Task。 |
metafs_check_balance.ts | 工具 | 检查 MVC 余额,支持 --file-size-mb 估算 Gas。 |
monitor_task.py | 监控 | 轮询分块上传任务状态。Stderr 输出进度,Stdout 输出最终 JSON。 |
query_indexer.py | 查询 | 封装 Indexer API。 |
read_file_base64.py | 辅助 | 读取文件并输出 Base64/MIME 信息。 |
https://file.metaid.io/metafile-uploaderhttps://file.metaid.io/metafile-indexertxId / indexTxId: 链上哈希。pinId: 格式为 {txId}i0,是文件在 MetaWeb 上的唯一标识。viewUrls: 包含 content (直接下载) 和 pin (浏览器查看) 链接。File too large (且未走分块): 强制切换到分块上传逻辑。Insufficient balance: 提示用户向 account.json 中的地址充值。ChunkPreTxHex required 或格式错误,通常是因为未使用 TS 脚本而尝试直接 Curl。解决: 强制使用 upload_with_balance_check.sh。chmod +x scripts/*.sh scripts/*.py。