Skip to content

Releases

CI latest (full - GPU + 3D SAM)

Pre-release

Choose a tag to compare

@github-actions github-actions released this 26 Sep 05:32
ci-latest-full

fix(deps/spec): 把 CUDA torch 写进 requirements-full 并 pin 死;spec 在 FULL…

CI latest (base)

CI latest (base) Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 26 Sep 03:31
1202030
ci-latest

Add files via upload

v1.0.0 — Animal Dicom 爱宠影像工作站(含 Windows 便携版 EXE)

Choose a tag to compare

@hg3992260 hg3992260 released this 25 Sep 17:51

v1.0.0 — Animal Dicom 爱宠影像工作站

首个正式版:把原 SSD+VR Fusion Viewer(人医/科研)改造为面向宠物医院的离线 CT / DR / MRI 影像工作站。

本版资产

资产 大小 说明
Animal_Dicom_v1.0.0_win64_portable.zip 424 MB Windows 64 位便携免安装:解压后双击 Animal_Dicom.exe;必须保留同级 _internal/
Source code (zip/tar.gz) — 源码(MIT)

便携包是基础版:渲染 12 模式 / MPR / 测量 / PACS / 档案 / AI / 期限全部完整,
已附带 ErCore.dll;仅不含 GPU 加速(cupy+CUDA 约 1.9 GB,Frangi 走 CPU)与
3D SAM 推理依赖(torch 约 4.5 GB)。需要完整能力请用源码装 requirements-full.txt。

亮点

  • 五页签工作流:爱宠列表 → MPR 阅片 → 渲染 → 档案中心 → 设置;术语全量「爱宠」化。
  • MPR 阅片:三正交视图、滚轮翻层、双击单元格放大 2×2;长度/角度/矩形/椭圆/不规则多边形测量;窗宽窗位滑块 + 5 组临床预设。
  • 3D SAM 交互式分割:MPR 上左键正点 / 右键负点 → 后台推理 → 绿色叠加;结果可存 ROI 记录(体积/HU/体素数)、加载回显、删除、一键导出 Excel。
  • PACS 取片:节点管理 + C-ECHO / C-FIND(检查·序列)/ C-GET → 一键载入阅片。
  • 档案中心:病例档案(5 段 24 字段模板)、render.png 封面、时间戳版本可查看/恢复、默认示例病例(置顶禁删)。
  • DeepSeek AI 引导补全:按模板逐字段补全病历,写入 ai_log,可自动存一版时间戳版本。
  • 12 种渲染模式(stable / hd_surface / cinematic / nature_channels / figure8_channels / layer_channel / frangi_channel / bone_mono / 2dtf / spectral / exposure_render / dual_volume)+ SSD/VR 独立不透明度、阈值、CR 参数、裁剪、背景、Slicer 预设。
  • 暖橙浅色拟物皮肤(retro.qss + warm_orange.json);爱宠列表 / 设置页隐藏右侧渲染区、占满整窗。
  • 30 天强制运行期限(license_guard.py):4 文件锚点 + HKCU 注册表 + HMAC + 篡改/回拨检测 + 代码常量硬上限;无 GUI 开关、无环境变量旁路。
  • MCP 控制桥:状态按子系统分块(tabs/mpr/roi_saved/archive/settings/pacs/case/ai/pets/trial),共 62 个 ssdvr_* 工具(新增 26 个新 UI 工具)、整窗截图、防模态框卡死。

移除

  • 自动 ROI(TotalSegmentator / SynthSeg / nnU-Net)整条功能线与 K-edge/PCCT 页;遗留 API 改为明确的 deprecated 说明。

修复

缺陷 影响
「③ AI 引导补全」子页永不可达 点进不去
「双容积模式」被 ErCore/CUDA 门误挡(index in (10,11)) 无 CUDA 机器上选了自动回退 stable
VR 不透明度标签与滑块不一致(写死 0.90,实际 0.20) 显示错误
load_dicom 隐藏的 127.0.0.1:7777 几何快照上报 改为 SSDVR_DEBUG_TELEMETRY=1 才启用
桥在 GUI 弹模态框时整体卡死 op 超时 → 新增 _NoDialogs 兜底
桥的 ok 未反映 op 级失败 记录失真 → 合并为"有效 ok"
桥未把 op 超时发给 GUI(桥侧恒 120s) 切 frangi_channel(实测 405 s)必然报超时 → 已修
冻结版缺 PyCt6 数据文件 EXE 启动即崩且无提示 → 修 spec + 新增 startup_error.log
隐藏页截图为空白(VTK 窗仅 400×38) 新增 vtk_visible/hint 与 switch_to_render
爱宠列表/设置页右侧保留渲染区 + 首屏状态不生效 按需求占满整窗

验证(本版实测)

  • 渲染功能核对:与原始版逐项比对 —— 12 模式映射完全一致、渲染相关控件属性 88/88 全在、渲染方法零缺失(缺的 20 个方法全属早期已删的 K-edge / 自动ROI 页)。
  • 逐模式实测(每模式独立冷启动,避免状态污染):stable 6056 / hd_surface 19078 / cinematic 28567 / nature_channels 6821' / figure8_channels 5231/bone_mono 6626/2dtf 17842/spectral 4102/exposure_render 12203/dual_volume 36952 色;frangi_channel` 需 ~405 s 的 Frangi 预处理(原版同条件 408 s,非回归)。
  • 冻结版冒烟:12/12 通过(桥/期限/5 页签/加载 176 层 CT/3 模式渲染/档案与设置/正常退出)。
  • 桥端到端自检:100/100;期限对抗自检:15/15(到期/改时钟/清锚点/删模块/假签名)。

文档

  • DEPENDENCIES.md:依赖与资源清点 + 冻结版打包实录(3.63 GB→1.16 GB 的取舍、PyCt6 数据文件坑、基础版/完整版对比)。
  • CHANGELOG.md;README.md(含下载即用、五页签工作流、MCP、运行期限、构建、FAQ)。
  • tools/verify/:桥端到端 / 期限对抗 / 工具注册自检脚本(均可无显示环境运行)。

使用

# 便携包(推荐):解压 zip → 双击 Animal_Dicom.exe
# 源码运行:
pip install -r requirements.txt
python ssd_vr_viewer.py                  # 启动
python ssd_vr_viewer.py --mcp            # 同时开启 MCP 控制桥(端口 7799)

⚠️ CR / Exposure Render 模式需 NVIDIA GPU + CUDA + ErCore.dll(便携包已附带;无 NVIDIA 时自动回退)。
⚠️ 本版本运行期限为代码级 30 天强制(含硬上限 2026-10-26);若需新期限请改源码常量后重新构建。

已知问题

  • .github/workflows/ 三个流水线文件暂未纳入仓库(提交令牌缺少 workflow scope);文件仍在本地工作区,补 scope 后可单独提交。
  • 便携包不含 CUDA/GPU 加速与 3D SAM(体积取舍,见上表)。
  • 依赖清点发现 scientific.json / render_templates.json 在代码中零引用;segmentation/sam_adapter.py、detectors/synthseg_detector.py 带 UTF-8 BOM(不影响运行)。