openai-node 7.46–7.50：五天五版，12 小时缓存与服务分层落地 SDK（2026）
openai-node 在 10 月 31 日至 11 月 3 日连发 7.46.0 到 7.50.0 五个版本，把官方 changelog 里的 12 小时 prompt caching、项目级服务分层、workload identity 等 API 侧能力落到 TypeScript 类型层。
openai-node 的 7.46.0 至 7.50.0 把官方 changelog 十月下旬的一批 API 能力批量带进了 TypeScript 类型层——按 npm registry（2026-11-04 核对），五个版本分布在 10 月 31 日与 11 月 3 日两天。
版本与功能对照
| 版本 | 发布（npm 时间） | 新增面 | 对应官方 changelog |
|---|---|---|---|
| 7.46.0 | 10-31 | agent context compaction、agent session review 与 tool settings、experimental agent time awareness、image edit markup overlays、组织外部密钥管理、SIP DTMF 命令与投递事件、typed Realtime references、hosted tool usage 暴露、按 metadata 过滤 agent sessions（#3070 等） | 10 月多条 agent / Realtime 条目 |
| 7.47.0 | 10-31 | typed Responses WebSocket warmup（#3084） | Realtime/Live 线 |
| 7.48.0 | 11-03 | Live Responses 委托工具与 choices 扩充（附穷举 switch 提示）；Responses WebSocket 稀疏输出事实保留（#3101/#3088） | Live API 扩充 |
| 7.49.0 | 11-03 | workload identity providers 与 federation rules（#3103） | changelog 暂无单列条目 |
| 7.50.0 | 11-03 | 12 小时 Responses caching 与 cache-write usage（#3106）；project service tier settings（#3105） | 10-20 十二小时缓存；10-21 服务分层 |
官方 changelog 对应关系里，最能对上号的是 7.50.0：10 月 20 日条目写明 Responses API 可选 12 小时 prompt caching，10 月 21 日条目写明可在平台设置中选择项目可用的 service tier、组织设置可限制全部项目——SDK 的 #3106 与 #3105 分别把两者落成类型与客户端支持。
升级注意点
七个字母里唯一需要动手的是 7.48.0：官方提交说明提示「exhaustive TypeScript switches may need to handle new variants」——对 Live Responses 工具类型或 choices 做穷举分派的代码，升级后要为新变体补分支。其余版本的 Features 均为新增面，Bug Fixes 主要是生态测试的依赖升级。
状态与核对口径
官方 changelog（2026-11-04 抓取 .md 全文）10 月最新条目为 10-30 的 GPT-6 Rosalind，11 月截至抓取时点无新条目；7.49.0 的 workload identity 在 changelog 里暂无单列条目，其能力边界以官方后续文档为准。五个版本的时间与 dist-tag 数据以 npm registry 当日返回为准。
下一步
关键要点
- 7.50.0（2026-11-03 发布，npm 2026-11-04 核对）：api 层新增 12 小时 Responses caching 与 cache-write usage（#3106）、project service tier settings（#3105）——对应官方 changelog 10 月 20 日「12 小时 prompt caching」与 10 月 21 日「项目服务分层」两条目
- 7.49.0（11-03）：api 层新增 workload identity providers 与 federation rules（#3103）
- 7.48.0（11-03）：扩充 Live Responses 委托工具与 choices，官方提交说明同时提醒「穷举式 TypeScript switch 可能需要处理新变体」；另修复 Responses WebSocket 稀疏输出事实的保留（#3088）
- 7.46.0 与 7.47.0 均于 10-31 发布：前者一批落地 agent context compaction、agent session review、time awareness、图像编辑 markup overlays、组织外部密钥管理、SIP DTMF、typed Realtime references 等（#3070 等），后者加入 typed Responses WebSocket warmup（#3084）
- 据官方 changelog（developers.openai.com，2026-11-04 抓取 .md 全文），10 月最新条目为 10-30 GPT-6 Rosalind；11 月截至抓取时点无新条目——SDK 的 7.49/7.50 功能均能回对到 10 月条目
常见问题
官方参考
相关文章
openai-python 3.49.0 与 openai-node 7.55.0：Agents 函数工具 async 设置的类型补齐
2026-11-10 发布的官方 SDK 双包：python v3.49.0 与 node v7.55.0 给 beta Agents 的函数工具形状补上既有 async 设置的类型标注——python 新增 async_ 别名字段与保留字 TypedDict，node 四个 interface 加 async 可选属性；python 同批修复 Microphone 录音的 WAV 编码。
阅读全文openai-python 3.48.0 与 openai-node 7.54.0：Agent 会话事件流的混淆填充与 stream_options
2026-11-09 发布的官方 SDK 双包更新：python v3.48.0 给 agent 会话事件流加了混淆填充开关（stream_options 与 include_obfuscation，33 个事件类型新增 obfuscation 字段）；node v7.54.0 仅同步 gpt-6-rosalind 类型与 agent scheduling 保留。本文全部事实经 GitHub API 与 tag 源码当日核对。
阅读全文openai-python 3.42.0 与 openai-node 7.46/7.47 更新解读：Agent 压缩与审查设置、外部密钥管理与 SIP DTMF
openai-python v3.42.0 与 openai-node v7.46.0/v7.47.0（2026-10-31）：Agents 会话新增后台压缩开关、auto_review 动作审查与 spend_control 支出上限，实验性 time_awareness 时间感知，组织级 external_keys 密钥管理面，Live sideband 的 SIP DTMF 发送命令，WebSocket 暖场与逐发送方投递回执，图像编辑 markup 蒙层。
阅读全文订阅 GPTMap Weekly
每周一封邮件，精选 OpenAI 重要更新、深度解读与最佳实践。无广告，可随时退订。
提交后将在新标签页打开 Buttondown 完成订阅确认。