中文 | English

面向电化学实验数据的本地处理与分析工具，支持 LSV、CV、EIS、ECSA 批量处理、本地 Web UI、项目/历史管理，以及可选的 AI 辅助分析。

ElectroChem V6 的目标是把常见电化学数据处理流程收敛到一个统一工作台中，减少手工整理、重复导出和脚本碎片化问题。

适用场景：

• 批量处理同一批实验样品
• 统一输出 LSV / CV / EIS / ECSA 结果文件
• 保留项目、历史和质量报告，方便复核
• 通过本地 UI 降低使用门槛

• 支持 LSV / CV / EIS / ECSA 多类型数据处理
• 支持按文件名前缀、包含、正则进行批量匹配
• 支持 LSV 的目标电流、电位换算、iR 补偿、Tafel、Onset、Halfwave
• 支持 LSV Tafel 拟合 R² 自动验证（R² < 0.99 时在质量报告中警告）
• 支持 CV 峰检测、ΔEp 计算和电荷积分
• 支持 EIS 的 Nyquist / Bode 绘图及 Randles 等效电路拟合（Rs + Rct‖Cdl）
• 支持 ECSA 的 Cdl / ECSA / RF 计算，内置材料比电容 Cs 预设（Pt、Carbon、IrO₂、RuO₂ 等）
• 支持参比电极预设（Ag/AgCl、SCE、Hg/HgO、Hg/Hg₂SO₄、MSE、RHE）
• 单文件失败不中断整批处理（skip-on-error），错误文件汇总至结果
• 逐文件进度反馈（LSV/CV/EIS 处理时显示 N/M 进度）
• UI 支持基础/高级模式切换，简化初学者操作
• 支持项目管理、历史记录（按指标范围/数据类型过滤）、质量摘要和质量报告
• 支持项目结果 ZIP 一键导出（GET /api/v1/projects/{id}/export-zip）
• 支持本地 HTTP 服务和 Web UI
• 支持可选的 LLM / Agent 分析链路

1. 双击 setup.bat
2. 安装完成后双击 start.bat

默认打开：

• http://127.0.0.1:8010/ui

python -m venv .venv .venv\Scripts\activate pip install -r requirements.txt python run_v6.py --port 8010

最常用：

python run_v6.py --port 8010

其他命令：

python run_v6.py check python run_v6.py smoke --port 8011 python run_v6.py stress --port 8012 python run_v6.py version

• UI：http://127.0.0.1:8010/ui
• 健康检查：http://127.0.0.1:8010/health
• API 示例：http://127.0.0.1:8010/api/v1/projects

• 目标电流点插值
• Tafel 拟合
• iR 补偿
• 过电位计算
• Onset / Halfwave
• 质量检测开关与阈值可调

• 曲线绘制
• 峰检测（可选）
• ΔEp 峰电位差计算（需启用峰检测）
• 电荷积分（∫|I|dE）
• 质量检测开关与阈值可调

• Nyquist 图
• Bode 图（幅值+相位）
• Randles 等效电路拟合（简化 Rs + Rct‖Cdl 模型，自动注释到 Nyquist 图）
• 历史记录与结果输出

• ΔJ-v 拟合
• Cdl
• ECSA
• RF
• 内置材料 Cs 预设（Pt=20、Carbon=20、IrO₂=40、RuO₂=35、NiFeOOH=60、MnO₂=40、CoOₓ=50 µF/cm²）

当前质量检测以 LSV 和 CV 为主，处理完成后会生成质量摘要，并在有需要时输出质量报告。

目前支持：

• LSV：启用/禁用质量检测，调节最少点数、异常值比例、扫描范围、噪声、跳变比例、局部波动阈值
• CV：启用/禁用质量检测，调节最少点数和循环闭合容差

相关实现位置：

• src/electrochem_v6/core/processing_quality.py
• src/electrochem_v6/core/processing_lsv.py
• src/electrochem_v6/core/processing_cv.py

处理后通常会生成：

• 各类型结果图
• LSV_results.csv
• ECSA_results.csv
• quality_report.json
• latest_quality_report.json
• 历史记录与项目记录

具体输出取决于启用的数据类型和参数配置。

换一个端口启动：

python run_v6.py --port 8011

先执行：

setup.bat

默认路径为 ~/.electrochem/v6/，可通过环境变量自定义。

安全说明：服务仅监听 127.0.0.1（localhost），不对外网暴露，无需 CORS 或身份认证。

在 PowerShell 或 CI 中出现中文乱码时，设置：

$env:PYTHONUTF8 = "1"

或在 CMD 中：

set PYTHONUTF8=1

系统需安装中文字体（SimHei / Microsoft YaHei / SimSun 之一）。
也可通过处理参数的 font 字段指定可用字体名称。

在无图形界面环境（CI / Docker）中，需在导入 matplotlib 前设置：

import matplotlib matplotlib.use("Agg")

• 检查文件编码：支持 UTF-8、GBK、GB2312、ASCII、Latin-1
• 检查 start_line 参数是否跳过了表头行
• 确认数据列之间以制表符或逗号分隔

启用详细日志：

$env:ELECTROCHEM_V6_LOG_LEVEL = "DEBUG" python run_v6.py

• run_v6.py：命令行入口
• setup.bat：创建虚拟环境并安装依赖
• start.bat：启动本地服务和 UI

• src/electrochem_v6/core/processing_core_v6.py：兼容入口、共享工具、统一导出
• src/electrochem_v6/core/processing_pipeline.py：批处理编排与目录扫描
• src/electrochem_v6/core/processing_quality.py：质量检查与质量报告
• src/electrochem_v6/core/processing_lsv.py：LSV 处理与 IR/Tafel
• src/electrochem_v6/core/processing_cv.py：CV 处理
• src/electrochem_v6/core/processing_eis.py：EIS 处理
• src/electrochem_v6/core/processing_ecsa.py：ECSA 处理与样品匹配辅助函数

• src/electrochem_v6/server/：HTTP 服务与路由
• src/electrochem_v6/store/：项目、历史、模板、本地持久化
• src/electrochem_v6/ui/：本地 Web UI
• src/electrochem_v6/agent/：Agent 工具链
• src/electrochem_v6/llm/：LLM 客户端与配置

安装开发依赖：

pip install -r requirements-dev.txt

常用验证：

python run_v6.py check python run_v6.py smoke --port 8011 python -m pytest -q

当前发布版验证状态：

• 110 passed, 1 skipped
• python run_v6.py check 通过
• python run_v6.py smoke --port 8011 通过

打包相关文件位于：

• packaging/

发布前建议检查：

• PUBLISH_CHECKLIST.md
• CHANGELOG.md
• packaging/README.md

本项目采用 MIT 许可证，详见 LICENSE。

后续较值得继续优化的方向：

• 为 EIS / ECSA 补更细的质量检测
• 为 README 补使用截图或流程图
• 实测 PyInstaller 打包链路
• EIS Randles 拟合支持 CPE 替代 Cdl 的更通用模型
• CV 多圈自动分段与循环伏安参数提取
• 前端结果页展示跳过错误文件的详细列表