TRAE FLOW v1.2.1

TRAE FLOW 1.2.1

TRAE FLOW 1.2.1 发布。本次更新为内置演示页新增「在 TRAE CN 中编辑」入口，并优化首次展开尺寸，让自定义功能的创建与迭代更顺畅。

新功能

• traeFlowOpenInTrae JS Bridge：自定义 HTML 区域新增「在 TRAE 中打开编辑」消息通道。HTML 端通过 window.webkit.messageHandlers.traeFlowOpenInTrae.postMessage({ variant: "trae-cn" }) 触发，应用以当前区域目录为工作区在指定 TRAE 变体（默认 TRAE CN，支持 tra-e / trae-cn / trae-work / trae-work-cn）中打开，便于用户直接编辑 HTML 源文件。仅 .localArea 源有效，网络拦截脚本已放行该通道
• 演示页编辑入口卡片：内置「TRAE Flow 自定义功能演示」页 Hero 上方新增紫色渐变 CTA 卡片「想要快速实现自定义功能？去 TRAE 编辑」，点击调用 traeFlowOpenInTrae Bridge 在 TRAE CN 中打开演示页目录，引导用户直接修改 HTML 源文件
• 演示页默认展开尺寸：演示页内容较多（Hero + CTA + 三个区块），首次展开默认尺寸从全局回退值调整为 720×850，保证首次打开即可完整呈现，避免内容被裁剪需要手动拖拽。已手动调整过尺寸的用户不受影响（通过 backfillExpandedSizeIfNil 仅回填 nil 值）

说明

• TRAE FLOW 1.2.1 继续围绕自定义区域体验迭代
• 感谢用户的持续反馈

Built (ad-hoc signed) on GitHub Actions. Not notarized by Apple.

TRAE FLOW v1.2

TRAE FLOW 1.2

TRAE FLOW 1.2 正式版本发布。本次更新修复了全局快捷键注册与语言切换显示两项关键问题，并调整了默认配置以提升开箱体验。

修复

• 全局快捷键注册不生效：@Published 在 willSet 时刻发送事件，此时 wrappedValue 尚未更新，导致 refreshRegistrations 读到旧值，录制 / 复原快捷键均不生效。为 openActiveSessionShortcut / openSessionListShortcut / leftFeatureQuickExpandShortcut 三个订阅链路添加 .receive(on: RunLoop.main)，将 sink 调度到下一 runloop tick，确保读取到落地后的新值
• 语言切换中英混杂：设置页「检查更新」区域的文字通过 AppLocalization.string 本地化，在应用 / 系统语言切换时会出现中英混杂显示。更新区域文字统一固定为中文，避免本地化查找导致显示异常

变更

• 鼠标离开自动收起 Flow 岛（autoCollapseOnLeave）默认值从「开启」改为「关闭」，避免鼠标偶然离开触发区即收起面板，影响连续操作体验

说明

• TRAE FLOW 1.2 继续围绕稳定性和细节体验迭代
• 感谢用户的持续反馈

Built (ad-hoc signed) on GitHub Actions. Not notarized by Apple.

TRAE FLOW v1.1

TRAE FLOW 1.1

TRAE FLOW 1.1 正式版本发布。本次更新聚焦于自定义 HTML 区域视觉体验打磨，让用户嵌入的网页内容与 Flow 岛深色主题更协调。

新功能

• 自定义区域深色滚动条：为本地自定义 HTML 区域注入深色半透明滚动条样式（color-scheme: dark + 8px 宽度 + rgba(255,255,255,0.22) thumb），避免 WebKit 默认浅色系统滚动条与 Flow 岛深色主题不协调。仅对 .localArea 生效，不影响 .remoteURL / .mineradio 等远程内容

说明

• TRAE FLOW 1.1 继续围绕稳定性和细节体验迭代
• 感谢用户的持续反馈

Built (ad-hoc signed) on GitHub Actions. Not notarized by Apple.

TRAE FLOW v1.0

TRAE FLOW 1.0

经过多个 beta 版本迭代，TRAE FLOW 迎来首个正式发布版本。本次更新聚焦于交互体验打磨与多项关键问题修复，为日常编码陪伴场景提供稳定可靠的基础。

新功能

• Dock 图标显示开关：新增「在 Dock 中显示图标」设置项（设置 → 通用）。关闭后应用切换为 accessory 策略，仅在菜单栏运行，不再出现在 Dock 中；开启时恢复为 regular 策略。测试构建不受影响
• 用户主动展开突破全屏隐藏限制：通过快捷键或点击触发的展开（openReason == .click）在全屏应用下不再被强制收起，让用户在全屏 IDE / 浏览器中也能随时呼出 Flow 岛查看任务或使用左侧功能。被动展开（hover / notification / boot）仍受全屏隐藏抑制，避免误触

修复

• 修复宠物已分离到桌面时 docked Flow 岛无法点击展开的问题：mouseDown 进入拖拽分离跟踪后，mouseUp 的 detached guard 拦截了短按展开逻辑。现在仅 docked 状态下触发拖拽分离手势，分离态下点击直接展开面板
• 修复宠物拖拽分离手势进行中误切换到中转站的问题：拖拽期间不再响应文件拖拽 hover，避免 dragPasteboard 残留 URL 导致误切换

