analysis-toolkit：分析质控工具包

触发词：精密度、室内质控、室间比对、方法验证、标准曲线、趋势监控、Prophet 预测、PCA分析 适用场景：室内质控 | 室间比对 | 方法验证 | 趋势监控 | PCA分析 | 报告生成

场景驱动的检验检测分析工具箱 — 不是给你一堆函数，而是给你一套完整的分析工作流。

触发条件

正向触发：

• [帮我做室内质控分析 / 算一下精密度 / 画个质控图]
• [做几个实验室比对 / 算ANOVA和Z值 / 画YYouden 图]
• [做方法验证 / 算检出限定量限 / 拟合标准曲线]
• [做趋势监控 / 预测未来数据 / 跑Prophet 预测]
• [帮我生成质控报告 / 数据分析报告]
• [做PCA主成分分析 / 一致性评价]
• [做批次间比对 / 重复限性检查]
• [F值查表 / 回归分析 / 分组统计分析]

核心能力

→ 详见 渐进式文件索引表

📚 渐进式加载：本技能采用渐进式 MD 体系，SKILL.md 为入口（≤230行），详细内容拆分到 references/*.md 按需加载。

渐进式文件索引

工作流程

1. 理解用户需求 → 识别分析场景和目标参数（输入：用户原始需求；输出：分析计划）
2. 规划执行步骤 → 选择算子/Pipeline 模板，确定数据要求和预期输出（输入：分析计划；输出：执行方案）
3. 调用相关工具/脚本 → 执行数据分析/质控计算/报告生成（输入：执行方案；输出：数值结果+HTML报告）
4. 返回结果给用户 → 呈现分析结论和可视化报告（输入：数值结果+HTML报告；输出：用户可读的最终输出）

能力边界

支持范围

• 本技能专注于检验检测行业的质量控制和数据分析
• 单次调用可处理任意数量的测量数据点（基于 numpy/pandas 向量化计算）

适用范围说明

• 通用分析引擎：本技能专注统计分析与质控算法，方法和公式跨行业适用。
• 非专有场景：不包含农产品/食品检测的专用判定标准，但通用算法可直接处理其数据。
• 最小数据量要求：精密度分析每水平≥2行，质控图建议≥10个点，Prophet 预测需要≥3个聚合后的时间点。数据不足时函数会抛出 ValueError 或返回 result["warnings"] 提示。严重问题（如列名错误、斜率为0）抛出明确异常；轻度问题（如含空值、数据偏少）写入 result["warnings"] 并同步输出到控制台，避免静默返回错误结果。
• 最小数据量要求：精密度分析每水平≥2行，质控图建议≥10个点，Prophet 预测需要≥3个聚合后的时间点。数据不足时函数会抛出 ValueError 或返回 result["warnings"] 提示。严重问题（如列名错误、斜率为0）抛出明确异常；轻度问题（如含空值、数据偏少）写入 result["warnings"] 并同步输出到控制台，避免静默返回错误结果。

运行环境

• 离线可用，无需网络连接
• 基于 Python 3.8+，依赖 numpy/pandas/matplotlib
• 输入格式：pandas DataFrame
• 输出格式：数值结果 + HTML 可视化报告
• 内置算子数量持续增长中，可通过测试验证确保正确性
• 计算精度受限于 IEEE 754 双精度浮点数标准

核心场景

1️⃣ 室内质控（Internal QC）

同一实验室内部，评估方法精密度和稳定性。

→ 详见 渐进式文件索引表

2️⃣ 室间比对（Inter-lab QC）

多家实验室/操作人员/仪器之间的结果比对。

→ 详见 渐进式文件索引表

3️⃣ 批次间比对（Inter-batch QC）

不同批次的检测结果一致性检验。

→ 详见 渐进式文件索引表

4️⃣ 方法验证（Method Validation）

标准曲线、检出限、定量限、回收率、不确定度。

→ 详见 渐进式文件索引表

5️⃣ 趋势监控（Trend Monitoring）

长期数据跟踪与风险预警。

→ 详见 渐进式文件索引表

快速使用

导入

from scripts.operations import calc_mean, calc_sd, calc_rsd, calc_bias
from scripts.scenarios.internal_qc import internal_precision_analysis

示例

# 完整室内精密度分析
import scripts.scenarios.internal_qc as iqc
result = iqc.internal_precision_analysis(df, "水平", "结果")
fig, stats = iqc.control_chart(df, "结果")

流水线（Pipeline）

四种用法：

• 单独用 — 单步调用算子
• 组合用 — pipeline() + step() 临时拼装
• 场景模板 — 加载内置模板跑完整场景+HTML报告
• 自扩展 — 查标准->自动补全算子->注册模板

from scripts.pipeline.registry import load_template
from scripts.reporting.report_engine import render_from_template

pipe = load_template("总误差评估")
results = pipe.run(data)
html = render_from_template("总误差评估", results)

数据格式

统一接受 pandas.DataFrame。 关键列名参数：value_col(数值列), group_col(分组列), date_col(时间列)