DeepSeek Harness (DSH) 採用模塊化插件架構。在構建智能體時,直接在代碼中實現複雜的數學邏輯往往既低效又不穩定。xby-math 插件提供了一個專門的數學計算協議服務器,旨在將複雜的數學運算邏輯從智能體推理流程中剝離,提供標準化的計算接口。
這是什麼¶
xby-math 是由 xby-skill 維護的 DSH 插件。它是一個高性能的數學計算協議服務器,支持從基礎算術到高級微積分、線性代數、統計學以及金融計算的全面功能。插件依賴 SymPy 進行符號計算,依賴 Polars 進行數據處理。
核心功能¶
該插件提供以下核心能力:
-
基礎算術與函數
使用 SymPy 評估數學表達式。支持算術運算、三角函數、對數、指數、常數(pi, e)以及絕對值、平方根等函數。支持變量代入。 -
百分比與數值處理
支持百分比計算,包括求百分比(of)、增加、減少及變化率。
支持高級四捨五入操作,包括 round(四捨五入)、floor(向下取整)、ceil(向上取整)和 trunc(截斷)。 -
單位轉換
支持角度單位之間的轉換,主要涉及度與弧度。 -
數組操作與變換
基於 Polars,提供數組間的加減乘除、冪運算等元素級操作。支持歸一化、標準化、對數轉換等數據預處理變換。 -
數組統計與聚合
提供列/行/整體的統計量計算(均值、標準差等)。支持加權平均、點積、Sumproduct 等聚合操作。 -
數據分析
提供綜合統計分析,包括描述性統計、四分位數、異常值檢測(IQR 方法)。
支持創建數據透視表。
支持計算變量間的相關係數矩陣(Pearson, Spearman)。 -
金融計算
支持時間價值金錢(TVM)計算,可求解現值(PV)、終值(FV)、年金支付(PMT)、利率或內部收益率(IRR)。
安裝與啓用¶
當前未提供官方安裝命令。用戶可通過源碼或目錄鏈接手動集成。
典型用法¶
以下爲部分已覈實的使用示例:
// 基礎算術
2 + 2
sin(pi/2)
// 變量代入
x^2 + 2*x + 1, variables={"x": 3}
// 百分比計算
15% of 200
// 結果: 30
// 高級四捨五入
round(3.14159, 2)
// 結果: 3.14
// 單位轉換
convert_units(value=180, from_unit="degrees", to_unit="radians")
// 結果: 3.14159... (π)
// 數組元素操作
array_operations(operation="multiply", array1=[[1,2],[3,4]], array2=2)
// 數據透視表
pivot_table(index="region", columns="product", values="sales", aggfunc="sum")
適用場景與注意¶
該插件適用於需要處理數學邏輯、數據分析或金融計算的智能體場景。插件以當前 DSH 進程權限運行。由於許可證爲 MIT,可在遵守協議的前提下自由使用。建議在使用前檢查源碼以確認兼容性。
總結¶
xby-math 通過封裝 SymPy 和 Polars 的能力,爲 DSH 智能體提供了從基礎運算到複雜數據分析的標準化入口。其自動持久化的 API 密鑰設置機制也降低了配置成本。更多詳情可查閱 GitHub 倉庫 或 技能目錄。