用途：为已掌握 Gleam v1.6.x 基础（核心语言、类型、模式匹配、管道、use、Result/Option、标签参数、泛型、不透明类型、外部函数、BEAM 与 JavaScript 目标、基础构建工具）的开发者，提供 1.7.0 至 1.17.0 的升级与迁移参考。
主要能力：按主题组织参考文档，包括语言与诊断、编辑器与重构、包构建与配置、目标与 FFI、约定与模式、标准库迁移与行为。涵盖破坏性变更与弃用项，如 gleam.toml 使用 snake_case（dev_dependencies、tag_prefix、source_maps、typescript_declarations）；发布要求（README、公开类型或函数、licences/description/repository、Hex 认证）；语言迁移（弃用 _ as value、保留不可变更新返回值、用模式判断空列表、移除私有类型上无意义 opaque）；标准库迁移（int.range 替代 list.range、gleam/dynamic/decode 替代旧解码器、list.flatten 替代 list.concat、drop_start/drop_end/pad_start/pad_end/trim_start/trim_end 替代旧名、gleam_deque/gleam_yielder/gleam_regexp 替代已移除模块、gleam/bytes_tree 与 gleam/string_tree 替代旧构建器）。
使用方式：按工作内容阅读对应参考文件，将快速参考当作迁移清单而非详细文档替代。开发与 CI 可用 gleam dev、gleam build --warnings-as-errors、gleam format --check src test；依赖可用 Git 依赖加 ref、gleam deps tree、gleam deps outdated；导出可用 gleam export erlang-shipment 与 gleam export escript；编辑器用 gleam lsp。
适用场景：升级旧 Gleam 代码、迁移标准库 API、配置 JavaScript 输出（node/deno/bun）、编写 FFI 与外部类型、发布 Hex 包、使用语言服务器重构。
限制：资料未提供具体收费、价格、平台支持范围或效果数据；部分行为（如位数组目标支持、JavaScript 整数模式截断）需以实际目标为准。