前言¶
在 DeepSeek Harness (DSH) 中,助手消息通常通過 HTML 渲染。直接複製(Ctrl/Cmd+C)通常會丟失鏈接、LaTeX 源碼、代碼塊語言等信息,導致粘貼到 Markdown 編輯器時格式損壞。下面介紹 dsh-message-copy-enhance 插件,它通過攔截複製事件,將助手輸出重寫爲完整的 Markdown。
核心功能¶
該插件專注於將助手消息的複製內容轉換爲 Markdown 格式,並保留特定元素的結構信息:
- Markdown 輸出:將助手輸出轉換爲 Markdown。
- 鏈接保留:保留鏈接,輸出格式爲
[label](url)。 - LaTeX 源碼保留:從 MathML 註解中檢索 TeX 源碼。
- 代碼塊保留:保留代碼塊,從類或橫幅信息中提取語言。
- HTML 轉 GFM:將標準 HTML 元素(標題、強調、列表、引用、表格)恢復爲 GitHub 風格 Markdown (GFM)。
安裝與啓用¶
該插件通過官方命令安裝:
dsh plugin --profile desktop add dsh-message-copy-enhance
該包處於預 1.0 階段,版本範圍 ^0.1.0 僅覆蓋補丁版本(0.1.x)。若要安裝最新版本,請使用 @latest 標籤。
使用方法¶
- 在助手回覆的消息中選中內容。
- 按下
Ctrl/Cmd + C複製。 - 將內容粘貼到 Typora、Obsidian 或 VS Code 等支持 Markdown 的編輯器中。
注意事項¶
- 攔截範圍:僅攔截從助手消息(
[data-chat-flow-kind="assistant"])內開始的選擇。跨多消息的選擇不會被攔截。 - 鏈接恢復:由渲染白名單過濾的鏈接(例如
file:、相對鏈接)沒有href,因此無法恢復。 - 代碼塊:僅恢復選中的行。如果選擇區域不包含橫幅,則缺少語言標籤。
- KaTeX 錯誤:渲染失敗的 KaTeX 元素(顯示爲
.katex-error)輸出爲$source$。 - 表格:輸出爲轉義了
|的 GFM 管道表。 - 依賴項:需要
@deepseek-ai/cordispeer 依賴(^4.0.1)。 - 權限:插件在當前 DSH 進程上下文中運行;安裝前請檢查源碼和許可證。
總結¶
該插件解決了從 DSH 助手消息複製內容到 Markdown 編輯器的格式丟失問題。它利用 DOM 到 Markdown 轉換器,確保鏈接、LaTeX 源碼和代碼塊語言等關鍵信息得到保留。