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 仓库。