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 仓库 或 技能目录。
