前言¶

在 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