更新日志

本文档记录 CZUR Open SDK 项目的重要版本变更。

[0.0.4] - 2026-07-24

新增

• Windows 运行时和打包补充 32-bit 支持。
• 新增 storage.cleanup_temp，用于清理 SDK 托管的已完成临时任务和缓存文件；存在活跃任务时拒绝清理。
• 采集配置新增 profile.output.quality 和 profile.output.target_size，可指定 JPG 输出质量和目标拍照输出尺寸档位。
• device.open 响应新增 capture_output.target_sizes，返回当前设备支持的目标输出分辨率选项。
• Demo 补充采集输出参数选择和临时存储清理验证页面。

修复

• 修复 OCR Demo 默认输出路径、Linux 清理目录兼容和部分打包校验问题。

兼容性说明

• 新增 command 方法：storage.cleanup_temp。
• 采集 profile 新增可选字段：output.quality、output.target_size。
• device.open 响应新增可选字段：capture_output。

[0.0.3] - 2026-07-10

新增

• 新增 device.added 设备接入通知，Demo 可在设备热插拔后自动刷新授权范围内的设备列表。
• 硬拍事件现在可直接创建异步采集任务，并复用当前预览/采集配置和图像增强流程。
• 授权上下文补充返回状态信息，便于客户端展示当前可用能力、购买等级和试用态。

变更

• 优化设备移除事件：已打开或正在预览的设备返回精确 device_id，未打开设备仅提示设备列表变化，避免暴露未授权设备信息。
• ocr.recognize 在 Linux PDF/OFD 导出中使用独立临时目录处理质量参数，识别仍基于原始输入图片，避免压缩影响识别效果。
• file.convert.options.quality 明确继续作为公开质量参数使用，用于图片层或页面渲染输出质量控制。
• 优化 API Key 的正式态、试用态和本机激活状态处理，使不同授权模式下的能力判断更稳定。

修复

• 修复部分授权状态被默认值覆盖的问题，避免状态展示和能力判断不一致。
• 修复离线本机激活状态恢复问题，提升重启后的授权状态稳定性。
• 修复 Windows 运行时加载私有授权 DLL 和拷贝私有 Provider 依赖的问题。
• 修复设备关闭、视频停止和设备拔出同时发生时的清理与错误语义，减少残留预览、挂起采集和重复事件。

兼容性说明

• 新增 command 事件：device.added。
• 授权上下文有状态字段补充；旧版离线 Key 与既有本地限额行为保持兼容。

[0.0.2] - 2026-06-26

新增

• 新增 sdk_open_app.exe 的 Windows Service 模式，同时保留控制台启动方式，便于调试。
• 新增采集流程中的设备动作与移除支持，包括 capture.set_turn_detect、capture.turn_detected、capture.hardgrab_detected 和 device.removed。
• 新增 OCR 可下载任务资产和运行时版本元信息。

变更

• ocr.recognize 在未传入 output_path / output_dir 时可使用 SDK 托管输出路径，支持 output_format 作为 format 别名，并返回可下载的 task.assets。
• video.set_profile 同时支持嵌套和内联 profile 参数；capture.get 返回标准化任务结构。
• 优化授权上下文响应，以及 Demo 站点 command/video WebSocket 端口配置能力。

修复

• 修复本地授权、离线激活、授权上下文序列化和会话缓存稳定性问题。
• 修复设备视频启动/停止、视频格式设置、设备关闭清理和采集任务异常处理问题。
• 修复 OCR 导出/下载响应、Demo 路由与运行事件展示、SANE 不可用响应，以及 Windows 构建/private Provider 兼容问题。

兼容性说明

• 新增 command 方法：capture.set_turn_detect。
• 新增 command 事件：capture.turn_detected、capture.hardgrab_detected、device.removed。
• 新增设备动作/事件 Provider 可选接口；默认实现保持旧 Provider 兼容。

[0.0.1] - 2026-06-17

新增

• 引入 CZUR Open SDK 独立运行时入口 sdk_open_app。
• 建立 transport、application、facade、provider interface 四层运行时结构。
• 增加本地 admin、demo、asset HTTP 服务。
• 增加 command WebSocket，支持 system、auth、device、video、capture、image、file conversion 等指令。
• 增加 video WebSocket，用于预览帧流和相关视频事件输出。
• 增加基于 API Key 的会话创建、会话刷新、会话销毁、授权上下文查询和离线 API Key 解封流程。
• 增加带 quota 控制的拍摄、图像处理、页面处理、色彩模式应用和文件转换业务方法。
• 增加 device、graphic、image enhancement、OCR、OFD、recognition、SANE、authorization 等能力的公共 provider interface 和 DTO。
• 增加 mock provider 组合，使运行时可在不暴露私有能力库类型的前提下独立构建和体验。
• 增加内置 admin 和 demo Web 站点，用于本地运行时管理与 SDK 工作流验证。
• 增加运行时架构、指令通道流程和 SDK 错误码等公开文档。

平台

• Linux 是首个已实现平台。
• Windows 和 macOS 支持计划在后续版本中逐步补齐。