白小姐开奖结果数据分析发布数据字典 v2，126 个字段全量释义

2026 年 8 月 26 日，白小姐开奖结果数据分析发布数据字典 v2，收录 126 个字段，覆盖开奖记录、统计指标、图表参数与导出文件四类。每个字段都标注释义、取值边界、计算方式、示例值与更新频率，用户和开发者可以据此核对每一个数字的来源。字典页面无需登录即可访问。字典按四类组织：开奖记录 32 个字段、统计指标 54 个字段、图表参数 21 个字段、导出文件 19 个字段。

126 个字段：从期号到分位值

字段命名统一采用小写下划线风格，与数据接口保持一致。四类字段之间存在引用关系，字典用「关联字段」一栏标出，便于顺着链路查；命名规则在页面顶部说明，避免出现同义不同名的情况。每个字段包含七项信息：字段名、中文名、类型、取值边界、计算方式、示例值、更新频率。以 average_gap 为例，类型为数值，边界为 0 至 49，计算方式为「总间隔数 ÷ 出现次数，保留一位小数」，示例值 8.8。

示例值取自最近一期真实数据，脱敏后展示，数值类型保留原始精度，不做四舍五入。数据负责人陈昱说：「字典的价值在于消除歧义。同一个『遗漏』，有人理解为未出现期数，有人理解为间隔天数，写清楚之后争论就少了。」陈昱补充说，字典编写过程中最耗时的是核对历史口径，部分早期字段的说明已经与实现不一致；核对以代码为准，说明与实现冲突时修改说明，并在变更记录里注明原因。

口径变更如何公示

v2 相比 v1 新增 34 个字段，修改 9 个字段的说明，废弃 4 个字段。所有变更以表格形式公示，标注变更类型、影响范围与生效版本。新增字段主要来自属性与尾数统计，9 处说明修改集中在遗漏与区间的边界描述；公示页面按版本号归档，旧版本仍可查阅，减少沟通成本。废弃字段保留 6 个月过渡期，期间接口仍返回，但响应头附带 Deprecation 标记与替代字段名。过渡期结束后，废弃字段将返回空值而非报错，避免旧脚本直接中断。

过渡期内，文档在废弃字段旁标注替代字段与迁移示例，减少改造成本；6 个月后接口仍返回字段名，值为 null，调用方需提前做空值判断。字典页支持按字段名、中文名、所属分类三种方式检索，检索结果高亮匹配词。页面还提供字段对比功能，可以同时查看两个字段的类型、口径与示例，便于区分相近指标。检索支持模糊匹配，输入「gap」可以同时命中 average_gap 与 max_gap；对比功能最多同时选择 3 个字段，差异项用底色标出。

字典与文档、接口三方对齐

字典、接口文档与导出说明共用同一份字段源数据，任何改动只需改一处，三处同步更新。上线前做了 126 个字段的三方一致性检查，发现并修正 7 处命名不一致。字段源数据存放在独立的配置库，字典、文档与导出说明通过构建脚本生成；7 处命名不一致中，5 处是大小写差异，2 处是中文名不统一，均已修正。为方便离线查阅，字典支持导出为 CSV 与 PDF。

PDF 版按分类分节，带目录与页码，共 42 页，适合打印后贴在工位上。上线首周，PDF 下载 1,106 次。PDF 采用 A4 版式，字段说明以表格呈现，长文本自动换行不截断；CSV 版每行一个字段，包含全部七项信息，可直接导入内部知识库。下一阶段，字典将接入字段级示例数据：点击任意字段，可以直接看到最近一期的真实取值与该字段在全部历史中的分布，帮助用户理解数值范围。

该功能计划随 5.4.0 版本发布。示例数据按字段类型生成，数值型给出分布直方图，文本型给出最近 10 个取值；该功能依赖字段级统计缓存，首屏加载预计增加 0.2 秒。字段的示例值由每日任务生成，取最近一期真实数据并保留原始精度。对于已经废弃的字段，示例值保留最后一次有效取值，并标注对应期号，方便老脚本对照。字典页还提供了变更订阅入口，字段说明变动时会通过站内消息通知订阅者，首月共有 328 人订阅。