# aicoder-release

**Repository Path**: wangtaihong/aicoder-release

## Basic Information

- **Project Name**: aicoder-release
- **Description**: 智码 AICoder 是一款轻量级桌面应用，为 AI CLI 编程工具打造统一管理平台。支持 Claude Code、Codex CLI、Gemini CLI 三大 AI 编程助手，提供可视化的会话管理、多标签终端、Token 统计和开发效率工具，让你在一个桌面应用中高效管理所有 AI 编程工作流。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 12
- **Created**: 2026-09-02
- **Last Updated**: 2026-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智码 AICoder

> 一站式 AI 编程助手管理平台 — 支持 Claude Code / Codex / Gemini CLI

## 简介

智码 AICoder 是一款轻量级桌面应用，为 AI CLI 编程工具打造统一管理平台。支持 **Claude Code**、**Codex CLI**、**Gemini CLI** 三大 AI 编程助手，提供可视化的会话管理、多标签终端、Token 统计和开发效率工具，让你在一个桌面应用中高效管理所有 AI 编程工作流。

## 应用预览

### 主界面 — 多项目会话管理 + 快捷键面板

![主界面](screenshots/1.jpg)

### 多标签终端 — 代码 Diff 视图 + 多项目会话管理

![多标签终端](screenshots/2.jpg)

### 项目右键菜单 — 导入导出 / 记忆管理 / 文件操作

![项目菜单](screenshots/3.jpg)

### 状态栏 — Token 用量统计 + 会话耗时追踪

![状态栏](screenshots/4.jpg)

### 设置面板 — API 配置 / CLI 工具管理 / 版本切换

![设置面板](screenshots/5.jpg)

### 内置浏览器 — 分屏预览网页应用

![内置浏览器](screenshots/6.jpg)

## 核心功能

- **多工具统一管理** — 支持 Claude Code、Codex CLI、Gemini CLI，自动检测已安装工具和版本，一键切换
- **终端管理** — 内置 PTY 终端，支持多标签页并行会话，会话可弹出为独立窗口
- **会话管理** — 创建、切换、收藏会话，按项目自动分组，8 种颜色标记，模糊搜索秒找历史对话
- **多账号隔离** — 多实例完全独立（登录凭据/API Key/会话记录/配置），支持同时使用公司和个人账号
- **Claude 会话浏览** — 查看历史对话记录，支持搜索和导出（Markdown/HTML），自动生成会话摘要
- **Token 统计** — 实时追踪 API 用量（输入/输出/缓存分别统计），每日趋势图 + 月度总览 + 180 天热力图
- **代码片段** — 保存常用 Prompt 和代码模板，支持模板变量，一键插入终端
- **AI 记忆管理** — 支持多 AI 提供商的记忆生成和管理
- **快捷命令面板** — `Ctrl+K` 整合内置指令、项目命令、代码片段，智能排序
- **内置浏览器** — 分屏预览网页应用
- **文件浏览器** — 树形浏览项目文件，20+ 种文件类型图标
- **Git 面板** — 查看当前分支、提交日志、文件变更状态
- **API 配置管理** — 多 API Profile 切换，支持不同密钥和端点配置
- **MCP Server 管理** — 可视化管理 Model Context Protocol 服务器配置
- **CLAUDE.md 编辑器** — 项目级和全局 CLAUDE.md 在线编辑
- **深色/浅色主题** — 跟随系统或手动切换，护眼舒适
- **系统托盘** — 最小化到托盘，常驻后台
- **自动更新** — 内置 OTA 更新，新版本自动推送
- **零额外开销** — CLI 原生运行，不拦截/不修改/不转发 API 请求，费用与直接用终端完全一样

## 系统要求

