SuperAPI AI 工具集

canhelp

编程与开发

查看项目

更新于 10-15 21:09

技能介绍

用途:给定主网 canister ID 或可读名称,抓取并汇总该 canister 的 Candid 接口,相当于 canister 版的 --help。

主要能力:解析 canister ID(若参数已是合法 principal 则直接返回,否则查询 IC Dashboard API 并输出 <canister-id> <name> 匹配列表);抓取 Candid 接口并下载 .did 文件;以可读结构展示结果,包括 Canister ID、Query methods、Update methods 和 Types(自定义 record/variant 类型及其字段)。方法按查询与更新分组,组内按字母排序;复杂嵌套类型展示顶层结构并标注嵌套。

使用方式:在技能基础目录下运行 ./scripts/resolve-canister-id.sh "$ARGUMENTS" 解析 ID;若返回多个结果,需让用户选择后再继续。随后运行 ./scripts/fetch-candid.sh <resolved-canister-id> 获取 .did 文件路径,再用 Read 工具读取并整理输出。

限制:仅适用于主网 canister。若 Candid 接口很大(超过 100 个方法),只显示数量摘要和看起来最重要的方法,并可应要求展示完整列表。若抓取成功但接口为空,说明该 canister 未在 wasm metadata 中暴露 Candid 接口。若抓取失败,建议用户核对 canister ID 并确认已安装 icp。