Voxenra v1.7.0

Voxenra v1.7.0

本版完善从测量、分析到工作区保存和报告导出的流程，并新增常见彩色 DICOM 二维阅片。

新增与改进

• 彩色 DICOM：RGB、YBR、PALETTE COLOR 支持二维、平铺、多帧播放、标注和 PNG 导出；正确应用调色板，保留源颜色。有有效像素间距时开放物理尺寸测量。
• 测量管理：结果列表支持重命名、定位、显隐、锁定、复制与删除；操作按钮合并为紧凑行，名称与状态随工作区保存。
• 报告与分析保存：PDF 默认匹配测量所在切片／平面的参考图；MTF、FWHM、QA 的 ROI、曲线、数值和计算信息随工作区保存，恢复后不自动重算。
• 工作区恢复：恢复此前选择的一级功能及二级工具，播放保持暂停；不会恢复未完成拖拽或自动执行计算、导出等动作。
• 外观与窗模板：新增中性深灰主题，统一界面配色；窗模板改为可编辑的本地 JSON，支持打开目录和重新读取，内置 13 个常用 CT 窗模板。
• 帮助与反馈：提供 GitHub 和邮件反馈入口，可带入基础软件信息；邮件支持添加附件并交由用户确认发送。
• 自动更新：可选择启动检查，查看更新内容并下载；取消同一版本后不再自动提醒，设置中保留更新标识。检查失败静默处理，安装失败尝试恢复旧版。
• 文档：更新中英文 README、官网功能说明和操作手册，刷新测量、导出、工作区、设置及导入界面截图和相关动画。

修复

• 重构本地导入目录列表，避开 macOS 辅助功能读取后切换目录触发的 Qt 崩溃路径。
• 文件夹改为后台读取，等待磁盘或系统授权时仍可取消或切换路径；修复 Windows 路径分隔符导致的目录选择失败。
• 修复 PALETTE COLOR 被当作灰度图显示的问题。
• 修复彩色标记影响普通灰度／PET 影像窗值叠加信息的问题。
• 更新安装器直接调用系统 SHA-256，避免 PowerShell 模块发现异常导致 Windows 更新失败。
• 修复页签切换或窗口关闭时提示框锚点失效引发的界面错误。
• 修复窗模板示例的语言包占位符校验及模板重名提示。

安装与范围

• 提供 macOS Apple Silicon DMG、Windows x64 安装版及单文件便携版，各附 SHA-256。
• 这是首个带自动更新的正式版本，旧版用户请先手动安装 1.7.0。 后续更新可在设置中检查。
• 彩色支持限常见二维对象；不含彩色 MPR / 3D、视频编码、超声区域专用标定及大型病理图像。
• macOS 使用 ad-hoc 签名，未经 Apple 公证；Windows 未做 Authenticode 签名，可能出现系统信任提示。
• Windows 实机视觉验收与真实用户安装的端到端自动升级尚未完成；CI 与隔离更新／回退测试不等同于这些验收。

---

English summary

Voxenra 1.7.0 adds common color DICOM 2D viewing, a compact measurement results list, matching reference images in PDF reports, and persistent MTF/FWHM/QA analysis records. Workspaces restore the selected tools while keeping playback paused. Other additions include a neutral gray theme, editable JSON window presets, feedback with email attachments, and optional automatic update checks with rollback handling.

The release also fixes palette-color rendering, macOS import-directory navigation crashes triggered by accessibility inspection, and grayscale/PET overlay regressions. Documentation and screenshots have been refreshed.

Install 1.7.0 manually when upgrading from older versions; this is the first official release with the updater. Color support is limited to common 2D objects. macOS is ad-hoc signed and not notarized; Windows binaries are not Authenticode signed. Windows desktop visual checks and end-to-end upgrades of real user installations remain unverified.

Voxenra v1.6.0

更新内容

