# @essrt/physics 中文文档

规范地址：https://npmcn.com/package/%40essrt/physics/

版本：26\.15\.0
npm 元数据更新时间：2026-11-13T21:32:00.702Z
中文译文更新时间：2026-11-13T22:54:33.158Z
软件包许可：AGPL-3\.0-or-later

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

原始 npm 页面：https://www.npmjs.com/package/%40essrt/physics
原文对照：https://npmcn.com/package/%40essrt/physics/?lang=original
项目主页：https://3d.holisticuniverse.com/
源码仓库：https://github.com/dvansonsbeek/3d

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

- 包体积（解压后）：1.7 MB，151 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-08-11T19:46:14.866Z
- 最新版本发布：2026-11-13T21:32:00.520Z
- 近 30 天下载量：4410（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：94（近 12 个月 94 个）

## 中文简介

ESSRT(扩展太阳系共振理论) 物理核心——纯正可注射-康克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克 完整的模型包括了系数;每个公布的版本都无一例外地记录了模型身份.

## 安装

```sh
npm install @essrt/physics
```

也可以使用：`pnpm add @essrt/physics`、`yarn add @essrt/physics`、`bun add @essrt/physics`

## README

# @essrt/物理学

物理学核心 **斯洛文尼亚** ——扩展太阳系共振理论 执行 [ESSRT 模拟器](https://3d.holisticuniverse.com/) (单位:千美元)[资料来源,AGPL-3.0](https://github.com/dvansonsbeek/3d)) (中文(简体) ). 纯计算 : 没有I/O, 没有全球, 没有DOM, 常数注入。 包裹运送 **完整的模型**,包括安装的系数,所以安装了副本 在共享的黄金主机上复制模拟器的引擎(bit-exact in) 节点;浏览器构建被持有到一个被测量到的交叉运行时间可容忍度.

## 版本 - 二轴,故意

-   **软件包组件** (这个包裹) `version`跟踪 **API 轴** —— 说 什麽 `import` 给你.
-   **模式身份** 骑 _内部_ 每个已出版的版本: `essrt.modelVersion` 输入 `package.json` 加号 `CONSTANTS_HASH` 财务报告和审定财务报表 `COEFFICIENTS_HASH` 内 `src/constants/`重建或结构模型 变换总是作为新软件包版本降落——npm的不可再现 保证了固定版本的结果永远不会改变。 散装弹 VALUES: 文物出处邮票 `inputs` 块) 排除,所以重印时不移动数字不移动散列 .

评选结果为 _型号为vX.Y(包装为A.B.C)_。 。 。 .

## 使用量

```js
import { DEFAULT_CONSTANTS, FITTED_COEFFICIENTS, createEpochPrimitives } from '@essrt/physics';
```

域模块为 CJS 子路径导出, 每个 a `create*` 工厂拿走 明确依赖性(可注入-相容性设计——反事实) 运行为一等:

```js
const { createEclipseFinders } = require('@essrt/physics/eclipse/finders');
const { createMoonSeries } = require('@essrt/physics/moon/series');
```

