dsh-sci 🔬

DeepSeek Harness 零依赖科学计算工具包：物理单位换算、CODATA 物理常数、Runge–Kutta 常微分方程/动力学仿真。零核心改动。

English | 简体中文

一个 DeepSeek Harness（DSH） 的纯工具插件，注册三个科研日常会用到的模型工具，全部零依赖纯函数实现——不联网、不装外部软件、可单测：

工具	用途	示例
units_convert	物理量单位换算（长度/质量/时间/温度/能量/压强/频率/力/角度/体积/面积/电学，70+ 单位）	1 eV → J、0 ℃ → K、1 kWh → J
physical_constants	查 CODATA 物理常数（c、h、e、k、G、N_A …）	physical_constants("h")
ode_solve	四阶 Runge–Kutta 数值求解常见动力学系统（仿真引擎）	指数/Logistic/谐振子/阻尼/单摆/捕食者/传染病/洛伦兹/Van der Pol

✨ 特性

• 零依赖：单位换算、物理常数、RK4 积分器全部手写纯函数，无 node_modules 运行时依赖、无网络。
• 安全仿真：ode_solve 用模型库（9 个精选动力学系统）+ 参数化，而非任意代码执行——模型可安全调用。
• 精度可验：RK4 精度与解析解（e^-t、cos t）在单测中对标。
• 零核心改动：纯 ctx.tools.register，无客户端 bundle。

📦 安装

前置：DSH（dsh web 可运行）、Node ≥ 22.19、pnpm。

# GitHub 安装（预构建 lib/ 已提交）
dsh plugin --profile web add "github:Blaczz/dsh-sci#main"

# 本地目录安装
cd dsh-sci && npm install --legacy-peer-deps && npm run build
dsh plugin --profile web add ./dsh-sci

安装后重启 dsh web。然后直接问 agent："把 5 电子伏特换算成焦耳"、"查一下普朗克常数"、"仿真一个阻尼谐振子，ω=2, ζ=0.1，跑到 t=20"。

🔬 使用示例

用户：帮我仿真 Lotka-Volterra 捕食者模型，alpha=1, beta=0.1, gamma=1, delta=0.02，到 t=50
agent → ode_solve(model="lotka-volterra", params={...}, tEnd=50)
       → 返回时间序列 + 末态 [prey, predator]

用户：1 个电子伏特是多少焦耳？
agent → units_convert(value=1, from="eV", to="J") → 1.602176634e-19

用户：列出所有物理常数
agent → physical_constants() → c, h, e, k, G, N_A, ... 全部

🛠️ 本地开发

npm install --legacy-peer-deps
$env:DSH_NODE_MODULES = "$env:USERPROFILE\.dsh\profiles\node_modules"
npm run setup:dsh-workspace
npm run verify                          # ★ 一键门禁：clean + typecheck + test + build
npm test                                # vitest（24 项：单位/常数/ODE 精度 + manifest）