@grapecity-software/dsh-spreadjs-editor 0.2.6 → 0.2.8

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Release Notes / 版本记录
 
+## 0.2.8
+
+### 中文
+
+- 精简中英文 README，集中说明安装、保存、可选 Driver 和授权配置；明确恢复快照只在当前页面内存中，刷新或关闭页面后不保留。
+- 统一桌面授权要求：必须取得适用于该场景、同时覆盖 SpreadJS 和 Designer Component 的无限制授权；没有该授权，桌面版无法使用本编辑器。移除桌面配置指引和本地授权试验记录。
+- 删除已不可达的新建/下载导出内部接口及辅助代码、Node 20 构建补丁、冗余成功日志和过时注释；保留保存、另存为、恢复及 Driver 桥接协议。
+- 清理过时发布 TODO，将可复用的发布流程和手工回归步骤整理到 `docs`；依赖安装统一使用已提交的 pnpm 锁文件。
+
+**升级说明：** 建议与 Driver `0.1.5` 配套使用；Driver 本次同步发布文档与工程清理。DSH 兼容范围和内置 SpreadJS / Designer 版本保持不变。
+
+**验证：** 类型检查、260 项测试、构建、客户端与宿主 smoke、独立离线包安装校验通过。
+
+### English
+
+- Simplify both README languages around installation, saving, the optional Driver, and licensing. Clarify that recovery snapshots live only in page memory and do not survive a page refresh or close.
+- Require applicable unrestricted licenses covering both SpreadJS and Designer Component for desktop use; without them, the editor cannot be used in the desktop app. Remove desktop configuration instructions and local licensing experiments.
+- Remove unreachable internal New/Download Export interfaces and helpers, the Node 20 build polyfill, redundant success logs, and outdated comments. Retain saving, Save As, recovery, and the Driver bridge contract.
+- Replace obsolete release TODOs with reusable release and manual regression documents. Use the committed pnpm lockfile for dependency installation.
+
+**Upgrade notes:** Use companion Driver `0.1.5`, released alongside this version with documentation and project cleanup. The DSH compatibility range and bundled SpreadJS / Designer versions are unchanged.
+
+**Validation:** Typecheck, 260 tests, build, client and host smokes, and independent offline package installation passed.
+
+## 0.2.7
+
+### 中文
+
+**隔离授权及初始化失败，保留 DSH 侧栏可用性**
+
+- 隔离 SpreadJS / Designer 初始化与文档渲染错误，失败时显示当前页面来源和授权排查提示，避免异常冒泡并破坏 DSH sidebar。
+- 初始化失败后清理局部 DOM 和已创建实例；销毁时先撤销工作簿与 Driver 租约，分别处理恢复、事件解绑及 SDK 销毁异常。
+- 主题切换触发的工作簿刷新异常交由文档错误页处理，避免中断 DSH 的主题事件。
+- 避免正常关闭时重复销毁 Workbook；Designer 已负责销毁它持有的工作簿。
+- 补充授权要求，修正「留空即能试用」的描述；当前策略见[桌面授权策略](docs/desktop-licensing.md)。
+
+**范围说明：** 本版保留 SDK 的授权校验，失败时显示当前文件的提示。无须配套升级 Driver，继续使用 `0.1.4`。
+
+**验证：** 类型检查、260 项测试（含真实 React 调度下的初始化失败与侧栏隔离）、构建、客户端 / 宿主 smoke 和独立离线包安装校验通过。
+
+### 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 licensing requirements and the limits of keyless evaluation; see the current [desktop licensing policy](docs/desktop-licensing.md).
+
+**Scope:** SDK license validation remains in place; failures display a document-local message. Companion Driver `0.1.4` remains suitable.
+
+**Validation:** Typecheck, 260 tests (including real React initialization-failure and sidebar-isolation tests), build, client / host smokes and independent offline package installation passed.
+
 ## 0.2.6
 
 ### 中文
@@ -16,7 +70,7 @@
 
 **升级说明：** 建议与 Driver `0.1.4` 配套升级，完成打开任务的取消处理。恢复快照仍仅在当前页面生命周期内有效；取消不会撤销已发生的导航或已发送的写入。
 
-**验证：** 类型检查、240 项单测、构建、两个 smoke 和独立离线包安装校验通过；用户在 DSH `0.2.1-rc.4` dev 环境做过基本回归，未发现问题。rc.3、rc.4、rc.5 相关 UI API 包实现比对无差异，桌面运行验证基线为 rc.4。
+**验证：** 类型检查、240 项单测、构建、两个 smoke 和独立离线包安装校验通过；用户在 DSH `0.2.1-rc.4` dev 环境做过基本回归，未发现问题。rc.3、rc.4、rc.5 相关 UI API 包实现比对无差异，开发运行验证基线为 rc.4。
 
 ### English
 
@@ -32,7 +86,7 @@
 
 **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.
+**Validation:** Typecheck, 240 tests, build, both smokes and an independent offline package installation passed. The user completed basic development 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; development runtime validation is on rc.4.
 
 ## 0.2.5
 

package/README.md

@@ -1,169 +1,56 @@
 # SpreadJS Editor for DeepSeek Harness
 
