生产环境版本更新

当前浏览的是 生产环境 文档，本页只列出生产版本的更新记录。

环境说明

用页面顶部的版本选择器切换到 测试通道后，这里会显示测试版本的更新记录。

当前版本

v0.2.4 · 2026-08-12

• 提交：v0.2.3 之后的 SDK 下载页文件名修复
• 变更：修复文档站下载的 wheel 无法安装的缺陷。此前下载页把 wheel 重命名为不带版本号的「稳定别名」twitter_sdk-py3-none-any.whl，而 wheel 文件名是 PEP 427 规定的元数据，缺版本段会让 pip 与 uv 直接拒装并报 Must have a platform tag。改为保留版本化文件名 twitter_sdk-X.Y.Z-py3-none-any.whl；同步修正 workflow 中硬编码旧别名的校验步骤，并新增 sha256sum -c 核对下载页公布的校验和；新增 test_stage_sdk_docs.py 断言产物名符合 PEP 427 且组装过程不重命名
• 兼容性：下载链接变更——由 downloads/twitter_sdk-py3-none-any.whl 变为 downloads/twitter_sdk-X.Y.Z-py3-none-any.whl，旧别名路径不再存在。GitHub Release 附件名一直是版本化的，不受影响；sdist 与复制包此前虽也被重命名但仍可安装
• 平台：android
• 验证：本地 71 项脚本测试通过；test-v0.4.5 已在测试通道完成端到端实测——从文档站下载 wheel、sha256sum -c 通过、干净环境安装成功、导入并完成状态往返
• E2E：skipped —— 本版仅文档站产物命名与校验修复，业务代码与 gRPC 契约自 v0.1.0 起未改动；测试账号仍处于平台频控冷却期
• 部署：GHCR 0.2.4 与 latest；文档站 /pro/0.2.4/、/pro/latest/ 与站点根
• Python SDK：0.2.4，三件产物；这是第一个可从文档站直接下载安装 wheel 的版本
• 已知限制：v0.2.3 及更早版本的文档站下载页提供的 wheel 无法安装（需手动重命名为带版本号的形式，或改用 GitHub Release 附件）；iOS / Web 未实现；13 个 RPC 未真机验收
• 升级与回滚：无迁移动作。回滚将 IMAGE_TAG 指回 0.2.3

历史生产版本

v0.2.3 · 2026-08-12

• 提交：v0.2.2 之后的发布记录更正
• 变更：更正 v0.2.0 与 v0.2.1 条目中关于文档站可用性的不准确表述。原文称「v0.2.0 文档站未发布、/pro/0.2.0/ 不存在」，实际情况是该版本的 mike deploy 已成功写入版本树，仅最后的 Cloudflare 上传步骤失败，v0.2.1 发布时随全量聚合补齐——/pro/0.2.0/ 内容完整且版本戳正确。错误表述会误导回滚决策（让人以为该版本文档不可用），故更正。同时在发布规范中记录这一自愈特性
• 兼容性：无破坏性变更；仅文档表述更正
• 平台：android
• 验证：已逐条核对 /pro/0.1.0/、/pro/0.2.0/、/pro/0.2.1/、/pro/0.2.2/ 均可访问且版本戳与各自版本一致；核对 v0.2.0 那次流水线中 mike deploy 为 success、仅 Wrangler 上传为 failure
• E2E：skipped —— 仅文档表述更正，无代码变更；测试账号仍处于平台频控冷却期
• 部署：GHCR 0.2.3 与 latest；文档站 /pro/0.2.3/、/pro/latest/ 与站点根
• Python SDK：0.2.3，三件产物；代码与前序版本功能等价
• 已知限制：iOS / Web 未实现；13 个 RPC 未真机验收；生产 Environment 无审批规则
• 升级与回滚：无迁移动作

v0.2.2 · 2026-08-12

