支持政策
活跃版和 LTS 发布分支、破坏性变更的判定标准及支持的运行时。
本页介绍 Text.js 各发布分支接收修复的时长，以及哪些变更属于破坏性变更。
发布分支
| 状态 | 接收内容 | 持续时间 |
|---|---|---|
| 活跃 | 新功能、修复、安全补丁 | 直到下一个主版本发布 |
| 维护期 LTS | 关键修复和安全补丁 | 下一个主版本发布后 12 个月 |
| 生命周期结束 | 无 | — |
每个主版本只为最新的次版本提供补丁：1.5.0 发布后，修复会进入 1.5.x，而非 1.4.x。2.0.0 发布后，1.x 的最后一个次版本会成为维护期 LTS 分支，并使用 lts 和 v1-lts 分发标签发布。
| 版本 | 状态 | 支持截止时间 |
|---|---|---|
| 1.x | 活跃 | 2.0.0 发布后 12 个月 |
LTS 修复范围
- Text.js 包中的安全漏洞
- 没有变通方案的崩溃、数据丢失和构建失败
- 导致控制台渲染异常的 Chrome、Edge、Firefox 和 Safari 新版本的兼容性问题
- 受支持的运行时和部署目标的兼容性问题
新功能、性能优化和重构只进入活跃分支。
破坏性变更
以下内容只会在主版本中变更，且至少提前一个次版本发出弃用警告：
@textjs/app、@textjs/react和@textjs/core的公共导出，包括@textjs/app/server和@textjs/app/cachetext.config.ts选项、textCLI 命令和标志app/中的文件约定、middleware.ts和路由段配置- 适配器输出布局（
.vercel/output、_worker.js、dist/server.js）
不在保障范围内的内容：标记为实验性或 unstable_ 的 API，包括 @textjs/core/experimental 和 @textjs/react/experimental 下的所有内容（可能在次版本中变更，并在更新日志中说明）；内部实现，如 @textjs/core/internal、x-middleware-* 请求头和 .text/ 构建元数据；canary 版本；以及 console.log 格式字符串和 CSS 的具体内容（帧的视觉效果保持一致，编码速度可能提升）。
运行时支持
| 运行时 | 支持范围 |
|---|---|
| Chrome / Edge DevTools | 当前及之前两个稳定版本 |
| Firefox 和 Safari 控制台 | 当前稳定版本 |
| Node.js | 活跃期和维护期 LTS 版本（text start、Vercel 函数） |
| Bun | 最新的 1.x 版本 |
| Cloudflare Workers | compatibility_date 为 2025-01-01 或更晚，nodejs_compat |
停止支持已结束自身生命周期的运行时版本不属于破坏性变更。
安全
通过 [email protected] 或 GitHub 安全公告 私下报告漏洞。所有受支持的分支会同时发布修复，补丁版本在 npm 上发布后再公开安全公告。
有关版本和分发标签的生成方式，请参阅发布渠道。