QC Toolkit — QC 化验工具链

滴定计算 · 送检单生成 · 检验报告

电池回收行业（湿法冶金）QC 化验员的日常工具包。

安装

pip install qc-toolkit

零依赖，纯 Python，Windows / macOS / Linux 通用。

三个工具

1. qc-calc — 化验计算器

支持 EDTA 滴定、酸碱滴定、稀释校正、单位换算、规格比对。

快速模式（适合每天用）：

# EDTA 滴定：EDTA消耗18.5mL, 浓度0.05mol/L, 取样2.0mL → 测钴
qc-calc --titrate Co 18.5 0.05 2.0
# 输出: 26.3542

# 带稀释倍数
qc-calc --titrate Co 18.5 0.05 2.0 2.5

# 酸碱滴定
qc-calc --acid-base 15.2 0.1 25.0

# 稀释校正
qc-calc --dilute 5.0 100 10

# 单位换算
qc-calc --convert 15000 mg/L g/L

# 规格比对
qc-calc --check 85 g/L 80 110

交互模式（适合偶尔用）：

qc-calc

菜单一步步引导，适合不记参数的时候用。

2. qc-sample — 样品送检单生成器

生成格式化送检单，包含车间选择、工艺环节、检测项目、规格要求。

qc-sample

按提示填写，自动输出格式化的送检单。

支持车间：

• 102 萃取车间（P204/P507/CY272）
• 103 钴盐车间
• 105 浸出车间
• 109 电钴车间
• 301 四钴车间
• 等等

3. qc-report — 检验报告生成器

生成带表格边框的检验报告，自动计算合格率，给出判定结论。

qc-report

快速体验演示数据：

qc-report --demo

输出示例：

╔══════════════════════════════════════════════════════════╗
║              寒锐钴业（赣州）化验室                       ║
║              检 验 报 告 单                              ║
╚══════════════════════════════════════════════════════════╝
...
┌──────┬────────┬────────┬──────────┬──────────┬──────────┐
│ 序号 │ 检测项目 │ 单位  │ 标准要求 │ 检测结果 │ 单项判定 │
├──────┼────────┼────────┼──────────┼──────────┼──────────┤
│  1   │ Co     │ g/L    │ 80-110   │ 85.25    │ 合格    │
│  2   │ Ni     │ g/L    │ ≤1.0     │ 0.85     │ 合格    │
│  3   │ Cu     │ g/L    │ ≤0.5     │ 0.12     │ 合格    │
...
│  合格率: 6/6 (100.0%)                               │
└──────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────┐
│  结论                                                   │
├──────────────────────────────────────────────────────────┤
│  经检验，该样品所检项目符合标准要求，判定为合格。         │
└──────────────────────────────────────────────────────────┘

应用场景

• 电池黑粉回收 — 浸出液钴镍滴定计算、报告
• 湿法冶金 — P204/P507 萃取线化验
• 钴盐生产 — 硫酸钴、氯化钴、四钴 QC
• 第三方检测 — 送检单标准化

输出格式

所有报告和送检单均为纯文本表格，可直接：

• 复制粘贴到微信/钉钉
• 截图发送
• 打印（80 列宽适配）

定价

¥98 / 单次买断（包含所有三个工具和后续更新）

对比 Excel

许可

MIT License