说明

• TRAE FLOW 1.0 标志着产品进入正式发布阶段，后续将围绕稳定性与功能完善持续迭代
• 感谢所有 beta 版本用户的反馈与支持

Built (ad-hoc signed) on GitHub Actions. Not notarized by Apple.

TRAE FLOW v0.3.3

TRAE FLOW 0.3.3

修复

• 修复 Flow 岛窗口被菜单栏图标隐藏类应用（iBar / Bartender / Ice 等）遮罩窗口拦截点击的问题：窗口层级从 .mainMenu + 3 提升到 .popUpMenu + 50（rawValue 151），盖过 menu bar hider 的 overlay，同时仍低于 .screenSaver 不影响锁屏
• 修复同一 cwd 下不同 TRAE 变体并发会话被 SessionStore 误合并的问题（Spec: dual-variant-concurrent-session-key）：
  • HookPayloadMapper 在 hook 未传 session_id 回退到 cwd 时，拼入 __CFBundleIdentifier 解析出的变体标识，sessionId 变为 provider:variant:cwd，避免四个变体在同一目录下生成相同 key
  • SessionStore.appendSession 去重逻辑增加变体判断：仅当两会话解析到同一变体（或都无法解析）时才清理旧会话，不同变体的并发会话不再互相清除
• 修复自定义 HTML 区域未开启「允许请求外部接口」时 fetch / XMLHttpRequest / navigator.sendBeacon 仍可发起网络请求的问题：注入 networkBlockScript（atDocumentStart）从 JS 层源头拦截，仅放行 file: / trae-flow-local: 本地资源与 JS Bridge 消息通道

变更

• 鼠标悬停自动展开 Flow 岛默认值从「开启」改为「关闭」，避免鼠标路过触发区误触展开；用户仍可在设置中开启
• 演示页区块 2 升级：GitHub API JSON 改为随机猫咪图片，并增加多源 fallback 链（The Cat API → Cat as a Service → The Dog API 兜底）+ 图片代理 fallback（images.weserv.nl，保证国内网络可用）；3 源 × 2 加载方式共 6 种尝试
• 演示页 HTML 模板版本化（defaultDemoHTMLVersion）：模板升级时老用户启动会自动覆盖刷新 trae-flow-demo/index.html（用户已删除则不重建）
• 体验用例文档文案调整：移除「鼠标悬浮」相关描述，统一为「点击展开」

说明

• 本次为 0.3.x 系列的 patch 版本，修复窗口层级、多变体并发会话、自定义区域网络权限三项关键问题，并升级演示页图片加载能力

Built (ad-hoc signed) on GitHub Actions. Not notarized by Apple.

TRAE FLOW v0.3.2

TRAE FLOW 0.3.2

修复

• 修复自定义 HTML 区域图标未同步到 LeftFeature.customIconName 的 bug：创建 / 编辑 / 启动迁移三个路径都会同步 CustomArea.iconName，使 FeatureIconView(feature:) 能正确渲染文字 / 图片图标，不再回退到默认 globe SF Symbol
  • CustomAreaStore.addArea / addAreaWithAutoGeneratedDirectory / addTestHTMLArea 联动调用 appendCustomAreaFeature 时传入 iconName
  • SettingsWindowView 编辑保存回调调用 setCustomIconName 同步图标
  • 新增 LeftFeatureStore.syncCustomAreaIconNames，启动时幂等补齐老数据（仅填充 nil，不覆盖已设置图标）

变更

• 默认 Flow 岛宽度从 320 调整为 380，紧凑态展示更多信息
• 新增「TRAE Flow 体验用例」文档（docs/experience-cases/），覆盖 Hook 安装、双变体任务、自定义功能、桌面宠物 detach、中转站、网页嵌入、音乐控制等场景的图文演示
• 体验用例文档侧边栏目录滚动优化：增加边缘容差与节流，避免 sticky + 浮点在边界附近反复触发滚动抖动

说明

• 本次为 0.3.x 系列的 patch 版本，修复自定义区域图标显示问题并补充体验用例文档

Built (ad-hoc signed) on GitHub Actions. Not notarized by Apple.

TRAE FLOW v0.3.1

TRAE FLOW 0.3.1

修复

• 修复左侧功能切换栏拖拽排序失效问题：Button 包装会消费 mouseDown 事件导致 .onDrag 几乎无法识别拖拽手势，改用普通 View + .onTapGesture 处理点击，让 .onDrag / .onDrop 能正常接管鼠标拖拽
• 紧凑态音乐功能从「仅图标」恢复为渲染 MusicCompactView（18pt 封面 + 截断标题），与文档描述一致

变更

• 文案统一：将「精灵表」调整为「宠物表」（README、宠物设置页提示词模板）
• AGENTS.md 同步紧凑态音乐渲染说明

说明

• 本次为 0.3.x 系列的 patch 版本，聚焦修复 v0.3 引入的拖拽回归与紧凑态音乐显示问题

