前言¶
在 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.0react: ^18.2.0exceljs: ^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
