DSH 的侧边栏文件预览功能提供了基础的渲染能力。dsh-sidebar-plus 插件在此基础上进行了扩展，为文件预览增加了六项具体功能：源编辑、编辑与保存、行号显示、全局搜索、字号调节以及对比视图工具条。这些功能旨在解决在本地快速查看和微调文本内容时的操作链路问题。
插件概览¶
- 名称：dsh-sidebar-plus
- 维护者：sailoumili
- 许可：MIT
- 核心价值：给 DSH 侧边栏的文件预览新增六项功能：源编辑、编辑保存、行号、搜索、字号调节、对比视图。
核心功能¶
源编辑视图¶
仅适用于 .md / .markdown 格式文件。在侧边栏文件预览界面的右上角点击「打开方式」，选择「源编辑」。该视图支持 Markdown 语法着色显示，并包含行号。
编辑与保存¶
- 编辑：Markdown 格式文件点击「编辑」按钮，会跳转至「源编辑」视图；其余文本格式（如 json, yaml, txt 等）点击「编辑」则直接在当前视图修改。
- 保存：按
Ctrl+S或点击「保存」按钮退出编辑。插件支持自动备份旧版本，若文件已在别处被修改，会提示选择「强制保存」或「重载最新」。 - 限制：插件不接管二进制格式（Office、PDF、图片等），以免损坏原件。
行号与搜索¶
- 行号：官方「纯文本」视图新增行号显示开关，默认关闭，可随时在工具栏中开启或关闭。
- 搜索与字号：所有视图均新增搜索（支持
Ctrl+F）与字号调节功能。字号调节可通过工具条上的A−/A+按钮，或按住Ctrl滚动滚轮实现。
对比视图工具条¶
官方「本轮变更」的左右对比页（对比视图）增加了工具条，支持：
- 搜索：支持双侧或单侧搜索，搜索行内可限定范围。
- 字号：双侧同步调整字号。
- 编辑右侧：仅允许编辑右侧内容，左侧为起始快照。
备份设置¶
工具条行末新增「⋯」按钮，点击打开设置面板。可自定义备份文件夹路径，默认为 ~/.dsh/sidebar-plus-backups。更改路径时，原路径内的备份文件会自动移动至新路径。
安装与启用¶
插件已发布到 npm。
Web 端安装：
在 DSH 终端中执行以下命令：
dsh plugin --profile web add dsh-sidebar-plus
桌面端安装：
通过 DSH 界面操作：
1. 打开「设置」 -> 「插件」。
2. 点击「添加插件」。
3. 在「包名或地址」输入 dsh-sidebar-plus。
4. 安装完成后按界面提示重启一次。
注意事项¶
- 版本要求：需安装 DSH 版本
0.1.7及以上。 - 运行机制：插件仅本地运行，无任何外部网络请求。
- 热插拔机制：修改
hot-*.cjs文件约 2 秒自动生效；修改加载器本身需重启 DSH。
