更新日志

重新设计的 GitHub Sync `IMPROVED`

• 从仓库树和文件内容中自动检测 file structure + key format(`flat` 与 `nested`)
• Cloudflare 风格推荐卡片,带国旗和语言名称,锚定源语言
• 编辑弹窗暴露 File Structure 和 Key Format;保存会保留现有结构

四种文件结构 — 现已支持 Astro `NEW`

• Single file `locales/en.json` · Locale folders `locales/en/common.json` · Namespace folders `faq/en.json` *(新增)* · Locale-suffixed `faq.en.json`
• 检测、读取与对称写入路径端到端打通,含 v2 CDN manifest

更顺滑的连接与重新同步 `IMPROVED`

• "Sync now" 按钮,轮询直到完成
• 已连接/孤立的仓库会被 reconcile 而非 409
• "You're all set" 界面;GitHub Sync 流程跳过不需要的 framework/SDK 步骤

翻译工作流引擎 — 生产级强化 `IMPROVED`

• 按语言并发翻译;key-keyed LLM 契约 + dual-limit 分块 + 重试
• 批量工作流使用 GPT-4.1 Mini;批量翻译走工作流
• Cancel 端到端;`translateBatch` 修复(曾是 no-op,现已执行并在失效 provider 上明确失败)

自带 DeepL `NEW`

read-after-write 一致性 `IMPROVED`

• 编辑器、sync、publish 状态与 CMS 启用读取最新
• Billing 弥合差距 — 付费计划在 Checkout 后即时反映
• 安全: 授权状态始终 uncached 读取

自助账户删除 `NEW`

• 邮件确认删除,专属确认页 + 关闭邮件(含 OAuth)
• 等待确认状态的 Resend 按钮 + 强化的删除弹窗;用户 FK 置空

Content CMS — 更安全的发布、上传与 Trash `IMPROVED`

• Save-before-publish + dirty-state 门控;Trash、媒体上传、更清晰的按语言状态
• 多值关系字段;不再编造分析数据

可靠性与安全 `IMPROVED`

• 卡启动画面冷加载修复 + 启动看门狗;重新设计的 error/not-found/empty 状态
• 合作伙伴 OAuth: 内容 CRUD、API key 发放;新增 中文 (`zh`) 语言;生产环境不再泄露堆栈跟踪

Mastra 原生 AI Agent v3

• Mastra 迁移 — `handleChatStream` 现为规范的聊天路由,移除旧的 AI SDK 路由。
• 跨线程语义记忆 — Mastra Memory + pgvector,使用 postgres.js 适配器(Path B);768 维嵌入,HNSW 重新启用。
• 通过 `useChat` 的 HITL — `@ai-sdk/react` 原生 suspend/resume,无需自定义快照端点。
• 写入工具 Auto-Apply — 写入工具直接应用;部分成功诚实地报告为「请求 40 / 写入 38」,而非假完美数字。
• `webSearch`(Exa) — 项目感知的研究,带月度配额。
• 70%+ 上下文减少 — read/workflow 工具的 Memory 写入精简化。

Cloudflare Workers 上的工作流引擎 `NEW`

Helpway 应用内支持 `NEW`

侧边栏导航改造

• 从顶部导航栏迁移到可折叠侧边栏(受 ElevenLabs 启发)
• 范围感知的设置侧边栏 + last-context 导航
• 成员和账单显示在组织设置侧边栏
• 紧凑的用量卡片移至侧边栏底部
• 内容编辑器采用统一标题布局 + 面包屑导航

合作伙伴 OAuth 2.0 `STABLE`

• 面向 Claude Code 和 Cursor 的 OAuth(无 key)MCP onboarding
• RFC 7591 动态客户端注册 + 去重
• `GET /v1/installations` 授权发现端点
• 同意界面 polish + 自动重定向
• 通过 `dbDirect` 撤销授权(立即生效)

Content CMS 分析 `NEW`

• 表格中按条目 sparkline(7 天/30 天切换)
• Cloudflare 风格的 TimeRangePicker(10 个预设)
• 含国家/来源细分的分析侧边栏
• 基于 Cloudflare Analytics Engine 的 KV 缓存统计端点
• `publishEntry` 拒绝发布空 body 的翻译

遥测、可靠性与安全

• 迁移到 PostHog Managed Reverse Proxy + sourcemap 管道
• index.html 上的 `no-cache` + `vite: preloadError` 恢复
• TanStack Router #7120 临时方案(`wrapInSuspense: true`)
• `samlify` >= 2.13.0(XML 注入)、`dompurify` >= 3.4.0(XSS)、`next` >= 16.2.6(8 个 CVE)
• CODEOWNERS + 组织级安全基线