Built (ad-hoc signed) on GitHub Actions. Not notarized by Apple.

TRAE FLOW v0.3

TRAE FLOW 0.3

亮点

• 新增 traeFlowCollapse JS Bridge：自定义 HTML 区域可通过 window.webkit.messageHandlers.traeFlowCollapse.postMessage({}) 主动收起 Flow 岛展开面板，配合提示推送可实现「推送后自动收起」的流畅交互
• 内置「TRAE Flow 自定义功能演示」重新设计：三区块结构 + 喝水提醒（集成 Flow 岛推送 + 可设定时提醒）

变更

• CustomAreaWebView 注册 traeFlowCollapse message handler，Coordinator 转发为 traeFlowCollapseLeftExpanded 通知
• NotchView 监听收起通知，新增 collapseLeftExpandedPanel()，仅对 docked 展开态的 customExpanded 生效，不影响分离态
• 演示页 HTML 重构：原四区块（提示 / 接口 / 计数器 / 监控）合并为三区块（喝水提醒 / 接口 / 监控）
  • 喝水提醒卡片集成 Flow 岛推送：「喝一杯水 +1」计数（localStorage 持久化）、「发送提醒」测试按钮推送「已喝水 N 杯」并自动收起展开面板、「启动定时」按 1–240 分钟间隔自动推送喝水提醒
  • 定时器不收起面板，保持 WebView 存活使定时器持续
• ReleaseNotesWindowView 版本号显示加 fixedSize 防止截断
• .gitignore 新增 default.profraw / *.profraw 忽略 LLVM profiling 输出
• README 删除一段重复描述

说明

• 本次发版标志着 0.3.x 系列开始：重点强化自定义 HTML 区域与 Flow 岛的交互能力，JS Bridge 从单向提示扩展为双向联动（推送 + 收起）
• 喝水提醒演示页是「自定义 HTML 区域 + JS Bridge」的最佳实践示例，可作为用户开发自己功能区的参考

Built (ad-hoc signed) on GitHub Actions. Not notarized by Apple.

TRAE FLOW v0.2.4

TRAE FLOW 0.2.4

亮点

• 新增内置「AI 热搜」功能：默认启用并排在第一位，开箱即用，无需任何配置即可在灵动岛查看 AI 领域热点
• 左侧功能开箱即用策略：音乐、中转站默认启用，配合 AI 热搜组成默认功能区，新用户安装后立刻有可玩内容
• 首次启动自动安装 TRAE Hooks：不再延后到首次欢迎向导，安装后即可接收 TRAE IDE 事件
• 「TRAE Flow 自定义功能演示」预设改为默认启用，展示 JS Bridge 四区块交互能力

变更

• LeftFeatureStore 新增 aihot 内置功能（webURL 指向 aihot.virxact.com），默认 sortOrder=0 启用
• 内置功能 sortOrder 重排：AI 热搜(0) / 音乐(1) / 中转站(2) / NewsNow(trailingBase) / Mineradio(trailingBase+1)
• 新增「末尾内置功能」机制：NewsNow / Mineradio 始终排在用户自定义功能之后，sortOrder ≥ 1000
• CustomAreaStore 演示预设重命名为「TRAE Flow 自定义功能演示」并改为默认启用
• HookInstaller 首次启动改为直接执行 performFirstRunDefaultInstall()，移除已废弃的 onboarding pending 标记
• 默认展开面板宽度从 500 调整为 630
• README 更新：Hooks 启用提示截图、三条主线文案优化、变体配置表格排版修正

说明

• 本次发版重点优化开箱即用体验：新用户安装后默认有 AI 热搜 + 音乐 + 中转站 + 演示四个可用功能，且 TRAE Hooks 自动安装无需手动配置

Built (ad-hoc signed) on GitHub Actions. Not notarized by Apple.

TRAE FLOW v0.2.3

TRAE FLOW 0.2.3

亮点

• 自定义功能「在 TRAE 中打开」改为变体选择菜单：从原来固定使用 TRAE CN 升级为列出全部四个 TRAE 变体（TRAE / TRAE CN / TRAE WORK / TRAE WORK CN），用户可自由选择任一变体打开工作区

变更

• TraeVariant 新增 isInstalled 双路检测（标准安装路径 + LaunchServices 回退）与 installedCases 已安装变体列表
• TraeSessionLauncher.openWorkspace 增强：IDE 系列走 URL Scheme 工作区协议；SOLO/WORK 系列改用 NSWorkspace.open([URL], withApplicationAt:) 等价于 open -a 打开目录；最终回退仅激活应用
• 设置页 .customArea 功能行的固定按钮替换为 openInTraeMenu 变体选择 Menu
• CustomArea.defaultVariant 字段保留用于向后兼容，不再被设置 UI 读取
• AGENTS.md 更新 jump-back-to-IDE 与左侧功能说明

说明

• 本次发版让用户可以灵活选择任一已安装的 TRAE 变体打开自定义功能工作区，不再受限于固定变体

Built (ad-hoc signed) on GitHub Actions. Not notarized by Apple.