前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”，开发者可以通过扩展组件丰富智能体的能力。在进行数据分析或科学计算时，直接在对话中调用计算能力比编写代码片段更高效。xby-math-genie-calc 是一个为此场景设计的插件。
插件简介¶
xby-math-genie-calc 是由 xby-skill 维护的 DSH 客户端插件，它将 Python 的科学计算能力引入 DeepSeek Harness 环境，提供从基础四则运算到复杂数学函数的执行接口。
安装与启用¶
使用以下命令安装插件。默认使用 web 配置文件（--profile web）。
dsh plugin --profile web add github:xby_skill/xby-math-genie-calc
核心功能¶
插件提供了以下计算能力：
-
基础运算
add：两个数相加subtract：两个数相减multiply：两个数相乘divide：两个数相除exponentiation：计算幂运算，支持负整数和小数
-
三角函数
sine：计算正弦函数cos：计算余弦函数tangent：计算正切函数cotangent：计算余切函数secant：计算正割函数cosecant：计算余割函数
-
对数与根
natural_log：计算自然对数（底数为 e）common_log：计算常用对数（底数为 10）custom_log：根据给定的底数计算对数math_sqrt：使用 Python 内置的数学模块进行平方根计算operator_sqrt：使用指数运算符来计算平方根complex_sqrt：计算复数平方根
-
反三角函数与阶乘
arcsin：计算反正弦函数arccos：计算反余弦函数arctan：计算反正切函数factorial_math：求阶乘
-
配置
set_xby_apikey：在聊天中设置 API 密钥，该操作会自动持久化，重启后依然有效。
典型用法¶
在 DSH 聊天窗口中，可以直接调用上述命令。
- 设置密钥：
set_xby_apikey（需提前在小笨羊官网获取密钥） - 数值计算：例如
add 10 5、subtract 20 8 - 函数计算：例如
sine 0.5、natural_log 10
适用场景与注意事项¶
该插件适合需要频繁进行数学运算的场景，如学生作业辅助、科研数据初步处理等。
使用前需前往小笨羊官网注册并获取 API 密钥。插件以当前 DSH 进程的权限运行，安装前请检查源码与许可证。
总结¶
xby-math-genie-calc 为 DSH 提供了原生的科学计算能力。更多细节请访问：
* 插件目录页
* GitHub 仓库
