v0.9.0 — 写新邮件 (compose new)

✨ 写新邮件 (compose new)

• 侧边栏 accent「写邮件」主按钮（收起态纯 icon）+ 全局 ⌘N
• 居中模态撰写器：glass-pop 磨砂材质 + 进退场动效（useExitAnimation），复用 Outlook 式表单（From / To / Cc·Bcc / 主题+重要性 / 签名 / 格式工具栏）
• 后端 mode='new' 写线：无源邮件、零线程派生（service / HTTP / IPC 适配器放宽哨兵 id）

🛠 修复 & 打磨

• 正文 placeholder / 格式按钮高亮响应式（TipTap v3 useEditorState）
• compose 重做对齐 Outlook + 草稿点开即编辑 + 签名 / 重要性
• 草稿保存后正文秒开（mirror 直写 email_body）
• 发件箱切号后 Sent 同步冻结修复（增量游标按 UIDNEXT 钳制）

—— 经 codex gpt-5.5 三轮 review + 真机 dogfood 迭代。

v0.8.4 — KOS Settings 配置 + 字形流光 shimmer

v0.8.4

🧠 KOS 知识大脑

• 新增 Settings 配置区（设置 → 集成 → 知识大脑 KOS）：启用开关 + 服务地址 + OAuth 凭据（脱敏）+ 高级选项，含用途说明与 gbrain 部署指引。
• chat 工具注入收紧：仅在「启用 AND 凭据齐全（已对接）」时注入 KOS 工具，避免开关开着却没对接时注册必然失败的工具。
• 修复 serve-api 配置 stale（改 .env 即时生效，无需重启）。

✨ 思考态动效

• AI 思考多段文案轮播 + 字形流光（高光扫过文字笔画，不再是矩形背景）。
• 重写 shimmer 为纯 CSS 双层 transform，绕过 Electron GPU 合成对 bg-clip-text 的纹理缓存（真机可靠）；统一 chat / 报告 / 邮件详情所有「进行中」文字。

经 opus 4.8 独立 review（APPROVE WITH NITS，已修）+ 真机验收。

v0.8.0

v0.8.0

新特性

