# @fitchmultz/pi-calculator 中文文档 规范地址：https://npmcn.com/package/%40fitchmultz/pi-calculator/ 版本：4\.1\.5 npm 元数据更新时间：2026-11-01T01:28:38.167Z 中文译文更新时间：2026-11-01T03:59:20.837Z 软件包许可：MIT 本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40fitchmultz/pi-calculator 原文对照：https://npmcn.com/package/%40fitchmultz/pi-calculator/?lang=original 项目主页：https://github.com/fitchmultz/pi-calculator#readme 源码仓库：https://github.com/fitchmultz/pi-calculator ## 关键信息（来自 npm 元数据） - 包体积（解压后）：34.5 kB，8 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=24\.0\.0 - 运行依赖：2 个 - peer 依赖：typebox \*，@earendil-works/pi-tui \*，@earendil-works/pi-coding-agent \* - 首次发布：2026-10-05T23:29:59.972Z - 最新版本发布：2026-11-01T01:28:37.856Z - 已发布版本数：6（近 12 个月 6 个） ## 中文简介 确定性高精度的圆周率计算器工具 ## 安装 ```sh npm install @fitchmultz/pi-calculator ``` 也可以使用：`pnpm add @fitchmultz/pi-calculator`、`yarn add @fitchmultz/pi-calculator`、`bun add @fitchmultz/pi-calculator` ## README # pi-calculator Pi-calculator添加了一个计算器工具 [π](https://github.com/earendil-works/pi)，具有40位有效的十进制精度。用它来检查总数或评估科学表达式。 ![Pi sends an expression to the calculator, which returns a decimal result or rejects an invalid expression.](https://npmcn.com/package/%40fitchmultz/pi-calculator/.github/readme/calculator-flow.png) ## 安装并试用 使用Node.js和支持的Pi版本。看到 [兼容性的需求](https://github.com/fitchmultz/pi-calculator/blob/main/docs/reference.md#installation-options). ```sh pi install npm:@fitchmultz/pi-calculator pi ``` 在新的Pi会话中输入以下提示： ```text Use the calculator to evaluate [0.1 + 0.2, 2^64]. ``` 计算器工具回来了 `["0.3","18446744073709551616"]`. 看到 [安装选项](https://npmcn.com/package/%40fitchmultz/pi-calculator/docs/reference.md#installation-options) 用于Git安装或从Git到npm的更改。 Pi扩展以完全系统访问权限运行。在安装包之前检查源代码。 ## 表达式 试试这些表达： ```text percent(15, 200) → 30 roundTo(-1.25, 1) → -1.3 mean([2,4,6,8]) → 5 sin(radians(90)) → 1 sum([1e40,1,-1e40]) → 1 (12.5 * 1.0825) ^ 3 → 2477.500518798828125 ``` 算术支持 `+`， `-`， `*`， `/`， `%`， `^` 和 `**`, `PI` 和 `E` 为常数。将独立的计算放在一个平面数组中，如第一个示例所示。 三角函数用弧度。使用 `radians()` 将度转换为弧度。使用 `degrees()` 把弧度转换成度数。 `roundTo(value, places)` 将一半的值舍入为零。使用负数来四舍五入到十位、百位或更大的单位。 看到 [表达式引用](https://npmcn.com/package/%40fitchmultz/pi-calculator/docs/reference.md#expressions) 用于所有函数和数组索引。 ## 结果和限制 结果是十进制字符串或十进制字符串的平面数组。输入数字和算术使用一半四舍五入。大的有限结果使用科学符号。 计算器工具拒绝无效表达式、非有限结果和嵌套结果数组。如果数组中的一个结果无效，计算器工具将拒绝整个表达式。 将表达式控制在4096个字符以内。看到 [限制](https://npmcn.com/package/%40fitchmultz/pi-calculator/docs/reference.md#limits) 对于嵌套，输出大小和工作预算。 看到 [结果格式](https://npmcn.com/package/%40fitchmultz/pi-calculator/docs/reference.md#result-format) 使用计算器工具从另一个扩展。 读了 [迁移笔记](https://github.com/fitchmultz/pi-calculator/blob/main/docs/reference.md#migration) 在升级之前。 ## 验证 看到 [开发指南](https://npmcn.com/package/%40fitchmultz/pi-calculator/docs/development.md) 用于本地检查和Pi兼容性测试。看到 [更新日志](https://npmcn.com/package/%40fitchmultz/pi-calculator/CHANGELOG.md) 查看发布历史。 ## 许可证 [麻省理工学院](https://npmcn.com/package/%40fitchmultz/pi-calculator/LICENSE) ©Mitchell Fultz。 ## 常见问题 ### @fitchmultz/pi-calculator 是什么？ 确定性高精度的圆周率计算器工具 ### 如何安装 @fitchmultz/pi-calculator？ 在项目目录运行 npm install @fitchmultz/pi-calculator，或使用 pnpm add / yarn add / bun add。 ### @fitchmultz/pi-calculator 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fitchmultz\_\_pi-calculator 是否存在。 ### @fitchmultz/pi-calculator 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @fitchmultz/pi-calculator 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @fitchmultz/pi-calculator 可以商用吗？ @fitchmultz/pi-calculator 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @fitchmultz/pi-calculator 还在维护吗？ 最新版本 4\.1\.5 发布于 2026/11/01（2 天前）；至今共发布 6 个版本，其中过去 12 个月发布了 6 个；首次发布于 2026/10/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。