v1.4.8

AgentGate 1.4.8

English section headings are generated automatically. Detailed notes follow the bilingual changelog source.

Added / 新增

• Configurable request body limit / 请求体上限可配置 —— The gateway request body limit now defaults to 32 MB and can be changed in Settings or via AGENTGATE_REQUEST_BODY_LIMIT_MB; both paths are capped at 128 MB to avoid accidental memory blow-ups. 网关单次请求体上限默认 32 MB，可在设置里调整，也可用 AGENTGATE_REQUEST_BODY_LIMIT_MB 覆盖；两条路径都硬限制最高 128 MB，避免误设超大值打爆内存。

Fixes / 修复

• Friendly 413 errors / 413 错误提示可理解 —— Oversized requests now return a structured AgentGate error with guidance to start a new session, reduce payload size, or raise the configured limit, instead of surfacing Axum's raw Payload Too Large message. 请求过大时返回结构化 AgentGate 错误，并提示新开会话、减少内容或调大上限，不再把 Axum 原始 Payload Too Large 文案直接丢给用户。
• Existing database upgrade path / 存量数据库升级路径 —— Existing v6 databases now receive the request_body_limit_mb column through a guarded v7 migration, preventing settings reads from breaking after upgrade. 存量 v6 数据库会通过带守卫的 v7 迁移补上 request_body_limit_mb 字段，避免升级后读取设置失败。

Performance / 性能

• Bounded request-log storage / 请求日志存储有界 —— Large raw/converted request and response bodies, SSE event logs, and trace JSON are capped per field before writing to SQLite; retention cleanup and manual log clearing now checkpoint and vacuum the database so deleted log pages can be returned to disk. 写入 SQLite 前会限制大体积原始/转换请求、响应、SSE 事件和 trace JSON 的单字段大小；保留期清理和手动清空日志后会执行 checkpoint 与 vacuum，让删除后的日志页释放回磁盘。

v1.4.7

AgentGate 1.4.7 — Daily cost alert & a stability fix / 今日花费预警与稳定性修复

What's new

• Daily cost alert. Set a daily spend threshold in Settings; when today's total cost crosses it, AgentGate sends a system notification + pet bubble — at most once per day, so no spam.

Fixes

• Existing-user upgrade crash. Some newly added settings columns were only created for brand-new databases, so already-installed users hit DATABASE_ERROR after upgrading (blank Overview). New columns now go through versioned migrations with idempotent guards, with a regression test on the existing-DB upgrade path.

本次更新

• 今日花费预警。 在设置里设一个每日花费阈值,当今日累计花费超过它时,AgentGate 发系统通知 + 桌宠气泡提醒——每天最多一次,不刷屏。

修复

• 存量用户升级崩溃。 部分新增设置列此前只对全新数据库创建,导致已安装用户升级后 DATABASE_ERROR(概览白屏)。现改为走带幂等守卫的版本化迁移,并补了存量数据库升级的回归测试。

Why it matters / 为什么重要

Cost alert keeps spend visible before it surprises you; the migration fix makes upgrades safe for everyone already on AgentGate. 花费预警让开销在失控前就被看见;迁移修复让所有已在用 AgentGate 的人升级时不再踩坑。

Full changelog / 完整更新

See CHANGELOG.md for the full itemized list.

v1.4.6

AgentGate 1.4.6 — Scenario routing by model name / 按模型名做场景路由

What's new

• Route by client model name. A route's provider can now match on the requested model name, so background subtasks (e.g. Claude Code's haiku calls) go to a cheaper provider while the main conversation stays on your primary one. Works across Claude Code / Codex / Gemini.
• Config write verification. After applying a client config (Codex / Claude Code / Gemini / others), AgentGate reads the file back and verifies it landed correctly — a mis-written config now reports an error instead of a false success.
• Slimmer Routes page. Removed the duplicated "Conditions" summary block, and the fallback chain now only shows in failover mode, so the page is much shorter.

本次更新