• feat(search): Gmail 风格搜索 DSL —— from: / to: / subject: / after: / since: / has: / is: / -否定 / OR，命令面板搜索语法图例 + 收件人 Outlook 式自动补全 (#28)
• feat(translate): 沉浸式翻译 v2 —— run 划分提取/注入重写 + sonnet-4.6 + Path A 缓存升级 + 纯文本邮件打通 (#26)
• feat(motion): transitions.dev review —— shimmer 推广 + icon-swap 原语 + overlay 补缺 + 动效 token 收口 (#27)

修复 / 优化（dogfood round）

• fix(agents): 报告 agent 配置抽屉模型下拉被磨砂抽屉遮挡点不开（SelectContent 抬到 z-[70]）
• fix(chat): 思考态恢复 loading spinner（对齐 ReportsTab）+ 模型双层记忆（切回会话恢复当时模型 + 用户默认模型持久化）
• fix(compose): 邮件回复面板上同款 modal 入场动效（scale + fade + slide）
• fix(theme): 界面材质选择去 droplet/square 图标，统一用 mini swatch（含默认回显）

KOS

• feat(kos): bulk ingest 加 --priority-floor 过滤（排除低优先噪音）

装机

退出旧 app → 单次 ditto（等它跑完）→ 再 open，三步串行单线（避免 torn bundle / dyld libffmpeg 崩溃）。

v0.7.2 — 草稿删除秒刷 + 深色适配 + chat 修复 + UI 统一

dogfood round 3 全修复 + UI 统一

修复

• 草稿删除秒刷：delete_draft 本地删 + SSE 先行（UI <1s 移除行），IMAP 慢链后置 + 连点幂等
• 深色正文适配：邮件自带黑字/底色保色相亮度翻转（HSL 只翻 L，蓝仍是蓝；亮背景移除露主题底）
• chat 加载卡死（双根因）：① /chat/config 背后 Notion context 加载限时 8s + 子页并行；② folder_discover 同步 IMAP 调用冻结 serve-api event loop → 包 to_thread
• 看板 Token 状态：DAVMAIL_ROOT 配置化（打包态路径修复，恢复有效期显示）
• 报告卡转圈：进程中途被杀的 generating 孤儿行自动回收 → failed 可重试
• 日报摘要换行：overview 段去独立限宽，与同卡片块对齐

UI

• 统一 SegmentedControl 组件：会话历史 / chat 切换 / 报告类型四处统一半透胶囊 + 滑动指示器（亮暗无硬底）
• 输入类控件深色材质：设置页输入框 / 下拉 / 搜索框深色实底 → 半透墨色，融入磨砂玻璃
• toolbar active 跟主题 accent / chat picker 选中态可读

安装

退出旧 app → 用 dmg 或解压 zip 替换 /Applications/MailAgent.app → 打开。userData 跨重装保留，跳过 onboarding。

v0.6.4 — 稳定性修复

修复

• App 退出杀净 Python 子进程：before-quit fire-and-forget 断开 SIGKILL 链导致后端孤儿进程残留，补三层防御；serve-api 异常退出自动拉起
• 内存水位自愈：后端内存超水位自动重启 + dump 留证（针对 17GB 内存泄漏事件的防护网）
• 繁体/智能标点乱码：邮件声明 gb2312 实际为 GBK 字节时按 charset 超集解码，修复正文/主题乱码
• caldav 3.x 兼容：ctag 取法适配 caldav 3.x API + 同步失败告警降频 + DAVClient 超时
• fire-and-forget asyncio task 防 GC：持引用防任务中途被垃圾回收；cipher_key POC 警告降频
• CLI backfill body 尊重 MAILAGENT_BACKEND：davmail 模式下可用

---

🤖 Generated with Claude Code

v0.6.3 — 动态模型列表

亮点

• 动态模型列表：设置 → AI 从上游网关拉取全量模型（缓存 + 手动刷新），下拉多选勾选启用集（写 LLM_ENABLED_MODELS，热读即时生效）；chat 模型 picker / 报告 Agent / 邮件 AI 主·备模型三处统一消费启用集，未配置时回退默认四模型
• 翻译模型独立 provider：LLM_TRANSLATE_MODEL 改单选下拉，从翻译自己的 provider（LLM_TRANSLATE_BASE_URL）拉取列表，未配置回退主网关
• claude-fable-5 支持：custom AI chat 与日/周/月报 Agent 模型可选 fable-5（1M 上下文 / 64k 输出）
• 主/备模型、Agent 模型选择均改为下拉单选

修复

• 远程访问 "email not allowed"：L2 鉴权扩展为多邮箱白名单（MAILAGENT_API_ALLOWED_EMAIL，邮箱后缀切换场景）
• Select 收起态回显长模型名出现假缩进（button 默认居中 + line-clamp 撑宽盒，组件层 text-left 根治）
• 设置各 tab 页头副标题不随语言切换（26 个 i18n key 双语补齐）
• compose 回复/转发原文引用默认收起；chat tab 与会话历史标题字号微调

---

🤖 Generated with Claude Code

MailAgent v0.5.0 — 多文件夹同步

多文件夹同步（Multi-Folder Sync）

自定义 Exchange 文件夹（Jira / Notion / 中文名文件夹）现可勾选并入邮件主链路，与收件箱享受完全等同的能力：

• 配置入口：设置 → 同步 → 自定义文件夹同步，树形勾选要同步的文件夹（支持嵌套、中文名、首次同步窗口/单文件夹上限可调）
• Sidebar 树形导航：勾选的文件夹出现在 MAILBOXES 区（树形 + 计数 + 折叠态 tooltip），点击过滤邮件列表
• 完整能力：AI 分类、Notion 同步、全文搜索、线程折叠、标旗/归档/移动/回复全部可用
• 文件夹管理：树行 ⋯ 菜单支持新建子文件夹 / 重命名 / 删除（直达 Exchange，系统文件夹受保护）
• 通知降噪：自定义文件夹默认不推送通知（可白名单开启）；LLM 分类默认开启（可黑名单关闭）
• Onboarding：新用户向导新增文件夹勾选步（可跳过）
• 中文/特殊字符文件夹名（modified-UTF7）全链路支持；未勾选任何文件夹时行为与之前版本完全一致

同时带入（0.4.x 波次合入）

• 第三波 Chat 体验：Thinking 流式块、工具调用 Cowork 时间线、授权卡片改造
• 设置页 /api/env 解析与 i18n 修复、landing page

修复

• caldav 3.2.1 依赖漂移导致打包缺 vobject（日历同步 ImportError）
• 中文文件夹 IMAP SELECT 编码错误（正文拉取/标记回写失败）
• serve-api 白名单读取不随保存更新（设置勾选状态丢失）
• 设置页文件夹扫描结果缓存（重进秒开，手动刷新才重扫）

安装：下载 dmg 安装，或解压 zip 后拖入 Applications。arm64 (Apple Silicon) only。

MailAgent v0.2.3

MailAgent v0.2.3 · macOS (Apple Silicon / arm64)

本版本为 ad-hoc 签名（无 Apple Developer ID）。首次安装需手动解除一次 Gatekeeper（见「安装」第 2 步）。

✨ 自 v0.2.0 以来的更新

📊 报告 Agent 系统（全新）

• 日报 / 周报 / 月报三个独立 agent，各自可配触发模式、时区、提示词。
• 日报 agentic：喂邮件摘要 + 重要邮件预载正文，AI 按需下钻任意邮件正文 / 附件 / 知识库（Gbrain），产出结构化报告。
• 周报综合自然周日报、月报综合自然月周报（层级聚合）。
• 报告纳入邮件状态（flag / 置顶 / 已回复，从发件箱推导已回复）。

⚙️ Agents 配置体验

• 配置面板固定不随列表滚动、打开时锁背景；卡片保持自然高度。
• 配置时预填默认提示词全文，可编辑覆写。

🐛 关键修复

• 修复升级后首次启动很慢 / 邮件列表空白：启动就绪门控的 DB 版本判据滞后，导致等满 120s 才降级开窗。已修正 + 加跨语言一致性测试防回归。

📦 安装

1. 下载 mailagent-frontend-0.2.3-arm64.dmg → 打开 → 拖 MailAgent 到「应用程序」。
2. 首次打开（ad-hoc 必做一次）：右键 MailAgent.app → 打开 → 再点「打开」。或终端：xattr -dr com.apple.quarantine /Applications/MailAgent.app
3. 旧版升级：直接覆盖安装；userData 保留、自动迁移数据库、跳过 onboarding。

⚠️ 已知

• ad-hoc 签名 → 应用内自动更新装不上，需手动下载覆盖。

MailAgent v0.2.0

MailAgent v0.2.0 · macOS (Apple Silicon / arm64)

本版本为 ad-hoc 签名（无 Apple Developer ID）。首次安装需手动解除一次 Gatekeeper，见「安装」第 2 步。

✨ 本次更新

• 回复 / 转发引用原文重构：AI 建议与历史邮件引用分离 —— 大邮件秒开、引用格式不再错乱；发送时仍完整带上原文引用 + 线程头（标准邮件答复，对方能看到完整历史）。
• 回复建议渲染修复：签名（──── / Best, / …）、无 URL 占位链接、多余换行。
• 引用原文默认展开 + 折叠样式对齐整体设计。
• 更新检查：检测到新版本时弹出提示 → 一键跳转本发布页下载 → 手动覆盖安装。

📦 安装（首次）

1. 下载 mailagent-frontend-0.2.0-arm64.dmg，打开，拖 MailAgent 到「应用程序」。
2. 首次打开（ad-hoc 必做一次）：右键 MailAgent.app → 打开 → 弹窗再点「打开」。
   若提示「已损坏，无法打开」，终端执行后再双击：

   xattr -dr com.apple.quarantine /Applications/MailAgent.app

3. 首次启动按引导填写 Notion / 邮箱配置。

🔄 升级（覆盖安装）

退出旧版 → 新版替换 /Applications/MailAgent.app（拖拽覆盖，或 ditto <new>.app /Applications/）→ 打开。配置 / 数据保留，跳过 onboarding。

---

ℹ️ 应用内「一键自动更新」需 Apple Developer ID 签名 + 公证（暂未接入）；当前为「检查更新 → 跳转下载页 → 手动覆盖安装」模式。Intel (x64) 暂未提供，需 Apple Silicon。