前言¶
DSH 支持通過插件擴展功能。在開發或使用過程中,有時需要隨時記錄想法或待辦事項。切換到外部編輯器再切回,會打斷工作流。dsh-draft 插件旨在解決這個問題,提供一個無需切換上下文的 Markdown 草稿板。
插件定位¶
這是一個基於 Markdown 的草稿板插件。它提供實時預覽和本地文件持久化能力,適合需要快速記錄、管理本地草稿的場景。
核心功能¶
- 實時預覽:輸入內容時即時渲染 Markdown。
- 本地持久化:自動保存到
$DSH_HOME/draft.md(默認路徑爲~/.dsh/draft.md),刷新或重啓進程不會丟失內容。 - 格式快捷鍵:支持鍵盤快速格式化文本。
Mod-B/Ctrl-B:切換粗體Mod-I/Ctrl-I:切換斜體Mod-L/Ctrl-L:切換任務列表複選框
安裝與啓用¶
該插件依賴 dsh 0.1.5-rc.1 或更新版本。
1、運行以下命令安裝插件:
dsh plugin --profile <profile> add dsh-draft
將 <profile> 替換爲你的配置文件名稱(默認 Web 配置文件爲 web)。
2、安裝完成後,重啓 Web UI 或刷新頁面即可生效。
典型用法¶
1、打開右側邊欄。
2、點擊邊欄標籤欄上的 + 號,選擇 Draft / 草稿。
3、開始輸入,右側會即時顯示渲染結果。
4、使用鍵盤快捷鍵進行格式調整:
- 在文本上按下 Ctrl/Cmd+B 加粗。
- 按下 Ctrl/Cmd+I 變爲斜體。
- 在列表行按下 Ctrl/Cmd+L 切換任務複選框狀態(未選中 ⇄ 已選中;普通行變爲任務行)。
- 在嵌套列表中繼續輸入時,使用 4 個空格縮進。
注意事項¶
- 版本要求:需要 dsh >= 0.1.5-rc.1,Node.js >= 18,React >= 18.0.0。
- 開發方式:該項目的代碼由 dsh agents 端到端開發,無人工直接編輯。
- 構建方式:npm 包包含預構建的瀏覽器包,無需執行本地構建。
- 生態說明:該插件收錄於社區目錄(Skillhub),與 DeepSeek 或幻方官方無從屬關係。
總結¶
dsh-draft 通過側邊欄集成的方式,提供了輕量級的 Markdown 記錄能力。利用本地文件持久化機制,配合實時預覽和快捷鍵,能夠滿足基本的草稿記錄需求。