前言¶
在 DeepSeek Harness 桌面端開發或使用時，需要一個穩定、私密的筆記環境，用於記錄設計思路、整理技術方案或記錄日常備忘。現有方案往往依賴雲端服務或需要額外配置環境，本地存儲的 Markdown 筆記工具又難以與 DSH 深度集成。
DSH Markdown Notes 是一個獨立的 Markdown 筆記插件，直接在 DSH 桌面端側欄打開，所有筆記保存在本地文件系統，與 DSH 工作區共用同一套筆記目錄，不依賴模型調用或網絡服務。
功能概覽¶
插件提供完整的閱讀、編輯和文檔管理能力，同時支持豐富的 Markdown 語法渲染和拖拽導入等便捷操作。
閱讀與編輯¶
- 閱讀/編輯/並排模式：默認展示排版後的文章；頂欄一鍵切換「閱讀 / 編輯 / 並排」，
Ctrl+E在閱讀和上次的編輯佈局之間切換；並排模式下雙向同步滾動。 - 文檔大綱：閱讀和並排時可用，點擊跳轉，滾動時高亮當前章節。寬屏時常駐在正文右側；窗口較窄或並排時變成右邊緣的刻度條，懸停展開完整大綱，點擊刻度直接跳轉。
預覽主題¶
提供三套預覽排版，只改變顯示樣式，不修改文件：
- 默認：清爽界面風格，提示塊帶圖標，引用、分割線和高亮經過精修。
- 書刊：米色紙張底、襯線正文與標題、居中標題、段首縮進、首字下沉、楷體引用、三線表，圖片下方顯示說明。
- 公衆號：居中標題、主題色色塊的二級標題、兩端對齊、窗口式代碼塊，圖片下方顯示說明，便於預覽文章的發佈效果。
文檔管理¶
- 多級文件夾樹：支持創建、重命名、移動、刪除筆記和文件夾，拖拽筆記到文件夾上即可移動。
- 標題即時篩選：側欄篩選框輸入標題，按
Enter打開第一條，Esc清除。 - 右鍵與懸停操作：文件夾和筆記支持懸停快捷按鈕與右鍵菜單，操作結果以頂部提示顯示。
- 另存爲副本：重命名、移動到…、另存爲副本、刪除等操作均可對當前筆記進行。
自動保存與快捷鍵¶
- 停止輸入約 450 ms 後自動保存。
- 離開編輯區、切換文檔或點擊「完成」時保存。
- 支持
Ctrl+S/⌘S手動保存。 - 文件被其他編輯器修改時，插件會提示衝突並保留草稿，可使用「草稿另存爲」。
豐富的 Markdown 支持¶
- 代碼高亮、表格、任務列表、腳註、數學公式、Mermaid 流程圖、AntV 信息圖、注音和提示框。
- KaTeX 渲染數學公式，Mermaid 渲染流程圖和餅圖等圖表。
> [!TIP]等警告塊，以及::: tip、::: theorem等容器。
拖拽導入與目錄遷移¶
- 拖拽導入：將
.md/.markdown文件拖入頁面，複製導入並打開；拖到某個文件夾上時導入到該文件夾；同名文檔自動添加(2)等後綴。 - 目錄遷移：在界面中更換保存目錄，自動搬遷筆記，遷移成功後刪除空的舊文件夾。
其他能力¶
- 資源管理器：從側欄「…」菜單直接打開當前筆記目錄。
- 按需加載：未打開筆記時僅加載輕量入口，編輯器和圖表庫在使用時加載。
插件不註冊 Agent 工具，不讀取聊天記錄，不請求模型，沒有同步、附件管理或版本歷史。
安裝與啓用¶
- 從 Releases 下載
dsh-markdown-notes-0.5.4.tgz，無需解壓。 - 打開 DSH 主界面左側「插件」，點擊右上角「添加插件」。
- 粘貼下載包的完整本地路徑，例如：
D:\Plugins\dsh-markdown-notes-0.5.4.tgz
- 按提示安裝、啓用；如果提示需要重啓，重啓 DSH。
- 從左側「筆記」進入。
插件安裝包通過 engines.dsh 聲明兼容 DSH 0.2 系列（^0.2.0-rc.2）。如果更新的 DSH 拒絕安裝，請先覈對兼容性。
典型用法¶
創建與管理筆記¶
- 在側欄頂部「＋」按鈕在當前選中的文件夾中新建筆記並進入編輯。
- 單擊筆記打開閱讀，頂欄「閱讀 / 編輯 / 並排」切換模式。
- 點擊頂部的筆記名稱可以改名，點擊前面的文件夾路徑可在側欄中定位。
切換主題¶
- 頂欄「主題」切換預覽排版，選擇保存在本機。
- 主題只改變預覽顯示，不修改 Markdown 文件。
- 圖片的替代文字在書刊和公衆號主題中顯示爲圖片說明。
導入 Markdown¶
- 將 UTF-8 編碼的
.md/.markdown文件拖到筆記頁面，或選擇側欄「…」→「導入 Markdown…」。 - 拖到側欄中的某個文件夾上時導入該文件夾。
- 每批最多 20 篇、合計 20 MB，單篇最大 2 MB。
更換保存位置¶
- 在側欄「…」→「保存位置…」中選擇文件夾或輸入絕對路徑。
- 點擊「遷移並使用」：
- 保存當前草稿，檢查新舊目錄和同名衝突。
- 保持子目錄結構，複製普通.md筆記與初始化標記，並重建空文件夾。
- 保存新路徑，再清理已成功遷移的舊文件。
- 清理遷移後的空文件夾。 - 新路徑保存在
$DSH_HOME/plugin-data/dsh-markdown-notes/settings.json。
適用場景與注意¶
- 適合需要本地存儲、離線訪問、與 DSH 工作流深度集成的 Markdown 筆記場景。
- 插件以當前 DSH 進程權限運行，安裝前建議檢查插件源碼與許可證（MIT License）。
- 插件目前面向 DSH 0.2 系列（
^0.2.0-rc.2）開發，在 0.2.0-rc.2 上驗證過；其他版本尚未驗證。 - 超過 12 萬字符的文檔暫停自動預覽，超過 8,000 字符或 180 行的圖表需手動繪製，超過 32,000 字符僅展示源碼。
總結¶
DSH Markdown Notes 提供了一個輕量、本地化的 Markdown 筆記環境，支持豐富的 Markdown 語法、三套預覽主題、拖拽導入和目錄遷移等實用功能。所有筆記保存在本地文件系統，不依賴雲端服務或模型調用，適合在 DSH 桌面端進行技術文檔記錄、設計筆記整理或日常備忘。
插件目錄頁：https://www.skillhub.cn/plugins/Wanyi424/dsh-markdown-notes
GitHub：https://github.com/Wanyi424/dsh-markdown-notes
