dsh-math-input: DeepSeek Harness 零 Token 離線數學輸入插件

DeepSeek Harness (DSH) 的 Composer 默認爲純文本輸入。若需模型推理公式，通常需手動輸入 LaTeX，過程繁瑣且易出錯。dsh-math-input 爲 DSH 提供了零 Token 消耗的離線數學輸入能力，支持手寫識別、截圖 OCR 和 LaTeX 編輯，所有推理均在瀏覽器端完成。

插件定位¶

dsh-math-input 是一個 DeepSeek Harness 插件，提供零 token 消耗的離線數學輸入能力。該插件由 xiaxi626 維護，開源協議爲 MIT，屬於模型推理類工具。

核心能力¶

插件主要提供以下功能：

手寫筆跡識別：基於 CoMER ONNX 模型，支持鼠標、觸控或手寫筆輸入。
截圖 OCR：從圖片提取 LaTeX，支持 Ctrl+V 粘貼或上傳文件。
LaTeX 編輯器：提供符號調色板，方便插入希臘字母和數學模板。
內聯渲染：輸入 \[ ... \] 即可渲染公式。
零消耗與離線：所有推理在瀏覽器端完成，不依賴遠程 API，不產生 Token 消耗。

安裝與啓用¶

安裝前請確保滿足以下環境要求：

DeepSeek Harness 版本 >= 0.1.1-rc.2
Node.js 版本 >= 20.0.0
瀏覽器支持 SharedArrayBuffer 和 WebGPU（推薦 Chrome 或 Edge）

執行以下命令安裝：

dsh plugin --profile web add github:xiaxi626/dsh-math-input

安裝成功後，重啓 DSH Web 進程，輸入行左側會出現一個 + 按鈕。

典型用法¶

點擊輸入行左側的 + 按鈕打開菜單，選擇對應功能：

手寫輸入
- 點擊“手寫輸入”，在畫布上繪製公式。
- 停頓約 1.5 秒（可在設置中調整）觸發自動識別。
- 預覽生成後，點擊“確認並插入”，公式以 \[ ... \] 形式進入 Composer。
截圖 OCR
- 點擊“截圖並識別”。
- 按 Ctrl+V 粘貼圖片，或點擊“上傳文件”。
- 插件自動提取 LaTeX，確認後插入。
LaTeX 編輯器
- 點擊“LaTeX 語法編輯器”，面板展開。
- 利用符號調色板（希臘字母、分數、根號等）插入代碼。
- 右側實時預覽，點擊“插入”寫入公式。
內聯渲染
- 在 Composer 中輸入 \[x^2 + y^2 = r^2\]，系統將自動渲染爲公式。

注意事項與限制¶

依賴環境：首次識別會下載約 7.2 MB 模型（緩存在 IndexedDB），後續加載使用緩存。
瀏覽器支持：需要支持 WebAssembly SIMD 的現代瀏覽器。若選擇 WebGPU 但不支持，引擎會自動降級爲 WASM。
緩存清理：IndexedDB 中的緩存不會自動清除，需在瀏覽器開發者工具中手動刪除 math-handwrite-models 數據庫。
識別精度：CoMER 模型針對手寫公式優化，打印公式或複雜排版可能識別效果不佳。
安全性：依賴 SharedArrayBuffer 時，需要設置 Cross-Origin-Opener-Policy 和 Cross-Origin-Embedder-Policy 請求頭。

總結¶

通過該插件，開發者可以在不產生 Token 消耗的情況下，快速輸入高質量的數學公式，提升開發與調試效率。更多細節請參考插件目錄頁或 GitHub 倉庫。