前言¶

在 DSH Web 里处理 .xlsx 文件时，常见做法是复制文件路径后打开外部表格工具，修改完再保存。dsh-excel-panel 把“打开、预览、编辑、保存”这几步放进右侧栏，适合需要在 DSH Web 工作界面中快速处理表格的场景。

下面介绍它的功能、安装方式和典型用法。

这是什么¶

dsh-excel-panel 是面向 DSH Web 的右侧栏插件，运行在 dsh-better-sidebar 中，用于直接预览、编辑和保存 .xlsx 文件。维护者为 Melody-max114，许可证为 MIT。

它解决的核心问题是：在 DSH Web 右侧栏中完成单元格编辑、样式调整、公式预览和工作表操作，并把结果保存回原文件。

核心功能¶

单元格选择与编辑¶

• 单击选中单元格。
• 双击编辑单元格文字。
• 拖动或 Shift+点击 选择范围。

格式工具栏¶

可以调整以下样式：

• 字体大小
• 加粗、斜体、下划线
• 左对齐、居中、右对齐
• 字体颜色
• 背景颜色

自定义颜色支持色盘快速选色、RGB 滑块和 HEX 输入。

公式实时预览¶

在 fx 栏输入公式后，可以看到公式计算结果。已列出的公式能力包括：

• + - * / ^
• 单元格/区域引用
• SUM、ROUND、IF、MAX、MIN、AVERAGE、COUNT、ABS、INT、LEN、UPPER、LOWER

例如可以输入：

=D2*0.15

工作表操作¶

• 合并或取消合并单元格
• 插入/删除行和列
• 拖拽调整列宽/行高
• 底部 Sheet 栏与新建工作表
• 右键菜单：复制、粘贴、清除、合并、插入删除行列

保存与撤销¶

• 保存时重建整个 .xlsx，避免样式表逐步损坏。
• 多次保存后格式不丢失。
• 保存失败时提示具体原因。
• 文件被占用时提供“关闭占用程序并重试”。
• Ctrl+Z 撤销。
• Ctrl+Y 或 Ctrl+Shift+Z 重做。

安装与启用¶

插件面向 DSH Web。依赖信息中声明了：

• dsh-better-sidebar: ^0.12.0
• react: ^18.2.0
• exceljs: ^4.4.0

先确认 DSH Web 环境满足这些依赖要求，再安装插件。

常用安装命令¶

dsh plugin --profile web add dsh-excel-panel

也可以作为 npm 包安装到项目：

npm install dsh-excel-panel

如果使用本地目录，可以按 file 依赖添加，例如：

dsh plugin --profile web add file:D:/apps/DP专武/dsh-excel-panel

如果使用 zip 包，可从 GitHub Releases 下载：

dsh-excel-panel-v0.6.1.zip

解压后按 file 依赖方式添加。

安装完成后，重启 DSH Web。

典型用法¶

1、重启 DSH Web。

2、在右侧栏打开任意 .xlsx 文件。

3、单击选中单元格，双击编辑文字。

4、在上方 fx 栏输入公式，例如：

=D2*0.15

5、多选范围后，使用格式工具栏批量调整字体、颜色、对齐等。

6、点击右上角「保存」写回磁盘原文件。

适用场景与注意¶

适合在 DSH Web 右侧栏中查看和修改 .xlsx 文件的场景，尤其是需要调整格式、输入公式、管理工作表，并直接保存回原文件的情况。

注意：

• 插件会以当前 dsh 进程权限运行。
• 安装前应检查源码与许可证。
• 许可证为 MIT，允许自由使用、修改和分发。
• 文件被占用时，需要先关闭占用程序再重试。
• 依赖 dsh-better-sidebar 与 react，安装前确认版本要求。

获取¶

社区插件目录页：

https://www.skillhub.cn/plugins/Melody-max114/dsh-excel-panel

GitHub 仓库：

https://github.com/Melody-max114/dsh-excel-panel