• 操作手册：合并重复章节，目录精简为 8 组、31 章；支持分组收起、搜索、图标导航和可拖动目录宽度，宽度在重启后保留。原有帮助入口仍能跳转到对应内容。
• 语言与文档：提供中英文 README 和离线手册；整合社区贡献的巴西葡萄牙语。设置中可打开语言包目录，放入 JSON 后重启或重新加载即可识别；新增中英文语言包教程与 GIF。更新设置、测量和手册截图。
• 工作区：退出已有工作区时明确提供“更新 / 不更新 / 取消”；临时工作区保留保存提示。工作区与退出对话框适配深浅主题。
• 偏好与路径：保留用户设置，并分别记住影像、目录、工作区等文件选择位置。
• 稳定性：修复 MPR 对比页创建期间可能出现的网格布局冲突、快速切换 Tag 页时的无效工具栏绑定，以及英文测量说明文字重叠。

Changes

• Reorganized the offline manual into 8 collapsible groups and 31 chapters, with icons, search, a resizable navigation pane, and saved width. Existing help links still reach the appropriate section.
• Added bilingual README/manual content, bundled Brazilian Portuguese, and local JSON language packs discovered on restart or reload. The manual includes an illustrated language-pack guide and GIFs in Chinese and English.
• Clarified workspace exit actions: Update / Don't update / Cancel for an existing workspace; Save for a temporary workspace. Workspace dialogs follow the selected theme.
• Preserved preferences and last-used locations for image, folder, and workspace selection.
• Fixed MPR comparison grid initialization, invalid toolbar bindings during rapid Tag-tab switching, and overlapping translated measurement instructions.

平台与验证 / Platforms and validation

• macOS 完整回归：2117 通过、61 跳过，0 失败；MPR／Tag 快速切换连续 5 轮、共 95 项通过。跳过项需要外部样本、目标平台或额外运行环境。

• macOS Apple Silicon：本地构建，已检查 1.6.0 版本、arm64 架构、ad-hoc 签名完整性、DMG 内容一致性、实际启动与压缩 DICOM 解码。源码原生界面已验证 CT / PET 阅片、MPR、3D、分割和中英文手册。

• Windows 完整回归：2117 通过、61 跳过，0 失败；原生窗口检查及三轮页面切换压力测试通过。

• Windows x64：由本标签的 GitHub Actions 构建安装版与便携版；回归和安装升级检查结果见 Windows 工作流。

• 提供三个安装／运行包及对应 SHA-256。macOS 未使用 Developer ID 签名／Apple 公证；未在独立干净实体 Windows 电脑进行人工验收。This release uses an ad-hoc macOS signature, without Apple notarization; Windows validation is performed in CI, not on a separate physical test PC.

Voxenra v1.5.1

主要更新

• 自由形状改为逐点点击创建并平滑闭合；新增曲线长度测量，改进自交、打结和控制点编辑处理。
• 改进点源 MTF 的背景、边缘加权与 ROI 稳定性检查；小 ROI 也显示基础尺寸和面积。
• MTF 设置移入「服务工具」。默认提供基于实测 MTF10 的高斯等效曲线；其中 MTF50 是模型估计，关闭此选项可查看实测频谱及阈值结果。
• MPR 的 3D 旋转联动默认开启，空间参考与联动选项移入独立「视口设置」，支持展开及收起侧栏。
• 修复工具提示在窗口边缘反复触发造成的悬浮闪烁；调整设置页 GitHub 项目入口。
• 延迟加载非启动必需的模块与页面，精简 Qt QML 运行资源，改善启动速度和安装包体积。

下载

• macOS Apple Silicon：本地构建的 DMG。
• Windows x64：GitHub Actions 构建的安装版与单文件便携版。
• 每个安装包均附 SHA-256 校验文件。

macOS 使用 ad-hoc 签名，未做 Apple 公证；Windows 包未做 Authenticode 签名。

验证

macOS 与 Windows 全量回归各 2097 项通过、61 项跳过。Windows 三轮异步界面压力测试全部通过；安装启动、覆盖升级、打包解码器及图标检查通过。macOS 已完成实际应用启动、设置页、解码器、签名完整性及 DMG 文件一致性检查。

Voxenra v1.5.0

Voxenra v1.5.0

本版本改进 MTF 分析的负旁瓣处理与结果展示，并打磨测量工具的若干交互细节。

主要变化