• 提交：v0.2.1 之后的站点根复制清单修复
• 变更：docs_site.py 把「复制到站点根」由手工白名单改为全量复制 + 排除版本树目录。此前每加一个文档页都需同步该清单，漏掉即在站点根静默 404——v0.2.1 发布后 /grpc/llms-full.txt、/python/llms-full.txt、/releases/ 三者在站点根缺失（版本目录 /pro/0.2.1/ 下均正常）
• 兼容性：无破坏性变更；站点根内容仍完全来自 pro/latest，仅补齐此前遗漏的页面
• 平台：android
• 验证：本地 63 项脚本测试通过（新增「后加页面无需登记即到根」与「版本树不套娃」双向断言）；test-v0.4.2 已在测试通道验证
• E2E：skipped —— 本版仅文档站聚合逻辑修复，业务代码与 gRPC 契约自 v0.1.0 起未改动；测试账号仍处于平台频控冷却期
• 部署：GHCR 0.2.2 与 latest；文档站 /pro/0.2.2/、/pro/latest/ 与站点根
• Python SDK：0.2.2，三件产物；代码与前序版本功能等价
• 已知限制：iOS / Web 未实现；13 个 RPC 未真机验收；生产 Environment 无审批规则
• 升级与回滚：无迁移动作。回滚将 IMAGE_TAG 指回 0.2.1；文档站可用 /pro/0.2.1/ 固定版本地址

v0.2.1 · 2026-08-12

• 提交：v0.2.0 之后的 wrangler 版本钉定修复
• 变更：给 cloudflare/wrangler-action 钉死 wranglerVersion: 4.59.2。此前未指定版本，每次安装 wrangler@4 最新版；v0.2.0 发布时 wrangler@4.122.0 依赖的 miniflare@5.20260811.0-alpha 在 npm 上不存在，导致文档发布作业失败
• 兼容性：无破坏性变更；仅 CI 依赖版本钉定。文档内容与 v0.2.0 一致
• 平台：android
• 验证：本地门禁全绿；test-v0.4.1 已在测试通道验证 wrangler 安装与文档发布恢复正常
• E2E：skipped —— 本版仅 CI 依赖钉定，业务代码与 gRPC 契约自 v0.1.0 起未改动；测试账号仍处于平台频控冷却期
• 部署：GHCR 0.2.1 与 latest；文档站 /pro/0.2.1/、/pro/latest/ 与站点根
• Python SDK：0.2.1，三件产物；代码与 0.2.0、0.1.0 功能等价
• 已知限制：v0.2.0 的文档在其发布当次未能上传到 Cloudflare（站点根在本版发布前停留在 v0.1.0 内容），但其版本树已由 mike 写入，本版全量聚合时已补齐，/pro/0.2.0/ 现可访问。其余限制同 v0.2.0
• 升级与回滚：无迁移动作。回滚将 IMAGE_TAG 指回 0.2.0 或 0.1.0；文档站可用 /pro/0.2.0/ 或 /pro/0.1.0/ 固定版本地址

v0.2.0 · 2026-08-12

• 提交：v0.1.0 之后至 test-v0.4.0 对应提交，文档站能力补齐
• 变更：（1）新增文档站版本切换 UI，可在 Test / Pro 两个通道与各自历史版本之间切换，切换时保留当前页面路径；（2）AI 文档补足字段级契约——逐 RPC 输出请求/响应字段的类型、约束与语义，并附全部 27 个 message 定义，llms-full.txt 由 246 行增至 829 行；（3）新增 grpc/ 专项入口（含全部 proto 原文，供其它语言自行生成 stub）与 python/ 专项入口（门面方法签名、状态序列化、错误处理）；（4）接口参考与模块指引改为由 proto descriptor 与元数据自动生成，消除与契约的漂移；（5）新增 5 个任务编排工作流，写明步骤顺序与步骤间参数传递；（6）新增按通道隔离的版本更新页；（7）状态页新增任务可用性汇总
• 兼容性：无破坏性变更；gRPC 契约、Python 门面 API 与 SDK 用法均未改动。仅文档与文档生成器变更
• 平台：android
• 验证：本地门禁全绿（63 项脚本测试、20 项 Python 离线契约测试、llms 文档校验、mkdocs 严格构建、proto 生成物一致性、SDK 三件产物干净环境安装、生产镜像构建）；CI validate 复核同一套离线门禁；test-v0.4.0 已在测试通道完整验证（版本切换数据源、新增入口可达、字段契约上线）
• E2E：skipped —— 本版仅文档与生成器变更，业务代码与 gRPC 契约自 v0.1.0 起未改动；登录与发帖/删帖的真机验收结论沿用 2026-08-11 记录，其余 RPC 仍标记 implemented 待频控冷却期后验收
• 部署：GHCR ghcr.io/robin528919/go-twitter-api:0.2.0 与 :latest 已发布。文档发布作业当次失败：cloudflare/wrangler-action 未钉版本，安装 wrangler@4.122.0 时其依赖 miniflare@5.20260811.0-alpha 在 npm 上不存在。失败点在最后的上传步骤——mike deploy 已成功把本版写入 gh-pages 版本树，因此 v0.2.1 发布时随全量聚合一并上线，/pro/0.2.0/ 现可正常访问。根因修复见 v0.2.1
• Python SDK：0.2.0，wheel、sdist 与 twitter_sdk-0.2.0-copy.zip 三件产物；SDK 代码与 0.1.0 功能等价，版本号随 Tag 同步递增
• 已知限制：iOS / Web 平台未实现；互动/媒体/读取类 13 个 RPC 未经真机验收（能力清单标 implemented_not_verified）；生产 Environment 无审批规则，推送生产 Tag 即触发发布；不发布 PyPI
• 升级与回滚：无迁移动作。回滚将 IMAGE_TAG 指回 0.1.0 并重跑 compose up；文档站回滚可用 /pro/0.1.0/ 固定版本地址

