magnify-count

边界闭合的平滑虚构人数算法 —— 在展示统计数时，针对冷启动数字较小的情况进行虚增放大，使数据看起来更"漂亮"。

🤖 本项目完全由 AI 生成，包括代码、文档、构建配置等。

特性

• 平滑过渡：从冷启动到真实值之间，虚增部分自动平滑衰减
• 边界闭合：达到设定阈值后自动显示真实数值，不会出现跳变
• 零依赖：纯函数实现，无外部依赖
• ESM + CJS：同时支持 import 和 require

安装

npm install magnify-count

使用

import magnifyCount from 'magnify-count';
// 或
const magnifyCount = require('magnify-count');

API

magnifyCount(actualCount, maxRealValue, initialMultiplier?)

| 参数 | 类型 | 必填 | 默认值 | 说明 | |------|------|------|--------|------| | actualCount | number | ✅ | - | 实际人数 | | maxRealValue | number | ✅ | - | 达到此真实人数后不再虚增 | | initialMultiplier | number | ❌ | 3 | 初始起步倍数 |

返回值：number - 最终展示的人数（向下取整）

示例

import magnifyCount from 'magnify-count';

// 实际只有 5 人，设定 100 为上限，默认 3 倍起步
magnifyCount(5, 100);    // => 18

// 实际有 50 人，接近上限时虚增逐渐减少
magnifyCount(50, 100);   // => 81

// 达到或超过上限，直接返回真实人数
magnifyCount(100, 100);  // => 100
magnifyCount(150, 100);  // => 150

// 自定义初始倍数
magnifyCount(10, 200, 5); // => 48

算法原理

核心公式：

展示值 = x + ((M - 1) × x × (L - x)) / (L + (M - 1) × x)

其中 x 为实际人数，L 为上限阈值，M 为初始放大倍数。

虚增部分 ((M - 1) × x × (L - x)) / (L + (M - 1) × x) 会随着 x 趋近 L 而自动衰减至 0，保证在阈值处与真实值无缝衔接。

License

MIT