dsh-probstat：DeepSeek Harness 的确定性概率与统计推断工具箱

前言¶

DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在使用 DSH 构建模型推理或数据分析流程时，智能体常因概率论基础薄弱而产生幻觉，例如查错 Z 表、算错置信区间或误判假设检验结果。这些误差在自动化工作流中会被放大，导致错误的决策。

dsh-probstat 旨在填补这一空白，它提供了一套零运行时依赖的数学工具，用于替代智能体在概率计算中最容易出错的部分。

这是什么¶

dsh-probstat 是一个为 DeepSeek Harness (dsh) 提供确定性概率与统计推断数学计算的插件，由 TYEclipse 维护。

它包含六个核心工具，覆盖了从基础分布计算到复杂推断的完整链路：
* 分布计算：支持正态、二项、泊松、指数、均匀、几何六种分布的 PDF、CDF、生存函数、分位数及统计量。
* Z 分数：标准正态表计算，包括 Z 值与概率的相互转换。
* 置信区间：均值 Z/t 置信区间及 Wilson 比例区间。
* 事件概率：并集、交集、条件、贝叶斯公式及补集计算。
* 假设检验：单样本均值 Z/t 检验及比例检验，返回统计量、p 值、临界值及拒绝/不拒绝的决策。
* 样本量规划：针对目标误差的均值 Z 和比例（Wald/Wilson）样本量计算。

安装与启用¶

安装该插件需要使用 DeepSeek Harness 的插件管理命令：

dsh plugin --profile web add github:TYEclipse/dsh-probstat

典型用法¶

1. 分布计算¶

插件支持多种分布的密度、累积概率及分位数计算。正态分布的 CDF 使用 Abramowitz & Stegun 7.1.26 erf 拟合，绝对误差控制在 1.5e-7 以内。

{
  "distribution": "normal",
  "x": 1.96
}
// 返回 cdf 0.9750022 (P(Z ≤ 1.96))

2. Z 分数计算¶

支持 Z 值与概率的互转，以及双尾 P 值计算。

{
  "mode": "between",
  "z1": -1.96,
  "z2": 1.96
}
// 返回 0.9500043

3. 置信区间¶

支持均值 Z/t 检验及 Wilson 比例区间（适用于小样本或极端比例）。

{
  "kind": "mean_t",
  "mean": 72.5,
  "sd": 8.2,
  "n": 25
}
// 返回 [69.115, 75.885]

4. 事件概率¶

包含并集、条件概率及贝叶斯公式计算。

{
  "operation": "bayes",
  "prior": 0.001,
  "truePositive": 0.99,
  "falsePositive": 0.01
}
// 返回 0.09016

5. 假设检验¶

提供完整的假设检验流程，包括统计量、P 值、临界值及决策结论。

{
  "kind": "mean_z",
  "sampleMean": 102,
  "mu0": 100,
  "sigma": 15,
  "n": 36
}
// 返回 z 0.8, two-sided p 0.4237108, critical 1.959964 → do not reject

6. 样本量规划¶

根据目标误差计算所需的样本量。

{
  "kind": "mean_z",
  "sigma": 15,
  "marginOfError": 5
}
// 返回 n 35

适用场景与注意¶

该插件适合需要严谨数学计算的 DSH 工作流，如自动化 A/B 测试分析、风险评估或数据科学教育工具。

注意事项：
* 零运行时依赖：插件纯 JS 实现，无额外依赖。
* 精度：正态分位数使用 Acklam 反正态算法，相对误差小于 1.15e-9。
* 比例检验警告：当比例检验中的 \(n \cdot p_0 < 5\) 时，插件会发出警告，而非静默返回结果，这有助于避免不当的近似计算。
* 权限与安全：插件在当前 DSH 进程权限下运行。安装前建议检查源码与 MIT 许可证。

结尾¶

dsh-probstat 通过提供高精度的统计计算工具，降低了 DSH 智能体在处理概率与统计任务时的出错率。开发者可以通过插件目录或 GitHub 仓库获取更多文档与源码。