MCP Agent 工具

• 语义重复检测 — `createKeys` 在相同源文本存在于其他命名空间时发出警告。
• **幻影键检测** — `listKeys` 标记损坏 CDN 文件的遗留重复行（`p: true`）。
• 翻译上下文 v2 — 通过 pgvector 相似性搜索进行按键 RAG 检索。
• `setTranslations` — 载荷减少约 60% 的批量写入工具。
• `cancelSync` + `getSync` 阻塞等待 — 取消待处理发布并等待完成。

OAuth 应用系统 `BETA`

CDN 管道

• 基于哈希的差异 — 每次发布 R2 写入减少 99%。
• 命名空间交付 — 按命名空间提供翻译文件而非单一文件。
• 源作者归属 — 键携带 Git 提交作者信息。

平台

• Vercel 风格计费 UI 统一配额执行
• 上下文感知 AI 抽屉建议
• 内容 CMS Webhook 事件
• `createKeys` 路径冲突检测
• 带 CDN 分析的管理仪表板

翻译编辑器

• 批量翻译工作流： 通过 Shift+点击范围选择和批量操作，一次性选择、批准、拒绝或翻译多条翻译。

Content CMS

• 关联字段与内置 Users 模型： 内容模型现在支持关联字段，具有适当的编辑器渲染和内置作者引用。
• 内容 API 密钥与集成指南： 创建 API 密钥后，提供包含 cURL 示例、SDK 安装命令和代码片段的快速入门部分。
• Cloudflare AI 迁移与 Content MCP： 由 Cloudflare AI 驱动更快的 AI 翻译，支持基于模型的授权和 llm.txt 端点。

付表盘

• 快速入门中的交互式 AI 聊天： 无需离开设置向导，直接从引导流程中试用 AI 助手。
• 项目导航重设计： 更简洁的标签结构，将“语言”合并到概览中，并以侧边栏布局重新组织了设置。
• 重新设计的“添加语言”流程： 常用语言部分、即时搜索过滤以及地区变体分组。

错误修复与改进

• 团队成员权限： 管理员不能再分配所有者角色或移除其他管理员。待处理邀请数量现在可正确显示。
• 使用量概览： 翻译密钥和 AI 使用量数值现在从 API 获取真实数据。
• 内容编辑器崩溃： 修复了条目详情页上的“Expected drag drop context”错误。

Content CMS

• 博客、更新日志和路线图内容： 创建和编辑具有完整本地化支持的内容条目。
• 富文本编辑器： 由 PlateJS 驱动的写作体验，支持格式化、代码块等功能。
• 多语言内容翻译： 管理所有项目语言中每个内容条目的翻译。
• 草稿/发布状态控制： 通过状态管理控制内容何时上线。
• Unsplash 集成： 直接在编辑器中搜索和添加免费图片。
• 自动保存： 自动保存功能让您不会丢失任何工作。

AI 翻译

• 自动批准模式： 一键完成整个翻译流程。
• 更快的翻译建议： 改进的 AI 模型提供更高质量的翻译。

付表盘

• 帮助菜单： 快速访问支持和资源的菜单。
• 入门指南： 逐步设置向导，包含每个步骤的预计时间和备注。
• 可视化进度指示器： 一目了然地跟踪已完成的引导步骤。
• 拖放语言排序： 按您偏好的显示顺序排列语言。
• 重置语言顺序： 快速重置为默认顺序，英语置顶。

AI 代理

• 优化的 AI 响应： 所有读取端点现在返回减少 40–50% 的响应，显著降低 AI 令牌成本。
• 优化的工具输出： `getKeyDetails` 返回更高效的格式（令牌减少 55%），内置字段说明。
• 即时 HTTP 流式传输： AI 聊天立即打开 HTTP 连接，消除初始化时的感知“挂起”。
• AI 上下文窗口： 令牌计数现在使用最后一步的使用量而非累计总量。
• 自动批准用户体验： 更清晰的自动批准提示流程，使用语义化 XML 标签。

付表盘

• 备注活动类型： 使用活动记录中跟踪的备注为翻译键添加注释。
• 计费周期切换： 月度/年度定价，年度套餐享有 20% 折扣标识。
• 工具 UI 分解： 单体 tool.tsx 分解为 11 个专注文件，视觉效果零变化。

基础设施

• R2 双存储桶架构： 旗帜图片和静态资源迁移到专用 R2 存储桶（`s3.better-i18n.com`），与翻译文件分离。
• 发布查询优化： 并行化查询以加快响应时间。
• 用户归因： 同步任务现在跟踪触发它们的用户。

