前言¶
在 DeepSeek Harness（DSH）Web 對話中，數學公式通常由 KaTeX 渲染。頁面上看到的公式不一定適合直接複製，若需要 LaTeX 源文本，還需要額外整理。Blackspace2/dsh-math-copy 針對這個場景，爲已渲染的數學公式提供輕量、可訪問的複製交互。
這是什麼¶
Blackspace2/dsh-math-copy 是面向 DeepSeek Harness Web 客戶端的插件，由 Blackspace2 維護，許可證爲 MIT。它爲 DSH 對話中的 KaTeX 數學公式添加複製操作，幫助使用者獲取原始 LaTeX。
核心功能¶
插件會自動識別 DSH 已渲染的行內公式、行間公式以及 KaTeX 錯誤公式，並提供以下交互：
- 鼠標懸停或鍵盤聚焦時，公式輕微懸浮，並顯示柔和的邊緣光影。
- 左鍵單擊公式，直接複製爲
$$...$$。 - 右鍵單擊公式，可選擇複製爲
$...$、$$...$$或 LaTeX 塊命令\[...\]。 - 複製成功後，在公式上方顯示半透明的
Copied ✓提示。 - 支持鍵盤操作：
Enter/Space複製，菜單鍵或Shift+F10打開格式菜單，方向鍵選擇，Escape關閉。 - 支持對話流式輸出後新增的公式，並在插件卸載 / HMR 時完整清理事件與 DOM。
安裝與啓用¶
DSH 插件管理命令會調用 pnpm，安裝前先確認 pnpm 可用：
corepack enable
pnpm --version
然後從 GitHub 安裝插件：
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add "github:Blackspace2/dsh-math-copy"
安裝完成後，在希望作爲 DSH workspace 的目錄中運行 Web 客戶端：
dsh web
然後強制刷新瀏覽器中的 http://127.0.0.1:3080。
如果修改了源碼，需要重新構建：
corepack pnpm run build
安裝命令引用 GitHub 倉庫 Blackspace2/dsh-math-copy，卸載命令使用插件名 math-copy：
dsh plugin --profile web remove math-copy
典型用法¶
1、左鍵單擊公式，或聚焦後按 Enter / Space，複製爲 $$原始 LaTeX$$。
2、右鍵單擊公式，或按菜單鍵 / Shift+F10，打開復制格式菜單。
3、在菜單內用 ↑ / ↓ 切換格式。
4、按 Escape 關閉格式菜單。
適用場景與注意¶
該插件適合在 DSH Web 對話中處理數學公式，並希望直接複製 LaTeX 源文本的使用者或開發者。
需要注意：
- 當前面向 DeepSeek Harness
0.1.0-rc.6Web 客戶端。 package.json要求 Node.js>=20，packageManager指定pnpm@11.21.0。- 插件只依賴穩定的客戶端模塊交接協議和 KaTeX 標準 DOM，不依賴 DSH 內部 React 組件實現。
- DSH 本身負責 Markdown 數學語法識別與 KaTeX 渲染；本插件從 KaTeX 的
application/x-tex註解讀取原始 LaTeX，不從視覺文本反向猜測公式。 - 如果現代 Clipboard API 因權限不可用，插件會嘗試使用同一用戶手勢中的
document.execCommand('copy')兼容路徑。 - 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
