dsh-spreadjs-editor 是一个 DSH Web UI 插件，聚焦在：让工作区里的 Excel 工作簿能在 DSH 里完整的编辑预览，并支持把结果写回原文件。
DSH 自带的表格预览可以打开工作簿看内容。但改公式、改格式，再把结果存回原文件，需要一套完整的工作簿引擎。插件把这个引擎接了进来，用的是原生 SpreadJS Designer。装好之后，从右侧文件树点开工作簿，就是完整的表格界面，改完写回原文件。
DSH 是什么
DSH（DeepSeek Harness）是一个以 B/S 架构运行的 AI Agent 工作台。Agent 在服务端执行任务，把结果写进当前会话的工作区；用户通过浏览器看会话内容，也看文件。它提供插件机制，第三方可以往 Web UI 里加文件查看、编辑这类能力。
Agent 已经能生成和修改工作簿文件。人要去核对结果、动手改两处时，缺的是一个人工编辑并写回的入口。这一步此前要跳出浏览器，下载之后用桌面软件改完再传回去。
表格引擎用的是 SpreadJS
把数据画成网格并不难。难的是让用户按熟悉的 Excel 方式工作：多个工作表要能切换，公式要能重算，合并单元格、数字格式、边框、列宽行高要保留，筛选、排序、冻结窗格这些操作也得有。这些都需要一套完整的工作簿模型，从头实现一遍不现实。
插件因此没有自己实现表格引擎，而是嵌入了 SpreadJS。它是葡萄城提供的 Web 电子表格引擎，这里用的是原生 Designer 界面，插件没有对它做任何二次开发。用户在编辑器里能做的事，都由这套引擎提供：
- 在同一个工作簿里查看多个工作表。
- 编辑单元格并看到公式计算结果。
- 保留合并单元格、数字格式、边框、颜色、列宽和行高。
- 使用筛选、排序、冻结窗格等常见操作。
- 把改完的内容保存回原文件，继续用于后续流程。
业务系统控制自己的界面、文件流程和部署方式，表格交互交给 SpreadJS。插件夹在中间，只对接文件路径、浏览器编辑器和保存动作。
插件自己要做的事只有四件：注册入口、分流格式、写回文件、配置运行环境。这四件事在代码层面怎么接的，在《dsh-spreadjs-editor 的集成链路》里单独说明。
装上之后，操作变成什么样
安装插件后，从当前会话的右侧文件树打开 Excel 文件，就在 SpreadJS Designer 里查看和编辑。改完的内容写回原文件。
DSH 不需要重新实现一套 Excel。插件只把「打开文件、编辑工作簿、保存结果」这条链路组织起来，让专业的表格能力出现在用户已经待着的页面里。
安装：两条命令
项目已发布到 npm，通过 DSH CLI 安装：
bash
dsh plugin --profile web add @grapecity-software/dsh-spreadjs-editordsh --profile web需要版本较新的 DSH，建议先把 DSH 升到最新 release 版本------插件使用 DSH 自带的右侧栏，不需要再装任何第三方侧边栏插件。安装包内置了 SpreadJS 和 Designer 的预构建资源，安装时不需要编译，也不执行任何安装期脚本。启动后就能从右侧文件树打开工作簿。
用 npm 分发有个直接的好处：版本能被明确记录，升级有公开的变更说明。需要在多个环境部署时，这比手动拷一组静态文件好维护。
开源仓库也提供反馈入口，可以看源码、提 Issue，或者按自己的 DSH 场景提改进建议。
建议先拿一个实际业务里的 Excel 文件，走一遍打开、改公式、保存的流程。生产环境还要结合目标浏览器和文件规模再验一遍。
适合谁用
这个插件首先适合在 DSH 里让 Agent 处理表格文件的开发者和团队：
- Agent 生成 Excel 报表后，需要马上预览结果。
- Agent 改完工作簿，需要人工核对公式、格式和多个 Sheet。
- 用户想在 DSH 里继续调 Agent 生成的数据，而不是下载到桌面软件。
- 自建 DSH 服务，希望给用户提供完整的表格查看和编辑能力。
如果需求只是展示一张简单数据表，普通表格组件可能就够了。需要保留 Excel 的工作方式、而且要处理真实的工作簿文件时，才需要一套完整的表格引擎。
延伸阅读
插件不大，牵出的问题不少。围绕它还有几篇更细的讨论：
- 《从 AI 生成到在线预览》：Agent 生成文件之后的完整工作流，以及 DSH、插件与 SpreadJS 各自的职责。
- 《在线 Excel 怎么验收》：评估在线 Excel 方案时，哪些维度需要放进验收用例。
- 《dsh-spreadjs-editor 的集成链路》：插件在代码层面如何完成注册、导入分流与写回。
- 《dsh-spreadjs-editor 当前支持什么》：当前版本的能力边界，以及上线前需要确认的事项。
小结
dsh-spreadjs-editor 处理的是 DSH 里 Excel 文件查看和编辑链路太长的问题。它把 DSH 的文件管理能力和 SpreadJS 的在线电子表格能力接上，让用户能在熟悉的表格界面里完成操作。
对正在用 DSH 处理表格任务的开发者，这个插件补上了人工编辑和保存写回这一环。对准备建设 Agent 文件工具或自有 Web 服务的团队，它接文件与写回的那套写法也可以直接参考。