# aicoder-release **Repository Path**: bkywksj/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**: 35 - **Forks**: 11 - **Created**: 2026-03-09 - **Last Updated**: 2026-05-27 ## 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） ## 下载安装 ### 最新版本: v3.8.0 | 平台 | 下载链接 | |------|---------| | Windows x64 | [AICoder_3.8.0_x64-setup.exe](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder/releases/v3.8.0/AICoder_3.8.0_x64-setup.exe) | | macOS Apple Silicon | [AICoder_3.8.0_aarch64.dmg](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder/releases/v3.8.0/AICoder_3.8.0_aarch64.dmg) | | macOS Intel | [AICoder_3.8.0_x64.dmg](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder/releases/v3.8.0/AICoder_3.8.0_x64.dmg) | | Linux Debian/Ubuntu | [AICoder_3.8.0_amd64.deb](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder/releases/v3.8.0/AICoder_3.8.0_amd64.deb) | | Linux 通用 (AppImage) | [AICoder_3.8.0_amd64.AppImage](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder/releases/v3.8.0/AICoder_3.8.0_amd64.AppImage) | ### 移动端伴侣 · v0.4.0 > Android 侧载分发，需要在系统设置中允许「未知来源安装」。iOS 暂未发布。 > 移动端版本号与桌面端独立维护：移动端 v0.4.0。 | 平台 | 下载链接 | 用途 | |------|---------|------| | Android APK | [AICoder-mobile-v0.4.0.apk](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder-mobile/releases/mobile-v0.4.0/AICoder-mobile-v0.4.0.apk) | 用户直接安装 | | Android AAB | [AICoder-mobile-v0.4.0.aab](https://pub-9d9e6c0cb6934fb0a0c505e3c64f39b2.r2.dev/aicoder-mobile/releases/mobile-v0.4.0/AICoder-mobile-v0.4.0.aab) | Google Play 上架用（暂存档） | **🆕 v0.4.0 — 配置档案切换 / 指令面板 / Provider 选择**：移动端补齐三大常用功能，详见 [移动端版本历史](#移动端版本历史)。 **🔐 签名提示**：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 可能会提示： > 未打开"智码 AICoder.app"，Apple 无法验证"智码 AICoder.app"是否包含可能危害 Mac 安全或泄漏隐私的恶意软件。 这是因为应用未经过 Apple 公证（Notarization），**并非恶意软件**。请执行以下命令解除限制： ```bash sudo xattr -d com.apple.quarantine /Applications/智码\ AICoder.app ``` 输入 Mac 登录密码后即可正常打开应用。 ## 更新机制 应用内置自动更新功能： - 启动后自动检查更新（首次延迟 5 秒，之后每 30 分钟检查一次） - 发现新版本后，右上角浮动通知显示「有可用更新」 - 点击「立即更新」按钮，自动下载并安装 - 安装完成后自动重启应用 更新清单文件: [update.json](update.json) ## 移动端版本历史 ### 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 渲染** — 用户消息气泡里把 `@` 渲染成 `[🖼 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 强制 + 审计日志 + 熔断 + 紧急下线 - **🔍 全局搜索** — 标题 / 项目路径 / 消息内容三合一 --- ## 版本历史 ### 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 的 `` 声明跳过重复扫描子模块；面板新增「清空全部任务」+ 右键菜单 - **清空 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` 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-`），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-mobile/ # 移动端伴侣 (Android APK + AAB，独立版本号) │ ├── mobile-v0.4.0/ # 配置档案切换 + 指令面板 + Provider 选择 (P0+P1+P2) │ │ ├── AICoder-mobile-v0.4.0.apk │ │ └── AICoder-mobile-v0.4.0.aab │ ├── mobile-v0.3.6/ # 🔐 首个稳定 release keystore 签名版本（旧版需卸载重装） │ │ ├── AICoder-mobile-v0.3.6.apk │ │ └── AICoder-mobile-v0.3.6.aab │ ├── mobile-v0.3.4/ # 按 session_id 精确路由 PTY (配桌面 v3.5.5) │ │ ├── AICoder-mobile-v0.3.4.apk │ │ └── AICoder-mobile-v0.3.4.aab │ ├── mobile-v0.3.3/ # 修复检查更新永远报「已是最新版本」的关键 bug（parseSemver 不识别 mobile- 前缀） │ │ ├── AICoder-mobile-v0.3.3.apk │ │ └── AICoder-mobile-v0.3.3.aab │ ├── mobile-v0.3.2/ # 刷新授权状态 UX 优化（loading + alert 反馈） │ │ ├── AICoder-mobile-v0.3.2.apk │ │ └── AICoder-mobile-v0.3.2.aab │ ├── mobile-v0.3.1/ # 修复 cleartext traffic 关键 bug（http:// 桌面端无法添加） │ │ ├── AICoder-mobile-v0.3.1.apk │ │ └── AICoder-mobile-v0.3.1.aab │ ├── v0.3.0/ # 启动检查新版本 + 网络错误中文化 + IPv6 字面量 │ │ ├── AICoder-mobile-v0.3.0.apk │ │ └── AICoder-mobile-v0.3.0.aab │ ├── v0.2.0/ # 附件上传 + 消息时间戳 + debug/release 并存 │ │ ├── AICoder-mobile-v0.2.0.apk │ │ └── AICoder-mobile-v0.2.0.aab │ └── v0.1.0/ # 首发：Tauri Mobile Android (T-MC010~050) │ ├── AICoder-mobile-v0.1.0.apk │ └── AICoder-mobile-v0.1.0.aab └── releases/ # 桌面端版本发布目录 ├── v3.8.0/ # 远程 SSH 工作区 + 工作区编辑器 + Provider 远程化 + 自动更新后台下载 + 订阅页重做 │ ├── AICoder_3.8.0_x64-setup.exe # Windows 安装包 │ ├── AICoder_3.8.0_x64-setup.exe.sig # Windows updater 签名 │ ├── AICoder_3.8.0_aarch64.dmg # macOS Apple Silicon │ ├── AICoder_aarch64.app.tar.gz # macOS ARM updater 产物 │ ├── AICoder_aarch64.app.tar.gz.sig # macOS ARM updater 签名 │ ├── AICoder_3.8.0_x64.dmg # macOS Intel │ ├── AICoder_x64.app.tar.gz # macOS Intel updater 产物 │ ├── AICoder_x64.app.tar.gz.sig # macOS Intel updater 签名 │ ├── AICoder_3.8.0_amd64.deb # Linux Debian/Ubuntu │ ├── AICoder_3.8.0_amd64.deb.sig # Linux DEB 签名 │ ├── AICoder_3.8.0_amd64.AppImage # Linux 通用（也是 updater 产物） │ └── AICoder_3.8.0_amd64.AppImage.sig # Linux updater 签名 ├── v3.7.5/ # 崩溃自愈 + sleep/wake 监听 + NSIS 升级护盾 + 输入清空多行 + 任务清空 + UI 体验 │ ├── AICoder_3.7.5_x64-setup.exe # Windows 安装包 │ ├── AICoder_3.7.5_x64-setup.exe.sig # Windows updater 签名 │ ├── AICoder_3.7.5_aarch64.dmg # macOS Apple Silicon │ ├── AICoder_aarch64.app.tar.gz # macOS ARM updater 产物 │ ├── AICoder_aarch64.app.tar.gz.sig # macOS ARM updater 签名 │ ├── AICoder_3.7.5_x64.dmg # macOS Intel │ ├── AICoder_x64.app.tar.gz # macOS Intel updater 产物 │ ├── AICoder_x64.app.tar.gz.sig # macOS Intel updater 签名 │ ├── AICoder_3.7.5_amd64.deb # Linux Debian/Ubuntu │ ├── AICoder_3.7.5_amd64.deb.sig # Linux DEB 签名 │ ├── AICoder_3.7.5_amd64.AppImage # Linux 通用（也是 updater 产物） │ └── AICoder_3.7.5_amd64.AppImage.sig # Linux updater 签名 ├── v3.7.2/ # 守护进程模式扫描任务 PTY 路由修复 + 侧边栏目录单击折叠/双击打开工作区 │ ├── AICoder_3.7.2_x64-setup.exe # Windows 安装包 │ ├── AICoder_3.7.2_x64-setup.exe.sig # Windows updater 签名 │ ├── AICoder_3.7.2_aarch64.dmg # macOS Apple Silicon │ ├── AICoder_aarch64.app.tar.gz # macOS ARM updater 产物 │ ├── AICoder_aarch64.app.tar.gz.sig # macOS ARM updater 签名 │ ├── AICoder_3.7.2_x64.dmg # macOS Intel │ ├── AICoder_x64.app.tar.gz # macOS Intel updater 产物 │ ├── AICoder_x64.app.tar.gz.sig # macOS Intel updater 签名 │ ├── AICoder_3.7.2_amd64.deb # Linux Debian/Ubuntu │ ├── AICoder_3.7.2_amd64.deb.sig # Linux DEB 签名 │ ├── AICoder_3.7.2_amd64.AppImage # Linux 通用（也是 updater 产物） │ └── AICoder_3.7.2_amd64.AppImage.sig # Linux updater 签名 ├── v3.7.1/ # v3.7.0 守护进程方案的紧急修复（扫描白屏死循环 + 多实例 pty pipe 冲突 + dev 启动） │ ├── AICoder_3.7.1_x64-setup.exe # Windows 安装包 │ ├── AICoder_3.7.1_x64-setup.exe.sig # Windows updater 签名 │ ├── AICoder_3.7.1_aarch64.dmg # macOS Apple Silicon │ ├── AICoder_aarch64.app.tar.gz # macOS ARM updater 产物 │ ├── AICoder_aarch64.app.tar.gz.sig # macOS ARM updater 签名 │ ├── AICoder_3.7.1_x64.dmg # macOS Intel │ ├── AICoder_x64.app.tar.gz # macOS Intel updater 产物 │ ├── AICoder_x64.app.tar.gz.sig # macOS Intel updater 签名 │ ├── AICoder_3.7.1_amd64.deb # Linux Debian/Ubuntu │ ├── AICoder_3.7.1_amd64.deb.sig # Linux DEB 签名 │ ├── AICoder_3.7.1_amd64.AppImage # Linux 通用（也是 updater 产物） │ └── AICoder_3.7.1_amd64.AppImage.sig # Linux updater 签名 ├── v3.7.0/ # 守护进程方案：主进程崩溃自动重启 + 会话自动恢复 + CLI 输出不中断 │ ├── AICoder_3.7.0_x64-setup.exe # Windows 安装包 │ ├── AICoder_3.7.0_x64-setup.exe.sig # Windows updater 签名 │ ├── AICoder_3.7.0_aarch64.dmg # macOS Apple Silicon │ ├── AICoder_aarch64.app.tar.gz # macOS ARM updater 产物 │ ├── AICoder_aarch64.app.tar.gz.sig # macOS ARM updater 签名 │ ├── AICoder_3.7.0_x64.dmg # macOS Intel │ ├── AICoder_x64.app.tar.gz # macOS Intel updater 产物 │ ├── AICoder_x64.app.tar.gz.sig # macOS Intel updater 签名 │ ├── AICoder_3.7.0_amd64.deb # Linux Debian/Ubuntu │ ├── AICoder_3.7.0_amd64.deb.sig # Linux DEB 签名 │ ├── AICoder_3.7.0_amd64.AppImage # Linux 通用（也是 updater 产物） │ └── AICoder_3.7.0_amd64.AppImage.sig # Linux updater 签名 ├── v3.6.3/ # 空闲会话清理面板 + 最近项目搜索 + 用工作站模板 + ApiProfile 分享 + bug 修复 │ ├── AICoder_3.6.3_x64-setup.exe # Windows 安装包 │ ├── AICoder_3.6.3_x64-setup.exe.sig # Windows updater 签名 │ ├── AICoder_3.6.3_aarch64.dmg # macOS Apple Silicon │ ├── AICoder_aarch64.app.tar.gz # macOS ARM updater 产物 │ ├── AICoder_aarch64.app.tar.gz.sig # macOS ARM updater 签名 │ ├── AICoder_3.6.3_x64.dmg # macOS Intel │ ├── AICoder_x64.app.tar.gz # macOS Intel updater 产物 │ ├── AICoder_x64.app.tar.gz.sig # macOS Intel updater 签名 │ ├── AICoder_3.6.3_amd64.deb # Linux Debian/Ubuntu │ ├── AICoder_3.6.3_amd64.deb.sig # Linux DEB 签名 │ ├── AICoder_3.6.3_amd64.AppImage # Linux 通用（也是 updater 产物） │ └── AICoder_3.6.3_amd64.AppImage.sig # Linux updater 签名 ├── v3.6.2/ # WebView2 崩溃自愈 + 内存预防 + 修复 MCP 配置丢失 / 新会话误绑 │ ├── AICoder_3.6.2_x64-setup.exe # Windows 安装包 │ ├── AICoder_3.6.2_x64-setup.exe.sig # Windows updater 签名 │ ├── AICoder_3.6.2_aarch64.dmg # macOS Apple Silicon │ ├── AICoder_aarch64.app.tar.gz # macOS ARM updater 产物 │ ├── AICoder_aarch64.app.tar.gz.sig # macOS ARM updater 签名 │ ├── AICoder_3.6.2_x64.dmg # macOS Intel │ ├── AICoder_x64.app.tar.gz # macOS Intel updater 产物 │ ├── AICoder_x64.app.tar.gz.sig # macOS Intel updater 签名 │ ├── AICoder_3.6.2_amd64.deb # Linux Debian/Ubuntu │ ├── AICoder_3.6.2_amd64.deb.sig # Linux DEB 签名 │ ├── AICoder_3.6.2_amd64.AppImage # Linux 通用（也是 updater 产物） │ └── AICoder_3.6.2_amd64.AppImage.sig # Linux updater 签名 ├── v3.6.1/ # 侧边栏多选删除 + chevron 一致 + 模型选择尊重 + 自定义端点文案 │ ├── AICoder_3.6.1_x64-setup.exe # Windows 安装包 │ ├── AICoder_3.6.1_x64-setup.exe.sig # Windows updater 签名 │ ├── AICoder_3.6.1_aarch64.dmg # macOS Apple Silicon │ ├── AICoder_aarch64.app.tar.gz # macOS ARM updater 产物 │ ├── AICoder_aarch64.app.tar.gz.sig # macOS ARM updater 签名 │ ├── AICoder_3.6.1_x64.dmg # macOS Intel │ ├── AICoder_x64.app.tar.gz # macOS Intel updater 产物 │ ├── AICoder_x64.app.tar.gz.sig # macOS Intel updater 签名 │ ├── AICoder_3.6.1_amd64.deb # Linux Debian/Ubuntu │ ├── AICoder_3.6.1_amd64.deb.sig # Linux DEB 签名 │ ├── AICoder_3.6.1_amd64.AppImage # Linux 通用（也是 updater 产物） │ └── AICoder_3.6.1_amd64.AppImage.sig # Linux updater 签名 └── v3.6.0/ # 合规里程碑版本 - 第三方独立客户端定位 + 首启免责协议 ├── AICoder_3.6.0_x64-setup.exe # Windows 安装包 ├── AICoder_3.6.0_x64-setup.exe.sig # Windows updater 签名 ├── AICoder_3.6.0_aarch64.dmg # macOS Apple Silicon ├── AICoder_aarch64.app.tar.gz # macOS ARM updater 产物 ├── AICoder_aarch64.app.tar.gz.sig # macOS ARM updater 签名 ├── AICoder_3.6.0_x64.dmg # macOS Intel ├── AICoder_x64.app.tar.gz # macOS Intel updater 产物 ├── AICoder_x64.app.tar.gz.sig # macOS Intel updater 签名 ├── AICoder_3.6.0_amd64.deb # Linux Debian/Ubuntu ├── AICoder_3.6.0_amd64.deb.sig # Linux DEB 签名 ├── AICoder_3.6.0_amd64.AppImage # Linux 通用（也是 updater 产物） └── AICoder_3.6.0_amd64.AppImage.sig # Linux updater 签名 ``` ## 发布新版本流程 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.