• MTF 负旁瓣处理改为高斯等效 MTF：检出显著负旁瓣时不再使用边缘加权 FFT 包络，改为以实测 MTF10 锚定的标准形态曲线，MTF50 随之恢复合理比例，曲线平滑单调。
• 点源 MTF 移除「分析方式」选择：统一按原始 LSF 直接 FFT 计算，负旁瓣自动切换高斯等效，实际使用方式仍以文字标注。
• MTF 面板新增「方向」选择：X / Y 曲线与指标可单独或同时显示，默认只看 X，至少保留一个方向；图表图例与方向选择联动。
• 测量工具排序调整：自由形状移到测量工具组末尾。
• 自由形状 ROI 绘制过程中隐藏顶点操纵点，减少干扰；测量卡片交互与样式细节调整。

安装包

提供 macOS Apple Silicon DMG、Windows x64 安装版和便携版，以及各自的 SHA-256 校验文件。

macOS 沿用 ad-hoc 签名，Windows 包未做 Authenticode 签名；不代表 Apple 公证或商业代码签名。

Voxenra v1.4.0

Voxenra v1.4.0

本版本新增线斜坡 FWHM / 层厚分析，增强 MTF 与水模 QA 工具，改进测量卡片设置和 3D 渲染健壮性。

新增功能

• 服务工具新增 FWHM 线斜坡分析：沿单根线斜坡取样测量半高宽，并换算层厚 Slice Thickness = FWHM × tan θ。默认 23°（Catphan），可切换 45°；支持高斯拟合与半高交点法，剖面图随结果展示。FWHM 与 MTF 的 ROI、分析方式、结果和重置互不影响。
• MTF 分析增强：默认高斯拟合；检出显著负旁瓣时自动采用边缘加权 FFT（Tukey α=0.5），并在结果中标注本次使用的分析方式。频率单位可在 lp/mm 与 lp/cm 间切换，同步曲线横轴与 MTF50 / MTF10 标注。
• 水模 QA 统计表每行可复制附加圆形 ROI：副本独立移动与取样，单独显示均值、SD、Δ中心，不参与五区均匀性与噪声汇总；副本可删除，初始五区受保护。
• 测量设置新增「指标与卡片」分组：卡片与图形联动开关（关闭后卡片可独立拖动）、指标字号与卡片背景透明度，右侧提供实时预览。
• 设置分组折叠状态跨会话记忆；设置页新增 GitHub 项目主页入口。

操作与显示改进

• MTF / FWHM / 水模 QA 结果标题旁新增「分析方式与质量提示」弹窗，展示本次计算方式、适用条件与质量警告。
• 3D 渲染更稳健：OpenGL 不可用时明确提示原因与处理建议；渲染错误附带具体诊断信息；HiDPI 与大窗口自动限制屏幕空间采样密度，拖动与静止采用同一质量路径，避免画面跳变。
• 测量卡片与图形默认独立移动，联动行为可在设置中开启；标签拖动即时反映在结果数据中。
• 内置操作手册同步更新 MTF / FWHM 与水模 QA 章节，说明新工具的用法与结果边界。

结果说明

斜坡层厚换算仅适用于与影像 X / Y 对齐的单根线斜坡，不做模体倾斜校正；结果不代表层间距，也不以 DICOM 标称层厚替代实测。附加 QA ROI 是独立取样点，不改变五区协议的汇总指标。分析结果仍不自动判定合格。

安装包

提供 macOS Apple Silicon DMG、Windows x64 安装版和便携版，以及各自的 SHA-256 校验文件。

macOS 沿用 ad-hoc 签名，Windows 包未做 Authenticode 签名；不代表 Apple 公证或商业代码签名。

Voxenra v1.3.0

Voxenra v1.3.0

本版本完善分割结果交换与测量报告，扩展影像读取能力，并改善 3D、MPR 和窗口布局。

新增功能

