前言¶
在 DSH 工作流裏,數學計算經常不只需要一個後端:簡單表達式和符號化簡可以用 mathjs;積分、方程求解、極限、級數、特殊函數可能需要 Wolfram Mathematica;涉及流形、座標、張量、Christoffel/Riemann/Ricci 時,SymPy.diffgeom 更合適。若逐個查找並安裝插件,配置成本會上升。
下面介紹 dsh-math-suite。它是一個 DeepSeek Harness(DSH)插件聚合包,用於一次性安裝三個數學插件。
這是什麼¶
dsh-math-suite 由 hatter123 維護,許可證爲 MIT。
它聚合安裝以下三個插件:
dsh-mathdsh-wolframdsh-diffgeom
經過上面的安裝,DSH 中會出現三類工具入口:math、wolfram、diffgeom。每個工具對應一個不同後端,因此前置依賴也不同。
核心功能¶
math:mathjs¶
dsh-math 提供 math 工具,後端爲 mathjs,支持:
- 數值求值
- 化簡
- 符號微分
該插件沒有前置依賴,屬於純 JS 實現。
wolfram:Wolfram Mathematica¶
dsh-wolfram 提供 wolfram 工具,後端爲 Wolfram Mathematica,支持:
- 積分
- 方程求解
- 極限
- 級數
- 特殊函數
該工具需要外部環境提供 Wolfram Engine,或提供 wolframscript 的 Mathematica。
diffgeom:SymPy.diffgeom¶
dsh-diffgeom 提供 diffgeom 工具,後端爲 SymPy.diffgeom,支持流形、座標和張量數學,包括:
- 外微分
d - 楔積
∧ - Lie 導數
- 協變導數
- Christoffel/Riemann/Ricci
該工具需要 Python 3 與 SymPy。
安裝與啓用¶
先確認當前 DSH 環境能滿足該包的 peer dependency 要求。package.json 中聲明的版本範圍爲:
"@deepseek-ai/dsh-tools": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0"
然後執行安裝命令:
dsh plugin --profile web add dsh-math-suite
這條命令會把 dsh-math-suite 安裝到 web profile 中。安裝完成後,按 DSH 當前提供的工具調用入口使用 math、wolfram、diffgeom。
前置依賴¶
按工具檢查依賴,避免誤以爲所有數學能力都可用。
dsh-math:無前置依賴。dsh-wolfram:需要Wolfram Engine,或提供wolframscript的 Mathematica。dsh-diffgeom:需要Python 3與SymPy。安裝 SymPy 可使用:
python -m pip install sympy
缺少前置依賴時會按工具優雅降級:dsh-math 始終可用;dsh-wolfram 和 dsh-diffgeom 在對應後端缺失時返回 Error: 信息。
適用場景與注意¶
這個插件包適合需要把不同數學後端放進同一個 DSH 工作流的開發者。它解決的是安裝和入口聚合問題:一次安裝,三個工具一起進入 profile。
使用注意:
- 插件以當前
dsh進程權限運行,安裝前應檢查源碼與許可證。 dsh-wolfram依賴外部 Wolfram 環境。dsh-diffgeom依賴 Python 3 和 SymPy 環境。- 許可證爲
MIT。
結尾¶
dsh-math-suite 的價值在於把 math、wolfram、diffgeom 三類數學工具聚合到一個 DSH 插件包裏,同時保留各後端獨立可用和獨立降級的特性。
GitHub 地址:
https://github.com/hatter123/dsh-math-suite