前言¶
在 DeepSeek Harness（dsh）裏寫長提示時，輸入框往往只是一段純文本：標題、列表、代碼塊都要靠肉眼對齊符號，發送後氣泡裏也不一定會按 Markdown 呈現。對習慣用 Markdown 組織思路的開發者來說，這和 Obsidian、常見 IDE 裏的「邊寫邊看效果」體驗差一截。dsh 的擴展模型允許客戶端插件接管對話輸入區；下面介紹社區插件 dsh-markdown-input（維護者 long6177），它把輸入框換成帶實時渲染的編輯器，並讓已發送的用戶消息在會話裏按 Markdown 顯示。
這是什麼¶
dsh-markdown-input 是一個面向 dsh Web UI（桌面客戶端） 的客戶端插件：核心能力是在 composer（輸入框）裏做 Markdown 實時渲染，方便在 dsh 裏寫結構化提示。項目自述爲 alpha、仍在積極開發；與 DeepSeek / 官方無隸屬關係，採用 MIT 許可證。目錄頁：SkillHub；源碼：GitHub long6177/dsh-markdown-input。
核心功能¶
實時渲染的 composer¶
插件通過宿主 conversation.composer 選舉鏈上的低優先級入口接管輸入區（設計見倉庫 ADR-0005），內置 CodeMirror 6 編輯器，輸入時即渲染，風格接近 Obsidian Live Preview：粗體、斜體、行內代碼、刪除線顯示爲真實樣式；光標離開當前行後，語法標記會摺疊隱藏。可切換到 源碼模式，所有 *、# 等標記保持可見。
交互約定（與 README 一致）：
- Enter 發送（兼容 IME）
- Shift+Enter 換行
- 輸入內容會同步到宿主 draft，刷新頁面後草稿仍在
用戶消息按 Markdown 展示¶
發送後的用戶消息，以及排隊中的 steering 消息，在聊天記錄裏通過 宿主自帶的渲染管線 顯示爲 Markdown，而不是整段純文本。@ 提及與 skill 芯片保留；你輸入的換行按硬換行渲染。
富文本粘貼轉 Markdown¶
從網頁或 Word 等粘貼富文本時，會把剪貼板中的 text/html 轉爲較乾淨的 Markdown：在接管的編輯器中於光標處插入；在原生 composer 上則通過宿主帶版本守衛的插入 API 處理。Ctrl/Cmd+Shift+V 仍粘貼純文本；純文本、文件、圖片粘貼保持原生行爲。
分 surface 優雅降級¶
各能力在激活前會探測宿主是否具備對應接口：內置接管面板（審批、提問、子 agent 等）優先級更高，需要時仍用原生 composer；缺少某 surface 時只關閉該特性，不關掉整個輸入面；卡片級錯誤邊界失敗時靜默回退到原生 composer，草稿不丟。
安裝與啓用¶
需要帶 Web UI 的 dsh（桌面應用）。README 寫明在真機上驗證過 dsh 0.2.0-rc.2；安裝較新版本前請先查看倉庫 Compatibility 矩陣。
在終端執行（任選其一，命令來自官方 README）：
dsh plugin --profile web add dsh-markdown-input
dsh plugin --profile web add github:long6177/dsh-markdown-input
npm 包名同爲 dsh-markdown-input；截至資料中的 package.json，插件版本爲 0.2.0-alpha.20，peerDependencies 對 @deepseek-ai/dsh 爲 ^0.2.0-rc.2。
典型用法¶
安裝並啓用 Web profile 後，無需額外配置文件即可使用，用法即「在對話輸入框裏寫 Markdown」：
- 在 composer 中輸入標題、列表、代碼塊等，觀察實時渲染；需要覈對原始符號時切換到源碼模式。
- 發送消息後，在會話氣泡中查看 Markdown 渲染結果（含代碼高亮等宿主能力）。
- 從瀏覽器或文檔複製帶格式的段落，用普通粘貼（非 Ctrl/Cmd+Shift+V）得到 Markdown 源碼後再編輯或發送。
適用場景與注意¶
適合誰： 經常在 dsh 裏寫長提示、規範、步驟清單或帶代碼塊的說明，希望輸入與歷史消息都保持 Markdown 可讀性的開發者。
兼容性： 項目不提供寬泛的版本承諾，只維護「真機跑過」的矩陣。資料中記錄：dsh 0.2.0-rc.2 與插件 0.2.0-alpha.0 至 0.2.0-alpha.20 在 2026-10-07 驗證通過；上游 0.2.1-alpha.1 在資料中標註爲 Not verified，且 semver 預發佈規則下當前 peer 範圍不接受該版本，在未通過驗證前不應假定可用。
安全與信任： 客戶端插件隨 dsh 進程權限運行。安裝前建議閱讀 GitHub 源碼 與 MIT 許可證；問題與功能請求可走 Issues。
結尾¶
dsh-markdown-input 把「寫 Markdown」從純文本編輯變成 composer 內實時預覽，並統一了發送後的展示與富文本粘貼路徑；在 dsh 仍以開發者預覽、版本間可能 breaking 的前提下，它用能力探測與降級儘量不影響原生輸入。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
