# @actuarial-ts/core 中文文档

规范地址：https://npmcn.com/package/%40actuarial-ts/core/

版本：0\.27\.0
npm 元数据更新时间：2026-11-05T16:03:06.331Z
中文译文更新时间：2026-11-06T18:55:08.047Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40actuarial-ts/core
原文对照：https://npmcn.com/package/%40actuarial-ts/core/?lang=original
项目主页：https://github.com/yerromnitsuj/actng#readme
源码仓库：https://github.com/yerromnitsuj/actng

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：8.7 MB，1139 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-07-17T13:32:29.277Z
- 最新版本发布：2026-11-05T16:03:06.152Z
- 近 30 天下载量：2448（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

TypeScript的纯,零依赖性P&C精算数学:保留,泛定义驱动的诊断,趋势,限制,打折,并有被发布价值验证的种子花样法.

## 安装

```sh
npm install @actuarial-ts/core
```

也可以使用：`pnpm add @actuarial-ts/core`、`yarn add @actuarial-ts/core`、`bun add @actuarial-ts/core`

## README

# @ actuarial- ts/ core (帮助)

纯粹,无框架的P&C精算计算:保留模型,开发 模式、诊断指标、财务调整、预测和审查图表.

这个读取器描述 **候选人**。使用来自 相同的版本软件包集。 无害环境管理,类型脚本第一,节点20+, 没有运行时间依赖.

源寄存器为私用. 仓库用户可以从 `docs/sdk-guide.md` 财务报告和审定财务报表 `docs/migrations/0.27-sdk-cleanup.md` 用于安装, 软件包边界和归档/再计算路径。 这些指南不是 包含在 npm 沥青球。 候选文件不是出版物.

## 保持快速启动

(a) 由于索赔概要,有申报的日期和数额:

```ts
import { buildTriangles, computeDevelopmentFactors, runChainLadder, runMack } from "@actuarial-ts/core";

const { paid } = buildTriangles(claimSnapshots, { cadence: "annual", asOfDate: "2025-12-31" });
const selected = computeDevelopmentFactors(paid).averages.find((item) => item.spec.key === "all-wtd")!.values;
const chainLadder = runChainLadder(paid, { selected, tailFactor: 1.02 });
const mack = runMack(paid, { selected, tailFactor: 1.02 });
```

不可观察的三角单元格为 `null`. 量加权因子使用和/和 在有两种观测结果的行上。 CDFs从右到左相乘,尾相乘为后相乘. 缺少、零分数或负分数产生无法获取的因素,而不是 `NaN`。 。 。 . 真正的累积发展年龄为0; 缺少正- 年龄 观测结果仍然缺失。 源标签, 如 `"0"` 是一个普通的标签.

使用 `runModel` 对于连接的模型合同:它保留了打出的数量, 来源参考、假设、调查结果和现有的不确定性。 土著 内核等 `runChainLadder` 仍然有助于直接计算.

## 审查执行情况和核查

A 类 `ReviewPlan` 将输入、依赖、操作和指定产出绑定在一起. 审定计划:

```ts
import {
  runReviewPlan,
  verifyReviewPlanRun,
  replayReviewPlanRun,
  REVIEW_PLAN_VERIFICATION_LIMITS,
} from "@actuarial-ts/core";

const run = runReviewPlan(plan);
const verification = verifyReviewPlanRun({
  run,
  limits: REVIEW_PLAN_VERIFICATION_LIMITS,
});
// Explicitly execute the graph again, even for this exact live run:
const replay = replayReviewPlanRun({ run, limits: REVIEW_PLAN_VERIFICATION_LIMITS });
```

`verifyReviewPlanRun` 保存精确真实的当前进程执行; 导入或复制运行必须通过当前- SDK 执行复制 。 两条路径 请检查date=中的日期值 (帮助). `ReviewPlanVerification.assurance.calculations` 记录 `executed-current-sdk` 或者说 `replayed-current-sdk`。重新执行相同的 SDK 是可复制的证据,而不是独立的精算验证. `isVerifiedReviewPlan` 仅确认这一过程签发的收据.

`encodeReviewEvidence` 财务报告和审定财务报表 `decodeReviewEvidence` 使用情况 `actuarial-review-evidence-graph/3`共享JSON运输不准许执行 或源权威。 实物图表限制适用于实际保留的工作。 明确 树序化有其自身的扩展约束; 普通图属属性有 不扩大共享儿童. `canonicalJsonEqual` 比较完整的教条内容; 结构共享不是允许跳过验证或仅依赖散列.

## 一般诊断

申报数量、单位、开发语义、缺失和 人口/基准含义。 公式实例将类型角色与这些措施挂钩; 列报和审查规则与算术身份无关. 以下措施采用呼叫者授权的措施、人口、基准和期限政策:

```ts
import {
  CASUALTY_FORMULA_TEMPLATES,
  compileDiagnosticDefinition,
  createCasualtyMetricInstances,
  prepareDiagnosticData,
  runMetricDiagnostics,
} from "@actuarial-ts/core";

const instances = createCasualtyMetricInstances({
  counts: { reported: "reported", open: "open", closedNoPay: "closed-no-pay", closedWithPay: "closed-with-pay" },
  exposure: "earned-vehicle-years",
  amountBindings: [
    { id: "gross", paid: "gross-paid", incurred: "gross-incurred" },
    { id: "primary-250k", paid: "primary-paid", incurred: "primary-incurred" },
  ],
});

const compiled = compileDiagnosticDefinition({
  diagnosticDefinitionVersion: "1.0.0",
  id: "fleet-diagnostics",
  version: "1.0.0",
  lossRowGrain: "aggregate",
  measures,
  countPopulations,
  exposureBases,
  amountBases,
  derivedMeasures: [],
  formulas: CASUALTY_FORMULA_TEMPLATES,
  instances,
  reviewRules,
  periodAxis,
});

const prepared = prepareDiagnosticData({ definition: compiled, losses, exposures });
const result = runMetricDiagnostics({ prepared, groupMap: { fleet: "all-fleet" } });
```

源组/原产地/估价汇总和明确组别之后的分量 测绘. 接触时间宣布为 `origin-static` 或者说 `valuation-specific`。 。 。 . 合并前适用索赔水平上限;预先限定的源值必须 保留其宣布的转变,不能意味着重新产生索赔细节. 汇编验证了完整的定义,依赖性和周期坐标.

选择匹配准备、计算和到期函数 :

| 运行 | 没收证据 | 契约证据 |
| --- | --- | --- |
| 准备 | `prepareDiagnosticData` | `prepareDiagnosticDataCompact` |
| 计算 | `runMetricDiagnostics` | `runMetricDiagnosticsCompact` |
| 选择开发时代 | `sameMaturity` | `sameMaturityCompact` |
| 最近共同年龄 | `commonMaturity` | `commonMaturityCompact` |

契约所有者保留完整的审计证据。 审查评价及其评价 来源为 `pageDiagnosticReviewEvaluations` 财务报告和审定财务报表 `pageDiagnosticReviewEvaluationSources`;呼号不是采样. 物质化 明确扩展证据,并可能使用更多的内存。 副本和 解析的 JSON 无法重新创建已编译/准备的正版所有者 . 对于输入的数据和审查/执行闸门,请在 `@actuarial-ts/data`。 。 。 .

## 模型、假设和财务含义

-   保留包括链式阶梯、麦克、BF、本克坦德、科德角、预期索赔、, 频率高度 慕尼黑链状梯子 案件突出 费舍尔 -朗格 克拉克, ODP靴子和Merz-Wüthrich一年的风险。 可得性和不确定性 具体方法;检查结果结果.
-   `selectDevelopmentPattern` 将明确的平均/尾部意图约束在本地 证据. `createSelectedEstimateRange` 记录人类选定的终点和 理由;这是一个非概率范围.
-   连通调整包括平面/趋势、上限/ILF、ULAE、, 名义现金流量和有明确来源、日期和数量的贴现. `createModelForecast` 财务报告和审定财务报表 `scoreModelForecast` 保存已冷冻的预测值 并区分以后的重述与实际出现.

`AnalysisDefinition.financialTermSchedules` 解决已宣布的事故/报告/日期 超过全部索赔、发生数或政策数。 开始是包容性的, 结束独占;没有同等优先的匹配。 列表边界确实如此 不创建新的可扣除或推断的年度重排。 使用 `createFinancialTermScheduleBinding` 各种排期限制和 `deriveRecipeFinancialBasis` 从确认的输出中获取支持的输出含义 输入基础。 这些声明没有认证外部来源的事实.

公布的源定着物和独立比较是数字合同. 一揽子计划旨在支持精算师遵守ASOP; 它不能使工作产品符合要求或取代专业判断.

## 许可证

阿帕奇2.0,见LICENSE和NOTICE。 源寄存器为私有 已发布软件包保留其Apache-2.0许可证.

## 常见问题

### @actuarial-ts/core 是什么？

TypeScript的纯,零依赖性P&C精算数学:保留,泛定义驱动的诊断,趋势,限制,打折,并有被发布价值验证的种子花样法\.

### 如何安装 @actuarial-ts/core？

在项目目录运行 npm install @actuarial-ts/core，或使用 pnpm add / yarn add / bun add。

### @actuarial-ts/core 支持 TypeScript 吗？

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

### @actuarial-ts/core 支持 ESM 还是 CommonJS？

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

### @actuarial-ts/core 需要什么版本的 Node\.js？

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

### @actuarial-ts/core 可以商用吗？

@actuarial-ts/core 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @actuarial-ts/core 的下载量有多少？

根据 npm 官方下载统计，@actuarial-ts/core 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,448 次，日均约 82 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @actuarial-ts/core 还在维护吗？

最新版本 0\.27\.0 发布于 2026/11/06（2 天前）；至今共发布 28 个版本，其中过去 12 个月发布了 28 个；首次发布于 2026/07/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。