用途:为 Metabase 问题复现提供参考资料,涵盖 REPL 配方、API 模式、领域特性与边界情况处理。
主要能力:
- REPL 配方:用 t2/select 检查表与设置,用 mt/user-http-request 或 api_call 创建卡片,用 qp/process-query 运行查询,用 qp.compile/compile 编译 SQL。
- API 模式:GET /database、POST /card、GET /database/1/metadata 等;建议用窄 jq_filter 避免大响应。
- 领域知识:旧透视表(table.pivot: true,仅 3 列)与新透视表(PivotTable 类型)是不同代码路径;sort-by 单键有并列值时顺序不确定;appdb 可兼作数据仓库。
- H2 提示:不支持 report-timezone、DATETRUNC()、pg_sleep();保留 value、count、key、type 等关键字;FORMATDATETIME() 返回文本;Sample Database 中 CATEGORY 在 PRODUCTS 表。
- 边界情况决策表:无 Linear issue、JAR 下载失败、启动超 5 分钟、需干净重启、仅前端问题、驱动特定问题、无复现步骤、已有自动复现评论、版本未找到、升级/切换版本等场景的处理方式。
- MCP 工具:check_setup、start_appdb、stop_appdb_tool、create_env、jar_download、start_metabase、stop_metabase、reset_metabase、get_session_token、check_setup_token、api_call、setup_master_worktree、setup_worktree、save_test_patch、run_test、repl_eval、get_status、cleanup。
使用方式:通过 REPL 或 API 调用执行上述配方;卡片创建避免用 t2/insert-returning-instance!,改用 api_call 或 mt/user-http-request 以获得清晰错误。
限制:资料未提供收费、价格、平台与效果信息;部分行为(如 t2/update! 返回 0)需用 t2/select-one 验证。