• 按客户端模型名路由。 路由里的供应商现在可按请求的模型名匹配，把后台子任务(如 Claude Code 的 haiku 调用)分流到便宜供应商，主对话仍走主力供应商。Claude Code / Codex / Gemini 三端通用。
• 配置写后校验。 应用客户端配置(Codex / Claude Code / Gemini 等)后，AgentGate 会读回文件确认写入正确，写歪时报错而不是假成功。
• 路由页更精简。 去掉重复的「条件」汇总区块，失败转移链路仅在故障转移模式显示，页面短一大截。

Why it matters / 为什么重要

Scenario routing is the most-requested way to cut cost — cheap models for cheap work, strong models where it counts. 场景路由是最被需要的省钱方式——便宜活儿用便宜模型，关键处用强模型。

Full changelog / 完整更新

See CHANGELOG.md for the full itemized list.

v1.4.5

AgentGate 1.4.5 — Steadier Codex on third-party gateways / Codex 接第三方网关更稳

What's new

• Codex no longer stalls in long conversations. Applying a Codex config now enlarges the context window, so auto-compaction won't kick in early and freeze long chats.
• Images + text to Codex keep their content. Fixed a bug where the message body was dropped when sending mixed image/text to Codex.
• Cheaper auto-compaction. When the middle history is tiny, the gateway skips the summary round-trip instead of spending an upstream call on it.

本次更新

• Codex 长对话不再卡死。 应用 Codex 配置时加大上下文窗口，避免自动压缩过早触发、把长对话卡住。
• 发图文给 Codex 不再丢内容。 修复混合图文消息发给 Codex 时正文被丢弃的问题。
• 自动压缩更省。 中间历史很小时跳过摘要 round-trip，不为这点历史白发一次上游调用。

Why it matters / 为什么重要

For anyone running Codex through AgentGate, long chats and image+text turns are now reliable. 用 Codex 接 AgentGate 的用户，长对话和图文场景现在更稳。

Full changelog / 完整更新

See CHANGELOG.md for the full itemized list.

AgentGate 1.4.4

AgentGate 1.4.4 — Fresh icons and polish / 图标焕新与细节打磨

What's new

• Refreshed app and sidebar icons. Updated icon assets give the app and its sidebar a cleaner, more recognizable look.
• Smoother interactions. Code optimizations and small interaction tweaks across the app.

本次更新

• 应用与侧栏图标焕新。 更新图标资源，应用和侧栏更清爽、更好认。
• 交互更顺手。 一轮代码优化和交互细节调整。

Why it matters / 为什么重要

A polish release — no new features, just a cleaner look and smoother day-to-day feel. 一个打磨版本——没有新功能，只让界面更清爽、日常使用更顺手。

Full changelog / 完整更新

See CHANGELOG.md for the full itemized list.

v1.4.3

AgentGate 1.4.3 — Never miss your turn with Claude Code / 不再错过 Claude Code 该你上场的时刻

What's new

• Your pet now watches Claude Code for you. Step away during a long run — the moment Claude Code needs permission or finishes a turn, the desktop pet pops a bubble and a system notification so you can jump back in. Busy-working events stay silent, so no spam.
• Important alerts don't get buried. Waiting/done messages from Claude Code now outrank ordinary pet chatter and won't be pushed off-screen.
• Join the conversation. GitHub Discussions is now linked from the README.

本次更新

• 桌宠帮你盯着 Claude Code。 长任务挂机时，Claude Code 一旦需要授权或本轮跑完，桌宠会同时弹气泡和系统通知，你能立刻回来接手；工作中的事件保持安静，不刷屏。
• 重要提示不会被淹没。 Claude Code 的等待/完成提示优先级高于普通桌宠气泡，不会被顶掉。
• 参与讨论。 README 顶部新增 GitHub Discussions 入口。

Why it matters / 为什么重要

AgentGate's desktop pet evolves from a mascot into a Claude Code status companion — turning idle waiting into a hands-free workflow. 桌宠从吉祥物升级为 Claude Code 状态助手，把"盯着终端等"变成"挂机也不漏"。

Full changelog / 完整更新

See CHANGELOG.md for the full itemized list.

v1.4.2

AgentGate 1.4.2 — A real front door, in two languages / 一个真正的对外门面，双语上线

What's new

