前言¶
DSH Web Composer 提供了基礎的交互能力。對於需要精細控制 Markdown 渲染和上下文可視化的開發者，基礎版往往缺乏對複雜語法的實時預覽以及對長文本的便捷管理。dsh-better-composer 插件通過利用 DSH 的公共接口（seams），在不接管源代碼所有權的前提下，增強了編輯器的 Markdown 渲染效果，並引入了長粘貼剪貼板和交互式上下文地圖。
功能概覽¶
該插件通過 dsh.bundle.patch 配置文件層注入增強功能。核心能力包括：
- Markdown 視覺增強：支持標題、強調、鏈接、任務列表、引用、表格、圍欄代碼塊以及保留源標籤的附件展示。
- 本地確定性補全：提供圍欄語言、任務標記、標題間距等候選詞的本地補全。
- 交互式上下文地圖：通過 Composer 圓環打開右側邊欄，展示主機投影占用/模型窗口、結構統計及每輪增長情況。
- 長粘貼剪貼板：將長文本轉換爲可編輯的引用芯片，支持文件落地。
安裝與啓用¶
安裝前需確保環境滿足依賴要求：DSH 版本 0.1.7-alpha.2 或更高，Node.js >=20，pnpm >=10。
- 檢查 DSH 版本與 Web 界面：
dsh --version
dsh web --no-open
- 安裝插件：
pnpm dsh plugin --profile web add @cheesefox/dsh-better-composer@1.0.0
- 驗證安裝：
打開 Web UI，進入 Settings → Built-in plugins → Better Composer，確認插件卡片存在。新建會話後，確認 Composer 覆蓋層和+菜單可用。
使用方法¶
長粘貼剪貼板¶
- 在 Web UI 中打開新會話。
- 粘貼超過配置閾值的文本，確認其變爲
粘貼文本芯片。 - 打開該芯片，選擇 文件送達。
- 在 文件類型 選擇器中選擇文本或代碼擴展。
- 保存編輯並確認文件被寫入
.dsh/pastes/目錄。
編輯與撤銷¶
在芯片編輯器中，測試 撤銷 和 重做：
- 手動編輯後。
- 應用 LLM 重寫預覽後。
調整配置¶
進入 Settings → Built-in plugins → Better Composer，調整長粘貼閾值。文件擴展名在單個芯片中設置，而非全局設置。
技術實現與注意事項¶
- 插件架構：客戶端入口僅加載於 Web 平臺，依賴 DSH 官方聲明的心跳、渲染、設置等公共接口。DSH Core 仍保留對源、選擇、歷史、Context 對象及發送/隊列/引導的控制權。
- 上下文醫生（Context Doctor）：實驗性功能，需 DSH
0.1.7-alpha.2。它將診斷集成到上下文地圖工作區，提供概覽、診斷、分析和反饋頁面。 - 統計數據：插件提供的統計數據不調用模型，也不會激活冷 Agent。
- 卸載：移除插件會移除覆蓋層、設置卡片、剪貼板源和側邊欄標籤，但不會修改現有的 DSH 會話歷史或 Core 源代碼。
結語¶
dsh-better-composer 適合希望在 Web 端獲得更細緻 Markdown 展示和上下文管理能力的 DSH 用戶。更多細節可參考插件目錄或 GitHub 倉庫。