v0.1.0 · 2026-08-12

• 提交：4aebf0a（Android 登录与业务 RPC 闭环）至 test-v0.3.5 对应提交，全部发布基础设施与文档站能力
• 变更：首个生产版本。交付 Tag 驱动的发布流水线（本地十一步离线门禁 + CI 复核 + GHCR 镜像）、Python SDK 随 Tag 同版本发布（wheel/sdist/可复制包，干净环境安装校验）、Cloudflare 公开文档站与 AI 对接能力清单（llms.txt / llms-full.txt / capabilities.json，公开白名单 + 输出侧边界断言）、跨主机 TLS compose 变体与默认关闭的远程部署作业。业务能力为 Android 平台 5 个 service / 16 个 RPC
• 兼容性：首个生产版本，无历史兼容性负担。gRPC 契约以本版 proto 为基线
• 平台：android
• 验证：本地门禁全绿（gofmt、go mod verify、go vet、go test -race、proto 生成物一致性、Python 离线契约测试 20 项、发布工具测试 55 项、llms 文档校验、SDK 三件产物干净环境安装、生产镜像构建）；CI validate 复核同一套离线门禁；测试通道已连续发布 5 个版本验证全链路；经 code-reviewer 审查并修复全部 HIGH 级发现
• E2E：skipped —— 本版发布内容为发布基础设施与文档站，业务代码自 4aebf0a 起未改动；登录与发帖/删帖已于 2026-08-11 完成真机验收（见 docs/llms-metadata.json 的 verified 标记），互动/媒体/读取类 RPC 标记为 implemented 而非 verified，其真机验收待测试账号频控冷却期结束
• 部署：GHCR ghcr.io/robin528919/go-twitter-api:0.1.0 与 :latest；文档站 /pro/0.1.0/、/pro/latest/ 与站点根稳定入口；远程部署开关默认关闭
• Python SDK：0.1.0，wheel、sdist 与 twitter_sdk-0.1.0-copy.zip 三件产物，附加到本 Tag 的正式 GitHub Release，并在文档站下载页公开提供（含 SHA256SUMS 与 manifest.json）
• 已知限制：iOS / Web 平台未实现，其命名空间不可调用；互动/媒体/读取类 RPC 未经真机验收（能力清单标记 implemented_not_verified）；生产 Environment 无审批规则（private 仓库免费计划限制），推送生产 Tag 即触发发布；自定义域 twitter-api.es007.com 待补 CNAME 记录，当前经 go-twitter-api-docs.pages.dev 访问；不发布 PyPI
• 升级与回滚：首个版本无升级路径。回滚将 IMAGE_TAG 指回上一固定版本后重跑 compose up；SDK 回滚使用上一版本 Release 附件。已推送的生产 Tag 不可删除后复用，修复走递增新版本