dsh-file-explorer-preview-code：DSH Web 的代碼預覽與編輯插件

DSH Web 的文件瀏覽器默認提供純文本預覽。對於開發者而言，缺乏語法高亮和直接編輯能力會降低代碼閱讀和修改的效率。該插件旨在解決這一痛點。

這是什麼¶

這是一個由 wolfsonliu 維護的 DSH Web 插件。它註冊了一個名爲 “Code Editor” 的查看器，覆蓋了 dsh-file-explorer 的默認純文本預覽。插件基於 CodeMirror 6 構建，提供按語言的語法高亮、行號、撤銷/重做等編輯功能，並支持自動保存和主題跟隨。

核心功能¶

該插件提供以下能力：

多語言語法高亮：支持 90+ 種編程語言的語法高亮，文件擴展名（如 .ts, .json, .py 等）會自動映射到對應語言。
真正的編輯器：內置 CodeMirror 編輯器，支持行號、自動換行和撤銷/重做操作，而非只讀的 <pre> 標籤。
自動保存：編輯結束後 500ms 自動保存，同時也支持 Ctrl/Cmd+S 立即保存。
狀態欄：底部狀態欄顯示當前語言、光標位置（行/列）以及保存狀態（未保存、保存中、已保存、保存失敗）。
主題跟隨：編輯器高亮主題會跟隨 DSH 的深色/淺色主題切換。
查看器註冊：作爲命名查看器註冊，在文件行的 “Open with…” 菜單中顯示，可與其他查看器並存。

安裝與啓用¶

安裝前請確保已安裝 dsh-file-explorer 插件，並滿足 DSH 核心 v0.9.0+ 的版本要求。

克隆倉庫並安裝依賴

    git clone https://github.com/wolfsonliu/dsh-file-explorer-preview-code.git
    cd dsh-file-explorer-preview-code
    npm install && npm run build

添加插件到 Web 環境配置

    dsh plugin --profile web add .

典型用法¶

安裝完成後，啓動 DSH Web (dsh web)。在文件瀏覽器的文件列表中，找到代碼文件（如 .js, .py），點擊該文件行的 “Open with…” 菜單，選擇 “Code Editor” 即可進入編輯模式。

適用場景與注意¶

依賴要求：該插件依賴 @dsh-external/dsh-file-explorer，必須先安裝該插件才能正常使用命名查看器功能。
Markdown 限制：插件不支持 Markdown 文件（.md/.mdx），這些文件會回退到默認預覽。
直接寫入：編輯操作是直接寫入工作區文件，沒有差異預覽或多標籤頁功能。
大文件性能：對於超過 2MB 的大文件，插件會通過 readRawFile 加載，可能導致瀏覽器性能問題。