- **操作系统**: Windows 10/11 (x64)、macOS (Apple Silicon / Intel)
- **运行时**: 无需额外安装（Windows WebView2 已内置于 Windows 10+）
- **磁盘**: ~10 MB 安装空间
- **前置**: 需已安装以下至少一个 AI CLI 工具：
  - [Claude Code](https://docs.anthropic.com/en/docs/claude-code)（Anthropic）
  - [Codex CLI](https://github.com/openai/codex)（OpenAI）
  - [Gemini CLI](https://github.com/google-gemini/gemini-cli)（Google）

## 下载安装

### 最新版本: v5.4.0

> 🔐 **本版本 Windows 安装包已正规 EV 代码签名**，消除 Windows 智能应用控制的「未验证开发者」提示。
> 🍎 **macOS 安装包已 Developer ID 签名并通过 Apple 公证**，双架构均为 Accepted。
> 📌 **版本号规则自 v5.0.0 起变更**：每一位满 10 进 1（5.0.0 → 5.0.9 → 5.1.0 → … → 5.9.9 → 6.0.0），不再出现 4.55.0 这样的两位数段。

| 平台 | 下载链接 |
|------|---------|
| Windows x64 | [AICoder_5.4.0_x64-setup.exe](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder/releases/v5.4.0/AICoder_5.4.0_x64-setup.exe) |
| macOS Apple Silicon | [AICoder_5.4.0_aarch64.dmg](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder/releases/v5.4.0/AICoder_5.4.0_aarch64.dmg) |
| macOS Intel | [AICoder_5.4.0_x64.dmg](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder/releases/v5.4.0/AICoder_5.4.0_x64.dmg) |
| Linux Debian/Ubuntu ⭐ **推荐** | [AICoder_5.4.0_amd64.deb](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder/releases/v5.4.0/AICoder_5.4.0_amd64.deb) |
| Linux AppImage（仅 22.04 一带旧发行版） | [AICoder_5.4.0_amd64.AppImage](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder/releases/v5.4.0/AICoder_5.4.0_amd64.AppImage) |

> 🐧 **Linux 用户请优先用 `.deb`**。AppImage 在 Ubuntu 22.04 上构建、捆绑了当时的 glib / WebKitGTK，
> 在 **Ubuntu 24.04+ 上会因符号不匹配直接崩溃**（`WebKitNetworkProcess` 起不来 → 进程 `code=-1`）。
> 自 v5.1.5 起 AppImage 已注入 glib 隔离修复（断开包内旧 glib 与系统新 gio 模块的混用），但**尚未在
> 24.04 真机上逐一验证**，稳妥起见仍建议优先 `.deb`：`sudo apt install ./AICoder_5.4.0_amd64.deb` 自动解依赖。

### 移动端伴侣 · v0.6.0

> Android 侧载分发，需要在系统设置中允许「未知来源安装」。iOS 暂未发布。
> 移动端版本号与桌面端独立维护：移动端 v0.6.0。

| 平台 | 下载链接 | 用途 |
|------|---------|------|
| Android APK | [AICoder-mobile-v0.6.0.apk](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder-mobile/releases/mobile-v0.6.0/AICoder-mobile-v0.6.0.apk) | 用户直接安装 |
| Android AAB | [AICoder-mobile-v0.6.0.aab](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder-mobile/releases/mobile-v0.6.0/AICoder-mobile-v0.6.0.aab) | Google Play 上架用（暂存档） |

**🆕 v0.6.0 — 手机端能驱动远程 SSH 会话了**：PTY 桥接 + 远端历史读取、本机/远程统一目录选择器（支持新建文件夹）、点设备直接进会话列表、语音改点按 toggle、会话列表加工具筛选，详见 [移动端版本历史](#移动端版本历史)。

**🔐 签名提示**：v0.3.5 之前所有版本都是 CI 临时 debug 签名，与 v0.3.6+ 的稳定 release keystore 不一致——
**仍在 v0.1.0 ~ v0.3.5 的用户首次升级到 v0.4.0 必须卸载旧版重装一次**（一次性）；v0.3.6 及之后的用户可直接 OTA 覆盖升级，不受影响。

### 安装步骤

1. 下载上方安装包
2. 双击运行安装程序
3. 选择安装语言（中文/英文）
4. 按提示完成安装
5. 启动应用，开始使用

### macOS 安全提示

首次打开应用时，macOS 可能会提示「无法验证开发者」，或在 Apple Silicon 上提示「已损坏，无法打开，你应该将它移到废纸篓」。

这是因为应用走 ad-hoc 签名、未经 Apple 公证（Notarization），**并非恶意软件**。请打开「终端」执行以下命令解除限制，再重新打开应用：

```bash
sudo xattr -rd com.apple.quarantine "/Applications/智码 AICoder.app"
```

输入 Mac 登录密码后即可正常打开应用。若没把应用拖进 Applications，可把 `.app` 直接拖进终端窗口自动补全路径。

## 更新机制

应用内置自动更新功能：

- 启动后自动检查更新（首次延迟 5 秒，之后每 30 分钟检查一次）
- 发现新版本后，右上角浮动通知显示「有可用更新」
- 点击「立即更新」按钮，自动下载并安装
- 安装完成后自动重启应用

更新清单文件: [update.json](update.json)

## 移动端版本历史

### mobile-v0.6.0 (2026-09-02)

手机端能驱动远程 SSH 会话了：

**🚀 新功能**

- **手机端驱动远程 SSH 会话** — PTY 桥接 + 远端历史读取，手机上开的会话可以直接跑在远程主机
- **统一目录选择器** — 新建会话能点着选目录了，本机 / 远程 SSH 一套界面，支持新建文件夹
- **点设备直接进它的会话列表** — 不必再回到全局列表里翻
- **语音改点按 toggle** — 点一下开始、再点一下结束，长口述不用一直举着手机
- **会话列表加工具筛选** — 远程主机认不出时不再显示一串 UUID 片段
- **输入框改多行自动增高** — 写长 prompt 不用隔着一条缝

**🐛 修复**

- **点一下麦克风什么都不发生** — 语音输入长期被当成坏功能的真正原因
- **录音 / 识别不再有任何浮层** — 状态收进麦克风按钮；按住说话补上全程提示
- **终端流展开停在开头**、录音全屏遮罩盖住对话
- **会话里 AI 头像显示成一个大写 A**
- **选了远程主机目录却把会话归到本机**
- **选中的 Claude 图标隐形**、返回列表时筛选全丢
- **推荐应用的 logo 垫了层白底**，跟自带底色的图标不服帖

> 签名与 mobile-v0.5.0 一致（指纹 `a5b64af5…02ba`），v0.3.6 及之后的用户可直接覆盖升级。

### mobile-v0.5.0 (2026-06-05)

🐛 手机端可用性修复（守护进程上线后多项失效）：

- **🔑 新建会话收不到消息根治** — 新建会话补齐 `claude_session_id`（UUID v4）：缺它后端定位不到 JSONL，会话永远「暂无历史消息」收不到消息
- **🔓 默认带 --dangerously-skip-permissions** — 新建会话按工具填默认 CLI 参数，桌面起 Claude 不再卡每步权限弹窗
- **📁 项目目录改必填** — 新建会话强制选目录，避免后端因 project_path 为空返回空消息
- **♾️ 永久授权显示「永久」** — 授权天数 -1 正确显示「永久」（对齐桌面端），不再误显示「-1 天」或误弹续费提示
- **✨ 接收指示器自动归位** — 「接收中」改 idle 定时器状态机，PC 端回复完手机 2.5s 内停止闪烁（根治「已回复完仍一直转」）

### mobile-v0.4.0 (2026-05-11)

- **🔑 配置档案切换** — Chat 页顶部新增配置档案 chip，按当前工具列出所有 API Profile，一键切换（API Key 档案直接切，OAuth 档案提示需在桌面端切换）
- **⚡ 指令面板** — 输入框新增指令面板按钮，弹出底部面板，两个 Tab：
  - 「内置指令」：按当前会话的 provider 过滤的斜杠命令（claude / codex / gemini / opencode）
  - 「我的片段」：桌面端「代码片段」页创建的自定义片段
  - 点击条目把内容填入输入框
- **🧩 Provider 选择更智能** — 新建会话 FAB 的 provider 选项灰显未安装 / 未启用的工具，避免选了开不起来
- **✂️ placeholder 简化** — 输入框提示统一为「输入消息...」，小屏不再被换行撑乱
- **🔧 配合桌面 v3.5.7** — 桌面端给远程 prompt 加了 PTY 冷启动地板等待，移动端唤起桌面后立刻发消息不再被吞回车

### mobile-v0.3.6 (2026-05-08)

- **🔐 关键修复：固定生产签名 keystore（一次性破坏升级）**
  - **根因**：v0.3.5 之前 CI 仓库未配置 `ANDROID_KEYSTORE_BASE64` secret，每次构建用 GitHub runner 临时生成的 debug.keystore 签名 → 每个版本签名指纹都不同 → 用户每次升级都报"签名不一致"必须卸载重装
  - **修复**：本地生成稳定的生产 RSA 4096 keystore（SHA-256: `A5:B6:4A:F5:33:...:6B:02:BA`，有效期 100 年），配置到 CI 仓库 secrets，从 v0.3.6 开始所有版本都用同一 keystore 签名
  - **影响**：
    - 旧版（v0.1.0 ~ v0.3.5）用户**必须卸载后重装 v0.3.6**（一次性）
    - 装上 v0.3.6 后，未来所有版本（v0.3.7、v0.4.x...）都可直接 OTA 覆盖升级，不再卸载

- v0.3.5 中间版本因仍用 debug 签名实际未发布到下载源

### mobile-v0.3.4 (2026-05-08)

- **🎯 按 session_id 精确路由 PTY** — 配合桌面 v3.5.5 解决多会话发到错误会话的关键 bug
  - 之前用 `list.ids[0]` 选 PTY，多会话时新会话的 prompt 会被发到桌面侧的第一个会话
  - 现在按 URL 参数 `id`（桌面 Session.id）从 `list.items[]` 里精确匹配 `pty_id`
  - 老桌面端（无 `items` 字段）自动回退到 `ids[0]` 并 `console.warn` 提示用户升级
- **⚠️ 升级提醒** — 移动端单边升级解决不了根本问题，必须搭配桌面 v3.5.6+

### mobile-v0.3.3 (2026-05-07)

- **🔧 修复检查更新永远报「已是最新版本」的关键 bug**
  - 根因：`updateCheck.ts` 的 `parseSemver` 没剥 `mobile-` 前缀
  - `parseSemver("mobile-v0.3.2")` 返回 null → `compareSemver` 视为同版本 → UI 误报「已是最新」
  - 修复：先剥 `mobile-v` / `v` 前缀再做正则匹配
- **📱 老用户影响** — v0.3.1 / v0.3.2 用户**必须从下载页手动升级到 v0.3.3 一次**，
  之后 App 内自动 / 手动检查更新都能正常工作

### mobile-v0.3.2 (2026-05-07)

- **🔄 刷新授权状态 UX 重做** — 按钮加 loading state（图标旋转 + 文字「正在刷新…」）
- **✅ 反馈到位** — 调用成功 alert「已刷新：当前状态 已激活/试用中/已过期」；失败 alert 错误原因
- **🔧 内部** — `useMobileLicense.refresh` 改为返回新状态 / 抛错；自动 30min 轮询失败仍静默不打扰

### mobile-v0.3.1 (2026-05-07)

- **🔧 修复 Cleartext Traffic 关键 bug** — Android Release 包 `usesCleartextTraffic="false"`
  导致 fetch 直接被系统拦截，浏览器能打开但 App 内 AddServerDialog 添加桌面失败
- **🌐 全场景 http:// 支持** — IPv4 / IPv6 字面量 / 域名形式的公网地址都能正常配对
- **📱 用户影响** — v0.3.0 用户必须升级才能添加 http:// 桌面端，已配对的会话不受影响

### mobile-v0.3.0 (2026-05-07)

- **🔔 启动检查新版本** — 启动时静默检查 R2 `mobile-versions.json`，发现新版弹 Modal 提示去下载页（24h 节流）
- **🔍 手动检查更新** — 「我的」页加「检查更新」按钮，可主动触发
- **🌐 网络错误中文化** — 按 baseUrl 形式给差异化中文提示（HTTP/HTTPS/局域网 IP/IPv6）
- **🆕 IPv6 / IPv4 字面量** — 公网地址输入框支持 `[::1]:7420` / `[2408::1]:7420` / `192.168.x.x` 直接填入
- **🎨 添加桌面体验优化** — AddServerDialog 配对流程更顺滑

### mobile-v0.2.0 (2026-05-07)

- **📎 附件上传** — 输入框左侧新增 `📎` 按钮，支持图片 / PDF / 文档多选；图片自动压缩（拍照 4-12MB → ~300KB）；chip 缩略图点击 Modal 看原图
- **📋 粘贴图片** — `textarea` 监听 paste 事件，QQ/微信截图后 `Ctrl+V` 直接粘贴到对话
- **🏷 附件 chip 渲染** — 用户消息气泡里把 `@<path>` 渲染成 `[🖼 photo.jpg]`，替代裸路径
- **🕖 消息时间戳** — 用户气泡 + AI 气泡显示发送/接收时间（同天 `HH:mm`，跨天 `MM-dd HH:mm`）
- **📦 debug/release 并存** — 调试包独立 `applicationId` (`.debug` 后缀)，可与生产包同时安装互不覆盖
- **🔔 PC 端实时提示** — 手机发附件桌面右下角弹「📎 收到 photo.jpg [打开] [定位]」
- **🧹 自动清理** — `mobile-uploads/` 下 7 天前文件启动时自动清理
- **🎨 placeholder 缩短** — 输入框提示从「输入消息... (Ctrl+Enter 发送 · 可粘贴图片)」改为「输入消息...」，避免小屏被换行
- **🛠️ CI 修复** — `parseAttachments` re-export 用相对路径替代 `@/` 别名（修 v0.2.0 首次构建失败）

### mobile-v0.1.0 (2026-05-06)

- **🚀 移动端伴侣首发** — Tauri Mobile Android，与桌面端 v3.5.1 同期发布
- **📱 4 屏完整体验** — 会话列表 + 实时对话 + 设备管理 + 个人中心
- **🎙️ 按住说话** — 录音上传桌面 ASR 通道识别，松开自动填入输入框
- **🔐 设备配对** — PIN 兑换长期 token + 二维码扫码配对
- **🛡️ 安全收口** — TLS/WSS 强制 + 审计日志 + 熔断 + 紧急下线
- **🔍 全局搜索** — 标题 / 项目路径 / 消息内容三合一

---

## 版本历史

### v5.4.0 (2026-09-02)

浏览器设计模式、桌宠思考态，以及额度轮换的关键修复：

**🚀 新功能**

- **浏览器「设计模式」** — 在页面上直接点选元素，把它的 HTML / CSS / 截图一并喂给 AI，改样式不用再手动描述"第三个卡片的圆角"
- **mac / Linux 的浏览器自动化恢复可用** — 改由注入式驱动接管 JS 求值通道；此前这两个平台上浏览器工具静默返回空数组，失败还会被当成"页面没报错"反复重试
- **桌宠思考态由角色自己演** — 思绪气泡 + 眼神扫视，取代原来的三点药丸；状态改走局部点缀 + 头顶指示物，不再用状态色盖掉角色身份色

**🐛 修复**

- **撞 Claude 的 session limit 时额度完全不轮换** — 判据只认 `usage limit`，而 Claude 的 5 小时窗口说的是 `session limit`，名词一漂移自动轮换就从不触发
- **三个 CLI 图标是自绘臆造的** — 换成官方标识；未安装的 CLI 也不再涂成比已安装还抢眼的警告黄
- **Linux 下 opencode / agy 输入中文一个字变两个** — WebKitGTK 上 input / keyup 竞速，两道去重门控互斥各看一半
- **编排派活时提示词停在输入框没发出去**
- **开关工作区栏后切回其它会话，正文里多出重复的一段** — 陈旧的 pending resize 被当成目标下发
- **右上角会话列表点选后没在侧边栏定位**，看不出会话在哪
- **远程工具版本栏混入 CLI 日志与 unknown**；Antigravity 补上轮换卡片
- **远程 PTY 广播容量收回 4 倍**，去掉每帧的多余拷贝

### v5.3.1 (2026-08-29)

自动更新的下载链路重做：

**⬇️ 下载（本版主体）**

- **修好「进度百分比来回跳、最后下载不成功」** — Linux 上最明显。此前多个下载任务会同时开跑、各写各的进度（41 → 49 → 42 → 49），末了安装还会因为拿错更新包而失败。现在下载由后端单任务承担，进度不可能倒退
- **断点续传** — 网络中断不必从头再来，可以暂停 / 继续
- **点标题栏版本号展开下载面板** — 实时进度、速度、当前下载源一目了然，可一键重新下载或切换下载源
- **主源失败自动换源** — 已经下好的部分不浪费，换到备源接着续传
- **更新包不再整包占内存** — Linux 安装包近 100MB，此前重复下载会占双份

**🐛 修复**

- **用 `.deb` 安装的 Linux 用户「下载完却更新不成功」** — 更新清单缺 deb 目标，导致下到的是 AppImage 却按 deb 安装，校验必然失败
- **Codex 0.149 认证兼容** — 托管配置段的字段白名单漏了新增键，导致切换多个 API 档案后残留一堆失效配置段

### v5.3.0 (2026-08-28)

工作区内嵌、远程 SFTP 与 Maven 面板：

**🖥️ 工作区（本版主体）**

- **工作区可内嵌到主窗口右侧** — 此前工作区只能弹成独立窗口，看代码和聊会话要来回切窗。现在主窗右侧多了一条常驻 rail，点开即用、边缘可拖宽，项目 / 提交 / 分支 / 终端 / AI 五个视图都在里面
- **工作区栏加 Maven 构建面板** — 对标 IDEA 的 Maven 工具窗，生命周期、插件目标、Profiles 一览，不用切到终端敲 `mvn`
- **工作区终端开了个写入口** — 同窗口内其它面板可以往这个终端发命令，不再各自为政
- **`.vue` 补全延续上版能力**，配合内嵌 dock 在同一屏内完成编辑与提交

**🌐 远程**

- **远程主机 SFTP 传输** — 列目录、上传、下载、改权限、增删改名，直接在应用里管远端文件

**🗂️ 会话与模型**

- **项目快捷 Tab** — 点侧边栏目录直接开一个可搜索的会话列表，顶栏 / 状态栏 / 工作区栏三处同源，不会各显示各的
- **GLM 1M 上下文补齐自动压缩窗口** — 此前模型名加了 `[1m]` 后缀但压缩窗口没跟上，等于白加
- **各 CLI 档案的模型下拉加「还原内置清单」** — 手工改乱之后能一键还原，并与状态栏显示对齐
- **提示词编排的实现方 / 验收方改成下拉选** — 不用再手打模型名，打错就静默不生效

**🐛 修复**

- **mac 多实例 OAuth 三连** — 加新账号会顶替旧号（凭证读写全链漏了 Keychain）、切 OAuth 档案对 CLI 静默失效、跨实例导入读不到源凭证；并在多实例下明确提示官方账号是跨实例共用的
- **双击标题栏最大化被 toggle 两遍相互抵消** — 非 Windows 平台还会卡在最大化回不去
- **npm 装 CLI 崩了会把用户原有版本一起带走** — 现在装前探前缀、装后自检、失败自动回滚
- **Linux 上看不见 linuxbrew 里的 CLI** — `apply_full_path` 在 Linux 分支是个空操作，桌面启动的进程拿不到完整 PATH
- **中文界面残留英文** — 推送弹窗主按钮、暂存 / 取消暂存标签、Git 面板分组标题

### v5.2.0 (2026-08-26)

额度用尽自动轮换 —— 无人值守也能接着跑：

**🔄 额度轮换（本版主体）**

- **额度打满后自动换下一个档案接着跑** — 一个 token 的额度打满，此前要手动去设置里切档案、再回终端点「继续」；跑长任务时这一步经常发生在人不在场的时候，任务就一直卡着。现在自动完成：冷却当前档案 → 选下一个 → 探活 → 静默切换 → 重启会话 → 续发原提示词
- **覆盖六个面板** — Claude / Codex / Gemini / OpenCode / Kimi / Grok
- **设置界面** — 轮换顺序可拖拽、一键全选参与、冷却倒计时可视；带每小时切换次数护栏，避免异常情况下反复横跳
- **预防式提前切换真正接上用量数据** — 此前只有开关和阈值、触发逻辑没写（界面上有、实际不工作）。现在读 Codex 的 rate_limits 与 Grok 的配额，在额度接近上限时切换；且**只在一轮回答刚结束、会话回到空闲的那一刻动手**，不打断正在跑的任务
- **冷却状态落库** — 限额窗口常达 5 小时甚至一周，只存内存的话重启应用就忘了，一上来又撞回同一个已耗尽的档案
- **轮换历史列表** — 无人值守时到底发生过什么（何时因为什么从哪个档案换到哪个），现在看得见
- **限额报错识别修复** — Kimi K3 的周限额既认不出又被自己的否定规则否掉；弯引号撇号从没被字符类覆盖，导致通知与桌宠都认不出限额报错；报错里给了精确重置时刻却没用上，档案被多闲置一个多小时

**🖥️ 界面**

- **标签栏改「滚轮横滚 + 两端浮出箭头」** — 藏起那条占地方的横滚动条；主窗、内置浏览器、工作区三处一致，右键菜单目标补高亮
- **工作区复制文件名的「已复制」提示暗底黑字**，几乎看不清

**📝 工作区**

- **`.vue` 文件敲标签能补出项目组件和它的 props**

**🐧 Linux 与终端**

- **Linux 重启后协议要重签、项目和会话全不见**
- **图片粘贴失败后再输文本，终端整块布局就乱了**

**🤖 多 Agent 编排**

- **驳回意见发出去就没了，总控还以为送到了**
- 文档说清了什么时候能并行派活、什么时候必须一个一个来

### v5.1.6 (2026-08-24)

远程 SSH 稳定性与多 Agent 编排唤醒修复：

**🔌 远程 SSH**

- **用着用着就断，且只能重启客户端才好** — 报错 `channel_open_session 失败 (ConnectFailed)` 不是断网，是服务端 sshd 的会话槽位（MaxSessions，默认 10）被耗尽。两个根因：看门狗探测开完通道直接丢弃、不发关闭帧，sshd 对这种「开了没执行」的通道永不回收，约 7 分钟漏光；连接复用时一次都不验活，废连接被无限复用 —— 于是「点连接提示成功、紧接着的探测就报错，怎么点都好不了」
- **同一主机的多条命令不再互相阻塞** — 开通道不再把连接锁一路持到命令跑完，单条卡死也不会拖垮整台主机
- **远程终端跟随你的真实登录 shell** — 不再写死 bash；zsh 用户的提示符识别一并修好
- **远程会话起不来时也会归还槽位** — 此前失败路径漏还，反复重试会加速耗尽

**🤖 多 Agent 编排**

- **子会话跑完没叫醒总控** — 总控只能干等到超时；子会话起不来时同样收不到事件
- **派活时子会话默认起错 CLI**

**🖥️ 界面与终端**

- **工具栏选中的 CLI 图标加右上角绿点** — 九个图标排在一起时，原来那层淡背景块几乎看不出在用哪个
- **粘贴的长文本被折叠后，悬停占位符可看全文**
- **片段变量弹窗补正文编辑与自动填充** — 并修复带 `{{占位符}}` 的片段点击无反应（弹窗被指令面板盖住）

**📁 工作区**

- **远程仓库的中文文件名显示成一串假目录**，点开还报找不到文件
- **工作区 diff 能看已删除的文件了**

### v5.1.5 (2026-08-23)

远程工作区九家全部接线，提示词库重构，终端性能与会话恢复修复：

**🌐 远程工作区**

- **MCP 配置八家全部接线** — 补齐 CodeBuddy / Pi / Grok / Kimi / Antigravity，远程主机上也能可视化增删改 MCP 服务器；Pi 本身不带 MCP，随配置一并写入自研桥接扩展
- **Antigravity 远程会话读取上线，九家 Provider 全部覆盖** — 远程会话标题自动更新、重开标签页能还原历史
- **支持远程安装 agy / grok** — 修「切到远程主机点安装，却装到了本机」
- **原生配置编辑器改为真正读写远端** — 此前在远程工作区下编辑会静默改到本机，现已接入 workspace；未接通的入口一律停用而非放行
- **远程 Linux 收到 PowerShell 启动命令导致会话起不来**
- **远端路径含 `${VAR:-…}` 被单引号字面化，会写出「幽灵文件」**
- **远程脚本安装日志整段重复、代理反馈丢端口**

**📝 提示词库**

- **统一数据源 + MCP 能力感知** — 新增 19 条自动化 / 运维提示词，未装对应 MCP 的条目显示缺失角标而非静默失败
- **片段卡片预览溢出、内置与用户片段重复出现**

**🖥️ 终端**

- **长输出卡顿** — 生产端 PTY 读取补批量 drain（此前每 4KB 一次 IPC）；连字默认关闭；IME 拆字节改 writeChain
- **Codex 长对话每次出结果前疯狂滚动** — 重打的历史被当成净追加

**🔄 会话恢复**

- **点会话永远打开空白新会话** — resume 崩溃误判毁掉会话指针，且空壳记录会劫持 hook 日志，此前不可自愈
- **崩溃回退不再全局拉黑版本** — 已知安全版本干脆不挂监听
- **恢复提示永远列陈旧会话** — 快照改为只记本次实际打开的 tab
- **启动「恢复上次会话」提示加「不再提示」按钮与设置开关**

**🚀 Antigravity**

- **会话标题自动更新与精确恢复**
- **补齐 7 个缺失模型**，修「选了模型不生效」与 `--model` 重复下发
- **中文提问被英文标题盖掉** — 补 CJK 回退
- **一键安装漏读「走代理」开关** — 国内必然装不上

**✨ 其它**

- **Codex 用量限额改走 app-server 实时读取**
- **新建会话的模板可就地编辑**，并补编排配方
- **多 Agent 协同编排改为事件唤醒**，替代轮询
- **后台新建的会话卡死不执行任何命令**
- **Linux 桌宠鼠标穿透致主进程 panic 无限重启**

### v5.1.4 (2026-08-22)

远程工作区打通，终端稳定性修复：

**🌐 远程会话管理**

- **补齐 CodeBuddy / Pi / Gemini 的远程会话读取** — 加上此前已接的 Grok / Kimi / Codex / OpenCode，除本身没有会话历史的 Antigravity 外全部覆盖；标题自动更新、重开标签页能还原历史
- **OpenCode 标题不更新且重开不还原** — 它把 cwd 按正斜杠存库，SQL 精确匹配 0 命中，cli_session_id 始终绑不上

**🔑 远程 API 配置**

- **配置档案「看到的」与「用的」不是同一份** — 列表接口把 workspace 写死成本机，于是远程主机下显示的其实是本机档案，而真正注入远端的是另一份；结果是明明配好了、启动会话却报「未启用 API Key 类型的配置档案」。九家 Provider 里只有 Claude 幸免，其余全部修正
- **新增「从本地导入」** — 把本机配好的端点搬到远程主机，逐条挑选、对 `127.0.0.1` 这类搬过去指向远端自己的地址显眼标红、可导入时就地改
- **空态与新建会话时都说清这台主机是否已配置** — 不再只在会话起来后于终端里刷一行黄字

**🔌 远程连接**

- **SSH 连接支持取消** — 连不上不用再干等几十秒；等锁、握手、重试退避、认证四段都可中断
- **打开已有会话时也会自动重连** — 此前只有新建会话才有预检，切过去直接开会话必报「远程主机未连接」
- **远端装了 opencode / npm 却显示未安装** — 探测、安装、启动三处各猜各的 PATH

**🖥️ 终端**

- **远程桌面断开或锁屏后画面定格、重连才一股脑补渲染** — 窗口被判 occluded 时 rAF 完全暂停，积压只进不出；改为三重保障，兜底路径挂在不受节流影响的 PTY 数据到达处
- **Bun 运行时崩溃后自动重启并 `--resume` 续上原对话**
- **图片占位符悬停预览兼容 OpenCode / Grok / Codex 三种形式**
- **跨屏拖动后 Codex 输入框消失**

**✨ 其它**

- **接入 Grok 4.6**（Grok / Pi / OpenCode 三处模型清单与默认模型同步）
- **剪贴板写入改走原生 arboard** — 修复复制静默失败却提示「已复制」
- **自动关闭的会话重启后仍可找回**

### v5.1.3 (2026-08-19)

终端重绘、切档案生效链路与账号面板三块修复：

**🐛 终端重绘**

- **Pi 长对话回复时整屏反复滚动刷屏** — 整段重绘（清屏 + 重打历史）字节量超过单帧闸门，被按帧回放导致中间状态可见；改为见清屏就开直写豁免
- **豁免窗口改滑动式** — 固定 250ms 会在大批量传输中途到期，后半段掉回分帧、刷屏照旧

**⚙️ 切档案生效链路**

- **切档案后发消息 403 Request not allowed** — OAuth 档案把全局代理顶掉，改为复用既有回落名单，存量档案立即生效
- **代理改了不提示重启会话** — 代理是启动时注入的环境变量，进程起来就冻结；改为比对模型与代理指纹，任一变了才提示
- **`/status` 显示成两个账号的拼接体** — 换账号只改了邮箱，机构名/档位等十几个字段还留着上一个账号的
- **新账号登录成功后没设为激活** — 界面显示 A、实际跑 B，后续操作还会用旧凭据覆盖刚登录好的
- **切到凭据已过期的档案会把死凭据写上去** — 改为写盘前检查，过期则拦下并说明处理方式

**👤 账号面板**

- **pro 升级到 max 后一直显示 pro** — 档位读的是建档那刻的冻结快照，改为按字段取权威源
- **档案标「使用中」但实际跑另一个账号** — 新增漂移告警
- **OAuth 档案在界面上开不了代理** — 开关被包在非 OAuth 分支里，而 OAuth 连的正是最需要代理的官方端点

**⚡ 指令面板**

- **点项目命令只填进输入框不发送** — 改为按命令是否需要参数决定自动回车

### v5.1.2 (2026-08-18)

终端稳定性、工作区体验与档案切换三块打磨：

**🐛 终端修复**

- **多屏/合盖唤醒后输入框错位消失** — 快照源 pty-host 虚拟屏幕被写坏，resize 没编进 reader 字节流顺序
- **键盘全丢而鼠标正常** — OS 焦点卡在顶层窗，没下沉到 WebView2
- **后台标签重启后画面错位** — 隐藏容器尺寸是对的但网格陈旧，spawn 前补对齐
- **点应用内 UI 后终端输不进字** — refocus 只挂了窗口级焦点事件

**🚀 工作区增强**

- **推送弹窗支持选分支推送** — 目标分支可选、可输、可新建
- **超大文件预览一片纯白** — 超 5000 行的降级路径没挂语法高亮
- **diff 大文件提示条与代码叠字** — 还盖住了文件首行
- **提交面板目录名截断无提示** — 目录行补 title

**⚙️ 档案切换**

- **改完 API 档案只在真需要时才提示重启** — 本地 Claude 换端点/密钥立即生效，只有模型真变了才提示
- **Codex 切档案后旧 model_providers 段残留** — 按顶层 model_provider 选段，界面暴露配置漂移

**🌐 内置浏览器**

- **移动端 H5 设备画幅模拟** — 自动识别移动站点，按真机画幅居中显示
- **AI 调起浏览器毫无察觉** — 加闪烁 / 呼吸 / 未读三层提醒

**🎨 界面**

- **历史抽屉与弹窗透出背后终端文字** — 按「有没有遮罩纱」重新分类
- **顶部标签激活态与非激活几乎同色** — 纯色底下只差 7 个灰阶

### v5.1.1 (2026-08-16)

接入 GLM-5.3，终端与浏览器多处稳定性修复：

**🚀 新增能力**

- **接入 GLM-5.3（1M 上下文）** — Claude / Pi 模型列表与 Codex 窗口推断同步更新

**🐛 终端修复**

- **崩溃重启后输入框错乱** — 快照写完又 fit 触发整 buffer reflow，现已改为先对齐再恢复
- **IME 输入残留字母** — 上次修复误把 xterm 刚点亮的预览层当残留摘掉

**🌐 浏览器修复**

- **误报「直连和代理都无法访问」** — iframe 加载失败被当成主文档失败
- **mac 上预览浏览器自动化必崩** — wry 读 WKWebView.URL 为 nil 时 unwrap panic

**🎨 界面与诊断**

- **mac 诊断报告恒显示「内存 100%」** — sysinfo 的 available 被内存压缩减成 0
- **拖主题遮罩浓度整屏报错** — mousemove 预览每帧重渲染整棵树撞 React 更新上限
- **主题菜单 hover 预览撤销** — 扫过菜单就整屏变色，干扰太大

### v5.1.0 (2026-08-14)

界面材质、标签栏与工具可见性三块打磨：

**🎨 背景图与浮层材质**

- **修正 AntD 6 浮层类名** — 四条背景规则一直选中不存在的元素，等于从没生效过
- **浮层透明度重新分档** — 右键菜单、确认框、会话悬停浮窗各自单独调档，背后文字不再透上来干扰阅读
- **材质做法调整** — 大面板去掉 backdrop-filter 只保留透明度，小浮层保留模糊
- **背景图下统一提亮** — 最弱一级文字与标题栏图标补足对比度；激活标签翻回深底，修 accent 前景对比度只有 1.75:1 的问题
- **历史缩略图支持单张删除**，换图不再多出中间产物

**🏷️ 标签栏与侧边栏**

- **回答完毕改用行首圆环/橙点标记** — 不再给标题整体变色
- **收藏区按目录二级分组** — 去掉行内星标，目录图标改用收藏色
- **tab 目录名改双击锁定** — 单击回归切换；锁定状态只由小锁表达，不再变色
- **激活态改用字重表达** — 颜色整条让给完成态
- **应用图标落到标题栏最左** — 兼任侧边栏折叠开关，撤掉独立折叠按钮

**🔧 工具可见性**

- **工具栏右键可隐藏/显示 CLI 工具** — 配套「显示管理」弹窗与批量隐藏口径
- **记住上次选中的 CLI 工具** — 启动自动挑第一个已安装的
- **新建会话弹窗宽度自适应** — 9 个 CLI 已把工具条挤出横向滚动条

**🔌 Pi MCP 管理**

- **新增 MCP 服务器管理界面** — 支持从其它工具导入
- **桥接扩展支持 Streamable HTTP / SSE** — 双文件合并加载

**🐛 问题修复**

- **终端输入框残留** — 抢焦点打断 IME 后残留删不掉的字母/白竖线
- **侧边栏滚轮卡顿** — 推迟 title 拦截器的强制布局，滚动期屏蔽 hover
- **设置面板与队列提示不再可框选** — 值类内容显式放行
- **背景图目录按实例隔离** — 排序改用文件名时间戳

### v5.0.0 (2026-08-13)

全新应用背景图 + Pi / CodeBuddy 两个 Provider + 大量界面打磨：

**🎨 全新：应用背景图**

- **自定义背景图片** — 主窗口 / 工作区窗口 / 会话窗口 / 内置浏览器四处统一生效
- **智能裁切** — 选图后自动判断比例，与窗口差异较大时弹出裁切框；选框锁定窗口比例，拖动与滚轮缩放，裁完自动贴合
- **四种适配方式** — 填充 / 适应 / 平铺 / 居中，切换时缩略图实时预览真实效果
- **遮罩与模糊可调** — 鼠标划过滑块即可预览，移开自动还原
- **历史记录** — 自动保留最近 10 张，点缩略图一键切回用过的图
- **定时轮播** — 可选顺序或随机，间隔自定义
- **标题栏快捷入口** — 调色板下拉里直接换图、调参数、切模式，不用专门打开设置
- **浮层材质适配** — 弹窗、下拉菜单、右键菜单、气泡提示同步半透明，不再像贴纸浮在照片上

**🆕 新增两个 AI 编码工具**

- **Pi** — 作为第 9 个 Provider 接入，含配置面板、订阅登录弹窗、跨工具导入、MCP 桥接（零依赖透传 68 个工具）
- **CodeBuddy** — 核心实现 + 多实例配置隔离 + MCP 服务器管理 + 移动端显示与分派补齐

**✨ 界面改进**

- **侧边栏目录层级重构** — 目录名改 14px 加粗提亮，与会话标题拉开层级；文件夹图标改用独立语义色，不再与收藏的金色撞车
- **主题下拉悬停预览** — 鼠标划过主题即套用查看，关闭下拉自动还原，点选才真正保存
- **主窗口加宽** — 默认 1500、侧边栏 300，工具切换器紧凑阈值随之调整
- **七个 API 配置面板** — 统一表单形态与按钮规格
- **官方申请链接** — 各 Provider 面板增加申请入口
- **标签锁定** — 锁定后不会被内存压力或数量上限自动关闭
- **右键菜单调整** — 「关闭所有标签」归入关闭组，四个关闭项连排更好找
- **授权徽章分档** — 剩余 30 天以上显到期日，30 天内显倒计时

**🐛 问题修复**

- 修复调整窗口大小时终端闪白块与内容错位
- 修复 Claude 输入框按方向键后紧接着的空格被吃掉
- 修复激活的 API 配置档案会绕过全局代理开关
- 修复内置浏览器休眠标签页导航报「嵌入面板不存在」
- 修复标签锁定后目录名左右位移
- 修复「恢复上次会话」提示一次性消失

**🔧 其他改进**

- MCP 快捷预设改为先预览再添加，可顺手填入免费 API Key
- 压缩会话功能覆盖 7 家工具，注入等待过程有可见反馈
- 更新免责声明与商标归属说明

**📌 版本号规则变更**

自本版起版本号每一位满 10 进 1（5.0.0 → 5.0.9 → 5.1.0 → … → 5.9.9 → 6.0.0），不再出现 4.55.0 这样的两位数段，避免与 4.5.5 混淆。

### v4.55.0 (2026-08-11)

接入 Kimi Code 与 Antigravity MCP 面板：

- **新增 Kimi Code 作为第 7 个 Provider** — 前后端全链路打通，含多实例隔离补齐
- **Antigravity MCP 面板** — 面板接入 + 布局与文案修正
- **补 WM_DISPLAYCHANGE 通道** — 覆盖「接外接屏合盖」这类几何剧变，窗口不再错位
- **修 MCP 工具 schema 的布尔型 items** — Moonshot 不再拒收整个请求
- **工作区提交面板** — 底部两个下拉浮层限高，不再撞穿屏幕顶部
- **dev 不再冒用宿主 watchdog 身份** — 开发环境正确显示「实例 2」
- **工作区窗口尺寸改由后端读 tauri.conf.json** — 消除两处手抄，尺寸只有一个来源

### v4.54.0 (2026-08-10)

Grok Build CLI 全面接入 + 窗口与检测修复：

- **🚀 新增第 6 个 Provider：Grok Build CLI** — 后端全栈接入；前端 API 档案 / 订阅额度 / MCP 一键接入 / 代理引导全链路打通；补齐会话用量、系统托盘、远程网关与内置斜杠命令表
- **🚀 Grok 会话管理增强** — 侧边栏右键克隆 / 压缩会话，恢复会话改按 ID 精确匹配；添加账号支持内置终端跑 `grok login`，同账号自动覆盖去重
- **🐛 修复新会话标题停在「新会话」** — 会话 ID 绑定与标题推断链路修正
- **🐛 修复自定义端点档案下代理开关被跳过** — 曾导致 CLI 启动超时
- **🐛 修复 4 处 provider 分派缺 grok** — 状态栏支持切换配置档案，面板切换补齐完整链路
- **🚀 窗口操作 Win32 原生兜底** — tao 派发链路失效时由原生接管；混合 DPI 多屏下窗口不再逐次放大 / 戳出屏幕
- **🐛 后台工具检测改走 provider.detect()** — 修「装了却显示未安装」
- **🎨 UI 打磨** — Provider 官方 Logo 统一、工具切换器 ≥6 项自适应紧凑、布局容纳第 6 个工具
- **📱 移动端** — 软键盘不再挡住输入框，补齐 Grok / Antigravity 支持

### v4.53.0 (2026-08-07)

会话用量条、MCP 双通道与状态栏快切：

- **会话实时用量条** — 状态栏显示本轮/累计/缓存/花费四组数据，支持展开模式查看明细；接入 OpenCode，并修正 Claude 用量解析的两处缺陷
- **MCP 新增 streamable-http 第二通道** — 与 sidecar 共用同一份工具表，外部客户端多一种接入方式；端点掉线自动重绑，配健康指示灯
- **MCP sidecar 抗断改造** — 构建流程不再误杀进程、panic 改为 unwind 不拖垮宿主、生命周期留痕便于排查；盲杀 pid 前先复核进程身份
- **状态栏档案快切** — 新增 API 档案快速切换与 CLI 版本管理浮层，带待重启标记
- **授权徽章上移标题栏** — 从状态栏移到标题栏，永久授权加 VIP 皇冠标识
- **内置浏览器 tab 右键菜单** — 关闭键悬停反馈、截图直接入剪贴板；任务扫描新增识别非 SpringBoot 的可执行 jar
- **终端渲染修复** — 快照重建改为「先对齐几何再抓」，并停用判据恒为真、自身即致乱源的自愈网；路径尾部紧贴说明括号时点不开

### v4.52.0 (2026-08-03)

终端链接、模型清单与 MCP 引导三块打磨：

- **Claude 模型清单改走 Anthropic 协议** — 拉取模型列表改用 Anthropic 原生协议，失败时自动回退同域端点；档案名跟随供应商，不再固定显示
- **MCP 规则按钮暴露写入状态** — 接入后带引导提示，明确规则写到了哪；MCP 服务不可用时自动降级，不再静默失败
- **侧边栏「只看已打开」保留在跑子任务** — 有子任务正在运行的目录组不再被筛选条件误隐藏
- **安装时写入推荐码** — NSIS 安装钩子打通无感归因链路最后一环
- **终端链接修复** — 超宽路径被 TUI 硬折行后无法成链、点不开：折行拼接剥掉 Ink 的行填充空格，并补回 word wrap 吃掉的空格；折行判据不再依赖终端列数，改为单行优先
- **快捷短语提交修复** — 在 Claude Code 下偶发只填充不提交
- **设置面板修复** — 导入其他实例配置的弹窗不再默认全勾选；OAuth 本地校验提示时长由 8s 缩短到 3s

### v4.51.0 (2026-07-31)

修正仪表盘用量统计口径，模型选择支持端点真实清单，工作区提交面板支持多选：

- **仪表盘用量统计修正** — 修复 JSONL 每行重复携带 usage 导致的用量虚高；新增月度用量快照表，CLI 清理 30 天前历史后数据不再蒸发；四个入口统一接入快照合并；卡片文案与统计口径说明重写
- **模型下拉拉取端点真实清单** — 不再只吃硬编码预设，可从当前端点拉取实际可用模型；自动滤掉图像/图注等非对话模型，支持一键还原，新建会话也能拉；下拉新增筛选框，打字时弹层不再消失
- **厂商一致性守卫** — 第三方端点下选 Auto 不再下发 `/model default`（会切回内置 Anthropic 机型）；守卫提示不再写入终端打乱 CLI 重绘；守卫扩展到 Codex，并修正状态栏对非 Claude 工具的误判
- **工作区提交面板多选** — 支持复选框多选文件 + 右键批量操作（丢弃/暂存等）；批量操作统一以复选框为选中依据，菜单项按作用域裁剪
- **MCP 稳定性** — RPC 死线按工具单独计算，超时不再误报「连不上主应用」；CDP 定位加总死线；`ask_project` 补回 stdio 管道；35 处错误分类统一，并补进程树回收与耗时审计
- **终端渲染修复** — 根治 Claude 内联渲染错位：有损 backlog / idle SIGWINCH 后补快照再同步

### v4.50.0 (2026-07-29)

新增主窗口几何持久化与协议转换代理，修复会话跟踪与终端显示多处问题：

- **主窗口几何持久化** — 启动时还原上次的窗口位置与大小，拖动/缩放后自动保存；设置 → 通用新增「还原默认大小」入口
- **Anthropic ↔ Chat Completions 协议转换代理** — 新增「OpenAI 兼容端点」提供商，只提供 Chat 协议的网关（智谱、硅基流动等）也能驱动 Claude Code；档案 key 优先于请求头，避免 401
- **助手工作区支持 Gemini / OpenCode** — 人设文件名改由 provider 注册中心决定；修复 OpenCode/Gemini 下点「AICoder 助手」却开出 Claude 会话
- **接入 Claude Opus 5** — 设为默认模型 `claude-opus-5[1m]`；补齐 Antigravity(agy) 启动参数，会话不再零默认参数
- **会话跟踪链路修复** — 嵌套 claude 子进程顶掉真身导致 `--resume` 报 No conversation found；`/clear` 后跨模糊匹配目录改绑到别的项目；无校验回写与 hook 日志无轮转
- **终端显示修复** — 合盖开盖后输入框坍缩复发（解冻改几何稳定判定 + 恢复观察窗自愈）；状态栏模型短名把「(1M)」误当 model-id 只剩一个 1M
- **远程与 Provider 修复** — tmux 改用独占 socket 根治陈旧进程凭据致 EACCES；远程凭据提示按 provider 分流；Codex Base URL 不再强制补 `/v1`
- **终端性能优化** — 开久后滚轮卡、鼠标不跟手：链接解析行级缓存 + 悬停监听合并节流；子任务 tab 与会话 tab 的挪位效果对齐

### v4.32.0 (2026-07-26)

修复多开实例的账号与终端环境串扰，新增 MCP 指令引导与剪贴板兜底：

- **多开实例环境隔离修复** — 多开实例下添加 Claude 账号会落到别的实例、且不弹「保存账号」表单。根因是生产版真实 PTY 跑在 pty-host 子进程里，它与主进程是兄弟关系、收不到主进程设置的实例隔离环境变量，已在 RPC 边界统一补齐（同时覆盖任务系统与工作区终端）
- **MCP 指令引导** — MCP 接入卡每家客户端新增入口，一键把智码协作规则写入当前实例的 CLAUDE.md / AGENTS.md
- **剪贴板兜底** — 剪贴板被向日葵等远程工具占用时复制/粘贴仍可用：应用内复制缓冲 + 图片粘贴 arboard 兜底 + 串行化 broker
- **工作区增强** — 图片文件走内置预览不再当文本读；分段切换器圆点新增运行中会话绿色呼吸指示
- **安装优化** — 一键安装 npm 全局包统一走国内镜像源，不再卡在 registry.npmjs.org；新增超时兜底防孤儿进程
- **其它修复** — 关掉独立浏览器后再点终端网址打开一片空白；远程会话删除后重连复活；官方 OAuth「测试」因 Anthropic 封禁第三方探活而误报失败，改为本地校验；macOS 点击特殊链接崩溃的两处残留入口

### v4.31.0 (2026-07-23)

🔌 通义千问接入 + 📊 Codex 用量限额展示 + 终端复制增强 + Claude 账号恢复：

- **🔌 通义千问 qianwenai 接入** — Claude Code + Codex 预设，跨厂商模型（GLM / DeepSeek / Kimi / MiniMax），按端点过滤 + 分档校正
- **📊 Codex 用量限额展示** — 5 小时 / 每周窗口用量，状态栏 Tag + 仪表盘卡片 + 远程 workspace 读取 + 事件驱动刷新 + Provider 切换器
- **🖱️ 终端复制增强** — 新增「鼠标优先用于选择文本」（免按 Shift 拖选复制）；修复 mouse tracking 下终端右键复制失效
- **🔑 Claude 账号恢复** — OAuth 档案失效可一键重新登录，删除时清理磁盘幽灵登录态；添加账号代理默认继承全局
- **🐛 修复** — macOS 点网址/外链无弹窗崩溃重启根治；GPT-5.6 Sol 模型置顶；开发版橙色徽章；工作站 Authorization 头一键填 Bearer

### v4.30.0 (2026-07-21)

🌐 内置浏览器大升级（多标签 + 代理模式）+ Codex 压缩会话 + 一批终端/会话修复：

- **🌐 内置浏览器全局单窗多标签** — 会话浏览器统一到一个多标签窗口，标签栏带 favicon / 复制网址 / 窗口控制
- **🛡️ 浏览器代理模式（智能 / 始终走代理 / 从不）** — 智能模式直连失败自动走 App 代理并按域名记忆，根治雅虎等地域封锁站；代理 tab 用独立 WebView2 环境使 `--proxy-server` 真正生效
- **🪟 浏览器窗不抢焦点** — 默认藏主窗背后、定位屏幕右上角，后台打开不遮挡聊天；新建标签＝空白页 + 最近访问卡片（每行 5 个最多 10 个，按域名去重）；工具栏加「访问本地 localhost」快捷按钮
- **🔌 MCP browser_open 加 proxy 参数** — AI 可主动为被墙站开代理，打开任意网站默认走内置浏览器
- **📑 Codex 支持压缩会话** — 对齐 Claude Code，未打开的 Codex 会话也可压缩；克隆/派生/压缩会话后可靠定位到新会话
- **⭐ 收藏会话保留目录组并置顶** — 收藏区显示所属目录
- **🐛 子任务启动/重启偶发无输出修复** — session_id 唯一化 + TabBar 走原子 restart
- **🐛 快捷指令注入 Codex「发不出去变换行 / 多行多次发送」修复** — 改用 Alt+Enter 分内部换行与提交
- **🐛 终端渲染修复** — 终端右侧悬浮按钮避让滚动条；关闭 Claude 全屏渲染根治宿主 XTerm 滚动条消失

### v4.18.0 (2026-07-19)

🚀 Kimi Code 订阅接入 + 会话真克隆 + OAuth 自动续期 + 一批终端/会话修复：

- **🔌 Kimi Code 订阅接入** — 新增 Kimi Code 订阅端点，可直接驱动 Claude Code 与 Codex
- **📑 会话右键真克隆** — Codex 会话支持真克隆，继承完整历史后独立往下聊（原仅 Claude 支持）
- **🔄 Claude OAuth 自动续期** — token 临近过期自动用 refresh_token 换新写回，减少重新登录
- **🎯 diff 视图逐处跳转** — 工作区 diff 支持 F8/Shift+F8 在变更间跳转，带位置计数
- **🪟 内置浏览器按会话隔离** — 浏览器面板按会话归属隔离，默认不再跨会话共用
- **📋 侧边栏任务启动日志感知** — dev server / 构建任务能感知启动成功或失败
- **⚙️ 设置增强** — 快捷短语改可编辑下拉项、主题选择器迷你窗口预览、侧边栏「展开更多」改分页展开
- **🐛 根治内置浏览器/工具「无效 token」永久卡死** — MCP 401 鉴权失败纳入自愈重试
- **🐛 Codex 多行粘贴修复** — 修 Windows 下多行粘贴被逐行拆条提交，快捷短语/队列立即发送对齐 bracketed paste
- **🐛 终端链接修复** — 支持 file:// 本地文件链接、含空格的绝对路径链接可点击
- **🐛 终端渲染修复** — 修回答完毕后粘贴路径/宽表格「重复+坍缩」、新建会话按钮左上角点不动、Codex 新建会话标题不更新/下次不恢复
- **🐛 AICoder 助手按钮点了没反应** — 修静默失败 + sidecar 未就绪整体失败

### v4.17.0 (2026-07-15)

🔐 全平台代码签名 + 新手引导 + 终端悬停预览：

- **🔐 Windows / macOS 代码签名** — Windows 用 EV 证书签主程序 + sidecar + 安装器，消除「智能应用控制」拦截；macOS 用 Developer ID 签名并通过 Apple 公证（notarytool + 钉票据），消除 Gatekeeper「未验证开发者」提示
- **🧭 首次启动新手引导** — 环境体检向导 + 3 步上手 + 主界面聚光导览 + 标题栏常驻「?」帮助入口
- **👀 终端链接悬停预览** — 文件/URL 悬停即预览（图片缩略 / 文本文件头 / PDF·视频·Office 系统缩略图 / 真实网页截图），渲染 markdown 排版、可滚动、加「内置浏览器打开」
- **🔌 更多上游接入** — Codex 内置 Responses↔Chat 转换代理，可接硅基流动 / Ollama 等 Chat-only 上游；Claude Code 预设新增「硅基流动」
- **🐛 终端复制修复** — 修复复制「内容有误 / 快捷键复制不了」多处根因；提问记录支持右键复制原文

### v4.16.0 (2026-07-14)

🎨 终端右侧交互按钮微调 + 桌宠光环重设计：

- **🆕 滚动条快速跳转** — 终端右侧滚动条上/下端各新增「回到顶部 / 回到底部」跳转按钮，一键定位长输出的首尾（仅对话式 provider 显示）
- **🎯 右下角悬浮按钮对齐** — 语音 / 回车 / 停止按钮尺寸统一为 44×44，与右侧「提问记录 / 查看历史」竖排两两间距一致；提问记录位置固定，不再随「查看历史」的存隐而位移
- **✨ 桌宠等级光环重设计** — 重绘桌宠等级光环视觉

### v4.15.0 (2026-07-12)

🆕 侧边栏「文件夹快速定位器」：

- **🆕 文件夹快速定位器** — 顶部工具栏新增「定位文件夹」按钮，拖动滚览条 + 搜索框快速跳转并聚焦文件夹；搜索框聚焦时自动展开整行、失焦还原

### v4.14.0 (2026-07-10)

🚀 Codex GPT-5.6 家族 + 危险命令防护默认关闭 + 日志诊断工具：

- **🚀 接入 Codex GPT-5.6 Terra/Sol/Luna 模型家族** — Codex / OpenCode 内置三档模型（Terra 均衡默认 / Sol 旗舰 / Luna 轻量），Codex 默认切到 gpt-5.6-terra；effort 档位补齐 minimal / ultra（对齐 Codex CLI 0.144）
- **🛡️ 危险命令防护改为默认关闭** — 首次启动不再自动部署 hook，改由「设置 → Hooks」手动开启；拦截弹窗新增「定位到发起此命令的会话」，一键切到对应终端 Tab 对照上下文再决定放行
- **🔧 设置 → 数据管理新增日志工具** — 「打开日志目录」一键定位 startup / forensics / panic 崩溃取证日志；「导出诊断包」把全部日志 + 运行诊断报告打成一个 zip，排查时一键发给开发者（不再漏发关键日志）
- **💡 诊断区四个按钮增加悬停说明** — 复制日志 / CLI 诊断 / 打开日志目录 / 导出诊断包各自说明用途

### v4.13.0 (2026-07-09)

🐛 codex 指令面板修复 + 多工具项目命令 + 一键建会话：

- **🐛 修复 codex 底部指令面板点击斜杠命令(/mcp)不执行** — codex(ratatui) 有 120ms 回车抑制窗口，paste 后紧跟的回车被当成换行而非提交；改为延迟发送回车绕过抑制窗口，点击即执行
- **✨ 指令面板「项目命令」按当前工具各扫各的目录** — codex→`~/.codex/prompts`、gemini→`.gemini/commands`、opencode→`.opencode/commands`，非 Claude 会话不再误显示 Claude 专属命令；空状态提示同步按工具显示对应目录
- **✨ 侧边栏目录右侧加号支持一键直建本地会话** — 按默认设置不弹窗直接新建（含免审批等默认参数，与打开弹窗直接确认一致），远程会话仍走弹窗做 SSH 可达性预检

### v4.12.2 (2026-07-07)

🐛 Codex 会话历史丢失根治：

- **🐛 修复打开有历史的 Codex 会话变成空白新会话 / 写坏会话指针** — 存在性检查抖动、慢扫描、目录读取失败等假阴性不再被当成「会话不存在」；打开会话改为三态判定（存在 / 确认不存在 / 暂不可判定），只有确认不存在才回退，杜绝把有历史的会话静默判丢
- **🐛 修复英文界面会话标题「New Session」永远不被自动更新** — 标题「是否默认」改按 title_source 字段判定，不再依赖本地化字面
- **✨ Codex 会话目录扫描改完整 UUID 精确匹配** — 替换旧的子串匹配，避免误配到别的会话；目录扫描错误不再被静默吞掉
- **🐛 远程工作区 Codex 会话不再被本机误判为「历史丢失」**

### v4.12.1 (2026-07-04)

🐛 粘贴体验修正 + Codex/OpenCode 终端稳定性修复：

- **🖼️ 粘贴图片去掉「请查看图片：」前置提示词** — 现在只粘贴图片本身，不再附加多余引导语
- **🐛 修复 Codex/OpenCode 终端滚动历史被意外清空 / 花屏乱码** — 终端 alt-screen / 清屏控制序列改为按会话有状态、字节级过滤，根治控制序列跨数据块拆分时漏过 `ESC[3J` 清空 scrollback、以及半个 UTF-8 字符被解码成乱码的问题（回复内容显示丢失隐患）

### v4.12.0 (2026-07-03)

🗂️ 工作区远程仓库管理 + 最近目录不限量 + 代理修复：

- **🗂️ 工作区分支面板「远程仓库管理」** — 查看每个远程的地址，支持添加 / 改地址 / 重命名 / 删除远程；本地分支直接显示追踪的上游分支 + 领先/落后提交数，可一键设置 / 取消上游
- **📁 新建会话「最近目录」不再限 20 个** — 全量记录，列表最多两行、超出折叠，用搜索框快速定位
- **🐛 修复开系统代理（Clash 等）时内置浏览器 CDP 操作全废** — 网页自动化 / 截图 / 点击等恢复正常（本地回环走 no_proxy）
- **✨ 分支面板 Fetch / Pull 图标区分更清晰**

### v4.11.0 (2026-07-02)

🆕 新模型 + 更新体验 + 稳定性修复：

- **🆕 新增 Claude Sonnet 5 模型** — 前后端模型列表加入 Claude Sonnet 5
- **🔄 更新就绪确认窗** — 重启前弹确认窗展示本次更新摘要，两处入口统一收口
- **🐛 修复多会话恢复串号** — 同一项目多会话恢复不再张冠李戴（点 A 会话却恢复出 B 的内容）
- **🖥️ 修复亮色终端 Codex 输入框黑块** — ConPTY 拦截 OSC11 背景查询代答黑
- **🔗 修复添加账号弹窗 OAuth 链接检测** — 改读 xterm buffer 重建逻辑行，Ink 硬折的 OAuth URL 也能正确识别
- **✨ 终端悬浮按钮透明度优化** — 右下角悬浮按钮平时高透明，仅悬停本身才提亮
- **🍎 提升 macOS 剪贴板复制稳定性**

### v4.10.1 (2026-07-01)

🐛 稳定性与体验修复：

- **🤖 修复 MCP 自主会话并发丢提示词** — 让 AI 一次开多个自主会话时，只有最后一个会话收到任务提示词的问题（注入定时器改为每会话独立闭包，不再共享单槽状态）
- **📋 终端复制优化** — 复制内容预览遇 emoji 不再显示乱码（按 Unicode 码点截断）；右键复制改为写入成功后才清除选区并记入剪贴板历史，避免「复制失败却提示已复制」
- **🍎 终端 macOS 复制改走原生剪贴板** — Cmd+C / 右键复制走 arboard，复制成功提示带内容预览
- **🔗 Codex 第三方网关 Base URL 自动补 /v1** — 输入框失焦自动补全 + 校验提示
- **📱 移动端安全区避让** — 修复系统虚拟导航键遮挡聊天输入框

### v4.10.0 (2026-06-30)

🪟 Windows 工具检测加固 + 🐾 桌宠靠边躲藏 + 🤖 AICoder 助手 Codex 后端 + 🔗 终端链接弹窗：

- **🪟 Windows 工具检测加固** — Node / nvm / Claude 等「装了却检测不到」根治：读系统注册表里的真实 PATH，装完点「刷新检测」即可识别、无需重启应用；新增固定安装位置直探、nvm 未启用版本的可操作提示、自定义 Node 路径兜底
- **🐾 桌宠靠边躲藏** — 贴边吸附更靠边，真身可探头 / 拖出，带防抖
- **⚡ Claude Code ultracode 热切档** — xHigh + 多 agent 编排
- **🤖 AICoder 助手支持 Codex 后端** — AGENTS.md + 全局 config.toml 挂载 aicoder
- **🔗 终端链接点击统一为风格化确认弹窗** — 普通左键弹窗 / Ctrl 直开，TUI 下也生效
- **🌐 OpenCode 自定义 OpenAI 兼容网关** — 托管 provider 写入 opencode.json
- **🍎 macOS 麦克风权限失配引导** — 设置悬停提示 + 被拒弹窗带 tccutil 重置命令
- **⚡ 会话恢复改走 --resume 直恢复** — Claude Code 2.1.170 已修复崩溃 bug
- **🐛 修复** — 远程 SSH 工作区显示降级 / 失败态、macOS 原生全屏恢复（Esc 直达终端）、mac 剪贴板走原生 arboard、提问记录浮钮不再挡终端输入框

### v4.9.0 (2026-06-25)

🐾 桌宠自定义角色 + 🗂️ 会话历史体验大改 + 🧩 工作区 AI 气泡 + ✅ 任务手动添加：

- **🐾 桌宠自定义角色包** — 支持导入/导出自定义角色（静态图 / 序列帧），通用渲染器数据驱动；全屏「发大招」特效保留
- **🗂️ 完整历史改右侧覆盖式抽屉** — 不再用居中弹窗，贴右侧滑出、不挤压也不打断终端
- **💬 会话历史 AI 回复合并** — 同一轮回答不再被拆成多条框；工具调用收成轻量 chip，与正文视觉隔离
- **🔎 提问记录增强** — 新增「加载更多」；点击已滚出终端 5000 行缓存的提问，自动打开完整历史并定位到该条
- **🧩 工作区 AI 历史** — 改左右气泡布局 + 工具调用 chip 隔离 + 提问记录浮窗点击定位
- **✅ 项目任务手动添加弹窗**

### v4.8.0 (2026-06-25)

🐾 桌宠大招特效 + 🌐 远程增强 + 🍎 macOS 修复 + 🔁 API Profile 切换重启：

- **🐾 桌宠** — 「发大招」全屏特效专属大招（右键菜单 / 连点 10 下 / 升满级三触发）+ Agent 当前目录建会话/切会话/答完单击聚焦该会话 + 多开实例识别角标 + 空闲随机搭话默认开启 + 撒花错峰优化 + 右键菜单防截断
- **🌐 远程 SSH** — 登录终端复制粘贴/光标修复 + 本地代理默认值兜底 + 未连接提示带「去远程主机设置」跳转按钮 + 远程 codex 默认带免审批参数
- **🍎 macOS** — 禁用原生全屏（绿灯改 Zoom，避免全屏下 Esc 被系统吞致终端 CLI 收不到中断）+ 文件浏览器不再隐式枚举 TCC 受保护目录（消除相册/日历/文档误索权）
- **🔁 切换 Claude API Profile 后自动重启会话** 使新端点生效
- **⚡ 快捷短语** — 状态栏 split-button 衍生项 + 提交按钮 + 主窗口加宽
- **🔐 开代理时授权请求不走系统代理**（no_proxy），修复 clash 等代理把国内授权服务器走国外节点致验证失败、新建会话被拦
- **🔧 终端** — 子任务终端长驻命令窄列硬换行修复 + 相对路径含中文目录段可 Ctrl+点击打开

### v4.7.1 (2026-06-25)

🐾 全新桌面桌宠系统 + 🌐 远程 SSH 增强 + ⚡ 终端性能 + 推广返佣：

- **🐾 全新桌面桌宠系统** — 独立透明窗 + 16 个可插拔角色 + 互动反应（点击爱心/双击转圈/连点彩蛋/拖拽回弹）+ 羁绊气场养成（自动 Lv1-6 + Lv6 镀金）+ 节日皮肤（圣诞/万圣/元旦/春节自动饰品）+ 拟真情绪（空闲打盹 Zzz + 心情值）+ 对话 Agent（意图操作 App + 搜索会话定位）+ 语音输入 + 番茄钟 + 边缘停靠游走 + 长期记忆「关于我」
- **🌐 远程 SSH 增强** — 真·OAuth 登录 + 按主机代理三模式（直连 / 远程自己代理 / 反向隧道借本地电脑代理出网）+ 各 CLI 配置面板一键「配置代理」直达对应主机 + 远程工作区添加 Claude 账号
- **⚡ 终端性能** — 修复长时间运行后终端滚动变卡 + 内存泄漏清理 + 默认 Tab 上限 20 + 侧边栏滚动合成层隔离
- **🎁 推广返佣来源识别** — 推广来源识别弹窗 + 注册表无感归因捕获
- **🔧 体验修复** — 右上角通知偏移避开顶部 tab 栏（不再遮挡）+ 桌宠右键菜单固定宽度（长角色名不再忽宽忽窄抖动）

### v4.6.1 (2026-06-17)

API key 自动启用 + 自主会话回车修复 + 终端链接防误触 + 终端渲染修复：

- 🐛 **切第三方 API key 自动启用** — 换普通 API key 档案时自动预批准 customApiKeyResponses，不用再 `/config` 手动开「Use custom API key」开关
- 🐛 **自主会话修复** — `start_agent_session` 喂入提示词后自动回车开跑（之前只填进输入框不提交）
- 🔗 **终端链接改 Ctrl+左键打开** — 防误触，悬停仍显示为链接（路径 + URL 统一，覆盖主/任务/工作区终端）
- 🖥️ **终端渲染修复** — 根治 Claude 回答时「冒号后内容永久消失」+「回答中拖窗口/插拔投屏致正文错位」

### v4.6.0 (2026-06-16)

Antigravity Provider 接入 + MCP 自主会话 + 会话历史搜索 + 多项稳定性修复：

- 🚀 **Antigravity (agy) Provider 完整接入** — 骨架/图标/模型目录(Gemini 3 Pro/Flash)/远程检测/配置编辑器(settings.json + mcp_config.json)/一键安装/「走代理」开关解决 Google OAuth 登录
- 🚀 **aicoder MCP 新增 start_agent_session 自主会话工具** — 外部 AI 可建会话 + 喂提示词自主开跑（配 spawn-agents 拆任务并行多开）
- 🚀 **会话历史查看器 + 工作区 AI 对话历史新增站内关键字搜索** — 命中高亮 + 上/下跳转
- 🚀 **内置浏览器嵌入面板** — accent 描边 + 边缘拖拽改大小
- 🚀 **快捷指令面板 /mcp 置顶** — 高频用免找
- 🐛 **终端路径链接** — 识别中文标签前缀的相对路径，并改 Ctrl/Cmd+点击打开
- 🐛 **「在资源管理器中显示」** — 修 Windows 下打开「文档」而非定位真实文件/目录
- 🐛 **aicoder-mcp sidecar 连接韧性加固** — 启动打不死 + 退避重试 + 关连接池（少断连 + 断连自愈）
- 🐛 **侧边栏会话提问缓存加 LRU 上限** — 根治用久了鼠标滚轮滚动卡顿

### v4.5.0 (2026-06-14)

未响应死锁根治 + 仪表盘大幅升级 + 多项修复：

- 🐛 **根治键盘输入引发的「未响应」死锁** — 移植上游 tao #1215，把 PeekMessage 移出输入锁作用域，从根上消除输入卡死
- 🐛 **修复部分电脑终端 Ctrl+V 无法粘贴** — 大小写/IME/空剪贴板三因
- 🐛 **修复新 WebView2 内核（Chromium≥121）下终端滚动条消失**
- 🐛 **修复内置浏览器切换会话时的闪现与归属错绑**
- 🚀 **仪表盘大幅升级** — 费用按模型版本正确计价（修正 Opus 旧价 3× 高估）、活动时间线每日 token 按真实日期分桶、概览新增「本月输入/输出 Token」、详细页改为「每月花费」柱状图 + 每月输入/输出/花费明细表
- 🚀 **工作区分支视图加提交历史** — 点击分支查看其提交记录 + 提交详情/改动文件面板（master-detail）
- 🚀 **内置浏览器支持 file:// 与本地绝对路径预览**
- 🚀 **底部状态栏 git 分支切换即时刷新**
- 🚀 **新增智谱 GLM glm-5.2 模型**
- 🚀 **MCP 接入新增「接入自家工具」提示卡片**（Sigil / Reeve / AgileShot / AICoder）

### v4.4.2 (2026-06-12)

侧边栏会话筛选 + 关于页生态产品矩阵

- 🆕 **侧边栏「只看已打开会话」筛选** — 搜索框旁新增漏斗开关，一键收起未打开的历史会话，仅保留当前打开为标签页的会话（目录分组照常显示），方便在大量会话中快速定位；再点一下恢复显示全部
- 📖 **关于页新增生态产品矩阵** — 介绍三款姊妹应用：Sigil（AI 凭据金库，密钥永不离手）、Reeve（服务器管理 + 受控 AI 接入）、AgileShot（AI 时代截图标注工具）
- 🔧 AI 工作站模块数更新（55+ → 60+）

### v4.4.1 (2026-06-10)

主线程卡死（未响应）专项根治

- 🚀 24 个高频文件读写/子进程/统计命令移出主线程（会话标题轮询、历史读取、全文搜索、工具检测、仪表盘统计），根治"用着用着未响应"
- 🚀 数据库读写分离：慢查询/聚合走独立只读连接，不再阻塞界面操作
- 🚀 Token 统计增量化：只解析有变化的会话文件，消除每分钟全量扫描 GB 级会话数据的磁盘洪峰
- 🔍 新增主线程慢命令取证日志（SLOW-CMD / HANG-SUSPECT），再遇卡顿可直接定位到具体命令
- 🔄 回退「tab 重开插回原位」功能

### v4.4.0 (2026-06-10)

- 🚀 新增「禁用 GPU 加速」开关：远程桌面（向日葵/远程桌面等）或老显卡下界面闪烁/撕裂时，可在设置→通用一键让本应用改用软件渲染（只影响本软件，不碰系统，重启生效）
- 🚀 Tab 栏新增「查看完整历史」按钮：一键查看当前会话完整对话（读 JSONL，不受终端 5000 行限制）
- 🚀 Tab 栏三个按钮悬停改用主题色提示，「下一个已完成」常态显示
- 🚀 点击边缘 Tab 自动露出相邻 Tab，方便连续切换
- 🚀 新增 Claude Fable 5 模型，修正后端 Sonnet 4.5 无效 ID/默认
- 🐛 修复多开实例终端调度串窗（注入实例端点）
- 🐛 修复 PTY 自动重连导致的终端渲染错乱（精确续订 offset + 直写背压）
- 🚀 推送弹窗点提交可查看该提交变更

### v4.3.0 (2026-06-09)

- 🐛 修复扫描器生成的 Java 启动命令在中文路径下乱码/找不到类（BOM + argfile 编码）
- 🐛 修复输入法候选窗在终端输入时闪烁
- 🚀 远程会话跨电脑统一（远程 JSONL 对账补建）
- 🚀 工作区 diff/编辑器补齐 Java/SQL 等语言高亮
- 🚀 Tab 数量默认不限制 + 内存触发阈值调整
- 🐛 修复多实例内置浏览器串窗
- 🐛 修复主窗口大内容渲染卡死（markdown/历史浮层/diff 降级）
- 🚀 扫描器支持 CMakePresets 双层布局

### v4.2.0 (2026-06-05)

🚀 工作区 Git 增强 + 标题栏开关：

- **🗂️ 工作区目录树右键菜单** — 工作区提交面板改为 IDEA 风格目录树，右键支持暂存/取消暂存/暂存整个目录、打开 Diff、在编辑器/IDEA/系统程序打开、复制相对·绝对路径·文件名、在资源管理器显示
- **🗑️ Git 丢弃改动** — 新增「丢弃改动…」：把选中文件还原到上次提交（未跟踪文件直接删除），带二次确认
- **🤖 文件级 AI 操作** — 右键可把文件 @引用 发送到主窗口 AI 终端、复制 @引用、让 AI 解释/审查此文件
- **🚫 一键加入 .gitignore** — 右键未跟踪文件直接写入 .gitignore
- **🔗 标题栏官网链接显隐开关** — 设置→通用新增开关，关掉后标题栏只保留应用名，适合录屏/演示
- **⚡ 面板打开无延迟** — 遮罩面板打开的瞬间同步隐藏子 webview，消除「设置先显示、webview 后隐藏」的可见延迟

### v4.1.0 (2026-06-04)

🚀 模型切换 + 多平台模型适配 + 终端体验：

- **🚀 底部状态栏一键切换模型** — 点状态栏模型名即可切换：Claude 即时热切当前会话，Codex/Gemini/OpenCode 重启会话生效；下拉显示当前 API 配置（Profile）的真实模型（小米 MiMo / GLM / DeepSeek 等），不再误显示 Anthropic 机型
- **🚀 Codex 第三方模型上下文窗口自动写入** — 切换配置时按模型自动写入真实上下文窗口（MiMo 1M、GLM 200K、DeepSeek 128K 等），避免提前压缩、用满超长上下文
- **🚀 Claude 第三方端点别名映射** — 接小米/GLM/Kimi 等第三方端点时，`/model` 选 Opus/Sonnet 也能正确跑实际模型，不再报错
- **🚀 添加账号登录终端支持点击聚焦 + 右键粘贴** — 贴 OAuth code 更顺手
- **🚀 提交弹窗可点文件查看 diff（HEAD ↔ 工作区）+ 主题感知**
- **🛡️ 下一步建议发送前自动脱敏** — 密钥类 + PII 强制常开；建议显示 30 秒后半透明、hover 恢复
- **⚡ 终端内存优化** — scrollback 默认 10000→5000，pty-host 常驻内存减半；远程 PTY 改走统一后端抽象
- **🐛 修复 Gemini 会话记录不上 / 每次需手动 resume**
- **🐛 修复历史查看器/导出把工具结果误标为用户消息**
- **🐛 侧边栏 AICoder 助手目录稳定置顶；关闭会话清理通知时间戳累积**

### v4.0.4 (2026-06-03)

🔧 修复 MCP 接入 + 内置浏览器开发者工具：

- **🐛 修复「一键接入 Claude Code」接入不生效** — 生产环境（安装版）下一键接入会把配置写到错误的文件位置，导致设置页显示「已接入」但 Claude Code 实际读不到 aicoder MCP。现按 Claude Code CLI 实际读取规则统一配置路径，接入后终端 `/mcp` 即可看到 aicoder（修复后需重新点一次「一键接入」写到正确位置）
- **🚀 内置浏览器支持开发者工具** — 生产环境的内置浏览器（含 AI 自动打开的预览面板）现可用 F12 / 右键「检查」打开开发者工具调试网页；应用主界面本身仍不暴露，安全无虞
- **🐛 修复 macOS 旧版系统终端路径链接崩溃** — 旧版 macOS 系统 WebView 不支持某正则语法，导致终端里的文件路径点击功能整体失效，现改为等价写法兼容

### v4.0.3 (2026-06-03)

🌐 外部浏览器窗 + 嵌入面板会话归属 + 本地优先恢复：

- **🚀 外部站点独立浏览器窗** — 工具栏移到外层（宿主窗 React），网页作为子 webview 直连，不再被网页固定顶栏遮挡；内置浏览器面板按会话归属，切换会话自动隐藏/恢复，关闭会话自动回收子窗
- **🏷️ 标题栏版本号胶囊** — 新增版本号显示，点击一键检测更新
- **🏠 关闭重开只恢复本地会话** — 重开软件不再自动连接/恢复远程（服务器）会话，只恢复本地；远程会话的 tmux 仍在服务器运行，需要时手动切到对应远程工作区即可继续
- **🐛 修复目录被误当文件打开** — 提交面板 / Diff 视图中，未跟踪目录或嵌套 Git 仓库不再被当成文件打开而报「拒绝访问」，改为友好提示（勾选复选框仍可整目录提交）

### v4.0.2 (2026-06-02)

🔧 修复安装器升级失败：

- **🐛 修复升级安装时报「无法写入 aicoder-pty-host.exe」装不上的问题** — PTY 主机是游离进程（与守护进程解耦以便会话续传），旧安装脚本「单次结束进程 + 固定等待 1 秒」挡不住守护进程的秒级重启竞态，导致升级覆盖文件时 PTY 主机仍被占用。现改为「循环结束进程树 + 轮询确认已退出」，并补充结束 MCP sidecar 进程，根治升级装不上。

### v4.0.1 (2026-06-02)

🔀 IDEA 风格 Git 推送弹窗 + diff 高亮：

- **🚀 新增 IDEA 风格 Git 推送弹窗** — `Ctrl+Shift+K` 打开、`Alt+K` 一键推送；支持多远端勾选（如 github + gitee 同时推），左侧待推送提交列表 + 路由行，右侧变更文件树
- **🔍 推送弹窗内点击文件查看改动 diff** — 远端版 ↔ 本地 HEAD 并排比对，带代码语法高亮
- **🎨 修复 diff 比对视图缺少语法高亮** — 与文件编辑器一致的着色（暗/亮主题分别适配）
- **⌨️ Git 提交/推送快捷键拆分** — `Ctrl+K` 提交、`Ctrl+Shift+K` 推送，主窗口与工作区一致

### v4.0.0 (2026-06-02)

🚀 内置浏览器升级为 AI 自动化面板 + 多项效率与稳定性增强：

- **🌐 内置浏览器升级为 AI 可驱动的自动化面板** — 终端 AI 经 MCP 完整操作内置浏览器做网页自动化/测试：18 个工具覆盖导航 / 点击 / 输入 / 等待 / 悬停 / 下拉 / 上传 / 下载 / cookie / localStorage / 结构化数据获取 / 表格 / 接口 mock / 录制回放 / 断言 / iframe / 元素截图；嵌入式三态面板贴主窗右上角不挡提问，登录态持久 + 可跨窗复用
- **📑 标签数量上限 + 内存压力自动关闭** — 标签超上限或内存吃紧时，自动关掉最久未活跃的会话
- **💡 下一步建议** — 会话回答完毕后用独立模型推荐接下来可问的提示词，点击即填入
- **🖥️ VT100 虚拟屏幕快照恢复终端** — 根治重启后差分 TUI（Claude / Codex）重画错位
- **🔗 跨实例会话标识符续聊** — 复制会话标识符到另一实例（dev↔prod），经 MCP 续聊
- **🐛 稳定性修复** — 远程控制下终端 IME 一字变两字、会话时间排序跳变、托盘交互等

### v3.9.3 (2026-05-30)

内存治理 + 终端稳定性 + 体验优化：

- **🧠 修复提交内存满载导致界面崩溃重启** — 长时间使用后，后端 RPC 输出队列无上限堆积、已退出会话残留的进程树不回收，导致系统提交内存（commit）耗尽、WebView 渲染进程被系统杀死。现加每会话 8 MiB 队列上限（超限丢最旧、保最新屏）+ pty-host 自动回收死会话（关闭 JobObject 清掉残留的 node / MCP server 进程树），从根上消除"越用越占内存直到崩溃重启"。
- **📊 新增状态栏内存指示器** — 实时显示提交内存余量，可一键管理空闲会话
- **🐛 终端稳定性** — 修复异常关闭恢复后终端底部 UI 重影、输入时窗口轻微偏移、attach 重连后终端尺寸错位
- **🔀 会话历史读取统一** — 跨 Claude / Codex / Gemini / OpenCode 收敛到统一 helper
- **⚡ 修复主界面卡顿** — Git / 文件命令下放 blocking 线程池
- **🎯 侧边栏切换收藏后视线跟随** — 滚出可视区自动滚回保持可见
- **🔔 "恢复上次会话"提示弹窗下移** — 不再遮挡顶部标题栏

### v3.9.2 (2026-05-29)

修复 v3.9.1 子窗口样式回归：

- **🐛 修复工作区 / 会话 / 预览 / 语音等独立窗口标题栏样式崩坏** — v3.9.1 路由级懒加载拆分后，全局基础样式（App.css / variables.css）未被这些懒加载子窗口加载，导致标题栏按钮、标签页关闭按钮等错位挤压。现已将全局基础样式提到统一入口，所有窗口共用。主窗口不受影响。

### v3.9.1 (2026-05-29)

MCP 对外服务 + Claude Opus 4.8 + 本地 LLM + 会话恢复增强 + 亮色主题深度适配：

- **🔌 AICoder 对外 MCP 服务** — 6 家 AI 客户端（Claude Code / Codex / Cursor / Cline / Zed / OpenCode）一键接入 AICoder 数据（会话 / 代码片段 / Token 统计 / API Profile / 项目记忆）
- **🤖 支持 Claude Opus 4.8 模型**
- **🦙 Codex 本地 LLM 后端** — 接入 Ollama / vLLM / LM Studio 本地模型
- **🔄 冷启动自动恢复上次会话** — 重启后逐个前台恢复上次打开的标签
- **🛡️ PTY 会话恢复大幅增强** — 重启 / 死机后自动重连、启动重试、终端不再渲染错位
- **😴 长任务运行期间阻止系统睡眠**（responding 状态绑定 wake lock）
- **🔗 终端路径链接** — 点击开文件 / Ctrl+点击开目录
- **⌨️ IDEA 风格快捷键** — Ctrl+K / Ctrl+Shift+K
- **🏷️ 标签栏显示会话序号** + 总数下拉切换；终端历史回滚扩到 10000 行
- **🎨 亮色主题深度适配** — 引入语义色 token 体系，消除多处黑斑
- **🐛 修复 macOS Command+Q 被误判重启**；MCP 能力清单改居中弹窗；App 路由级懒加载加快冷启动

### v3.8.0 (2026-05-27)

全新「远程 SSH 工作区」体系 + 工作区编辑器 + 大量 Provider 远程化：

- **🌐 远程 SSH 工作区** — 连接远程主机，在远端直接运行 Claude / Codex / Gemini / OpenCode，API Profile / MCP / Hooks 全部按工作区隔离；内置 SSH 连接池、远程 PTY、known_hosts 管理
- **🖥️ 远程主机管理面板** — 一键安装 Node / CLI（实时 SSH 安装日志）、远程目录浏览、远程 Git 操作
- **🗂️ 工作区编辑器** — 文件树右键菜单、代码大纲、Java / XML 语法高亮（One Dark 主题）、横向滚动
- **💻 终端增强** — 路径可点击跳转、远端 tmux 鼠标滚轮翻历史、修复 Claude /config 等 TUI 标签切换不响应
- **🔄 自动更新改为后台静默下载** — 下载完成后由用户主动重启，不打断当前工作
- **🧾 订阅页重做** — 日均成本 / 节省比实算、推荐档位、付费授权与设备绑定条款
- **☁️ WebDAV 同步支持跳过自签名证书校验** — 适配飞牛 NAS 等自签名证书环境
- **🐛 修复中文输入法候选窗飘移与重复输入；托盘「重启应用」保留会话标签**

### v3.7.5 (2026-05-24)

A-Enhanced 崩溃自愈链路 + 多实例隔离 + NSIS 升级护盾 + UI 体验改进：

- **WebView2 渲染崩溃强制让 watchdog 接管重启** — DiagnosticState 加滑动窗口风暴计数 / reload deadline + monotonic / unrecoverable 锁；用户被迫关闭黑屏窗口不再被误判为正常退出
- **power_monitor 监听 Windows WM_POWERBROADCAST** — 给 stale_heartbeat 加唤醒 30s grace，消除 sleep/wake 后立即关窗的误判
- **NSIS 安装前强杀整棵守护进程树**（watchdog + main + pty-host）— 解决升级时三个 exe 任一被锁导致「无法写入」
- **TUI provider detect 兜底 v3.7.0~v3.7.2 临时 UUID 残留** — codex/opencode/gemini 老会话 DB 里的临时 UUID 不在文件系统时自动覆盖为真实 cli session id
- **项目任务扫描去重** — 识别父 pom 的 `<modules>` 声明跳过重复扫描子模块；面板新增「清空全部任务」+ 右键菜单
- **清空 PTY 输入框支持多行 + Ctrl+L 快捷键** — `` + 200×Backspace 跨行兜底，覆盖 Ink TUI 多行输入
- **tab 重启菜单** — sessionId 不变重 spawn PTY，跳过 responding 确认弹窗
- **内存压力 toast 改造** — 20s 自动隐藏 + 避让右下角 FloatButton
- **4 个 Provider API config 面板表单聚焦统一** — 打开编辑表单时自动 focus 名称输入框

### v3.7.2 (2026-05-24)

v3.7.0 守护进程方案的延续修复 + 侧边栏交互优化：

- **守护进程模式下扫描任务启动报「pty id 0 not found」修复** — v3.7.0 把 PTY 拆出独立 pty-host 进程后，project_task service 仍直连主进程 PtyManager 而非 RpcBackend，导致 spawn 出的 pid 在 pty-host 找不到 → 连续 10 次读取错误后断开。改为走 `Arc<dyn PtyBackend>` trait，与普通终端共用同一条 PTY 路径
- **侧边栏目录单击体验优化** — 单击目录 = 折叠/展开会话列表（等同左侧 chevron），双击 = 打开工作区窗口；250ms 延迟避免双击触发先折叠又展开的视觉抖动

### v3.7.1 (2026-05-24)

v3.7.0 守护进程方案的紧急修复 — 3 个会阻塞使用的关键问题：

- **侧边栏目录点击扫描白屏修复** — TaskScanDialog 的 Zustand selector 每次渲染都 `return new Set(...)`，在 React 19 `useSyncExternalStore` 下进入快照死循环（React #185 Maximum update depth exceeded）；改为 selector 只取 store 内稳定数组引用，`new Set` 构造移到 `useMemo`
- **多实例 / dev + prod 并存修复** — pty-host named pipe 端点名从固定 `\\.\pipe\pty-host-poc` 改为按 instance id 隔离（`\\.\pipe\aicoder-pty-host-<id>`），watchdog 用自身 PID 生成 id，通过 env `AICODER_PTY_HOST_ENDPOINT_ID` 注入给 pty-host + main，互不抢 pipe；shutdown flag 路径同步按 id 隔离
- **`cargo tauri dev` 启动修复** — debug build 永远跳过 self-respawn via watchdog，仅 release build 启用守护进程接管；另加 `AICODER_NO_WATCHDOG=1` 应急关闭开关

### v3.7.0 (2026-05-23)

守护进程方案 — 主进程崩溃自动重启 + 会话自动恢复 + CLI 输出不中断：

- **守护进程架构（A-Enhanced）** — 引入 watchdog + pty-host 双 sidecar 进程：watchdog 监控主进程崩溃自动重启；pty-host 独立持有 PTY master，CLI 子进程不受主进程崩溃影响，继续运行
- **会话自动恢复** — 主进程崩溃 / 用户结束进程后，watchdog 自动重启主进程，所有活跃会话标签自动恢复，CLI 输出继续流式刷新（token 不浪费、对话不中断）
- **MessagePack RPC + 环形缓冲** — 前后端通过 named pipe / UDS + MessagePack 通信，每会话 2 MiB 环形缓冲保证重连无缝接续历史输出
- **AICODER_SUPERVISED 防 fork bomb 守卫** — 自重生路径加 env 守卫；watchdog 退出时主动清理 pty-host 子进程，避免僵尸进程
- **静默后台运行** — sidecar binary 用 GUI subsystem + CREATE_NO_WINDOW 标志，无任何命令行黑窗
- **NSIS 安装包默认携带守护进程** — 安装即启用 A-Enhanced 架构，无需用户额外配置

### v3.6.3 (2026-05-19)

体验完善 + 多项关键修复：

- **空闲会话清理面板** — 内存紧张时弹 notification 提供「管理空闲会话」按钮，列出所有非响应中的会话，闲置 ≥30 分钟默认勾选；勾选确认后批量关闭释放内存。responding 中的会话**绝对不显示**，关闭瞬间二次校验防误关
- **新建会话最近项目体验升级** — 加搜索框，输入时模糊匹配末两段路径并展开到 12 个；同名末段（如 `qt-app`）显示父目录前缀（`frameworks/qt-app`）区分；模板新增「用工作站」一键触发 ai-workstation MCP
- **API Profile 跨实例明文分享协议** — 单条 `ai.profile` / 多条 `ai.profile.bundle` envelope，跨同级软件互通；OAuth 类型档案后端强制跳过（凭证绑设备）；接入 4 个 Provider 配置面板
- **多个交互 bug 修复** — 空闲清理面板勾选反复回弹（每秒 tick 把用户取消的又自动加回）、连续关多 tab 时 activeTabId 残留幽灵（doCloseTab 闭包陷阱）、antd v6 Tooltip/Popover deprecation 迁移到 `styles.root/container`、静默 Windows PTY kill 已退出进程的 `os error 87` 无害报错

### v3.6.2 (2026-05-16)

WebView2 崩溃自愈 + 内存预防 + 多项关键修复：

- **WebView2 崩溃自动 reload** — 系统内存压力或其他原因导致 WebView2 渲染进程崩溃时，Rust 主进程监听 `ProcessFailed` 事件自动 reload，PTY 继续存活；前端重连后通过 `pty_list_active` + `attach()` 接管幸存终端，用户的 Claude / Codex / Gemini 对话状态零损失
- **commit-aware 内存预防** — 直接读 `GlobalMemoryStatusEx.ullAvailPageFile`（任务管理器同款指标），5 秒采样，commit 配额低于 30% 时自动降级 WebView2 内存模式；低于 15%/10% 时弹窗告警（双重判定：比例 + 绝对值 < 800MB 才报，大内存机不误报）
- **页面文件禁用提示** — 启动时检测系统页面文件被禁用一次性提示用户启用，避免低内存触发 0xc000012d 崩溃
- **修复新建空会话重开误绑** — 新建会话后秒关再从侧边栏重开时，detectActiveSession 会错误绑定上一次会话的 rollout（用户看到上一次对话的内容）。修复方案：双重过滤（since_ms ≥ session.created_at + occupiedIds 排除已归属会话）
- **修复 ~/.claude.json 写入擦掉 MCP/oauthAccount** — 历史 bug：4 处入口（ensure_onboarding_completed / ensure_claude_project_trusted / sync_claude_json_account_email / clear_claude_json_account_identity）用 `unwrap_or_else(|_| {})` 在 JSON 解析失败时静默替换为空对象，写回去就把整段 mcpServers/projects 擦了；改为解析失败立即返回 Err 不写入。`json_utils::write_json_file` 升级为「自动备份 + 原子 rename」三重保护，从根上解决 MCP Server 配置丢失问题

### v3.6.1 (2026-05-14)

侧边栏 UX 改进 + 模型选择尊重 + 自定义端点文案：

- **侧边栏多选删除** — Ctrl/Shift+Click 选中多条会话，右键弹「删除选中 N 条」批删
- **文件夹规则批删** — 右键文件夹动态显示「删除 30 天未活动 / 删除未收藏 / 删除已关闭」（条数为 0 不显示）
- **各 Provider 目录 chevron 一致** — Codex / Gemini / OpenCode 等少量会话文件夹也有 hover 切换器
- **激活会话强制可见** — 折叠态下保证当前选中 + 已打开标签页的会话不被收起
- **Claude 模型选择** — 新建对话框显式选的模型不再被活跃 API Profile 静默覆盖
- **自定义端点去后缀** — 4 个 Provider 面板的「自定义端点」选项去掉 `(OpenAI 兼容)` 后缀，避免误导 Claude / Gemini 用户
- **适配 Codex 0.124** — `codex_hooks` feature flag 改名为 `hooks`

### v3.6.0 (2026-05-14)

本次更新带来更清晰的产品体验：

- **新增首次启动使用说明** — 帮你快速了解软件定位与使用方式
- **设置-关于页新增产品说明区域** — 随时查看产品边界与商标信息
- **Provider 选项命名优化** — 措辞更直观清晰
- **终端性能提升** — TUI 会话消息加载更快、会话标题显示更稳定
- **无感升级** — 旧版配置自动适配新结构,本地数据无需手动操作

## 项目结构

```
aicoder-release/
├── README.md           # 本文件
├── update.json         # 桌面端自动更新清单（Tauri Updater 读取）
├── .gitignore          # Git 忽略规则
├── releases/           # 桌面端版本（仅保留最新版本 v5.4.0；完整历史见 GitHub 仓 + R2 CDN）
│   └── vX.Y.Z/         # 每版含 Win exe + macOS dmg/app.tar.gz + Linux deb/AppImage + 各自 .sig 签名
└── releases-mobile/    # 移动端伴侣 Android APK + AAB（独立版本号，仅保留最近版本）
    └── mobile-vX.Y.Z/  # 每版含 universal-release APK + AAB
```

## 发布新版本流程

1. 在主项目中更新版本号（`tauri.conf.json` / `Cargo.toml` / `package.json`）
2. 打 Git Tag（`v*.*.*` 格式）并推送到 GitHub，CI 自动构建 Windows + macOS 安装包
3. 从 GitHub Release 下载产物，本地推送到本仓库并生成 `update.json`

## 许可证

Copyright (c) 2026 AgileFR. All rights reserved.