在 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。