• 自由形状 ROI：沿边界绘制、闭合统计、编辑及撤销重做，可将选中 ROI 转为单层分割。
• DICOM SEG 导出与导入：多个区域可合并导出，保留名称、颜色与空间引用；右侧独立导入工具加载匹配当前影像的 SEG，并支持管理和再次导出。
• DICOM SR 结构化测量报告：输出带单位、空间位置及原影像引用的测量结果；分割统计输出对应 SEG，平面测量单独成报告。
• Enhanced CT / Legacy Converted Enhanced CT 多帧与线性定量显示映射；内置固定版本的 RLE、JPEG、JPEG-LS、JPEG 2000 解码组件。
• CT 3D 扩展为 20 个显示模板，默认 AAA；改善光照、采样与调窗对颜色及透明度的联动。

操作与显示改进

• 2D 选择器明确区分原始切片与轴位、冠状位、矢状位重建，并解释实际方向与位置信息。
• MPR 四宫格中激活任意切面或 3D 均可切换布局；支持记忆布局、双击放大 3D 和返回四宫格。
• 独立 3D 与四宫格采用适配视口的初始取景，完整展示并保留边距；旋转时保持用户的放大倍率。
• 切片播放与 CT 多时相播放分开控制；4D 的分割和 VOI 按时相保存。
• 主窗口默认 1440×900、最小 1280×720；独立窗口默认 1120×840、最小 960×720。侧栏调整保留阅片空间，设置导航适配最小窗口。
• 无法打开的影像仍创建页签，显示具体原因并提供关闭入口；PNG 导出状态与实际可用性一致。
• README 按软件整体功能重新整理，更新全部界面截图与 PET/CT 融合展示，现共 34 张静态图、6 段动画。

结果格式说明

左侧导入原始影像，右侧导入关联 SEG。SR / RTSTRUCT 导入暂未提供。SEG / SR 保留源身份与影像引用，不应用普通影像导出的匿名选项。

Slicer 已用于 SEG 与影像显示交叉验证；Slicer 对自由形状等平面测量 SR 的读取仍有限制，可用 PDF / CSV 查看数值。

安装包

提供 macOS Apple Silicon DMG、Windows x64 安装版和便携版，以及各自的 SHA-256 校验文件。

macOS 沿用 ad-hoc 签名，Windows 包未做 Authenticode 签名；不代表 Apple 公证或商业代码签名。

Voxenra v1.2.0

Voxenra v1.2.0

本版本改善日常阅片操作、序列导入和大体数据加载体验。

新增与改进

• 2D 视图左上角提供高亮的视图选择器，使用完整名称 Stack、Axial、Coronal、Sagittal。明确区分原始切片与标准切面的 2D MPR，保留位置及四角信息。
• 测量默认保留两位小数，可在设置中选择整数或 1–3 位小数；ROI、VOI、分析结果及测量报告使用一致的显示精度，原始计算值不变。
• 默认鼠标左键拖动调窗、右键拖动缩放、滚轮翻页；当前工具、十字线等专用交互优先。融合配准保留右键旋转，3D 滚轮保持缩放。
• 收起后的左侧栏保留导出、清除等操作；序列展开按钮更易点击，影像类型更醒目。右侧窄栏提供可展开的测量、旋转、标注和伪彩分组，底部按钮统一为重置所有。
• 工作区副本位置支持悬停查看、复制及在文件管理器中打开。恢复或丢弃后自动关闭工作区对话框。手册移除重复标题，正文支持选中复制。

修复

• 修复侧边栏提示首次出现时位置跳动及二级工具视觉区分不足的问题。
• 修正异常重复 SOP Instance UID 的识别，使用文件元信息区分可识别的独立文件，避免误跳过有效影像；空间重复和不规则数据仍进行重建校验。
• 正常导入结束后自动关闭进度窗口；存在重复、跳过或错误时保留结果供确认。
• MPR 切面偏离标准方向后正确显示 Oblique；独立旋转 3D 相机不改变切面名称。
• 修复原生 3D 空闲循环重绘，以及快速切换页签后已销毁页面继续执行延迟回调的问题。体数据数组准备移到后台；关闭视图取消旧读取，过期结果不再回写，缓存按预算回收。

验证与边界

已完成 CT、MR、Enhanced MR、PET、测量及窗口交互回归，并用真实 CT / MR 和大体积 CT 验证重复加载、切换、导出和关闭。优化保持原始像素、分辨率和患者坐标；首次 GPU 绘制仍可能短暂停顿。

