Metadata-Version: 2.4
Name: qc-lab-tools
Version: 2.0.0
Summary: QC化验工具链 — 滴定计算·送检单·检验报告 (电池回收/湿法冶金)
Author: EVOLVER
License: MIT
Project-URL: Homepage, https://github.com/evolver-dev/qc-toolkit
Project-URL: Source, https://github.com/evolver-dev/qc-toolkit
Keywords: qc,quality-control,titration,laboratory,battery-recycling,hydrometallurgy
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Manufacturing
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Chinese (Simplified)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: Office/Business
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# QC Toolkit — QC 化验工具链

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

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

---

## 安装

```bash
pip install qc-toolkit
```

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

---

## 三个工具

### 1. qc-calc — 化验计算器

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

**快速模式（适合每天用）：**
```bash
# 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
```

**交互模式（适合偶尔用）：**
```bash
qc-calc
```
菜单一步步引导，适合不记参数的时候用。

---

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

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

```bash
qc-sample
```

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

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

---

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

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

```bash
qc-report
```

**快速体验演示数据：**
```bash
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

| | QC Toolkit | Excel |
|---|---|---|
| 安装 | pip install | 已预装 |
| 滴定计算 | 一行命令 | 手动输入公式 |
| 送检单 | 交互式生成 | 手动填写 |
| 报告 | 自动排版+合格率 | 手动排版 |
| 数据溯源 | 自然产生 | 无 |
| 价格 | ¥98 | 免费 |


## 许可

MIT License
