在 DSH 生態中，處理導出的 CSV 或 TSV 數據時，文件往往包含大量行或複雜的格式。直接在側邊欄查看容易造成卡頓，且難以快速篩選和排序。hi-wenw/dsh-csv-viewer 插件解決了這一預覽體驗問題。
插件定位與功能¶
這是一個 DSH Web 插件，旨在爲 dsh-better-sidebar 增加對 .csv 和 .tsv 文件的專用查看器。插件由 hi-wenw 維護，開源協議爲 MIT。它通過虛擬化技術解決了大數據量表格的渲染性能問題，並支持複雜的 CSV 格式解析。
核心功能包括：
- 自動分隔符檢測：支持逗號、製表符、分號和管道符分隔的文件。
- 虛擬化渲染：不逐行創建 DOM 節點，防止大數據量導致瀏覽器卡頓。
- 交互能力：支持不區分大小寫的搜索、以及數值/文本列的升序/降序/重置排序。
- 顯示模式：提供
Table（表格）和Raw（原始預覽）兩種視圖。 - 格式支持：處理 CSV 引號、轉義引號、CRLF 和換行符。
安裝與啓用¶
在安裝前，請確保環境已滿足依賴要求：dsh-better-sidebar 版本 >= 0.19.0，以及 React 版本 >= 18.2.0。
使用官方命令安裝插件：
dsh plugin --profile web add https://github.com/hi-wenw/dsh-csv-viewer.git
安裝完成後，重啓 DSH Web，並在瀏覽器中執行硬刷新（Ctrl+Shift+R）以加載新插件。隨後從側邊欄打開 CSV 或 TSV 文件即可使用查看器。
典型用法¶
打開文件後，系統會根據文件內容自動判斷分隔符。在表格模式下，你可以點擊表頭進行排序，或使用搜索框定位關鍵字段。如果需要查看原始內容或處理特殊格式，可切換至 Raw 模式。
適用場景與注意¶
該插件適合需要在 DSH Web 界面直接處理數據分析、日誌查看或結果導出的場景。
由於插件以 DSH 客戶端權限運行，安裝前建議檢查源碼與許可證。插件的開發打包路徑通常在 lib/client.js（客戶端打包）、lib/index.js（入口）和 cordis.patch.yml（註冊）。
總結¶
dsh-csv-viewer 提供了輕量且高效的 CSV/TSV 預覽方案，特別是在處理大型數據集時，虛擬化技術保證了界面的流暢度。更多細節可參考項目目錄：https://www.skillhub.cn/plugins/hi-wenw/dsh-csv-viewer 或 GitHub：https://github.com/hi-wenw/dsh-csv-viewer。
