元数据库完整应用程序到模块化嵌入升级

工程开发 社区

技能解读

当前原文的自动摘译,尚未人工审校。

执行合同

按顺序执行工作流程步骤 - 不要跳过任何步骤。首先创建清单,然后执行每个步骤并用证据明确标记其已完成。每个步骤的输出都会输入到下一个步骤,因此跳过步骤会产生错误的迁移。如果由于缺少信息或工具故障而无法完成某个步骤,您必须:将该步骤记录为“已阻止”,准确解释缺少的内容/失败的内容,停止(不要继续执行后续步骤)。

所需的输出结构

您的回复应按以下顺序包含以下部分: 步骤 0:元数据库版本检测 步骤 0.1:迁移计划清单 步骤 1:项目扫描 步骤 2:iframe 分析和 Web 组件映射

证据要求

步骤 0:检测到元数据库版本(来源:Docker 标记、环境变量或用户答案)。第 1 步:每个匹配的文件路径、每个 iframe 位置、SSO 端点、布局/头文件、元数据库配置变量。第 2 步:每个 iframe — 解析的 URL、内容类型、ID、哈希参数、带有属性的映射 Web 组件。步骤 3:完整的逐个文件更改计划以及准确的旧/新代码。第 4 步:每个文件 — 更改了什么以及应用了确切的差异。

架构一致性

遵循应用程序现有的架构、模板引擎、布局/部分系统、代码风格和路由模式。不要切换范例(例如,将模板转换为内联 HTML,反之亦然)。如果应用程序具有用于共享模板变量的中间件,则更喜欢使用中间件而不是跨路由处理程序进行复制。

性能

最大化每个步骤内的并行性。尽可能在单个消息中使用并行 Grep/Glob/Read 调用。不要使用子代理进行项目扫描 - 结果需要保留在主要上下文中,以便在后续步骤中进行交叉引用。不要解析存储库分支、提交、PR 或问题。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@metabase · 未声明许可证
上下文用量评级
较高消耗
接入复杂程度
需手动接入
是否需要外部接口密钥
不需要
兼容的系统
Docker
运行环境要求
Node.js · Python · Docker
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
步骤0:检测Metabase实例版本

始终向用户询问元数据库实例版本的问题 - 即使版本出现在 Docker 标签或环境变量中,也要与用户确认。 如果 v52 或更早版本则中止(v53 中引入了模块化嵌入)。

02
第1步:扫描项目+获取文档(无子代理)

同时执行项目扫描和文档获取——它们是独立的。只要不存在依赖关系,就可以在单个消息中使用并行工具调用。 1a:获取目标版本文档 获取目标版本的 `llms-embedding-full.txt`(有关 URL 格式,请参阅“允许的文档源”)。这些文档是目标版本的 Web 组件属性、`window.metabaseConfig` 选项和 SSO 端点行为的权威来源。在步骤 2 中使用它们进行映射,而不是仅仅依赖于硬编码表。

03
第 2 步:分析 iframe 并映射到 Web 组件(仅在第 1 步之后✅)

使用步骤 1a 中获取的文档作为 Web 组件属性、`window.metabaseConfig` 选项和 SSO 端点行为的权威参考。下面的硬编码表是后备方案 - 如果文档描述了目标版本的附加属性或不同行为,则更喜欢文档。对于步骤 1 中找到的每个 iframe: 2a:解析 iframe URL 从 iframe `src` 属性提取(可以是模板表达式、变量或文字):

04
第 3 步:计划迁移更改(仅在第 2 步之后✅)

创建涵盖以下所有领域的完整的逐个文件变更计划。每次更改都应指定目标文件、旧代码和新代码。 3a:embed.js 脚本注入 - 每个应用程序仅一次目标:步骤 1e 中标识的布局/头文件位置:`<head>`内部(或尽可能靠近其他`<script>`标签)要添加的代码:

05
第 4 步:应用代码更改(仅在第 3 步之后✅)

按此顺序应用步骤 3 中的所有更改(首先进行后端更改,以最小化出现问题的窗口): 第一:修改 SSO 端点以返回 JSON(步骤 3c)——这仅适用于后端 第二:将 `window.metabaseConfig` 分配和 embed.js 脚本标记添加到布局/头文件中(步骤 3b + 3a,在 embed.js 之前进行配置) 第三:将每个 iframe 替换为其 Web 组件(步骤 3d),一次一个文件

06
第 5 步:验证更改(仅在第 4 步之后✅)

执行所有这些检查。检查 5a–5c 可以并行运行(都是独立的 grep 搜索)。检查 5d 和 5e 需要读取特定文件。每次检查都应该有明确的通过/失败结果。 5a:没有剩余的元数据库 iframe 使用 Grep 在所有项目文件中搜索 `<iframe` 和 `iframe`(不包括 `node_modules`、`.git`、锁定文件)。验证是否存在指向元数据库的完整应用程序/交互式嵌入 iframe。

07
第 6 步:输出摘要

将最终输出组织到以下部分: 应用的更改:列出每个修改的文件以及每个更改的一行描述 Web 组件映射:显示每个旧 iframe→新 Web 组件的表格 删除的参数:删除的完整应用程序 iframe 参数列表,并简要说明为什么它们不适用于模块化嵌入 主题配置:映射到 `window.metabaseConfig` 的任何主题/外观设置

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。