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。