错误修复与改进

• MCP 发布： 修复了启用 CDN 但尚未上传文件时失败的问题。
• 软删除重命名： 修复了使用单一连接进行查找+重命名+插入的事务问题。
• VList 高度： 修复了小型翻译列表（<20 条）的高度不匹配问题。
• 缓存失效： 修复了组织设置缓存失效键问题。

MCP 工具

• MCP 发布工具： 两个新工具——`getPendingChanges` 用于预览部署，`publish` 用于将翻译部署到 CDN，全程在您的 IDE 中完成。
• 完整的 MCP 工作流： AI 助手现在可以遵循完整循环：读取 → 翻译 → 验证 → 发布 → 确认。
• 待发布提示： 写入操作现在返回提示，提醒 AI 在更改准备好时调用发布。
• MCP 路由文档： 包含分类和推荐工作流指南的完整工具文档。

CDN 与发布

• 默认 CDN 格式： 将默认格式从 JSON_FLAT 更改为 JSON_NESTED，以提高 i18n 库兼容性。
• CDN 降级支持默认启用： 新项目自动启用降级语言支持。

付表盘

• 更安全的密钥重建： 通过单一数据库事务修复软删除重命名，防止冲突。
• 更好的聊天压缩： `/compact` 命令现在显示用户消息和实际摘要内容。
• 语言排序： 语言现在按状态排序：活跃 → 草稿 → 已归档。

错误修复与改进

• 斜杠命令自动提交： 修复了重复提交问题。
• 摘要清理： 从服务器端移除了已弃用的摘要工具。

AI 与 MCP

• AI 的命名空间上下文： AI 模型现在可以在创建或更新键时附加丰富的上下文（描述、团队、领域、AI 提示、标签）。
• 更智能的键提及： AI 聊天中提及的键现在包含其命名空间上下文，以精确定位 AI。
• 更快的 Gemini 流式传输： 针对 Gemini 模型优化的系统提示，显著加快了流式传输速度。

SDK 与平台

• 本地化降级： 添加新语言时，缺失的键自动从降级语言继承。
• 开源发布： 软件包、MCP 服务器和登陆页面现已在 github.com/better-i18n/oss 公开。
• 关联命名空间： 翻译键现在与命名空间有适当的关联连接，以便更好地组织。

付表盘

• 重新设计的项目设置： 为提高可用性而全面重新设计的项目设置界面。
• 增强的过滤器 UI： 改进了翻译付表盘的过滤体验。
• CDN 重新发布支持： 删除 CDN 文件现在会重置已发布状态，允许干净地重新发布。

AI 代理

• 更流畅的 AI 响应： 将 AI SDK 升级至 v6.0.39，使用 smoothStream 实现流畅自然的响应流式传输。
• 智能上下文缓存： 项目上下文查询的 30 秒缓存减少了数据库负载并加快了 AI 响应速度。
• 更智能的 AI 思考： 升级了思考配置，以做出更准确的翻译决策。

MCP 与开发者工具

• 更好的 MCP 工具 schema： 重新设计的 MCP 工具输入格式，使 IDE 集成更加直观。
• 即时 MCP 翻译： 通过 MCP 创建的键现在自动获得批准。
• 增强的键提及： AI 聊天中的键提及添加了命名空间字段，以提升上下文感知。

付表盘

• 已保存视图描述： 为您保存的翻译视图添加描述和隐私设置。
• 更简洁的聊天 UI： 简化的复制按鈕设计，减少视觉干扰。

错误修复与改进

• 消息解析： 修复了消息解析时移除调试 console.log 的问题。
• 发布可靠性： 提高了发布批处理器的可靠性。
• 数据完整性： 增强了软删除辅助函数，以提高数据完整性。

AI 代理

• MCP 删除键工具： 使用 MCP 服务器直接从您的 IDE 软删除翻译键。
• AI 代理性能： 更快的响应时间和更好的上下文处理。
• 聊天摘要： 改进了长会话的对话摘要。
• Gemini 集成： 迁移到新的 thinkingBudget API，以获得更好的 AI 响应。

付表盘

• 开发者工具模态框： 全新现代化 DevTools，包含聊天会话查看器和网络检查器。
• 管理员模拟用户： 团队管理员现在可以模拟用户以进行调试。

错误修复与改进

• RLS 安全性： 通过适当的事务处理修复了 RLS 绕过问题。
• 软删除策略： 解决了软删除 RLS 策略无法正常工作的问题。
• API 密钥解密： 修复了 API 密钥解密问题。