提供 macOS Apple Silicon DMG、Windows x64 安装版与便携版，以及各自的 SHA-256 校验文件。macOS 沿用 ad-hoc 签名，Windows 包未做 Authenticode 签名；不代表 Apple 公证或商业代码签名。

Voxenra v1.1.0

Voxenra v1.1.0

新增 MR 支持，完善多视口阅片、序列对比与工作区，并更新功能图集。

主要更新

• MR 与 Enhanced MR：支持经典单帧和增强多帧灰度 MR，按回波、扩散、时相及分量分组；提供自动调窗、反白、测量，规则序列支持 MPR 与 3D。
• 布局与多窗口：2D 预设／自定义网格、拖拽序列到视口、方向切换；MPR 多种布局及带切面参考的 3D 四宫格，页签可分离为独立窗口。
• 序列对比：2–4 序列 2D 对比、双序列 MPR 六宫格与对应切面放大；可控的位置、旋转、窗值与显示比例联动，各视口独立测量。
• 工作区与记录：保存／恢复影像引用、布局和操作状态，自动恢复副本；测量标注撤销重做、复制粘贴，支持 CSV / PDF 导出。
• 交互与稳定性：修复联动调窗实时显示、切片滑条与手册章节滚动状态；完善紧凑边栏、深浅主题及中英文界面。
• 文档与示例：重写精简 README，补充 30 张功能截图和 4D 动画，明确影像、归档和解码支持范围。

MR 重建以规则的单个浏览组为单位；分组浏览不包含 fMRI / DTI 分析或 MR 4D 播放。对比联动不执行自动配准。详见 影像支持说明。

下载

• macOS · Apple Silicon：Voxenra-1.1.0-macos-arm64.dmg，本地打包。
• Windows · x64：Voxenra-1.1.0-windows-x64-setup.exe（安装版）、Voxenra-1.1.0-windows-x64-portable.exe（便携版），由 GitHub Actions 构建。
• 三个安装包均对应 v1.1.0 标签源码，附 SHA-256 校验文件。

Voxenra v1.0.1

Voxenra v1.0.1

本次更新聚焦阅片交互、导入结果与界面一致性。

主要更新

• 平铺阅片修复：修复首张切片持续加载的问题；双击单张切片进入对应的 2D 视图并定位到该层。

• 鼠标与图标统一：修复平铺等视图中系统指针与自定义指针重复显示、跨切片拖动时图标重复的问题；更新 MPR 十字线旋转和 3D 裁剪图标，裁剪指针与工具图标一致。优化按钮悬停和按下反馈。

• 弹窗操作整理：应用内弹窗统一右上角关闭、固定底部取消与确认位置；主要操作、次要操作和删除采用不同颜色。优化 DICOM Tag 详情的尺寸、文字选择与复制。

• 导入结果重做：保留系统原生标题栏，去掉重复关闭按钮和内容区内框；调整状态、进度与结果布局，长错误可滚动和复制，底部保留关闭、取消导入及失败重试。导入进行中防止意外关闭进度窗口。

• 资源与代码清理：移除已被 SVG 替代的 21 个旧 PNG 图标、未使用组件、旧导入入口及过渡代码，清理约 9.8 MiB 的历史图标资源。

• 页签稳定性：修复关闭 3D 页签后重新打开时可能出现的控制器生命周期崩溃。

下载

• macOS · Apple Silicon：Voxenra-1.0.1-macos-arm64.dmg，由本机打包。
• Windows · x64：Voxenra-1.0.1-windows-x64-setup.exe（安装版）与 Voxenra-1.0.1-windows-x64-portable.exe（便携版），由 GitHub Actions 构建。
• 各安装包附带 SHA-256 校验文件；安装包均对应 v1.0.1 标签源码。

Voxenra v1.0.0

Voxenra v1.0.0

本次正式版汇总了自 v0.2.0 以来的导入、阅片、PET 重建与界面改进。

主要更新

