@bycelium/evidences-diagrams

中文文档
1.0.1发布于 2026/10/29Apache-2.0TypeScriptES Module零依赖

证据权重聚集和可视化。

此软件包已被标记为弃用

Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

中文使用文档
文档目录6 节
  1. 演示介绍
  2. 没有证据和颜色的传说
  3. 添加和组合证据
  4. 相互矛盾的证据和先验界限
  5. 模型
  6. 安装

@bycelium/evidences-diagrams

结合证据,测量失调,并探索先前的信念如何改变结果。

打开现场演示 · 下载独立演示

增加的证据

Add evidence

改变先验

Change the prior

调整证据权重

Adjust evidence weights

该演示支持英语和法语,具有可编辑的类别和说明性权重。下载的HTML可以离线工作。

演示介绍

没有证据和颜色的传说

Initial diagram with no evidence, a net weight of zero decibans, and a prior interval.

在没有证据的情况下,结果是 none (0 dBan). 前一波段是可见的 概率仍然是不确定的。颜色图例将不和谐放在 最上面,反对的证据在左边,支持的证据在右边,没有证据在 中心。

Triangular color legend showing dissonance, evidence against, no evidence, and evidence for.

添加和组合证据

Evidence controls and one supporting news report with a weight of plus five decibans.

选择一个类别,设置其支持或反对权重,并将其添加到 历史。控件的现有证据项进行编辑 相同的类别和方向。历史记录支持选择和删除。

Gray result for weak supporting evidence that leaves the posterior interval across fifty percent.

当后验间隔超过50%时,弱证据仍然是灰色的。

的证据证据
Green result for converging evidence for a claim.Red result for converging evidence against a claim.
+10 +10 +10 = +30 dBan−10 −10 −10 = −30 dBan

这些演练示例使用调整后的权重。结果从保守的先验终点开始,到后终点结束 用于显示概率的几率。

相互矛盾的证据和先验界限

Evidence path for alternating supporting and opposing entries.

带子保留了累积路径,所以相反的证据仍然可见。

Yellow result for completely dissonant evidence with zero net weight.

黄色表示不和谐:相等和相反的权重在网中抵消 重量,同时保持在绝对重量。

之前的时间间隔确切的前
A positive evidence weight evaluated across a prior interval.The same positive evidence weight evaluated with an exact prior.

移动先前的手柄或使用键盘更改每个绑定。平等的界限 形成一个精确的先验并公开一个可重用句柄。

模型

对于独立签名证据权重 wᵢ,该包计算出:

  • S = Σ wᵢ,净重。
  • A = Σ |wᵢ|,绝对重量。
  • D = 1 − |S| / A,不和谐,与 D = 0 当 A = 0.

例如, +9 dBan 和 −1 dBan 生产 S = +8 dBan, A = 10 dBan, 和 D = 20%. Decibans是对数赔率: +10 dBan 将概率乘以10。 的概率 p:

d = 10 × log10(p / (1 − p))
p = 1 / (1 + 10^(−d / 10))

先验间隔 [min, max] 以分贝表示。净证据转化为 它 [min + S, max + S],然后将每个端点转换为概率。这个 保守概率使用较低的端点作为积极证据,而 阴性证据的上终点。相等的边界产生精确的概率。

安装

pnpm add @bycelium/evidences-diagrams
API参考
import {
  aggregateEvidence,
  buildEvidenceDiagram,
  boundProbability,
} from '@bycelium/evidences-diagrams';

const evidence = [
  { id: 'report', weightDecibans: 12 },
  { id: 'counter-analysis', weightDecibans: -5 },
];

const summary = aggregateEvidence(evidence);
summary.netWeightDecibans; // 7
summary.absoluteWeightDecibans; // 17
summary.dissonance; // 10 / 17

const diagram = buildEvidenceDiagram(evidence);
diagram.steps[1].end; // { netWeightDecibans: 7, absoluteWeightDecibans: 17 }
diagram.resultant.jeffreysBand; // 'moderate'
diagram.probability.text; // 'Probability ≥ 13 %'

boundProbability(summary).direction; // 'lower'
出口目的
aggregateEvidence(weights)返回净重、绝对重量和不和谐度。
probabilityToDecibans({ probability })将概率转换为分贝。
decibansToProbability({ weightDecibans })将分贝转换为概率。
boundProbability(summary, options?)返回保守、精确或不确定的概率。
buildEvidenceDiagram(evidence, options?)返回与呈现无关的关系图模型。
jeffreysBand({ weightDecibans })返回 none, anecdotal, moderate, strong, very strong,或者 decisive;负的非零波段以 against.
color, triangleColor, trianglePosition提供图表颜色和三角形图例值。
DEFAULT_COLOR_OPTIONS提供默认颜色设置。

EvidenceWeight 有 weightDecibans. EvidenceSummary 有 netWeightDecibans, absoluteWeightDecibans, dissonance. Probability 有 probability. ProbabilityBoundsOptions 接受 minPriorDecibans 和 maxPriorDecibans. ColorOptions 增加了 saturationThresholdDecibans 和 anchors.gray, anchors.yellow, anchors.green, anchors.red.

数字 ProbabilityBound 值 direction (lower, upper,或者 exact), probability, displayPercentage和英语 text. 一个 不确定的值 direction: 'indeterminate',一个 reason 的 'no-evidence' 或者 'dissonant-evidence'和英语 text.

缺省的优先间隔为 [-15, +15] dBan. 该图表保留原始分贝 在其步骤和结果中,消费者可以选择自己的投影。

开发和本地化
pnpm install
pnpm build:demo
pnpm check

build:demo 将演示捆绑到 demo/index.html; check 运行项目 检查和用户安装测试。要添加区域设置,请在中创建字典 demo/locales/ 然后注册 demo/i18n.js. 要添加类别,请更新 demo/category-state.js 以及每个locale字典。

apache - 2.0。看到 许可证 和 请注意.

版本与发布记录

@bycelium/evidences-diagrams 共发布 3 个版本,首次发布于 2026/10/28;过去 12 个月发布了 3 个版本。

版本发布日期距今
1.0.1latest2026/10/295 天前
1.0.02026/10/285 天前
0.0.0-stage2026/10/285 天前

关于 @bycelium/evidences-diagrams 的常见问题

@bycelium/evidences-diagrams 是什么?

证据权重聚集和可视化。注意:该包已被作者标记为弃用——Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

如何安装 @bycelium/evidences-diagrams?

在项目目录运行 npm install @bycelium/evidences-diagrams,或使用 pnpm add / yarn add / bun add。

@bycelium/evidences-diagrams 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@bycelium/evidences-diagrams 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@bycelium/evidences-diagrams 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24.3.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@bycelium/evidences-diagrams 可以商用吗?

@bycelium/evidences-diagrams 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@bycelium/evidences-diagrams 还在维护吗?

最新版本 1.0.1 发布于 2026/10/29(5 天前);至今共发布 3 个版本,其中过去 12 个月发布了 3 个;首次发布于 2026/10/28。作者已将其标记为弃用,新项目建议寻找替代方案。