DSH 的核心理念是「一切皆插件」。對於 Web 客戶端，聊天輸入卡片通常是原生輸入框。dsh-vditor 插件使用 Vditor 3.11.3（IR 即時渲染模式）接管這一組件，將用戶消息渲染爲完整的 Markdown，提供所見即所得的輸入體驗。
插件信息¶
該插件由用戶 zhy201810576 維護，遵循 MIT 許可證。它旨在解決原生輸入框在 Markdown 渲染、代碼高亮及文件引用方面功能不足的問題，讓開發者可以在輸入框內直接編寫複雜格式的消息。
核心功能¶
Markdown 渲染與即時反饋¶
插件接管輸入卡片後，啓用 IR 模式，支持 Markdown 所見即所得。
* 代碼與公式：代碼塊支持語法高亮和語言徽標；支持 KaTeX 數學公式和 Mermaid 圖表即時渲染。
* 主題適配：界面會跟隨系統的亮色/暗色主題自動切換。
* 動態 Placeholder：根據會話狀態（如計劃模式、被阻塞原因）智能切換提示文案。
附件與文件交互¶
- 路徑膠囊：選擇工作區文件後，以膠囊形式展示路徑。插件修復了中文文件名及 Windows 反斜槓路徑的顯示問題，發送消息時會自動附入路徑。
- 粘貼圖片：剪貼板圖片可直接落盤到工作區，並生成對應的路徑膠囊。
- 內容引用：附件僅引用文件路徑，不拷貝文件內容，模型會自行讀取文件。
交互增強¶
- 斜槓命令：輸入
/可快速喚起命令列表（如/goal、/compact、/permission、/plan、/export、/feedback、/model），輸入過程中支持實時過濾。 - 文件引用：輸入
@可在工作區文件中進行實時搜索，並一鍵插入。
工具欄與狀態¶
插件自帶完整的工具行，包含以下功能：
* 模型選擇器：切換模型與推理等級。
* 權限菜單：切換審批/訪問模式，包含 Full access 的二次確認。
* 命令目錄：一鍵喚起上述斜槓命令。
* 上下文用量環：實時顯示上下文佔用百分比及構成。
安裝與啓用¶
版本要求：DeepSeek Harness (DSH) 版本需 ≥ 0.1.2-rc.1。該版本將 conversation.composer.bar 重構爲常駐輸入區，是本插件依賴的客戶端 API 基礎。
命令行安裝（推薦）¶
dsh plugin --profile web add github:zhy201810576/dsh-vditor
NPM 安裝¶
在 profile 目錄（如 ~/.dsh/profiles/web）下執行：
pnpm add dsh-vditor
隨後在 profile 的 package.json 中將 "dsh-vditor" 加入 dsh.profile.bundles 數組，重啓 DSH 生效。
典型用法¶
- 命令過濾：在輸入框輸入
/，列表會出現/goal、/compact等選項，輸入字符可實時篩選。 - 引用文件：輸入
@觸發文件搜索，選擇文件後路徑以膠囊形式展示。 - 插入圖片：直接粘貼截圖，文件會自動保存至工作區並生成路徑膠囊。
注意事項¶
- 網絡依賴：Vditor 庫通過
https://unpkg.com/vditor@3.11.3動態加載，運行環境需保持聯網。 - 版本衝突：若同時啓用本插件的動態（會話內）版本，會與正式版重複註冊，請停用其中一個。
- 文件讀取：插件僅提供路徑引用，模型會自行讀取文件內容進行推理。
生態與源碼¶
DSH 插件生態強調社區貢獻，本插件收錄在獨立社區目錄中，與 DeepSeek / 幻方無官方從屬關係。源碼與更多細節可參考：
* GitHub 倉庫
* 社區目錄頁
