一个基于 epycon 的 Web UI 工具集，用于解析和转换 Abbott WorkMate 系统记录的 EP 信号数据。提供便捷的图形界面，支持数据转换、日志解析和 HDF5 预览。
- 数据转换：将 WorkMate 日志文件转换为 CSV 或 HDF5 格式
- 日志解析：深度搜索和过滤 WorkMate 日志条目
- WorkMate Version: 4.3.2 (Recommended for x64 support) / 4.1 (Legacy x32)
- Supported Formats: WMx32, WMx64
- HDF5 预览：浏览和可视化 HDF5 文件内容
- Web 界面：本地 Flask 服务，支持配置管理和批量处理
- 跨平台：优化 Windows 兼容性，处理编码和时间戳问题
- 安装依赖：
pip install -r requirements.txt - 运行工具集：打开
ui/index.html或运行python app_gui.py - 使用 VS Code 任务：
Ctrl+Shift+P>Tasks: Run Task>运行 Epycon GUI
本系统采用医疗级信号处理标准，确保波形渲染既具备 WorkMate 级别的平滑质感，又完整保留诊断所需的微小病理细节（如 aVL 导联切迹）。
graph TD
A["💾 硬盘原始数据"] --> B{"后端去噪 (Python)"}
subgraph Backend ["后端处理"]
B -->|"1. ActiveNotch"| C("谐波陷波 50/100/150Hz")
C -->|"2. LowPass"| D("因果低通 40Hz 1阶")
D -->|"3. HighPass"| E("高通去漂移 0.5Hz")
end
E --> F{"前端预处理 (JS)"}
subgraph Frontend_Pre ["前端优化"]
F -->|"4. Micro-Smooth"| G("微平滑 [0.1, 0.8]")
G -->|"5. LTTB"| H("高密度降采样 4000点")
end
H --> I{"渲染引擎 (SVG)"}
subgraph Frontend_Render ["矢量绘制"]
I -->|"6. Spline"| J("紧致样条 0.3")
end
J --> K["👀 最终画面"]
-
后端去噪 (Signal Hygiene)
- ActiveNotch™: 级联陷波器，同时滤除基频 (50Hz) 及其二次/三次谐波 (100Hz/150Hz)，消除非线性负载微锯齿。
- Causal LowPass: 40Hz 1阶 IIR 滤波器。优先保证相位线性和无预振铃，还原真实生理信号起始点。
- HighPass: 0.5Hz 去基线漂移。用于消除呼吸波动带来的基线不稳。
-
前端微调 (Visual Polish)
- Micro-Smoothing: 极柔和的高斯核
[0.1, 0.8, 0.1]。作为“视觉降噪器”，擦除 1 阶滤波器残留下的高频模糊（Fuzz），而不侵蚀信号波峰。
- Micro-Smoothing: 极柔和的高斯核
-
高保真渲染 (High Fidelity)
- LTTB 采样: 4000 点/通道。在 1080p 下提供 >2x 像素密度的“视觉无损”精度，防止高速 (100mm/s) 下的折线感。
- SVG + Spline 0.3: 弃用 WebGL，改用原生 SVG 矢量抗锯齿。配合 0.3 的紧致样条系数，消除数字阶梯感的同时，完美贴合原始数据点。
- 使用项目内的 PowerShell 脚本（推荐，保留在
scripts/）：
.\scripts\run_tests.ps1- 或使用 Python/pytest 直接运行（在虚拟环境中）：
python -m pytest --cov=epycon --cov-report=term-missing --cov-report=html --cov-report=xml生成的 HTML 报告位于 htmlcov/index.html，XML 报告为 coverage.xml，这些输出已被添加到 .gitignore。
在开发或 CI 运行后，可以安全地清理本地产生的临时测试产物：
- 推荐（PowerShell，仓库根目录运行）：
.\scripts\clean_repo.ps1- 手动（如果不使用脚本）：
# 删除覆盖率报告与缓存
Remove-Item -LiteralPath htmlcov -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item -LiteralPath coverage.xml -Force -ErrorAction SilentlyContinue
Remove-Item -LiteralPath .coverage -Force -ErrorAction SilentlyContinue
Remove-Item -LiteralPath .pytest_cache -Recurse -Force -ErrorAction SilentlyContinue
# 删除仓库内的 __pycache__（跳过虚拟环境）
Get-ChildItem -Recurse -Directory -Force | Where-Object { $_.Name -eq '__pycache__' -and $_.FullName -notlike '*\\venv\\*' -and $_.FullName -notlike '*\\.venv\\*' } | ForEach-Object { Remove-Item -Recurse -Force $_.FullName }注意：该清理不会删除虚拟环境（venv / .venv）或源码文件。若需要删除临时脚本或已合并的临时文件（例如本地 PR_BODY.md），请使用 git rm <file> 并提交，然后推送到远端：
git rm PR_BODY.md
git commit -m "chore: remove temporary PR body file"
git push origin <branch>项目支持打包为独立可执行文件，无需安装 Python：
- 安装 PyInstaller：
pip install pyinstaller - 运行打包：
pyinstaller app_gui.py --name WorkMateDataCenter --add-data "ui;ui" --add-data "config;config" --add-data "epycon;epycon" - 生成的文件位于
dist/WorkMateDataCenter/
注意：运行时前端第三方 bundle 已集中放置于 ui/vendor/，请确保在打包时将该目录一并包含（例如使用 --add-data "ui/vendor;ui/vendor"）。
注意：这是目录模式打包，包含 EXE 和支持文件。您可以压缩整个文件夹分发。
运行 EXE 后，自动打开浏览器访问 http://127.0.0.1:5050 使用工具集（端口被占用时自动在 5050-5099 范围内选择）。
下载与分发
- 可分发包发布在 GitHub Releases（含
WorkMateDataCenter.exe及支持文件），版本变更说明见各 Release 页面。 - 最新版本： https://github.com/flyskyman/epycon-webui/releases/latest
快速下载安装并运行（Windows）：
- 从 Release 页面下载最新的 WorkMateDataCenter 压缩包。
- 右键解压到任意目录（例如
C:\Tools\WorkMateDataCenter）。 - 双击
WorkMateDataCenter.exe启动，或在 PowerShell 中运行：
Start-Process -FilePath "C:\path\to\WorkMateDataCenter.exe"- 程序会启动本地服务并在默认浏览器打开
http://127.0.0.1:5050，可在界面中选择示例数据或上传自己的.log文件进行转换。
提示：若你希望在无浏览器（服务器）环境使用批处理功能，请使用源码方式运行：
python -m epyconapp_gui.py：Flask Web 应用，项目的图形/HTTP 入口（保留为可执行主入口）。epycon/：核心 Python 包conversion.py：转换逻辑的唯一实现（CLI 与 GUI 共用，标注定位等语义只改这里）。__main__.py：CLI 入口（config 处理 + 调用 conversion）。api_ecg.py：ECG 查看器 HTTP API（Flask Blueprint）。iou/：WorkMate 二进制解析（parsers）与输出（planters）。core/、config/、utils/：校验、格式化、byteschema、辅助。
ui/：前端静态资源（index.html入口、ecg_viewer.html、editor.html、WorkMate_Log_Parser.html、h5_preview.html、vendor/第三方 bundle）。scripts/：在用脚本（CI 数据生成/校验、性能基准、打包 spec、巡检工具）；scripts/archive/为一次性脚本留档。分类规则见scripts/README.md。tests/：pytest 套件（CI 强制全绿）。config/：运行时配置（config.json,schema.json；与包内模板的分工见tests/test_config_sync.py）。docs/：活文档（台账、渲染规范、上游论文、工具用法）；docs/archive/为历史留档。 索引见docs/README.md。examples/：示例（demo.py）与合成测试夹具（examples/data/study01/，测试断言依赖其精确内容）。- 项目根还包含：
README.md,CLAUDE.md（维护约定）,LICENSE,setup.py,requirements.txt等元数据与开发文件。 - 变更记录：用户可见变更见 GitHub Releases；开发细节见 git log；待办问题见
docs/KNOWN_ISSUES.md。
打包说明：为了简化 PyInstaller 配置，--add-data "ui;ui" 可用于包含整个前端目录（示例命令已在上方“打包为可执行文件”部分）。