• There's now a website. AgentGate has a bilingual landing page at https://dengmengmian.github.io/agentgate-ai/ with a CLI-flavored design. The download section pulls the latest installer straight from the GitHub Releases API and recommends the build for your platform automatically.
• Docs now speak Chinese too. Eight new Chinese docs (a full reference plus seven use-* tutorials) ship alongside the English versions, with one-click language switching at the top of each page.
• First run guides you to your first request. The Dashboard now shows context-aware cards (no provider yet / gateway not started / no client configured / no requests yet) so a newcomer can click straight through to a working first request.
• The Setup Wizard sees you through. On success it points you to "configure a client" or back to the overview; on failure it offers recovery paths (re-enter your key and retry, or skip to settings).

本次更新

• 官网上线了。 AgentGate 有了双语 CLI 美学落地页 https://dengmengmian.github.io/agentgate-ai/，下载区直接对接 GitHub Releases API 拉最新安装包，并按你的浏览器自动推荐对应平台。
• 文档也有中文了。 新增 8 篇中文文档（一篇完整参考 + 7 篇 use-* 教程），与英文版并存，每页顶部一键切换语言。
• 首次使用一路引导到第一条请求。 Dashboard 按当前状态（供应商没配 / 网关没启动 / 没配客户端 / 还没请求）显示不同引导卡片，新手照着点就能跑通第一条请求。
• Setup Wizard 帮你走完全程。 配置成功后引导你"配客户端"或回概览；失败时提供错误恢复入口（重填 key 重试 / 跳设置）。

Why it matters / 为什么重要

This is AgentGate's growth release: a public, SEO-complete website plus bilingual docs and guided onboarding turn first-time visitors into first successful requests. 这是 AgentGate 的增长版本：对外有了完整 SEO 的官网，加上双语文档和引导式上手，把"首次来访"转化为"第一条成功请求"。

Full changelog / 完整更新

See CHANGELOG.md for the full itemized list.

v1.4.1

AgentGate 1.4.1 — Lighter, faster, leaner / 更轻、更快、更省

What's new

• No more runaway memory on long runs. Session storage used to cap its in-memory cache by entry count only, so long agent sessions (single histories of several MB) could grow resident memory to 10GB+. It now evicts by a 64MB byte budget, with the disk layer backing up evicted sessions — same behavior, far less RAM.
• It rests when you're not looking. When the main window is minimized or sent to the tray, page polling pauses (the overview alone used to fire up to 7 queries every 5 seconds) and refreshes instantly when you come back.
• Snappier stats and first paint. Lifetime KPI queries now ride a covering index (74ms→15ms on a 306MB log database), pages lazy-load by route (main bundle 850KB→416KB), and log search is debounced so it queries 300ms after you stop typing.
• Gateway state stays in sync. The topbar and overview now share a single polling source, so start/stop is reflected everywhere at once.

本次更新

• 长时间运行不再吃爆内存。 会话存储原本只按条数（1000）封顶缓存，长 agent 会话单条历史可达数 MB，常驻内存能涨到 10GB+；现按字节预算（64MB）淘汰，被淘汰会话由磁盘层兜底，功能不受影响、内存大降。
• 看不见时它会休息。 主窗口最小化或收进托盘后，各页面轮询自动暂停（此前概览页每 5 秒最多 7 个查询），回到前台立即刷新补上。
• 统计和首屏更快。 lifetime KPI 查询改走覆盖索引（306MB 日志库 74ms→15ms），页面按路由懒加载（主 bundle 850KB→416KB），日志搜索防抖（停止输入 300ms 后才查）。
• 网关状态保持同步。 顶栏和概览页合并为同一轮询源，启停操作即时同步所有界面。

Why it matters / 为什么重要

A pure stability-and-performance release: less memory, faster queries, lighter first load — AgentGate stays reliable as a long-running, always-on local gateway. 一个纯稳定性与性能版本：更省内存、更快查询、更轻首屏，让 AgentGate 作为常驻本地网关长期跑得住。

Full changelog / 完整更新

See CHANGELOG.md for the full itemized list.

v1.4.0

AgentGate 1.4.0 — Run Claude Code on your Copilot subscription / 用 Copilot 订阅跑 Claude Code

What's new

