0.2.7

@grapecity-software/dsh-spreadjs-editor 0.2.7

中文

隔离授权及初始化失败，保留 DSH 侧栏可用性

• 隔离 SpreadJS / Designer 初始化与文档渲染错误，失败时显示当前页面来源和授权排查提示，避免异常冒泡并破坏 DSH sidebar。
• 初始化失败后清理局部 DOM 和已创建实例；销毁时先撤销工作簿与 Driver 租约，分别处理恢复、事件解绑及 SDK 销毁异常。
• 主题切换触发的工作簿刷新异常交由文档错误页处理，避免中断 DSH 的主题事件。
• 避免正常关闭时重复销毁 Workbook；Designer 已负责销毁它持有的工作簿。
• 补充桌面版 dsh-app://app/ 授权说明、配置位置和测试步骤，修正「留空即能试用」的描述。

English

Contain licensing and initialization failures within the editor

• Contain SpreadJS / Designer initialization and document rendering failures within the editor, with page-origin and licensing guidance.
• Clean up partially initialized instances and DOM; revoke Workbook access and Driver leases before independently guarded recovery and disposal steps.
• Contain workbook refresh failures during theme changes without interrupting DSH's theme event.
• Avoid destroying a Workbook twice on normal close: Designer owns its workbook's disposal.
• Document desktop licensing for dsh-app://app/, profile configuration, regression steps and the limits of keyless evaluation.

0.2.6

@grapecity-software/dsh-spreadjs-editor 0.2.6

中文

放宽 DSH 兼容范围，修复保存与恢复中的数据丢失风险

• DSH 兼容声明和 UI peer 范围调整为 >=0.2.1-rc.3 <0.3.0-0，开发依赖继续固定在 0.2.1-rc.4。同一范围内的 patch 和 RC 不再要求逐个发布插件；扩展到新的 DSH 次版本前先验证 API 和运行行为。
• 保存期间继续编辑时，新改动仍标为未保存；关闭或切换标签页后，稍后完成的旧保存不会清除新留下的恢复快照。
• 另存为只写入了较早内容时，保留当前文件和后续改动，并提示继续保存；文档已关闭或切走时，不再因旧任务完成而自动跳转。
• 串行载入同一工作簿，避免旧加载最后完成并覆盖新内容。载入失败或导出期间工作簿发生切换、重新加载时，拒绝写入过时内容。
• 在同一宿主进程内，串行执行同一文件的冲突检查与写回，拒绝基于旧文件版本的后续保存；读取文件状态失败时停止写入。
• 保留延迟加载或临时重载的桥选择，避免其他桥先注册时清空用户设置；设置页会提示所选桥暂不可用，并允许改选或选择「不使用」。
• 打开工作簿支持取消信号：导航前拒绝已取消的请求，取消后停止加载等待并释放打开锁。

升级说明： 建议与 Driver 0.1.4 配套升级，完成打开任务的取消处理。恢复快照仍仅在当前页面生命周期内有效；取消不会撤销已发生的导航或已发送的写入。

验证： 类型检查、240 项单测、构建、两个 smoke 和独立离线包安装校验通过；用户在 DSH 0.2.1-rc.4 dev 环境做过基本回归，未发现问题。rc.3、rc.4、rc.5 相关 UI API 包实现比对无差异，桌面运行验证基线为 rc.4。

English

Broaden DSH compatibility and fix save and recovery data-loss risks

• Declare DSH and UI peer compatibility as >=0.2.1-rc.3 <0.3.0-0, keeping development dependencies pinned to 0.2.1-rc.4. Patch and RC updates within this range no longer require individual plugin releases; verify APIs and runtime behavior before supporting a new DSH minor.
• Keep edits made during a save marked as unsaved. An earlier upload finishing after a tab closes or switches no longer clears its newer recovery snapshot.
• Keep the current file and later edits when Save As wrote an older revision, and explain that another save is needed. A completed Save As no longer navigates after its document has closed or switched away.
• Serialize imports into one Workbook so an older load cannot overwrite newer contents. Refuse stale exports after a load failure, workbook switch or reload.
• Serialize conflict checks and writes to each file within the same host process, rejecting subsequent saves based on an outdated version. Stop writes when file metadata cannot be read.
• Preserve bridge selections during delayed registration and temporary reloads. Settings explains unavailable selections and lets users choose another bridge or None.
• Accept cancellation signals when opening workbooks: refuse cancelled requests before navigation, stop readiness waits and release the opening lock.

Upgrade notes: Update together with Driver 0.1.4 for complete opening cancellation support. Recovery snapshots remain limited to the current page lifetime. Cancellation does not undo navigation or writes already sent.

Validation: Typecheck, 240 tests, build, both smokes and an independent offline package installation passed. The user completed basic development desktop checks on DSH 0.2.1-rc.4 without finding issues. Relevant UI API implementations compare without differences across rc.3, rc.4 and rc.5; desktop runtime validation is on rc.4.

0.2.3

中文

增强 AI 协作与工作簿恢复

• 完善桥接协议，支持兼容 Driver 接入；由用户在「设置 → 电子表格编辑器」中明确选择。
• 支持 Driver 请求打开工作区文件，等待工作簿加载完成后执行操作。
• 增加 AI 执行期间的独占编辑保护，以及关闭、切换后的未保存内容恢复；恢复缓存仅在当前页面生命周期内有效。
• 按聊天、文件和加载实例隔离任务与恢复缓存；完善取消检查，阻止取消后的后续自动保存。
• 中文版 SpreadJS、Designer、IO、语言资源及全部扩展升级至 19.2.1。
• 适配 DSH 0.2.0-rc.2，需要 Node.js ≥22.19。

升级提示： 本版支持范围统一为 DSH 0.2.0-rc.2。请同步升级配套 Driver，使用完整的实例身份、独占锁与恢复协议。低版本 SpreadJS 打开本版保存的文件前，请确认格式兼容性。

English

Improve AI collaboration and workbook recovery

• Extend the bridge contract for compatible drivers, selected explicitly under Settings → Spreadsheet Editor.
• Allow drivers to request a workspace file and wait until its Workbook is ready.
• Protect the editor with an exclusive lease during AI work; preserve unsaved snapshots when the editor closes or switches. Recovery lasts only for the current page lifetime.
• Isolate tasks and recovery by chat, file and load instance; check cancellation before subsequent automatic saves.
• Upgrade the complete Chinese SpreadJS / Designer / IO / resources / extension suite to 19.2.1.
• Target DSH 0.2.0-rc.2 and require Node.js ≥22.19.

Upgrade notes: This version supports DSH 0.2.0-rc.2. Update the companion Driver together for the complete identity, lease and recovery protocol. Check file-format compatibility before opening files saved by this build in an older SpreadJS version.