-[GitHub](https://github.com/GrapeCityXA/dsh-plugin-spreadjs-editor) · npm: `@grapecity-software/dsh-spreadjs-editor`
+[中文](#中文说明) · [English](#english) · [GitHub](https://github.com/GrapeCityXA/dsh-plugin-spreadjs-editor) · [npm](https://www.npmjs.com/package/@grapecity-software/dsh-spreadjs-editor) · [版本记录 / Changelog](CHANGELOG.md)
 
-[版本记录 / Release Notes](CHANGELOG.md)
+在 DeepSeek Harness Web UI 的文件树中打开 Excel / SpreadJS 文件，使用 Designer 编辑并保存回工作区。
 
-在 DeepSeek Harness Web UI 里，直接在右侧文件树中打开、查看和编辑 Excel / SpreadJS 文件。
+Open Excel / SpreadJS files from the DeepSeek Harness Web UI file tree, edit them in Designer, and save back to the workspace.
 
-A DeepSeek Harness Web UI plugin that opens, views, and edits Excel / SpreadJS files directly from the right-side file tree.
-
-![SpreadJS editor opened in DeepSeek Harness Web UI](https://raw.githubusercontent.com/GrapeCityXA/dsh-plugin-spreadjs-editor/main/assets/dsh-spreadjs-editor.png)
-
----
+![SpreadJS editor in DeepSeek Harness Web UI](https://raw.githubusercontent.com/GrapeCityXA/dsh-plugin-spreadjs-editor/main/assets/dsh-spreadjs-editor.png)
 
 ## 中文说明
 
-### 功能
-
-- 支持 `.xlsx`、`.xlsm`、`.csv`、`.sjs`、`.ssjson` 文件。
-- 从文件树打开工作簿，使用 SpreadJS Designer 编辑表格。
-- 编辑后可直接保存回原文件：原子写入、限制在会话工作区内、带冲突检测。保存按钮在 DSH 文档头部自己的工具栏上，未保存时带一个标记点；它与「另存为…」的尺寸、字号、颜色都按 DSH 头部自身控件的规格绘制，而且**只在表格文件上出现**。
-- 「另存为」可以把当前工作簿（含新建的空白工作簿）写进工作区的另一个路径，成功后就地切换到那个文件；同名文件不会被覆盖。
-- 编辑器跟随 DSH 的浅色/深色主题，工具栏与工作表区域一起变；DSH 偏好设为「跟随系统」时自然跟着系统走。
-- 「设置」标签里有「关于」按钮：内置版本、授权状态与版权信息在弹窗里。
-
-### 配合 SpreadJS Driver 使用
-
-本插件**单独使用就是完整的**：打开、编辑、保存工作簿都不需要别的插件。但配上 driver，它会多出一件单独做不到的事——**让 AI 直接改你屏幕上这份表**。
-
-本编辑器通过公开的[SpreadJS 桥接契约](docs/bridge-contract.md)支持其他 driver：driver 登记到 `spreadjsBridgeRegistry`，由用户选择后获取真实 Workbook 引用，无需依赖本 editor 的 npm 包。配套 [`@grapecity-software/dsh-spreadjs-driver`](https://www.npmjs.com/package/@grapecity-software/dsh-spreadjs-driver) 是其中一种实现，也能接入其他符合该契约的 SpreadJS editor。使用同一引擎之外，还需遵守实例身份、独占锁、取消和保存协议，并核对 SpreadJS 版本及模块支持。
-
-本包不依赖任何 driver。SpreadJS、Designer 及扩展作为开发/构建依赖内联进浏览器产物，实例和授权始终由 editor 管理；DSH 与 React peers 由宿主提供。配套 Driver 不再包含 SpreadJS、Designer 或无头浏览器引擎。第三方 driver 使用自己的唯一 id；如需从服务端读取本 editor 的选择，设置文档命名空间为 `spreadjs-editor`，字段为 `bridge`。
-
-#### 安装
+### 安装
 
-两个插件都装在**同一个 web profile** 下——driver 的活工作簿能力只存在于 Web UI 里：
+需要 DSH `>=0.2.1-rc.3 <0.3.0-0`、Node.js ≥22.19。插件内置 SpreadJS 和 Designer `19.2.1`，使用 DSH 自带侧栏，无需额外侧栏插件或本地编译。使用前请确认下方的[授权要求](#授权与配置)。
 
 ```sh
-dsh plugin --profile web add @grapecity-software/dsh-spreadjs-editor@0.2.6
-dsh plugin --profile web add @grapecity-software/dsh-spreadjs-driver@0.1.4
+dsh plugin --profile web add @grapecity-software/dsh-spreadjs-editor@0.2.8
 dsh --profile web
 ```
 
-装完重启 DSH，打开任意一个表格文件，然后在 **设置 → 电子表格编辑器** 里选中 **SpreadJS Driver**。（没装任何 driver 时这一页只有「不使用」一项，编辑器行为与本功能不存在时完全一样。）
-
-> 「装了」不等于「激活」：两个包都必须出现在 profile 的 `dsh.profile.bundles` 里。光 `pnpm add` 或 `dsh plugin add` 不一定替你写进去，装完请开一个真实会话确认工具确实在场。
-
-#### 两边是怎么配合的
-
-编辑器**持有**你打开的那份工作簿，每个 driver **登记**为候选人；名册里可以有多个（比如我们的测试夹具），但**只有一个**会拿到工作簿——就是你在设置里选中的那一个。
-
-- **递出去的是活引用，不是副本。** 工作簿从不离开页面、也从不被序列化，所以通过它写的样式、公式、格式，当场就出现在表格里。
-- **默认不落盘。** AI 的改动先活在工作簿里，你看着满意了它才会要求保存。保存走的还是文档头部那颗「保存」，因此冲突检测、工作区围栏、原子写入一条都不少。
-- **名册只认被选中的那个。** 设置里改选别人、或选「不使用」，driver 的**全部**工具与 skill 都会让位。这个设置命名的是「谁来管这里的电子表格」，而不只是「谁暂时拿着这份活文档」。
-- **编辑器始终是守门人。** 名册是候选人列表，不是广播。没有被递到工作簿的插件，没有任何办法去够到它。
+安装后重启 DSH，在 Web UI 右侧文件树中打开 `.xlsx`、`.xlsm`、`.csv`、`.sjs` 或 `.ssjson` 文件。
 
-选中 driver 后，AI 获得 `sjs_live_open`、`sjs_live_execute` 和 `sjs_live_status`。没有打开工作簿时，driver 可以请求 editor 打开文件并等待初始化；新文件可由 driver 从准备好的空白模板复制，Workbook 仍由 editor 创建和持有。
+若插件未生效，检查当前 profile 的 `dsh.profile.bundles` 中是否已启用该插件。升级说明见 [CHANGELOG](CHANGELOG.md)。
 
-已保存的桥选择会在插件延迟加载、重载或卸载后保留。所选桥暂未注册时，设置页会显示「当前不可用」及它的 id；它重新加载后会自动连接，也可以手动选择其他桥或「不使用」。其他桥先加载不会清空这项设置。
+### 使用与保存
 
-driver 执行期间 editor 会显示操作中提示，禁用 Designer 的鼠标/键盘编辑及冲突的保存、另存为、新建、导出入口。若用户关闭或切换 editor，销毁 Workbook 前会保存当前快照到现有恢复缓存，driver 返回中断；重新打开文件后检查已恢复的部分，再继续任务。该缓存只在当前页面生命周期内有效，不跨页面刷新，也不恢复 JavaScript 的执行位置。快照失败会明确写入控制台日志。
+- **保存**：使用文档头部的「保存」或 `Ctrl+S` 写回原文件；「另存为…」写到工作区的另一路径，不覆盖已有文件。
+- **冲突保护**：文件加载完成后才能保存；若磁盘文件已被其他程序修改，保存会被拒绝。保存路径必须在当前会话工作区内。
+- **未保存改动**：切换或关闭文档时保留恢复快照，重新打开可恢复；磁盘文件已变化时，由用户选择恢复或丢弃。**快照仅在当前页面内存中，刷新或关闭页面后不保留，请及时保存。**
+- **界面**：跟随 DSH 明暗主题。Designer 的「设置 → 关于」显示内置版本及授权配置状态；「已配置」不代表授权已验证有效。
 
-driver 的状态和执行按调用聊天隔离，并绑定当前文件的加载实例；重新加载即更新实例身份。恢复缓存使用完整聊天资源地址，不同聊天的同名文件不会互相恢复或清理。取消或超时后阻止后续自动保存；异步导出结束、写回之前再次检查任务权限。忽略取消信号的脚本仍持有编辑锁，直到结束或实例被销毁。已发送的写入可能完成，因此取消不能保证回滚。两侧插件需同时更新以支持实例身份协议。
+Designer 自带的「文件」标签已隐藏，其新建、导入、导出、打印等入口暂不可用。低版本 SpreadJS 可能无法打开本版本保存的 `.sjs` / `.ssjson` 文件，与旧系统交换文件时请保留原文件并确认兼容性。
 
-#### 要求
+### 让 AI 操作工作簿（可选）
 
-- **请同步升级 editor 与 driver**，以使用完整的实例身份、独占锁和恢复协议。
-- **两侧声明支持 DSH `>=0.2.1-rc.3 <0.3.0-0`**：桥选择页使用 `settings.section`，选择结果保存在 editor 的设置文档中。开发依赖固定在已验证的 rc.4；rc.3 到 rc.5 的相关 UI API 实现无差异，当前桌面环境验收基线为 rc.4。
-- **driver 前提**：Node ≥22.19、同一 web profile 中的 editor 和可用的前端连接。服务端无需安装 Chrome/Edge。
-
-### 内置版本与文件兼容性
-
-| 组件 | 内置版本 |
-| --- | --- |
-| SpreadJS | 19.2.1 |
-| SpreadJS Designer | 19.2.1 |
-
-内置版本、授权状态与版权信息在 Designer「设置」标签的「关于」弹窗里。低版本 SpreadJS 可能无法打开本版本保存的 `.sjs` 或 `.ssjson` 文件；与旧版系统交换文件时，建议保留原文件并确认兼容性。
-
-### 安装
-
-Editor `0.2.6` 声明支持 DSH `>=0.2.1-rc.3 <0.3.0-0`，需要 Node.js ≥22.19；用户已确认 rc.4 的 dev 环境运行正常。插件使用 DSH 自带的右侧栏，**不需要安装任何第三方侧边栏插件**。新 DSH 次版本需验证 API 后再扩展支持范围。
-
-| DSH 版本 | 状态 | 说明 |
-| --- | --- | --- |
-| `>=0.2.1-rc.3 <0.3.0-0` | 声明兼容范围 | 覆盖 DSH 0.2.x 从 rc.3 起的版本；rc.3/rc.4/rc.5 UI API 包实现对比无差异 |
-| `0.2.1-rc.4` | 桌面环境验收基线 | 类型检查、240 项单测、构建、两个 smoke 与包安装校验通过；用户已确认 dev 环境运行正常 |
-
-**版本策略：** `engines.dsh` 与 DSH API peers 使用同一有界范围；范围起点取插件所需 API 的最低版本，上界停在下一条 DSH 次版本线。范围内的 patch 和 RC 不要求每次发布插件；开发依赖固定在最近通过验证的 RC。扩展到新的 DSH 次版本前，先比较 API 并跑安装/运行 smoke，再发布更新后的兼容声明。
-
-请同步使用 Editor `0.2.6` 与 Driver `0.1.4`；旧版插件的精确版本声明可能导致安装被拒绝。
-
-当前验收的 rc.4 提供工作簿所需的二进制后缀声明、内置只读预览、文档头部动作槽 `sidebar.right.tab.document.actions` 和设置分区 `settings.section`。兼容声明限定在 DSH 0.2.x 主线。
-
-插件内置 SpreadJS 和 Designer，无需编译。使用已安装的 DSH CLI 安装并启动：
+Editor 可以独立使用。需要 AI 操作工作簿时，将 [SpreadJS Driver](https://github.com/GrapeCityXA/dsh-plugin-spreadjs-driver) 安装到同一个 `web` profile：
 
 ```sh
-dsh plugin --profile web add @grapecity-software/dsh-spreadjs-editor@0.2.6
-dsh --profile web
+dsh plugin --profile web add @grapecity-software/dsh-spreadjs-driver@0.1.5
 ```
 
-启动后，在 Web UI 右侧文件树中打开 `.xlsx`、`.xlsm`、`.csv`、`.sjs` 或 `.ssjson` 文件即可。
+重启 DSH，在「设置 → 电子表格编辑器」中选择 **SpreadJS Driver**，即可让 AI 打开和修改当前聊天中的工作簿。选择「不使用」可停用 Driver。
 
-也可以通过 npx 安装并启动：
+AI 改动默认不落盘，可通过工具请求保存或手动保存。执行期间暂停手动编辑；取消不会撤销已产生的改动，已发送的写入仍可能完成。第三方 Driver 接入及执行规则见[桥接契约](docs/bridge-contract.md)。
 
-```sh
-npx --yes @deepseek-ai/dsh@0.2.1-rc.4 plugin --profile web add @grapecity-software/dsh-spreadjs-editor@0.2.6
-npx --yes @deepseek-ai/dsh@0.2.1-rc.4 --profile web
-```
-
-旧版本用户请参阅[升级说明](CHANGELOG.md)。
-
-### 保存
-
-保存的正式入口是 **DSH 文档头部自己的工具栏**（打开工作簿后，文件名旁边那颗「保存」）。它注册在 DSH 的官方动作槽 `sidebar.right.tab.document.actions` 里，与其它查看器的控件排在一起；有未保存改动时，「保存」前会多一个标记点，像 Excel 标题栏的 `*`。改动写回你打开的那个文件，不会再问你"要不要保存"，因为按下保存本身就是你的意图。
-
-同一份写回也挂在 **`Ctrl+S` 和 Designer 工具栏上的保存按钮**上：插件把 Designer 的 Save 命令重定向到写回，所以这两处按下都不会再弹出下载框。（Designer 自带的「文件」标签页已从 Ribbon 上隐藏，见本节末尾。）
-
-这两颗头部按钮并不引用 DSH 的按钮组件——第三方客户端插件不能假定内部的 `@deepseek-ai/*` 包在运行时一定可解析，解析失败会连编辑器一起挂掉——而是照抄了邻居的规格：28px 高、`padding: 0 6px`、12px 字号、常态 `--dsw-alias-label-secondary`，悬停转 `--dsw-alias-label-primary` 并给 `--dsw-alias-interactive-bg-hover` 底色，禁用转 `--dsw-alias-label-tertiary` 且不再响应。也就是头部「查看器名称」与图标按钮的那一套；有一条单测钉住这些数值，避免以后悄悄漂移。
-
-它们**只在本插件负责的文件上画出来**。这个动作槽对每个预览文件都会渲染，所以按钮要在插件自己的编辑器占据屏幕时才出现——否则工作区里每个 Markdown、图片、日志旁边都会多两颗按不动的按钮。产品自己的「用本地应用打开」也是这个形状：没有可打开的应用时就什么都不画。
-
-顺序上它们排在「用本地应用打开」**之前**。槽位是 list，条目按公开的 `order` 排序（先 `priority`，再 `order`，最后才轮到注册顺序），插件注册在 `-10` —— 而这正是 DSH 自己给「头部动作里排第一」用的值（`dsh-client-ui-agent-preset` 注册会话头部标签时就是 `order: -10`）。这样「先保存、再考虑外部打开」是确定的阅读顺序，也不再受插件加载顺序影响；未保存的标记点也因此落在这一组的第一项上，一眼就能看到。
-
-Designer 自带的「文件」标签页已经**从 Ribbon 上隐藏**：插件不再改写它的私有菜单模板（那段改写已删掉），也不让它留在那里——因为「文件」页里的保存是**下载副本**，与上面那颗**写回**的保存只隔一次点击，两颗都在就是误存副本的来源。现在这个编辑器里只有一处保存：文档头部的「保存 / 另存为…」，加上 `Ctrl+S`。
-
-代价是「文件」页里的其它分类（新建、打开、导入、导出、打印、信息）也一并看不到了——这是隐藏整页的必然结果，如果你需要其中某一项，告诉我，我们把它单独接回 Ribbon。隐藏方式是按产品公开的命令名（`CommandNames.FileMenuButton`）加它模板画出的元素类名做一条 CSS，作用域限定在本插件的面板内；这条规则有单测钉住，创建编辑器时控制台也会回报命中的元素数与它实际算出的 `display`，所以将来产品改名、规则失效会被看见，而不是悄悄多出一颗下载按钮。
-
-- **工作簿还没载入完时不让保存。** 载入中的工作簿是空的，此时保存会用空表覆盖原文件；载入完成前保存命令会拒绝并说明。
-- **不会冲掉别人的修改。** 打开文件时插件记下其内容哈希；保存前重新比对，若磁盘上的文件在此期间被改过（Agent 改过、你在别处存过），保存会被拒绝并说明原因，而不是覆盖掉那些改动。
-- **不会写出半个文件。** 同目录临时文件写完后 rename 覆盖，其他程序任何时候读到的都是完整文件。
-- **写不出工作区。** 目标必须在当前会话的工作区内，越界（含 `..` 逃逸）直接拒绝。
-- **只有循环回环地址可用。** 保存接口与 DSH 其它接口一样只服务本机来源；通过局域网地址访问时，需要把该地址加进 `trustedHosts`。
-
-### 另存为
+### 授权与配置
 
-头部工具栏上的「另存为…」把当前工作簿写到工作区的**另一个**路径——包括在 Designer 里重新置空的空白工作簿。它不碰原来那个文件。
+插件代码采用 [MIT 许可证](LICENSE)，**不包含 SpreadJS 或 Designer Component 的商业授权**。两个组件需要分别配置适用的授权；无 key 本地试用仅限供应商试用条款允许的 HTTP(S) 回环环境。正式部署或 SaaS 服务需获取适用于实际场景的授权。
 
-- **默认目标**：同目录、同后缀，文件名后面加「副本」（`报表.xlsx` → `报表-副本.xlsx`）。
-- **成功后就地切换**：当前内容完整写入且文档仍在时，这个标签页直接打开新文件继续编辑；若期间产生新改动，则保留当前文件并提示继续保存。已关闭或切走的文档不会因旧任务完成而跳转。
-- **同名不覆盖**：目标已存在时宿主会拒绝写入（写回要求带版本基线，另存为没有），对话框直接说「目标文件已存在，请换一个名字」，而不是默默覆盖。
-- **只接受 5 种后缀**：`.xlsx`、`.xlsm`、`.csv`、`.sjs`、`.ssjson`。写出格式由后缀决定，其它后缀会写出打不开的文件，所以在提交前就拦下。
-- **越界同样被拒**：路径解析与围栏由宿主按写回那一套规则判定，工作区之外一律拒绝。
-- **写不进去的另一种可能**：正在载入或另一次保存尚未结束时，对话框会说「编辑器还没准备好」，不会假装成功。
+**桌面环境需要同时覆盖 SpreadJS 和 Designer Component 的适用无限制授权；没有该授权，桌面版无法使用本编辑器。** 详见[桌面授权策略](docs/desktop-licensing.md)。
 
-### 未保存的改动
-
-DSH 在标签页被切走时会卸载文档主体，平台也没有可供拦下的关闭钩子（关闭是同步的，文档定义里既无生命周期也没有否决点），所以这里**不做「确认离开」的拦截**，而是保证不丢：
-
-- **切走再切回不丢。** 有未保存改动的工作簿会在主体卸载前留成一份快照，切回同一个标签页时原样恢复，不需要重新读盘。
-- **关掉标签页也不丢。** 快照同时按文件路径保留；重新打开同一个文件时，只要磁盘上的文件仍是快照写下的那一版，就自动恢复，并在面板右下角的胶囊里说明来源。
-- **文件被外部改过时不默默套用。** 若磁盘上的文件已经变了（Agent 改过、你在别处存过），面板右下角会浮出一个胶囊提示「存在未保存的改动缓存，但文件已在磁盘上被修改」，由你选择**恢复**（用缓存继续，之后保存即写入磁盘）或**丢弃**（重新读盘）。
-- **看得见，而且有两处。** 头部工具栏的「保存」在有未保存改动时带一个标记点（像 Excel 标题栏的 `*`）；面板右下角另有一个浮动胶囊，显示「未保存的改动」与「丢弃」操作。胶囊悬浮在表格上方，不占布局高度，当前内容全部保存后消失。
-- **整页关闭会提示。** 刷新或关闭页面时，只要还有未保存的改动（含已留存的缓存），浏览器会弹出一次自己的离开确认。
-- **保存当前内容后清空。** 当前内容完整写入后，该文件的快照清除；保存期间的新改动仍保留未保存标记，切走或关闭后留下的较新快照不会被旧保存清掉。
-
-### 配置
-
-如已获得许可证，在 web profile 的 `cordis.patch.yml` 中添加以下配置：
-
-| Key | 默认值 | 说明 |
-| --- | --- | --- |
-| `licenseKey` | `''` | SpreadJS 部署许可证。留空以带水印的试用模式运行。 |
-| `designerLicenseKey` | `''` | 独立的 SpreadJS Designer 部署许可证。留空保持 Designer 试用状态。 |
-| `maxSaveBytes` | `67108864` | 单次保存允许的最大字节数；超出直接拒绝，不做截断。 |
-| `trustedHosts` | `[]` | 除本机回环地址外，额外允许调用保存接口的地址（局域网部署时使用）。 |
+在 `web` profile 的 `cordis.patch.yml` 中更新已有的 `spreadjs-editor` 配置项，保留其他字段：
 
 ```yaml
 - id: spreadjs-editor
@@ -172,179 +59,58 @@ DSH 在标签页被切走时会卸载文档主体，平台也没有可供拦下
     designerLicenseKey: 'YOUR_DESIGNER_KEY'
 ```
 
-修改后重启 DSH 并刷新网页。
-
-还有一项**不写在这里**：`bridge` 是「电子表格编辑器」设置页在 Web UI 里写的，代表用户选了哪一个桥。它同样属于本插件的配置，但**不该手写进 patch**——设置页会把写入结果如实报出来（写入被拒或失败时页面会说明），而手写的值不会经过这条检查。既没选过、又在 patch 里留空，含义相同：`bridge: ''` 等于「不使用」。本插件自身的设置页取代了 DSH 从这个 schema 自动生成的那一页，所以不会出现两个入口。
-
-### 验证
-
-| 命令 | 验证内容 |
-| --- | --- |
-| `npm run typecheck`、`npm test` | 类型契约，以及 240 个单元测试（保存路由的每条守卫、文件地址解析与地址构造、另存为的目标校验、默认名与失败文案、保存命令重定向的每条分支、编辑器主题桥的每条分支、查看器名称与二进制后缀声明的边界、未保存改动的缓存规则与脏状态跟踪的边界、打开时「用文件还是用缓存」的每个分支、面板状态胶囊的状态与操作矩阵、文档头部动作的发布/订阅/命令路由、按钮的尺寸字号颜色规格、「只在表格文件上出现」的判定与注册顺序，隐藏 Designer「文件」Tab 那条规则的两处身份与作用域，以及桥选择的方向与「写入被拒也要报出来」、桥字段是否真的声明为 volatile、名册自身的契约（重复 id 拒绝、disposer 语义、只在真的变化时通知）、名册与设置页在有无 settings 服务时的接线，以及设置页每一行确实是照 DSH 自己设置页的行规格画的） |
-| `node scripts/smoke-client.mjs` | 构建后的浏览器半结构：loader 包装、内联的 SpreadJS 与样式、外部依赖只有 react |
-| `node scripts/smoke-node.mjs` | 构建后的宿主半：路由注册、许可证配置，以及保存路径的真实写盘、冲突与越界拒绝 |
-| `npm run probe:live` | **对着正在运行的 DSH** 跑一遍真实保存：真实 `ctx.fs` 的解析、落盘、冲突守卫、工作区越界；并核对进程里装的是不是本构建（插件版本与内置 SpreadJS 版本） |
-
-`npm run probe:live` 要求 DSH 已重启到本版本。宿主半会在 `/spreadjs/api/health` 回报插件版本与内置 SpreadJS 版本，探针据此判断「正在跑的进程是不是这一版」——回报的版本与本构建不一致会直接判失败；如果进程里是很早的宿主半（连版本字段都没有），探针会说明需要重启，如果连保存路由都报 404，则说明那更是旧版。可选参数：`--url`（默认 `http://127.0.0.1:3080`）、`--session <id>`、`--home <DSH_HOME>`。探针会在会话工作区内建一个临时文件，结束时删除。
-
-### 许可
-
-插件代码免费提供，采用 [MIT 许可证](LICENSE)。内置的 SpreadJS 和 Designer 是葡萄城商业产品，未配置许可证时可按其试用条款体验；插件免费不包含这两个产品的商业授权。
-
-如用于正式部署或 SaaS 服务，请根据使用场景获取适用的 SpreadJS 和 Designer 授权。
+| 配置项 | 默认值 | 说明 |
+| --- | --- | --- |
+| `licenseKey` | `''` | SpreadJS 授权 key |
+| `designerLicenseKey` | `''` | Designer Component 授权 key |
+| `maxSaveBytes` | `67108864` | 单次保存上限，默认 64 MiB；超出时拒绝保存 |
+| `trustedHosts` | `[]` | 除回环地址外，额外允许调用保存接口的地址；通过局域网访问时配置 |
 
----
+修改后重启 DSH 并重新打开文件。`bridge` 由「电子表格编辑器」设置页管理，无需手写。初始化失败时可查看编辑器内的错误提示，修正配置后重新打开文件。
 
 ## English
 
-### Features
-
-- Opens `.xlsx`, `.xlsm`, `.csv`, `.sjs`, and `.ssjson` files.
-- Open workbooks from the file tree and edit them with SpreadJS Designer.
-- Save edits straight back to the file: atomic, confined to the session workspace, with conflict detection. Save lives in the harness's own document header, with a mark while anything is unsaved.
-- **Save As** writes the workbook — including a new blank one — to another path in the workspace and moves the tab onto it; an existing name is never overwritten. Both header buttons follow the spec of the header's own controls (see Saving below) and appear on this plugin's own files only.
-- Follows the harness's light or dark theme, toolbars and worksheet alike; a harness preference of `system` still tracks the OS.
-- An **About** button in the settings tab reports the bundled versions, the licence state and the copyright.
-
-### Using it with the SpreadJS Driver
-
-This plugin is **complete on its own**: opening, editing and saving workbooks needs nothing else. Paired with the driver, though, it gains the one thing it cannot do alone — **letting the AI edit the very sheet you have on screen**.
-
-This editor supports other drivers through the public [SpreadJS bridge contract](docs/bridge-contract.md). A driver registers into `spreadjsBridgeRegistry` and receives the real Workbook only after explicit user selection, without an npm dependency on this editor. The companion [`@grapecity-software/dsh-spreadjs-driver`](https://www.npmjs.com/package/@grapecity-software/dsh-spreadjs-driver) is one implementation and can consume other compatible SpreadJS editors. Compatibility also requires document identity, leases, cancellation and save semantics, plus supported SpreadJS versions/modules.
-
-This package depends on no driver. SpreadJS, Designer and extensions are build/dev dependencies inlined into the browser bundle; the editor owns the instance and licensing. DSH and React peers are supplied by the host. The companion Driver bundles no SpreadJS, Designer or headless engine. Third-party drivers use their own unique ids; the host-side selection document for this editor is namespace `spreadjs-editor`, field `bridge`.
-
-#### Install
+### Installation
 
-Both plugins go into the **same web profile** — the driver's live-workbook capability exists only in the Web UI:
+Requires DSH `>=0.2.1-rc.3 <0.3.0-0` and Node.js ≥22.19. The plugin bundles SpreadJS and Designer `19.2.1` and uses DSH's built-in sidebar. No additional sidebar plugin or local build is needed. Check the [licensing requirements](#licensing-and-configuration) before use.
 
 ```sh
-dsh plugin --profile web add @grapecity-software/dsh-spreadjs-editor@0.2.6
-dsh plugin --profile web add @grapecity-software/dsh-spreadjs-driver@0.1.4
+dsh plugin --profile web add @grapecity-software/dsh-spreadjs-editor@0.2.8
 dsh --profile web
 ```
 
-Restart DSH, open any spreadsheet file, then pick **SpreadJS Driver** under **Settings → Spreadsheet Editor**. (With no driver installed that page offers only "None", and the editor behaves exactly as it does without the feature.)
-
-> Installed is not the same as active: both packages have to appear in the profile's `dsh.profile.bundles`. `pnpm add` or `dsh plugin add` does not always write that for you, so after installing, open a real session and confirm the tools are actually there.
-
-#### How the two fit together
-
-The editor **owns** the workbook you open; each driver **registers** as a candidate. The roster may hold several — our test fixture, for one — but exactly **one** is handed the workbook: the one you selected in Settings.
-
-- **What is handed over is a live reference, not a copy.** The workbook never leaves the page and is never serialized, so a style, formula or format written through it appears in the sheet at once.
-- **Nothing reaches disk by default.** An AI edit lives in the workbook until you are happy with it and the agent asks for a save. That save is the document header's own Save, so conflict detection, the workspace fence and the atomic write are all still in force.
-- **The roster answers to the selection alone.** Choose another bridge — or "None" — and **every** tool and skill the driver registers steps aside. The setting names the plugin that *owns spreadsheets* here, not merely the one holding the live document for the moment.
-- **The editor stays the gatekeeper.** The roster is a list of candidates, not a broadcast. A plugin that was not handed the workbook has no way to reach it.
-
-Selecting the driver enables `sjs_live_open`, `sjs_live_execute` and `sjs_live_status`. The driver can copy a template and ask this editor to open and initialize it. Import/export and Workbook ownership remain editor features.
-
-The saved bridge choice survives delayed loading, reloads and removal. If that bridge is absent, Settings shows it as unavailable with its id; it reconnects when loaded, or you can choose another bridge or None. Another bridge loading first never clears the saved choice.
-
-Driver status and execution are confined to the calling chat and bound to the current loaded-document identity, renewed on every reload. Recovery snapshots use the full session resource address, so same-named files in different chats cannot restore or clear each other's buffers. Cancellation/timeout prevent subsequent automatic saves; the editor rechecks permission after export and before write-back. Scripts ignoring cancellation retain their edit lock until they settle or the instance is destroyed. A write already sent may complete; cancellation cannot guarantee rollback. Update both plugins for the identity protocol.
-
-#### Requirements
-
-- **Update the editor and driver together** for the complete instance identity, lease and recovery protocol.
-- **Both plugins declare support for DSH `>=0.2.1-rc.3 <0.3.0-0`**: the bridge picker uses `settings.section` and stores the choice in the editor settings document. Development dependencies remain pinned to validated rc.4; the relevant UI API package implementations compare without differences from rc.3 through rc.5.
-- **Driver requirements**: Node ≥22.19, the editor in the same web profile, and a working browser connection. No Chrome/Edge installation on the server is required.
-
-### Bundled Versions and File Compatibility
-
-| Component | Bundled version |
-| --- | --- |
-| SpreadJS | 19.2.1 |
-| SpreadJS Designer | 19.2.1 |
-
-The **About** button in the Designer's settings tab shows the bundled versions, the licence state and the copyright. Older SpreadJS versions may not open `.sjs` or `.ssjson` files saved by this version. When exchanging files with older systems, keep the original files and check compatibility.
-
-### Installation
-
-Editor `0.2.6` declares support for DSH `>=0.2.1-rc.3 <0.3.0-0` and requires Node.js ≥22.19; the user confirmed rc.4 works in the development environment. The plugin uses the harness's own right Sidebar and needs **no third-party sidebar plugin**. Verify a new DSH minor's APIs before extending the supported range.
-
-| DSH version | Status | Notes |
-| --- | --- | --- |
-| `>=0.2.1-rc.3 <0.3.0-0` | Declared compatibility range | DSH 0.2.x from rc.3; the rc.3/rc.4/rc.5 UI API package implementations compare without differences |
-| `0.2.1-rc.4` | Desktop validation baseline | Typecheck, 240 unit tests, build, both smokes and package installation checks pass; the user confirmed the development environment works |
+Restart DSH after installation, then open an `.xlsx`, `.xlsm`, `.csv`, `.sjs`, or `.ssjson` file from the Web UI's right-side file tree.
 
-**Version policy:** Keep `engines.dsh` and DSH API peers on the same bounded range, starting at the oldest API version the plugin needs and ending before the next DSH minor line. Patch and RC releases inside that range do not require a plugin release each time; development dependencies stay pinned to the latest validated RC. Before extending support to a new DSH minor, compare the APIs and run install/runtime smokes, then publish the updated compatibility declaration.
+If the plugin does not appear, check that it is enabled in the active profile's `dsh.profile.bundles`. See the [changelog](CHANGELOG.md) for upgrade notes.
 
-Use Editor `0.2.6` together with Driver `0.1.4`; older plugins may be rejected because they declare an exact DSH version.
+### Editing and saving
 
-The validated rc.4 supplies the binary-suffix declaration, built-in read-only preview, document-header actions slot `sidebar.right.tab.document.actions`, and settings section `settings.section`. Compatibility is declared for the DSH 0.2.x line.
+- **Save**: use **Save** in the document header or `Ctrl+S` to write back to the original file. **Save As…** writes to another workspace path without overwriting an existing file.
+- **Conflict protection**: saving requires a fully loaded workbook and a path inside the current session's workspace. If another program has changed the file on disk, the save is refused.
+- **Unsaved changes**: switching or closing a document keeps a recovery snapshot. Reopening restores it, or offers Restore / Discard if the disk file has changed. **Snapshots live only in page memory and do not survive a page refresh or close. Save your work promptly.**
+- **Interface**: follows DSH's light/dark theme. **Settings → About** in Designer shows bundled versions and license configuration status; a configured key does not establish license validity.
 
-The plugin includes SpreadJS and Designer, with no build step required. With the DSH CLI installed:
+Designer's **File** tab is hidden, so its New, Import, Export, and Print entries are unavailable. Older SpreadJS versions may not open `.sjs` / `.ssjson` files saved by this version; keep originals and check compatibility when exchanging files with older systems.
 
-```sh
-dsh plugin --profile web add @grapecity-software/dsh-spreadjs-editor@0.2.6
-dsh --profile web
-```
+### Let AI edit workbooks (optional)
 
-After startup, open `.xlsx`, `.xlsm`, `.csv`, `.sjs`, or `.ssjson` from the right-side file tree.
-
-Alternatively, install and start through npx:
+The Editor works independently. To let AI operate on workbooks, install the [SpreadJS Driver](https://github.com/GrapeCityXA/dsh-plugin-spreadjs-driver) in the same `web` profile:
 
 ```sh
-npx --yes @deepseek-ai/dsh@0.2.1-rc.4 plugin --profile web add @grapecity-software/dsh-spreadjs-editor@0.2.6
-npx --yes @deepseek-ai/dsh@0.2.1-rc.4 --profile web
+dsh plugin --profile web add @grapecity-software/dsh-spreadjs-driver@0.1.5
 ```
 
-For upgrades, see the [release notes](CHANGELOG.md).
-
-### Saving
-
-Save's official entry point is **the harness's own document header** — the Save button beside the file name once a workbook is open. It is registered in the actions slot `sidebar.right.tab.document.actions` published by DSH, next to the other viewers' own controls, and it carries a mark while anything is unsaved, like the `*` in Excel's title bar. It writes your changes back to the file you opened, and there is no second prompt, because pressing Save *is* the intent.
-
-The same write-back is also on **`Ctrl+S` and the Save button on the Designer's own toolbar**: the plugin redirects the Designer's Save command, so neither of those reaches a download dialog any more. (The Designer's own File tab is hidden from the ribbon — see the end of this section.)
-
-These two header buttons do not import the harness's button component — a third-party client plugin cannot assume an internal `@deepseek-ai/*` package resolves at runtime, and a failure there would take the whole editor down — so they copy the values from the controls beside them instead: 28px tall, `padding: 0 6px`, 12px text, `--dsw-alias-label-secondary` at rest, `--dsw-alias-label-primary` with the `--dsw-alias-interactive-bg-hover` background on hover, and `--dsw-alias-label-tertiary` with no response when disabled. That is exactly what the header's own viewer-name button and icon buttons do, and a unit test pins those values so they cannot drift unnoticed.
-
-They are drawn **only on the files this plugin handles**. The slot renders for every previewed file, so the buttons appear only while this plugin's own editor is the body on screen — otherwise every markdown file, image and log in the workspace would carry two buttons that cannot do anything. The product's own open-in-app control works the same way: it draws nothing when there is no application to offer.
-
-They are ordered **before** open-in-app. The slot is a list, and its entries sort by the documented `order` (priority first, then order, then registration sequence), where this plugin registers at `-10` — the very value the harness itself uses for "first in a header actions list" (`dsh-client-ui-agent-preset` registers its session-header label at `order: -10`). That makes "save first, think about opening elsewhere second" a decided reading order rather than a side effect of plugin load order, and it puts the unsaved mark on the first item of the group, where the eye lands.
-
-The Designer's own File tab is **hidden from the ribbon**. The plugin no longer rewrites its private menu template (that rewrite is gone), and it does not leave the tab in place either: the File tab's Save *downloads a copy*, one click away from the Save that writes the file back, and having both is how the wrong one gets pressed. This editor now has exactly one place to save — the document header's **Save / Save As…**, plus `Ctrl+S`.
-
-The price is that the File tab's other categories (new, open, import, export, print, info) are not reachable from the UI any more; that is what hiding the page means. Say the word if you want one of them back on the ribbon and we will wire that one in. The hiding is one CSS rule keyed on the product's public command name (`CommandNames.FileMenuButton`) and the class its template draws, scoped to this plugin's panel; a unit test pins the rule, and creating the editor logs how many elements it matched and what `display` they compute to, so a rename in a future build shows up as a dead rule rather than as a quietly reappearing download button.
+Restart DSH and select **SpreadJS Driver** under **Settings → Spreadsheet Editor**. AI can then open and edit workbooks in the current chat. Select **None** to disable the Driver.
 
-- **A workbook that is still loading cannot be saved.** It has no content yet, so saving would overwrite the file with an empty book; the save command refuses, with an explanation, until the load finishes.
-- **It will not clobber someone else's edit.** The plugin records the file's content hash when it opens it and re-checks before writing; if the file changed in the meantime (an agent edited it, you saved it elsewhere), the save is refused with an explanation instead of overwriting those changes.
-- **It never leaves half a file.** A same-directory temporary file is renamed over the target, so any other reader always sees a complete workbook.
-- **It cannot write outside the workspace.** The target must sit inside the current session's workspace; anything else — including `..` escapes — is refused.
-- **Loopback only.** The save endpoint serves the local machine like the rest of DSH. If you reach DSH through a LAN address, add that address to `trustedHosts`.
+AI edits are not saved by default; a tool can request a save, or you can save manually. Manual editing is paused during execution. Cancellation does not undo edits already made, and a write already sent may still complete. See the [bridge contract](docs/bridge-contract.md) for third-party integration and execution rules.
 
-### Save As
+### Licensing and configuration
 
-**另存为…** in the same document header writes the workbook to a *different* path in the workspace — including a workbook that was reset to blank inside the Designer. The file it came from is left untouched.
+The plugin code uses the [MIT license](LICENSE). **SpreadJS and Designer Component commercial licenses are not included.** Configure applicable license keys for each component. Keyless local evaluation is limited to HTTP(S) loopback environments permitted by the vendor's trial terms. Production and SaaS deployments require licenses appropriate to their use.
 
-- **Suggested target**: same directory, same suffix, with the localized word for a copy appended (`report.xlsx` → `report-copy.xlsx`).
-- **It switches this tab.** When the current contents are fully written and the document is still present, the tab opens the new file. If later edits remain, it keeps the current file and asks for another save. A completed task does not navigate after its document has closed or switched away.
-- **An existing name is never overwritten.** The host refuses the write (a write-back needs a version baseline, and a Save As has none) and the dialog says so — "that file already exists; choose another name" — instead of replacing what is there.
-- **Only five suffixes are accepted**: `.xlsx`, `.xlsm`, `.csv`, `.sjs`, `.ssjson`. The written format follows the suffix, so anything else would produce a file this editor cannot reopen; it is refused before the write.
-- **Containment is judged by the host**, on the same rule as a write-back: a path outside the session workspace is refused.
-- **A busy editor says so.** While a load or another save is running the dialog reports that the editor is not ready rather than pretending to have written.
+**Desktop use requires unrestricted licenses applicable to that environment and covering both SpreadJS and Designer Component. Without them, the editor cannot be used in the desktop app.** See the [desktop licensing policy](docs/desktop-licensing.md).
 
-### Unsaved work
-
-The harness unmounts a document body when its tab is hidden, and the platform offers no close hook to intercept (a close is synchronous, and a document definition has neither a lifecycle nor a veto point). So leaving is never blocked — and nothing is dropped either:
-
-- **Switching away and back keeps the edits.** A dirty workbook is kept as a snapshot just before its body unmounts, and restored as-is when the same tab returns, without re-reading the file.
-- **Closing the tab keeps them too.** The snapshot is also kept under the file's path, so reopening that file restores it — and says so in the pill at the panel's bottom-right — as long as the file on disk is still the version the snapshot was written from.
-- **A file changed elsewhere is never silently replaced.** If the file on disk changed since the snapshot (an agent, another editor), the panel offers it instead in that same pill: **Restore** carries on from the buffer (a later save writes it to disk), **Discard** re-reads the file.
-- **It is visible, in two places.** Save in the document header carries a mark while edits are pending, like Excel's title-bar `*`. A floating pill at the bottom-right shows `Unsaved changes` and a Discard action. It costs no layout height and disappears once the current contents are fully saved.
-- **Closing the page warns.** A reload or close raises the browser's own prompt once, as long as anything is unsaved or still cached.
-- **Saving the current contents clears recovery.** Later edits remain marked as unsaved. An earlier save cannot clear a newer snapshot left when closing or switching the document.
-
-### Configuration
-
-If you have licenses, add the following to the web profile's `cordis.patch.yml`:
-
-| Key | Default | Description |
-| --- | --- | --- |
-| `licenseKey` | `''` | SpreadJS deployment key. Empty runs in evaluation mode with a watermark. |
-| `designerLicenseKey` | `''` | Separate SpreadJS Designer deployment key. Empty keeps Designer in evaluation mode. |
-| `maxSaveBytes` | `67108864` | Largest payload one save may carry; a bigger one is refused, never truncated. |
-| `trustedHosts` | `[]` | Extra authorities allowed to call the save endpoint, beyond loopback (for LAN deployments). |
+Update the existing `spreadjs-editor` entry in the `web` profile's `cordis.patch.yml`, preserving its other fields:
 
 ```yaml
 - id: spreadjs-editor
@@ -353,23 +119,33 @@ If you have licenses, add the following to the web profile's `cordis.patch.yml`:
     designerLicenseKey: 'YOUR_DESIGNER_KEY'
 ```
 
-Restart DSH and refresh the browser after changing the configuration.
+| Key | Default | Description |
+| --- | --- | --- |
+| `licenseKey` | `''` | SpreadJS license key |
+| `designerLicenseKey` | `''` | Designer Component license key |
+| `maxSaveBytes` | `67108864` | Save size limit, 64 MiB by default; larger saves are refused |
+| `trustedHosts` | `[]` | Extra addresses allowed to call the save endpoint beyond loopback; configure for LAN access |
+
+Restart DSH and reopen the file after changing configuration. The **Spreadsheet Editor** settings page manages `bridge`; no manual entry is needed. If initialization fails, review the editor's error message, correct the configuration, and reopen the file.
 
-One more field is deliberately **not** in that table: `bridge` is written by the **Spreadsheet Editor** page in the Web UI and records which bridge the user chose. It is this plugin's configuration all the same, but it should not be written into the patch by hand — the page reports honestly whether a write was accepted, and a hand-written value never goes through that check. Not having chosen yet and leaving it empty in the patch mean the same thing: `bridge: ''` is "None". This plugin's own page replaces the one DSH would otherwise synthesise from the schema, so there is only ever one entry point.
+## 开发 / Development
 
-### Verification
+使用 pnpm 和仓库中的 `pnpm-lock.yaml` 安装依赖。开发依赖固定在 DSH `0.2.1-rc.4`；兼容范围内的 patch / RC 不逐个发版适配，扩展到新的 DSH 次版本前先验证 API 和运行行为。
 
-| Command | What it proves |
-| --- | --- |
-| `npm run typecheck`, `npm test` | The type contract, and 240 unit tests: every save guard, file-address parsing and address building, the Save As target rules, suggested name and failure wording, every branch of the Save-command redirect, every branch of the editor theme bridge, the viewer-name and binary-suffix edge cases, the unsaved-buffer and dirty-tracking rules, every branch of the file-versus-buffer decision at open, the panel state pill's state/action matrix, the document header actions' publication, subscription, command routing, button spec, "spreadsheets only" rule and registration order, both identities plus the scope of the rule that hides the Designer's File tab, the direction of the bridge choice and that a refused write is reported, that the bridge field really is declared volatile, and the registry's own contract (a duplicate id refused, disposer semantics, notifying only on a real change), the wiring of the roster and the settings page with and without a settings service, and that every row of that page is drawn to the harness's own settings-row spec |
-| `node scripts/smoke-client.mjs` | The built browser half's structure: loader wrapper, inlined SpreadJS and styles, react as the only runtime external |
-| `node scripts/smoke-node.mjs` | The built host half: route registration, license config, and the save path writing real bytes plus refusing conflicts and escapes |
-| `npm run probe:live` | A real save against a **running DSH**: the actual `ctx.fs` resolving, writing, refusing a stale base hash, and refusing a workspace escape — plus a check that the process carries *this* build (plugin and bundled SpreadJS versions) |
+Install dependencies with pnpm and the committed `pnpm-lock.yaml`. Development dependencies are pinned to DSH `0.2.1-rc.4`. Patch / RC updates within the declared range do not require individual plugin releases. Verify APIs and runtime behavior before extending support to a new DSH minor.
 
-`npm run probe:live` needs DSH restarted onto this version. The host half reports the plugin and bundled SpreadJS versions on `/spreadjs/api/health`, so the probe can tell whether the running process is this build: a version that disagrees with this build fails outright, a host half old enough to omit the field is reported as needing a restart, and a 404 means the host half predates the save route. Options: `--url` (default `http://127.0.0.1:3080`), `--session <id>`, `--home <DSH_HOME>`. The probe creates one temporary file inside the session workspace and deletes it.
+```sh
+pnpm install --frozen-lockfile
+npm run typecheck
+npm test
+npm run build
+node scripts/smoke-client.mjs
+node scripts/smoke-node.mjs
+npm run verify:package
+```
 
-### License
+`npm run probe:live` 可验证运行中 DSH 的真实保存、冲突和工作区边界；运行前需重启 DSH 加载当前构建。支持 `--url`（默认 `http://127.0.0.1:3080`）、`--session`、`--home` 参数，使用 `npm run probe:live -- <参数>` 传入。探针会创建并删除一个临时文件。
 
-The plugin code is free under the [MIT license](LICENSE). Bundled SpreadJS and Designer are GrapeCity commercial products available for evaluation under their trial terms without license keys. The free plugin does not include commercial licenses for these products.
+`npm run probe:live` checks real saves, conflicts, and workspace boundaries against a running DSH. Restart DSH on the current build first. Pass `--url` (default `http://127.0.0.1:3080`), `--session`, or `--home` via `npm run probe:live -- <options>`. The probe creates and deletes a temporary file.
 
-For production or SaaS deployments, obtain SpreadJS and Designer licenses appropriate to your use.
+开发文档 / Development docs: [发布流程 / Release workflow](docs/releasing.md) · [手工回归 / Manual regression](docs/manual-regression.md).

package/cordis.patch.yml

@@ -17,8 +17,8 @@
     name: '@grapecity-software/dsh-spreadjs-editor'
     inject: [webServer]
     config:
-      # Optional: your SpreadJS license key. Empty (default) runs the
-      # evaluation watermark build. Keep it out of the patch if you prefer
-      # to configure it per-deployment.
+      # Separate SpreadJS and Designer Component keys. Keyless evaluation is
+      # limited to supported HTTP(S) loopback environments. Desktop use needs
+      # applicable unrestricted licenses; see docs/desktop-licensing.md.
       licenseKey: ''
       designerLicenseKey: ''

package/docs/desktop-licensing.md

@@ -0,0 +1,15 @@
+# 桌面授权策略
+
+桌面环境使用本编辑器，必须取得适用于该场景的**无限制授权**，并同时覆盖 **SpreadJS** 和 **Designer Component**。
+
+没有上述授权，桌面版无法使用本编辑器。SpreadJS 和 Designer Component 的授权需分别配置，缺少任一组件的适用授权均无法使用完整编辑器。
+
+免费插件不包含 SpreadJS 或 Designer Component 授权。无 key 的本地开发仅限供应商试用条款允许的 HTTP(S) 回环环境；桌面环境不能依赖这类本地试用。
+
+## English
+
+Use of this editor in a desktop environment requires **unrestricted licenses** applicable to that use, covering both **SpreadJS** and **Designer Component**.
+
+Without these licenses, the editor cannot be used in the desktop app. SpreadJS and Designer Component license keys must be configured separately; the complete editor requires applicable licenses for both components.
+
+The free plugin does not include SpreadJS or Designer Component licenses. Keyless local development is limited to HTTP(S) loopback environments permitted by the vendor's trial terms; desktop environments cannot rely on that local trial mode.

package/docs/manual-regression.md

@@ -0,0 +1,67 @@
+# 手工回归 / Manual regression
+
+在浏览器 Web UI 中测试，使用独立测试文件。先安装本次 Editor 构建及配套 Driver（如需 AI 测试），重启 DSH 并刷新页面。核对 `/spreadjs/api/health` 的 `plugin.version` 与待测版本一致；授权须适用于实际页面来源。
+
+准备 `regression.xlsx` 和 `scratch.xlsx` 两个文件。记录 DSH、Editor、Driver 版本及浏览器，避免在业务文件上制造冲突或坏文件。
+
+## 编辑、保存与恢复
+
+1. 打开 `regression.xlsx`，在 A1 输入 `BASE`、B1 输入 `100`、C1 输入 `=B1*2`，提交单元格编辑后保存。
+2. 刷新页面并重新打开，确认 C1 为 `200`，内容已写入磁盘，没有未保存标记。
+3. A2 输入 `RECOVERY`，不保存，切到 `scratch.xlsx` 后再切回；关闭文档标签后再打开。两种情况下均应恢复 A2，并保留未保存标记。
+4. 最后保存。恢复快照只在当前页面内存中，第 3 步不能用整页刷新代替切换文档。
+
+## 保存期间继续编辑或切换
+
+在浏览器 Console 中延迟交付保存响应，留出稳定的编辑时间；此代码不延迟服务端写入，刷新页面后失效：
+
+```js
+(() => {
+  if (window.__restoreSpreadjsTestFetch) return;
+  const original = window.fetch;
+  window.fetch = async function (input, init) {
+    const response = await original.call(this, input, init);
+    const url = typeof input === 'string' ? input : input?.url ?? String(input);
+    if (url.includes('/spreadjs/api/save')) {
+      console.info('[SJS-TEST] SAVE_RESPONSE_DELAY');
+      await new Promise(resolve => setTimeout(resolve, 10000));
+    }
+    return response;
+  };
+  window.__restoreSpreadjsTestFetch = () => {
+    window.fetch = original;
+    delete window.__restoreSpreadjsTestFetch;
+  };
+})();
+```
+
+1. 修改 A3 并保存。看到 `SAVE_RESPONSE_DELAY` 后立即修改 B3，等待保存结束。B3 仍应标为未保存，第二次保存后才清除标记。
+2. 再做一轮：修改 A4、保存，看到延迟提示后修改 B4，并立即切到另一文件。等待保存结束再打开原文件，B4 应仍可恢复。旧保存不能清掉较新的快照。
+3. 最后保存所有测试改动。若未在保存期间产生新改动，记录为「未触发」，重新测试。
+
+## 另存为
+
+1. 修改工作簿，另存为新的 `copy.xlsx`；内容完整写入后应打开副本，原文件的磁盘内容不变。
+2. 保持上述延迟，另存为另一个新文件；看到提示后切到 `scratch.xlsx`。等待完成后应仍停在 scratch，不能被旧任务导航到副本。
+3. 再次另存为已存在的 `copy.xlsx`，应拒绝覆盖；工作区外路径、其他后缀也应拒绝。
+4. 在 Console 执行 `window.__restoreSpreadjsTestFetch?.()` 恢复正常保存响应。
+
+## 冲突、加载失败与界面
+
+1. 两个浏览器标签页打开同一聊天的同一文件。第一边修改并保存，再在第二边修改并保存，第二边应提示磁盘变化或保存冲突。独立读盘确认第一边的内容未被覆盖；恢复缓存中的内容不能作为磁盘结果。
+2. 多次在大工作簿与小工作簿间切换，确认文件名和内容一致，不被旧加载覆盖。
+3. 准备内容为普通文本、后缀为 `.xlsx` 的测试坏文件。加载失败后应拒绝保存和另存为，不生成空白副本；关闭后文本、图片和聊天切换仍正常。
+4. 切换 DSH 明暗主题，检查表格及工具栏。若出现授权或初始化失败，记录错误详情，并确认关闭该文件后侧栏仍可使用。
+
+## 可选的 Driver 回归
+
+1. 在「设置 → 电子表格编辑器」选择 Driver，刷新后选择应保留；选择「不使用」后应停止提供其工具。
+2. 让 AI 修改单元格，使用 `save:false` 时只改变当前工作簿；使用 `save:true` 时经 Editor 保存，刷新后内容仍在。
+3. 运行包含可取消等待的任务，在写入之前停止，确认不继续保存。取消不回滚已经完成的改动；已发送的写入仍可能完成。
+4. 执行期间关闭或切换文件，任务应中断。重新打开后检查可恢复的部分，再继续测试；快照不能恢复 JavaScript 执行位置。
+
+Driver 的详细接入与执行约束见[桥接契约](bridge-contract.md)。
+
+## 记录结果
+
+记录测试项、版本、实际步骤、预期结果、实际结果和 Console / 工具错误。未触发的竞态测试单独标注；数据丢失、错误文件操作或保存结果不符需要先修复再发布。

package/docs/releasing.md

@@ -0,0 +1,47 @@
+# 发布流程 / Release workflow
+
+## 准备 / Prepare
+
+版本号以 `package.json` 为准；在 `CHANGELOG.md` 中写对应版本小节，并同步 README 安装示例。依赖使用 `pnpm-lock.yaml`，无需维护 npm 锁文件。
+
+Use the version in `package.json`, add a matching section to `CHANGELOG.md`, and update README installation examples. Use `pnpm-lock.yaml` for dependencies; no npm lockfile is maintained.
+
+```sh
+pnpm install --frozen-lockfile
+npm run prepublishOnly
+npm pack --ignore-scripts
+```
+
+`prepublishOnly` 包含类型检查、测试、构建、客户端与宿主 smoke，以及独立离线包安装验证。安装包使用预构建产物，不在用户安装时编译。运行中的 DSH 另用 `npm run probe:live` 验证保存；该命令需要已加载当前构建的 DSH 实例。
+
+`prepublishOnly` runs typechecking, tests, builds, client/host smokes, and an independent offline package installation check. Packages contain prebuilt artifacts; users do not build during installation. Use `npm run probe:live` separately against a running DSH loaded with the current build to verify real saves.
+
+## GitHub 版本记录 / GitHub release
+
+确认改动已提交到 `main`，工作区干净后运行：
+
+After committing changes on `main` with a clean working tree:
+
+```sh
+npm run release -- --dry-run
+npm run release
+```
+
+发布脚本先完成检查，再创建版本提交（如需要）、annotated tag、推送和 GitHub Release；说明文字取自 changelog。`--dry-run` 执行检查并显示计划，不推送。**此脚本不发布 npm 包。**
+
+The release script validates first, then creates a version commit if needed, an annotated tag, a push, and a GitHub Release using the changelog section. `--dry-run` validates and prints the plan without pushing. **It does not publish to npm.**
+
+## npm 发布 / npm publication
+
+发布已验证的 tarball，再核对 registry 中的版本：
+
+Publish the verified tarball, then check its registry version:
+
+```sh
+npm publish ./grapecity-software-dsh-spreadjs-editor-<version>.tgz --access public
+npm view @grapecity-software/dsh-spreadjs-editor@latest version
+```
+
+最后在 `web` profile 安装完整版本号，重启 DSH，验证打开、编辑、保存及可选的 Driver 操作。授权要求以 [README](../README.md) 和[桌面授权策略](desktop-licensing.md) 为准。
+
+Finally, install the exact version in a `web` profile, restart DSH, and verify opening, editing, saving, and optional Driver operations. Licensing requirements are documented in the [README](../README.md) and [desktop licensing policy](desktop-licensing.md).

package/lib/client.js

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/lib/client.js
-size: 52052364 bytes
-sha256: ec38a36efd2c2ec37f7e448f66c9cd27801581189bd76bd0614c2b9af467f351
+size: 52053126 bytes
+sha256: 965bcc53ce235e6ee2700035f9ddd2a8f30bc128bb137671f113b4763878c68b

package/package.json

@@ -1,122 +1,126 @@
-{
-  "name": "@grapecity-software/dsh-spreadjs-editor",
-  "version": "0.2.6",
-  "description": "DSH sidebar SpreadJS editor with binary save, recovery and a selectable bridge for compatible drivers.",
-  "keywords": [
-    "deepseek-harness",
-    "dsh",
-    "webui",
-    "plugin",
-    "spreadjs",
-    "excel"
-  ],
-  "type": "module",
-  "main": "lib/index.js",
-  "exports": {
-    ".": {
-      "default": "./lib/index.js"
-    },
-    "./client": {
-      "default": "./lib/client.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib/*.js",
-    "lib/licenses",
-    "cordis.patch.yml",
-    "README.md",
-    "docs/bridge-contract.md",
-    "CHANGELOG.md",
-    "LICENSE",
-    "THIRD_PARTY_NOTICES.md"
-  ],
-  "scripts": {
-    "build": "node scripts/build.mjs && node scripts/copy-notices.mjs",
-    "grapecity:update": "node scripts/update-grapecity.mjs",
-    "prepack": "npm run build",
-    "prepublishOnly": "npm run typecheck && npm test && npm run build && node scripts/smoke-client.mjs && node scripts/smoke-node.mjs && npm run verify:package",
-    "rebuild": "node scripts/build.mjs",
-    "probe:live": "node scripts/probe-live-save.mjs",
-    "release": "node scripts/release.mjs",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "verify:package": "node scripts/verify-package.mjs"
-  },
-  "engines": {
-    "node": ">=22.19.0",
-    "dsh": ">=0.2.1-rc.3 <0.3.0-0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/GrapeCityXA/dsh-plugin-spreadjs-editor.git"
-  },
-  "dsh": {
-    "engines": {
-      "dsh": ">=0.2.1-rc.3 <0.3.0-0"
-    },
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "inject": [
-        "@deepseek-ai/dsh-client-ui-theme",
-        "@deepseek-ai/dsh-client-ui-slots",
-        "@deepseek-ai/dsh-client-ui-sidebar-right",
-        "@deepseek-ai/dsh-client-ui-sidebar-documentpreview"
-      ]
-    }
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5",
-    "@deepseek-ai/dsh-client-ui-renderer": ">=0.2.1-rc.3 <0.3.0-0",
-    "@deepseek-ai/dsh-client-ui-sidebar-documentpreview": ">=0.2.1-rc.3 <0.3.0-0",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.2.1-rc.3 <0.3.0-0",
-    "@deepseek-ai/dsh-client-ui-theme": ">=0.2.1-rc.3 <0.3.0-0",
-    "@deepseek-ai/schemastery": "~3.18.5",
-    "react": "^18.0.0"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-client-ui-sidebar-documentpreview": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-client-ui-theme": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-host-webserver": "0.2.1-rc.4",
-    "@deepseek-ai/schemastery": "~3.18.5",
-    "@grapecity-software/spread-excelio": "19.2.1",
-    "@grapecity-software/spread-sheets": "19.2.1",
-    "@grapecity-software/spread-sheets-barcode": "19.2.1",
-    "@grapecity-software/spread-sheets-charts": "19.2.1",
-    "@grapecity-software/spread-sheets-datacharts-addon": "19.2.1",
-    "@grapecity-software/spread-sheets-designer": "19.2.1",
-    "@grapecity-software/spread-sheets-designer-resources-cn": "19.2.1",
-    "@grapecity-software/spread-sheets-formula-panel": "19.2.1",
-    "@grapecity-software/spread-sheets-ganttsheet": "19.2.1",
-    "@grapecity-software/spread-sheets-io": "19.2.1",
-    "@grapecity-software/spread-sheets-languagepackages": "19.2.1",
-    "@grapecity-software/spread-sheets-pdf": "19.2.1",
-    "@grapecity-software/spread-sheets-pivot-addon": "19.2.1",
-    "@grapecity-software/spread-sheets-print": "19.2.1",
-    "@grapecity-software/spread-sheets-reportsheet-addon": "19.2.1",
-    "@grapecity-software/spread-sheets-resources-zh": "19.2.1",
-    "@grapecity-software/spread-sheets-shapes": "19.2.1",
-    "@grapecity-software/spread-sheets-slicers": "19.2.1",
-    "@grapecity-software/spread-sheets-sparklines": "19.2.1",
-    "@grapecity-software/spread-sheets-tablesheet": "19.2.1",
-    "@types/node": "^22.0.0",
-    "@types/react": "^18.3.0",
-    "react": "^18.2.0",
-    "tsdown": "^0.22.0",
-    "typescript": "^5.9.0",
-    "unrun": "^0.3.1",
-    "vitest": "^3.0.0"
-  },
-  "license": "MIT"
-}
+{
+  "name": "@grapecity-software/dsh-spreadjs-editor",
+  "version": "0.2.8",
+  "description": "DSH sidebar SpreadJS editor with binary save, recovery and a selectable bridge for compatible drivers.",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "webui",
+    "plugin",
+    "spreadjs",
+    "excel"
+  ],
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/*.js",
+    "lib/licenses",
+    "cordis.patch.yml",
+    "README.md",
+    "docs/bridge-contract.md",
+    "docs/desktop-licensing.md",
+    "docs/releasing.md",
+    "docs/manual-regression.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs && node scripts/copy-notices.mjs",
+    "grapecity:update": "node scripts/update-grapecity.mjs",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build && node scripts/smoke-client.mjs && node scripts/smoke-node.mjs && npm run verify:package",
+    "probe:live": "node scripts/probe-live-save.mjs",
+    "release": "node scripts/release.mjs",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "verify:package": "node scripts/verify-package.mjs"
+  },
+  "engines": {
+    "node": ">=22.19.0",
+    "dsh": ">=0.2.1-rc.3 <0.3.0-0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GrapeCityXA/dsh-plugin-spreadjs-editor.git"
+  },
+  "dsh": {
+    "engines": {
+      "dsh": ">=0.2.1-rc.3 <0.3.0-0"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-theme",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-sidebar-right",
+        "@deepseek-ai/dsh-client-ui-sidebar-documentpreview"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.2.1-rc.3 <0.3.0-0",
+    "@deepseek-ai/dsh-client-ui-sidebar-documentpreview": ">=0.2.1-rc.3 <0.3.0-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.2.1-rc.3 <0.3.0-0",
+    "@deepseek-ai/dsh-client-ui-theme": ">=0.2.1-rc.3 <0.3.0-0",
+    "@deepseek-ai/schemastery": "~3.18.5",
+    "react": "^18.0.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-sidebar-documentpreview": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-client-ui-theme": "0.2.1-rc.4",
+    "@deepseek-ai/dsh-host-webserver": "0.2.1-rc.4",
+    "@deepseek-ai/schemastery": "~3.18.5",
+    "@grapecity-software/spread-excelio": "19.2.1",
+    "@grapecity-software/spread-sheets": "19.2.1",
+    "@grapecity-software/spread-sheets-barcode": "19.2.1",
+    "@grapecity-software/spread-sheets-charts": "19.2.1",
+    "@grapecity-software/spread-sheets-datacharts-addon": "19.2.1",
+    "@grapecity-software/spread-sheets-designer": "19.2.1",
+    "@grapecity-software/spread-sheets-designer-resources-cn": "19.2.1",
+    "@grapecity-software/spread-sheets-formula-panel": "19.2.1",
+    "@grapecity-software/spread-sheets-ganttsheet": "19.2.1",
+    "@grapecity-software/spread-sheets-io": "19.2.1",
+    "@grapecity-software/spread-sheets-languagepackages": "19.2.1",
+    "@grapecity-software/spread-sheets-pdf": "19.2.1",
+    "@grapecity-software/spread-sheets-pivot-addon": "19.2.1",
+    "@grapecity-software/spread-sheets-print": "19.2.1",
+    "@grapecity-software/spread-sheets-reportsheet-addon": "19.2.1",
+    "@grapecity-software/spread-sheets-resources-zh": "19.2.1",
+    "@grapecity-software/spread-sheets-shapes": "19.2.1",
+    "@grapecity-software/spread-sheets-slicers": "19.2.1",
+    "@grapecity-software/spread-sheets-sparklines": "19.2.1",
+    "@grapecity-software/spread-sheets-tablesheet": "19.2.1",
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.0",
+    "@types/react-test-renderer": "18.3.1",
+    "react": "^18.2.0",
+    "react-test-renderer": "18.3.1",
+    "tsdown": "^0.22.0",
+    "typescript": "^5.9.0",
+    "unrun": "^0.3.1",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT"
+}