前言¶
DeepSeek Harness (DSH) 的 Web 界面使用 Lexical 純文本編輯器，在輸入框中編寫 Markdown 需要逐字輸入字符。dsh-composer-markdown 是一個純客戶端插件，旨在將輸入框的 Markdown 編輯體驗提升至成熟聊天產品的水平。
該插件專注於編輯態的視覺呈現和按鍵手勢，確保發送的文本始終保持字面 Markdown，不做發送時的重寫或美化。
核心功能¶
該插件主要提供以下編輯輔助能力：
- 列表處理：支持無序/有序列表的自動續行與重新編號。實現列表層級階梯：在列表項中按 Tab 下沉，Shift+Tab 或 Backspace 升級（整棵子樹聯動），頂層升級行爲將列表還原爲普通文本。支持原子刪除與原子箭頭跳轉，刪除項目符號時會連同縮進一起刪除。
- 行內代碼：支持成對反引號樣式。編輯時反引號會隱藏，僅顯示內部文本的樣式；關閉反引號後立即隱藏；支持所見即所得的選擇。
- 代碼圍欄：支持
```/```ts的自動閉合與僅提交時渲染。支持在圍欄邊界處一鍵解包，使用箭頭鍵可跳過標記行，在圍欄內按 Shift+Enter 插入段落。 - 鍵盤交互：所有編輯手勢依賴 Shift+Enter；Enter 鍵保持 DSH 原生的提交語義，不會被攔截。
安裝與啓用¶
安裝前需確認環境滿足以下要求：
* DSH 版本：0.1.7-rc.x（已驗證 0.1.7-rc.2）
* Node.js 版本：^22.19.0 || >=24.0.0
* 現代桌面瀏覽器（Chrome/Edge/Firefox/Safari）
使用官方安裝命令：
dsh plugin --profile web add dsh-composer-markdown
安裝完成後，必須重啓 dsh web 服務以加載插件。如果通過 link: 安裝，需重新生成 client.js 文件。
使用方式¶
- 列表層級切換：將光標置於列表項中，按 Tab 下沉一層，按 Shift+Tab 或 Backspace（在原子後）向上提升一層。
- 代碼圍欄輸入：在任意行首輸入
ts，光標會自動進入圍欄內部。在圍欄內部按 Shift+Enter 將關閉圍欄並跳轉至下一行（此時圍欄爲空）。 - 行內代碼：輸入反引號包裹文本，編輯狀態下僅顯示樣式，反引號不可見。
適用場景與注意¶
- 僅編輯態增強：插件僅改變編輯時的視覺和按鍵行爲，不改變發送時的文本內容。提交的 Markdown 是逐字節忠實的原始輸入。
- 非富文本編輯：插件不支持富文本編輯，也不在發送時重寫或美化 Markdown。
- 環境依賴：插件運行在 DSH 進程權限內，安裝前應檢查源碼與許可證。安裝後若通過
link:方式修改源碼，需重新構建。
