SuperAPI AI 工具集

seeded-determinism-and-golden-vectors

通用与其它

查看项目

更新于 10-16 00:21

技能介绍

用途:确保派生内容可由密钥纯函数复现——同一密钥在所有设备、时区、未来构建中输出一致,且无服务器仲裁。适用于每日推荐、程序化布局、可验证的分享结果等场景。

主要能力与规则:密钥必须由调用方注入,生成路径上不得读取时钟或环境随机数;日历日密钥用民用日期(ISO YYYY-MM-DD 或日序号),不得用 DateTime 瞬间;全流程只用一个日期定义;熵只来自派生种子。种子推导为 fnv1a64(密钥) 异或 per-feature/per-mode 盐,再经 SplitMix64 混合步,落入仓库自有的 PRNG(不依赖未指定稳定性的 Random(seed))。抽签顺序属于契约,重构不得重排。派生内容只重新生成不存储,仅持久化 (key, generatorVersion, outcome);已发布的生成器冻结,改动走新版本加 cutover。用提交到仓库的黄金向量表固定 (key, params) → 指纹 及用户可见派生指标,期望值须来自独立 oracle,刷新只能靠显式经人工评审的本地命令,CI 只验证。

用法与代码:文中给出 FNV-1a-64 哈希与 SplitMix64 的 Dart 实现及 seedFor 辅助函数,命令示例为 dart run tool/update_vectors.dart,测试用 dart test 断言冻结向量。Web 端注意 64 位整数会编译为 JS double,需限制在原生目标或改用 32 位实现。

限制与边界:黄金向量是纯生成器的数据指纹,不是渲染 UI 的参考图(后者属 widget-golden-and-a11y-testing)。校准标签只能作为冻结阈值表,不可宣称“已证明”,不得重标已发布内容。其他具体平台、定价、效果等资料暂未提供。