SuperAPI AI 工具集

extension-data-viewer

数据与分析

查看项目

更新于 10-15 17:31

技能介绍

用途:这是 Caffeine AI 的数据查看扩展,面向管理员,用于查看稳定金库(canister state)。当用户需要查看器、仪表盘、调试面板或对后端数据的管理员浏览时使用。

主要能力:每个 Caffeine 应用自带 caffeineai-data-viewer mops 包并启用 moc --generate-view-queries 标志。在 actor 中加入 include MixinViews() 后,编译器会为每种受支持的稳定变量类型自动暴露一个仅限控制器调用的 __<var> 查询:Map.Map<K, V> 生成 (?K, ?Nat) -> [(K, V)];Set.Set<K> 生成 (?K, ?Nat) -> [K];[V]、[var V]、List.List<V>、Stack.Stack<V>、Queue.Queue<V> 生成 (?Nat, ?Nat) -> [V]。游标为 null 时从开头开始,计数为 null 时返回游标之后的全部内容。这些生成的查询对任何非控制器调用者都会 trap,仅供管理员仪表盘与调试查看器使用,不是面向用户的端点。

使用方式:模板已内置该包与 include,无需为查看器新增或修改任何内容;只要声明一个受支持类型的稳定变量,__<var> 查询就会自动出现。随包发布的 Lintoko 规则 include-mixin-views 会在 actor 体缺少 include MixinViews() 时报错,请保留该 include,删除它会禁用所有自动生成的查看器。

限制:绝不能把生成的 __<var> 查询当作面向用户端点的替代品,对任何非控制器调用者都会 trap;公开的列表、信息流、搜索方法仍需照常写成 public query func listX(...)。绝不能声明以 __ 开头的 actor 成员,否则会与自动生成的查询冲突或触发保留前缀。不支持纯(不可变)集合(pure/Map、pure/Set、pure/List、pure/Queue),查看器按设计仅支持可变集合;纯集合字段访问在 Caffeine 项目中本身已是废弃模式。其他收费、价格或平台信息暂未提供。