• 统一影像导入：一个窗口混选 DICOM 文件、文件夹和压缩包，支持多选、路径定位与拖拽到应用或原生 3D 画面。新增 ZIP、RAR4 / RAR5（含固实压缩）、7z、TAR 及 GZ / BZ2 / XZ 等归档导入，后台解压扫描可取消，无需安装 WinRAR。PACS 继续支持 DICOMweb 查询、多序列下载与多连接配置。
• 独立 PET MPR 与 PET 3D：无需 CT 配对即可打开 PET 三视图或三维体绘制。提供实际可用的定量单位、显示范围、色表、阈值和透明度；PET 3D 支持裁剪、恢复与 PNG 导出。完善 PET/CT 融合、手动配准及独立融合 3D 工作流。
• 阅片与显示工具：CT 调窗增加数值输入、自定义模板保存与删除，窗值最多保留一位小数；MPR / 4D 同页签同步窗值与反白。新增首末页、前后 10 页与 1× / 2× / 5× / 10× 缩放快捷操作。平铺支持伪彩、CT 反白及序列详情折叠。
• 测量、标注与分析：区分绘制 / 编辑、选中已完成状态，优化线段抗锯齿；长度、角度、ROI、箭头和文字箭头支持 Ctrl+C / Ctrl+V（macOS 为 ⌘+C / ⌘+V）复制粘贴。两类箭头可调整线宽、大小与颜色。水模 QA 的操作步骤与指标说明集中到离线手册。
• 序列管理与工作区：序列列表独立滚动、稳定更新缩略图；支持批量移除和清空列表，保留源文件与已打开视图。收起侧栏后仍可通过缩略图使用右键菜单，并保留 PACS、手册与设置入口。工具栏宽度可拖动并保存，视图打开提供加载、取消和失败重试。
• 导出与界面完善：序列及视口导出默认开启匿名，明确区分源序列 PNG 与当前画面截图。统一工具顺序、指针与操作图标，优化顶部栏、原生窗口按钮、小视图文字、比例尺和三维界面；README 补充完整功能与导入方式说明。

本次重新打包

• MPR 旋转性能：优化十字线旋转及三视图“3D 旋转”的体素插值，减少重复索引与临时内存；保持采样分辨率。macOS 合成 CT 对照中，两幅重采样约 41 → 17 ms，三幅约 61 → 24 ms，实际提升随数据和设备而异。
• Windows 顶部栏与按钮反馈：恢复单一原生标题栏，修复重复 logo / 应用名称、无法拖动窗口和窗口按钮悬停变白；导航及右侧工具按钮统一增加悬停、按下与选中反馈。
• 导入稳定性：大批量扫描改为后台整理、限频更新，进度窗口显示枚举、解压和读取状态，提供取消、失败重试及明确的数量上限提示。窗口尺寸固定，长提示内部换行、滚动，底部按钮保持原位。
• 更小的安装包：移除未使用的 Qt 模块与旧图标原稿，保留 CT / PET 三维绘制和压缩包导入功能。macOS 使用 LZMA DMG，Windows 安装器提高整体压缩率。
• Windows 安装目录：默认使用 %LOCALAPPDATA%\Programs\Voxenra，不再自动沿用旧品牌目录；升级时刷新安装器管理的 Qt 运行库，减少旧组件残留。用户影像、设置与日志保留。
• 界面细节：右侧操作按钮横纵间距略微增大，改善按钮区的辨识与操作。

这是 v1.0.0 的重新构建，下载文件名和版本号不变，附件与 SHA-256 已更新；需要这些修复时请重新下载安装包。

本次安装包构建提交为 7767fdf，对应构建源码。现有 v1.0.0 Git 标签保持不变。

下载

• macOS · Apple Silicon：Voxenra-1.0.0-macos-arm64.dmg，由本机打包。
• Windows · x64：Voxenra-1.0.0-windows-x64-setup.exe（安装版）和 Voxenra-1.0.0-windows-x64-portable.exe（便携版），由 GitHub Actions 构建。

压缩包导入当前不支持加密包或分卷包；归档支持不代表新增 DICOM 像素编码。匿名导出清理身份元数据和截图文字，不自动擦除影像像素内烧录的文字或人脸。