dsh-math-calculator

dsh-math-calculator

一个给 DSH（DeepSeek Harness）用的高精度数学计算器插件。

模型不再心算，而是调用它：64 位 BigNumber 求值、符号微积分、线性代数、统计概率、 微分方程、单位换算、395 条带标签的公式、物理常数推演。全部本地执行，不联网。

它首先是一个计算器。此外附带一组可选的架空世界推演工具（星球、文明、收支）——

用得上就用，用不上不影响计算能力。

主包在 `dsh-math-calculator/` —— 安装、用法、完整能力清单看那份 README。

快速安装

# 从 npm（发布后）
dsh plugin --profile <profile> add dsh-math-calculator

# 从源码
git clone https://github.com/czkssg/dsh-math-calculator.git
cd dsh-math-calculator/dsh-math-calculator
npm install && npm run build
dsh plugin --profile <profile> add .

计算能力

类别 · 能做什么 高精度求值 · 64 位有效数字，10^20+5 精确到个位，不丢精度 符号运算 · 求导、积分（带 +C）、化简、展开、多项式求根（含复根） 线性代数 · 矩阵乘/逆/行列式/迹、秩、零空间、奇异值、特征值与特征向量 统计概率 · 描述统计（含偏度峰度分位数）、7 种分布的 PDF/CDF、线性与多项式回归 微分方程 · RK4 数值解，一阶方程组与二阶自动降阶 单位换算 · 73 个单位：SI、中文古制（里/丈/斤/亩/时辰）、英制、天文；温度按仿射换算 公式库 · 395 条公式，参数全可覆盖；支持三轴检索与工作区自定义 物理常数 · 改一个常数，自动重算依赖它的派生量，并评估对世界的偏离度

为什么安全

• 禁用 math.import 与 createUnit（这两者能注入任意 JS）
• AST 遍历拦截 process / require / constructor / globalThis 等标识符
• 复杂度阈值：factorial(1e9) 这类在 AST 层就拒绝
• 无 `eval`、无 `new Function`

可选：架空世界推演

同一套底座也能推演虚构世界的物理后果（重力、气候、恒星、收支、技术树）。 这部分是附加能力，对纯计算需求没有影响。见 dsh-math-calculator/README.md。

开发

cd dsh-math-calculator
npm run build        # tsc
npm run test:all     # 67 套 / 2970 项
npm run doccheck     # 注释覆盖（每个模块头 + 每条导出）
npm run preflight    # 装机前自检

文档

完整索引见 docs/README.md（按「计算 / 工程 / 数据 / 推演 / 归档」分组）。

想了解 · 去哪 安装与完整用法 · dsh-math-calculator/README.md 全部文档索引 · docs/README.md 395 条公式目录 · dsh-math-calculator/FORMULAS.md 能力边界（实测） · dsh-math-calculator/LIMITS.md 代码结构 · docs/code-map.md 关键设计决策 · docs/adr/

许可