meridian-result-visualization

Meridian 结果可视化

用于加载拟合后的 Meridian 模型并生成标准可视化报告的技能。

核心工作流

交互检查点规则

在此工作流中，你会遇到关键交互检查点。在每个检查点，你必须：

1. 向用户展示当前拟定的配置、报告路径、脚本路径或状态，以供审批。
2. 使用可用的用户交互工具（例如 ask_question），以多选题的形式询问用户是否准备好继续。不要使用普通聊天文本。
3. 等待用户回复后再继续。
   • 必须遵守：无论初始提示中的说明如何，每个检查点都必须暂停（即使用户请求中包含“自主运行”“直接执行”“自主修复”等说法）。初始请求不能跳过这些交互检查点。
   • 注意：如果用户在检查点给出笼统的批准（例如“继续”“按你认为合适的做”），则按拟定的默认设置继续。

---

1. 初始设置

• 提示用户提供序列化模型文件的路径（默认为 meridian_model.binpb）。
• 提示用户提供以下输出路径：
  • 模型结果摘要报告（默认为 results_summary.html）。
• 提示用户提供生成的 Python 脚本所需的路径。
• 提示用户提供报告的任何可选配置（例如结果摘要的日期范围）。
• 关键交互检查点：向用户展示收集到的路径和配置，并在加载模型前征得确认。

2. 添加模型加载代码

• 使用 meridian_serde.load_meridian() 加载模型。
• 代码模板请参阅 load_model.md。
• 关键交互检查点：向用户展示模型加载路径配置和拟定的 Python 代码片段，并在继续指定健康检查前征得批准。

3. 添加建模后健康检查代码（可选）

• 使用 reviewer.ModelReviewer 执行健康检查并保存为 HTML。
• 小型／测试模型：如果模型的 MCMC 抽样次数少于 2 次（例如测试模型或模拟模型，其中 R-hat 计算需要至少 2 个样本），则捕获 ValueError，或优雅地跳过 R-hat 计算，以确保健康检查报告能顺利生成。
• 代码模板请参阅 health_check.md。
• 关键交互检查点：向用户展示拟定的健康检查报告路径和代码片段，并在继续配置结果摘要前征得批准。

4. 添加模型结果摘要代码

• 使用 summarizer.Summarizer 生成 HTML 结果摘要，并应用用户指定的配置（例如日期范围）。
  • 日期范围自动裁剪：如果用户指定的日期范围超出模型的时间坐标范围，则裁剪或调整日期范围，使其与模型的实际坐标相匹配。
  • 错误提示：如果遇到与 sample_prior 有关的错误，请绕过或修复相关要求（例如，设置 sample_prior=False 或传入所需参数），以确保成功生成。
• 代码模板请参阅 results_summary.md。
• 关键交互检查点：向用户展示拟定的日期范围、输出路径配置和结果摘要代码片段，并在继续生成和执行脚本前征得批准。

5. 执行前检查点

• 关键交互检查点：向用户展示最终报告路径和脚本路径，并询问是否最终确认现在执行结果生成脚本。

6. 执行与脚本设置

• 将累积的 Python 脚本写入用户指定的路径。如果你的文件写入工具可以请用户检查写入的文件，请不要请求用户检查：执行前检查点已经请求过批准，额外的提示会暂停工作流。
• 使用安装了 google-meridian 的环境中的 Python 解释器执行脚本：如果用户指定了解释器，就使用该解释器；否则，如果虚拟环境已激活（设置了 VIRTUAL_ENV 或 CONDA_PREFIX），则使用 python3；否则，如果项目目录中存在虚拟环境（.venv/ 或 venv/，例如 .venv/bin/python3），则使用该环境；否则使用 python3。如果 import meridian 失败，请询问用户要改用哪个环境，而不要擅自搜索计算机或安装软件包。
• 重要：任务结束时，不要删除生成的报告、脚本或输出目录。这些是用户要求交付的内容，必须保留。