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