项目编号20261021-003。需求方向来自当日公开产品简介所有示例均为独立合成数据不是产品真实日志。要解决的具体问题按显式参考时刻和有效期将时间戳分成有效、到期和未来三组等于有效期即到期。本工具只处理主动输入的JSON不连接账户、不抓取服务也不宣称能够替代热点产品。离线导出场景往往需要先给数据一个明确口径时间是毫秒还是秒右边界是否包含空集合要返回零还是无统计值。若这些约定没有写清报告看起来一致实际含义却可能不同。这里把规则直接写入核心函数和测试界面只负责调用同一实现。输入契约记录时间与nowMs、ttlMs均为非负安全整数毫秒agenow-observed。age0为futureagettl为expired。{id:string,evaluatedMs:number}调用者应先脱敏去掉密钥、账号与个人资料。标识使用字符串不进行自动类型转换重复id会拒绝整个请求避免一个实体在统计中被重复累计。数值先检查Number.isFinite带Ms后缀的时刻还必须是安全整数不能让精度丢失悄悄改变边界判断。合成样本与可核对输出{nowMs:10000,ttlMs:2000,records:[{id:fresh,evaluatedMs:8001},{id:expired,evaluatedMs:8000},{id:future,evaluatedMs:11000}]}{fresh:[{id:fresh,ageMs:1999}],expired:[{id:expired,ageMs:2000}],future:[{id:future,ageMs:-1000}]}实现原理与源码项目采用零第三方运行依赖的ES模块。validated函数统一处理输入结构、字段类型、重复标识与数值范围analyze只保留本项目的一种算法而不是将无关模式藏在同一个演示入口。结果排序有稳定的标识兜底同样的记录即使顺序改变也得到同样的JSON结果。输入对象不被修改便于在脚本或流水线里复用。exportconstMETA{id:20261021-003,title:评测迭代执行事件新鲜度分区器,focus:按显式参考时刻和有效期将时间戳分成有效、到期和未来三组等于有效期即到期};exportconstCFG{kind:freshness,metric:iterationMs,time:evaluatedMs,ref:suiteId,lane:runner,start:beginMs,end:endMs};exportconstSCHEMA{id:string,evaluatedMs:number};exportconstSAMPLE{nowMs:10000,ttlMs:2000,records:[{id:fresh,evaluatedMs:8001},{id:expired,evaluatedMs:8000},{id:future,evaluatedMs:11000}]};functionvalidated(input){if(!input||typeofinput!object||Array.isArray(input)||!Array.isArray(input.records)||input.records.length10000)thrownewTypeError(输入必须含records数组最多10000条);constseennewSet();returninput.records.map(r{if(!r||typeofr!object||Array.isArray(r))thrownewTypeError(记录必须是对象);for(const[k,t]ofObject.entries(SCHEMA)){if(typeofr[k]!t||(tstring!r[k].trim())||(tnumber(!Number.isFinite(r[k])||r[k]0)))thrownewTypeError(字段错误k);if(tnumberk.endsWith(Ms)!Number.isSafeInteger(r[k]))thrownewRangeError(毫秒必须为安全整数);}if(seen.has(r.id))thrownewRangeError(重复idr.id);seen.add(r.id);returnr;});}exportfunctionanalyze(input){constrowsvalidated(input);if(!Number.isSafeInteger(input.nowMs)||input.nowMs0||!Number.isSafeInteger(input.ttlMs)||input.ttlMs0)thrownewRangeError(nowMs和ttlMs须为非负安全整数);constout{fresh:[],expired:[],future:[]};for(constrofrows){constageMsinput.nowMs-r[CFG.time],item{id:r.id,ageMs};out[ageMs0?future:ageMsinput.ttlMs?expired:fresh].push(item);}for(constitemsofObject.values(out))items.sort((a,b)b.ageMs-a.ageMs||a.id.localeCompare(b.id));returnout;}运行步骤与实际测试需要Node.js 18。进入project文件夹执行npm test运行node --test执行npm run report生成dist/report.json与dist/report.html。网页使用python3 -m http.server 8080启动静态服务然后访问http://localhost:8080并点击“运行分析”。不要直接双击HTML因为ES模块在file协议下可能受浏览器限制本地静态服务不需要注册外部账号。本项目实际执行8项测试全部通过专用样本的具体数字、边界与空集合口径、错误顶层、缺失字段、字段类型、重复标识、输入不可变以及记录倒序后的结果一致性。测试文件可以直接打开复查docs/测试输出.txt保存本次真实命令输出。测试通过只证明这些已覆盖场景不代表生产日志已经核验。新增规则时应该先补一个会失败的反例再修改实现避免功能描述先于真实代码。真实运行截图说明完成本地服务启动后浏览器打开项目点击“运行分析”逐项比对结果与dist/report.json然后保存screenshots/运行效果.jpg。截图同时展示项目编号、输入和结果浏览器运行回执记录源码与截图的SHA-256。它不是绘制的摘要图也不是热点产品官方界面如果源码、样本或算法改变需要重新测试和捕获旧截图不再证明新版本。限制与使用建议记录时间与nowMs、ttlMs均为非负安全整数毫秒agenow-observed。age0为futureagettl为expired。 本项目只做离线计算不读取时钟自动刷新、不联网查询真实父项、不运行真实任务也不对任何产品的SLA、准确率或生产容量作背书。输入最多10000条区间两两比较为O(n²)很大规模应改成扫描线并增加压力测试分位数需要排序窗口与引用工具也有显式规模限制。JavaScript浮点数不适合未经设计的高精度账务累计这里不处理支付或结算。报告和界面均使用textContent或HTML转义显示输入避免将用户数据当成可执行HTML这不是完整安全审计部署到公网之前仍需设计访问控制和数据保留策略。当前最适合开发、教学及导出预检不应让示例阈值直接触发业务处罚或生产动作。资源与授权配套原创源码资源正在独立提交或审核待官方资源公开核验后再回填CSDN URL当前不提供虚构下载链接。包内含README、完整MIT LICENSE、原创授权声明、合成样本、8项自动化测试、离线报告及浏览器真实截图。不含第三方源码、模型权重、品牌素材或官方截图。标签JavaScript、JSON、时间序列