**类型脚本**: 包船申报文件(`types/`1个 来源“JSDoc”产生的子路径导出—— `import` 从 `@essrt/physics` 或任何子路径被完全输入; 不需要环境shim.

见 `exports` 地图在 `package.json` 整个地表:月球 (参数,序列,序列扩展,显式,ecc-通道, 深密通道,月链),地(年长,分化前相接, 框架-日期、侧向-年通道、深轨-历史),行星 (碳链、轨道链、世俗形状、世俗系列, inv-plane-frame,自旋通道,ecc-channel,几何学,模型),德克塔特 (循环,深时相接,相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相相接相接相接相接相接相接相接相相相相相相接相接相相相接相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 AstroGeo22 Earth – 月球距离历史,历史),主结构, 深长的日历 链子循环 太阳 气候和日蚀的发现者.

显示值(日/年长度、 元素作为预格式字符串,参见 [`@essrt/model-values`](https://www.npmjs.com/package/@essrt/model-values) —— 说 由此引擎在同一模型版本生成.

## 组装模型—— `createModel()`

在包裹内装有电线的警犬组装:

```js
import { createModel, DEFAULT_CONSTANTS } from '@essrt/physics';

const model = createModel();
model.identity.modelVersion;          // the shipped model identity (e.g. 'v21.0') + both content hashes
model.lunisolar.meanPeriodYearsAtYear(2000 - 380e6); // 21699 — the Devonian precession period
model.epoch.lodSecondsAtYear(2000 - 380e6);          // 78895 — the Devonian day (Wells 1963's coral count)
model.earth.obliquityDeg(2000);       // 23.4393
model.cardinal.jd(2000, 'SS');        // 2451716.5751 — June solstice 2000, the apparent Sun's crossing (USNO 2451716.575)
model.lengths.tropicalYearDays(2000); // 365.24219

// Counterfactual (§2d): inject different constants, get a different solar
// system — self-identifying, with its own constants hash.
const cf = createModel({
  ...DEFAULT_CONSTANTS,
  earthOrbital: { ...DEFAULT_CONSTANTS.earthOrbital, obliquityJ2000_deg: 23.5 },
});
cf.earth.obliquityDeg(2000);          // 23.5 — the injected anchor read through the assembly
cf.identity.counterfactual;           // true
```

地表组: `time` (准确的JD = SI的模型年转换) 轴线 : 他们的配方, `identity` (版本+散列+引用 DOI),, `epoch` (内部单元、LOD、α、QQT、前期和深时) (a) 任何年份 ±500 Myr, `lunisolar` (平均偏执症) 月球/月球扭矩分化,节点模式 节奏、节奏和时间 与公布窗口的比率), `earth` (盲目、偏心、倾角、隐蔽), `lengths` (年数和 日长, `cardinal` (Solstice/equinox JD、RA,年长), `moon` (时间间隔和月数,加上显式位置链) JD( UT) 轴- 离共享经度、 纬度和相距 Meeus系列关于框架内在论点), `eclipse` (以地心为中心) 太阳/月球日食在JD窗口上搜索,最壮观的阴道公约), `climate` (L1轨道强制公式)和 `planets` (N体链) 日期要素——近地经度、节点和倾角 平面不可变,偏心——并自旋. 验证目标被拒绝,因为 输入——反事实不能移动它所判断的目标站.

### 系列文物

地球公布的轨道历史(偏心、近地点、偏心)是 发动机的被封存的N-body系列—— 保存在 [公共仓库](https://github.com/dvansonsbeek/3d) (单位:千美元)`data/nbody-secular-series.json`),而不是在这个包。 传过来 获取已公布的值 :

```js
const series = JSON.parse(readFileSync('nbody-secular-series.json', 'utf8'));
const model = createModel(undefined, { secularSeriesArtifact: series });
model.earth.eccentricity(2000 - 100000);   // 0.04008 — the series (La2004: 0.04006)
createModel().earth.eccentricity(2000 - 100000);   // 0.03374 — the mode table
```

`model.identity.earthElements` 一个结果来自 (单位:千美元)`'secular-series'` 或者说 `'mode-table'`),所以存储值永远不会模糊. 没有文物 `createModel()` 评估嵌入式 18 个任期模式 每个时代的表格:精确于J2000年,一个紧凑的近似 (RMS 3.6-10-3 in e in against La2010a 上500kyr,该系列) 见2.5-10-5。 API 处理器、 MCP 服务器和模拟器 把文物递给我.

## 地下: 部件库

`createModel()` 组装在未组装的工厂里 每个工厂 通过一个道克对象——普通数字加 函数——没有模块导入另一个;这就是 反事实第一流,让相同的核心运行在节点和 浏览器. 集会本身是 `src/model.js`,一个作曲家的名字 切入 `src/model/` (每批数量一份档案) `one-source-movement`, (中文(简体) ), `lunar-theory`, (中文(简体) ), `sun-and-eclipses`, (中文(简体) ), `surface`,(......), 因此,数量通过它的切片文件名找到。 用于自定义接线(不同的α通道,子集组装),使用 参考适配器是 `tools/lib/` 输入 [公共仓库](https://github.com/dvansonsbeek/3d) - 东道主 模拟器和工程的核查门都在上面运行. 一个服务 水面过 `createModel()` 住在同一仓库中 (单位:千美元)`packages/api`,一个零运行时间依赖的 OpenAPI 3.1 处理器) ——仅建至托管决定.

## 证明

每一数值均取自模型参数和适用的系数 该软件包; 装配管道、核查闸门、数据集表和 文档存在于 [公共仓库](https://github.com/dvansonsbeek/3d)。 。 。 . 预印: [https://doi.org/10.2103/rs.3.rs-87588010/v4 (中文(简体) )](https://doi.org/10.21203/rs.3.rs-8758810/v4)。 。 。 .

## 许可证

AGPL-3.0-或-后传. 商业许可证: [dennis@holistoniverse.com (英语)](mailto:dennis@holisticuniverse.com)。 。 。 .

## 常见问题

### @essrt/physics 是什么？

ESSRT\(扩展太阳系共振理论\) 物理核心——纯正可注射-康克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克 完整的模型包括了系数;每个公布的版本都无一例外地记录了模型身份\.

### 如何安装 @essrt/physics？

在项目目录运行 npm install @essrt/physics，或使用 pnpm add / yarn add / bun add。

### @essrt/physics 支持 TypeScript 吗？

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

### @essrt/physics 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @essrt/physics 可以商用吗？

@essrt/physics 使用 AGPL-3\.0-or-later 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @essrt/physics 的下载量有多少？

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

### @essrt/physics 还在维护吗？

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