用途:该技能用于通过 frappectl CLI 在 Frappe Insights 4(develop)站点上管理 workbook 内容,包括查询、图表和仪表板,并可将内容推送到线上站点。
主要能力:支持创建、读取、更新、删除 workbook;通过 CLI 调用站点 API 读取版本、数据源、workbook 列表、表结构、列信息、函数库等;支持复用已有查询、图表和仪表板定义;支持跨数据源查询(需使用 data store);支持导入用户提供的 workbook JSON。
使用方式:所有操作通过 frappectl 完成,需使用 -s <profile> 指定站点 profile。先检查认证:frappectl -s <profile> auth whoami。读取版本:frappectl -s $SITE method call insights.api.get_app_version。读取数据源:frappectl -s $SITE method call insights.api.data_sources.get_all_data_sources。读取 workbook:frappectl -s $SITE method call insights.api.workbooks.get_workbooks。搜索已有内容可使用 doc list 配合 like 过滤,例如 frappectl -s $SITE doc list "Insights Query v3" --filters-json '{"title":["like","%partner%"]}' --fields name,title,workbook --all。
适用场景:在 Insights 4 develop 站点上构建和维护数据分析工作簿,适合需要将业务语言翻译为站点数据模型、复用已有定义、跨数据源查询的场景。
限制:仅支持 Insights 4(develop)站点,主版本低于 4 需停止;不直接读写站点文件、数据库、日志或 bench;不设置 FRAPPE_* 变量;不运行 auth 命令;需用户拥有 frappectl profile;部分端点可能因站点版本较旧而缺失,需先探测;错误处理需遵循特定流程,不可读取站点代码;不编造功能、收费、价格、平台、效果或使用步骤。