DSH-Scientific-Computing

NumPy / SciPy 数学计算工具，以 DSH（DeepSeek Harness）Cordis 插件形式集成到 AI Agent 的工具调用链。

模型可通过 math_compute 工具随时发起任意 NumPy / SciPy 运算，返回结构化 JSON 结果。

目录结构

DSH-Scientific-Computing/
├── src/
│   └── index.js              # DSH Cordis 插件（ESM，name/Config/apply）
├── scripts/
│   ├── math_compute_tool.py  # Python 计算引擎（stdin JSON → stdout JSON，安全重构版）
│   ├── run_tests.py          # 30 用例回归测试（含注入防御）
│   └── verify_plugin.py      # 五层验证脚本
├── docs/
│   ├── 集成指南.md            # 权威操作指导（唯一真相源）
│   └── 坑与经验沉淀.md         # 踩坑记录
├── cordis.patch.yml          # 发布版 bundle patch（npm 包名）
├── package.json              # npm 包清单
├── LICENSE                   # GPL-3.0
├── README.md                 # 本文档
└── AGENTS.md / CLAUDE.md     # 项目规范

安装

方式一：npm（推荐）

dsh plugin --profile web add @kiwifruit/dsh-scientific-computing

方式二：源码直装

dsh plugin --profile web add file:/你的路径/DSH-Scientific-Computing

前置条件

• Python 3.8+，已安装 numpy 和 scipy
• DSH（dsh CLI 可用）
• Node.js ≥ 18

pip install numpy scipy

快速验证

1. Python 引擎独立测试

echo '{"operation":"sum","args":[[1,2],[3,4]],"module":"numpy"}' \
  | python scripts/math_compute_tool.py

# → {"success": true, "result": {"type": "array", "value": 10}}

2. 全量回归测试

python scripts/run_tests.py
# PASS: 30/30 all passed

覆盖数组聚合、线性代数（含 solve/lstsq）、FFT、优化（lambda）、布尔参数、keepdims、注入防御、非法类型。

3. 插件合规验证

python scripts/verify_plugin.py

支持的运算

| 类别 | 操作 | module | |------|------|--------| | 数组聚合 | sum, mean, std, var, min, max, argmin, argmax, cumsum, prod, trace | numpy | | 线性代数 | inv, det, eig, eigvals, svd, qr, norm, pinv, solve | numpy.linalg | | 信号处理 | fft, ifft, rfft, irfft, fft2, ifft2, fftfreq | numpy.fft | | 矩阵乘法 | dot, matmul | numpy | | 优化 | minimize, linprog, least_squares, root | scipy.optimize | | 其他 | norm | scipy.linalg |

Lambda 函数传参

优化类操作需要传 lambda，须用字符串形式：

{
  "operation": "minimize",
  "module": "scipy.optimize",
  "kwargs": {
    "fun": "lambda x: x[0]**2 + x[1]**2",
    "x0": [1, 0]
  }
}

配置

通过 cordis.patch.yml 或 config 参数配置：

| 字段 | 默认值 | 说明 | |------|--------|------| | pythonPath | 'python' | Python 解释器路径（系统 PATH 或绝对路径） | | enginePath | 自动解析 | Python 引擎脚本路径；缺省从插件 install 位置自动解析 |

覆盖 enginePath

如需使用自定义 Python 脚本：

- insert:
    - id: scientific-computing
      name: '@kiwifruit/dsh-scientific-computing'
      config:
        pythonPath: 'python'
        enginePath: 'C:/custom/maths/math_compute_tool.py'

输出格式

成功

{
  "success": true,
  "result": {
    "type": "array" | "scalar" | "result" | "other",
    "value": [...]
  }
}

失败

{
  "success": false,
  "error": "Import error: No module named 'numpy'"
}

通信协议

插件 (JS)                    Python 引擎
   │                          │
   │── JSON stdin ──────────→│  module, operation, args, kwargs
   │←── JSON stdout ─────────│  success, result
   │                          │

验证清单

| # | 检查项 | 命令 | |---|--------|------| | 1 | 插件已安装 | dsh plugin --profile web list | | 2 | 模块形状合法 | node -e "import('./src/index.js').then(m=>console.log(m.name))" | | 3 | 引擎直连正常 | echo '{"operation":"sum","args":[[1,2]]}' \| python scripts/math_compute_tool.py | | 4 | 完整测试通过 | python scripts/run_tests.py | | 5 | 合规验证通过 | python scripts/verify_plugin.py |

发布到 npm

npm publish --access public

最后更新：2026-08-26