• Use your GitHub Copilot subscription as a provider. A new copilot provider type lets you run Claude Code / Codex on a Copilot Pro / Business subscription — no separate Anthropic API needed. Paste a gho_ token and it's auto-detected; credentials are exchanged and renewed for you (hash-cached, never stored in plaintext), and agent follow-up / compaction requests are tagged x-initiator: agent so they don't burn your premium-request quota. ⚠️ Using a Copilot subscription outside official clients is a GitHub ToS gray area; the feature is entirely optional — see the README risk note.
• Windows clients now fully supported. Running-client detection, automatic Codex restart after applying config, and Claude Desktop integration are all implemented on Windows (previously macOS-only).
• Smarter Claude thinking and caching. Thinking turns on whenever the target Claude model supports it, prompt-cache breakpoints are now injected on the direct Anthropic path too (savings show up in the cost dashboard), and a configurable circuit-breaker threshold (AGENTGATE_CB_FAILURE_THRESHOLD) keeps the occasional blip from tripping a healthy provider.
• Clearer errors when a session is polluted. Leftover truncated tool arguments that used to cause a raw upstream 400 now become an actionable "start a new session / upgrade" hint.

本次更新

• 把 GitHub Copilot 订阅当 Provider 用。 新增 copilot Provider 类型，可用 Copilot Pro / Business 订阅跑 Claude Code / Codex，无需单独的 Anthropic API。粘贴 gho_ token 自动识别为 Copilot；凭证自动换取并续期（hash 缓存、不落明文），工具续写 / 历史压缩请求自动标记 x-initiator: agent，不消耗 premium 请求额度。⚠️ 在官方客户端之外使用 Copilot 订阅属 GitHub ToS 灰色地带，功能完全可选，详见 README 风险声明。
• Windows 客户端集成补齐。 运行中客户端检测、应用配置后自动重启 Codex、Claude Desktop 集成全部补上 Windows 实现（此前仅 macOS）。
• Claude 思考与缓存更聪明。 转换到支持思考的 Claude 模型时"支持就开"，prompt cache 断点也注入直通路径（省的钱直接体现在成本仪表盘），熔断阈值可配（AGENTGATE_CB_FAILURE_THRESHOLD），避免偶发抖动误伤健康 provider。
• 会话污染时报错更清楚。 历史残留的截断工具参数原本会导致上游裸 400，现改写为"开新会话 / 升级"的可操作提示。

Why it matters / 为什么重要

The headline is Copilot-as-provider: a large existing subscription base can now run Claude Code without a separate API spend, while full Windows support widens the install base. 本版本的核心卖点是 Copilot 即 Provider：庞大的 Copilot 订阅用户可以无需额外 API 支出就跑 Claude Code，配合完整 Windows 支持进一步扩大可安装人群。

Full changelog / 完整更新

See CHANGELOG.md for the full itemized list.

v1.3.7

AgentGate 1.3.7 — Move your setup to a new machine in one paste / 一行分享码，配置秒迁新机

What's new

• Share your whole client config with a single code. Export any client setup to a one-line share code, paste it on another machine, and you're done — no more retyping ports, tokens, or model mappings.
• Per-model context windows. The provider capability matrix now has a "context window" column, so you can override the context window (in tokens) for individual models. Leave it blank to fall back to the built-in default.
• Smarter handling of long conversations. Auto-compaction of long history is now on by default, with the trigger threshold adapting to each model's context window. Codex remote compaction lands as an experimental option, and the dashboard shows how often it's actually firing.

本次更新

• 一行分享码搬走整套客户端配置。 客户端配置一键导出为单行分享码，另一台机器粘贴即导入，免去手敲端口、token、模型映射。
• 模型级上下文窗口。 Provider 编辑页能力矩阵新增"上下文窗口"列，可为单个模型覆盖上下文窗口（token），留空自动用内置默认值。
• 长对话处理更聪明。 长历史自动压缩改为默认开启，触发阈值按模型上下文窗口自适应；Codex 远程压缩作为实验功能上线，首页还能看到它当天实际命中的次数。

Why it matters / 为什么重要

This release makes AgentGate portable and self-tuning: configs travel in one paste, and long-context handling adapts on its own instead of needing manual knobs. 这一版让 AgentGate 可迁移、能自调：配置一键搬家，长上下文处理自动适配，少了手动调参的门槛。

Full changelog / 完整更新

See CHANGELOG.md for the full itemized list.