0.9.5

Proma v0.9.5

推荐所有用户更新

Bug 修复

• Agent Session 无法自动结束（彻底修复） — v0.9.4 的修复未能完全解决该问题；根因是 SDK async iterator 在发出 result 消息后永远不返回 done: true（因消息通道 generator 永不结束，导致 SDK 不关闭子进程 stdin）；修复后在 adapter 层收到 result 时主动关闭消息通道，让 SDK 自然结束子进程，同时在编排层保留 2 秒 drain timeout 作为安全网

下载

• macOS Apple Silicon — Proma-0.9.5-arm64.dmg
• macOS Intel — Proma-0.9.5.dmg
• Windows — Proma-Setup-0.9.5.exe

0.9.3

Proma v0.9.3

Bug 修复

• Fork 会话多轮对话失败 — 修复 fork 后第 2–3 轮对话触发"Session 已失效"错误并不断重试的问题；根因是 SDK forkSession() 在源 cwd 的 project-hash 下创建 JSONL，而 fork 会话的 cwd 对应不同的 project-hash 目录，导致首轮之后 SDK 找不到 session 文件；修复后在创建 fork 时立即将 session JSONL 复制到 fork 自身的 project-hash 目录下，每一轮都能直接 resume

• Quick Task 面板主题不同步 — 修复通过 Option+Space 呼出的 Quick Task 面板在主窗口切换主题后仍显示旧颜色的问题；现在 settings 更新时会广播主题变更事件给所有 BrowserWindow，Quick Task 窗口实时响应

• Windows 图标更换提示 — Windows 用户尝试更换应用图标时现在会看到明确的"不支持"提示，避免操作后无反馈的困惑

稳定性回退

• 回退 Idle Timeout 系列修复 — 回退了 v0.9.2 中引入的 4 项 idle timeout / agent stability 改动（#237、#245、#256、#257），这些修复在部分场景下引发了新的副作用；后续将以更稳妥的方案重新解决 idle timeout 误触发问题

下载

• macOS Apple Silicon — Proma-0.9.3-arm64.dmg
• macOS Intel — Proma-0.9.3.dmg
• Windows — Proma-Setup-0.9.3.exe

0.9.2

Proma v0.9.2

新功能

• 快照回退与 Fork 重构 — 会话时间旅行与原生分叉 — 全面重构快照/回退机制，支持会话时间旅行（回退到任意历史节点并继续）；引入原生 Fork 功能，从任意历史状态分叉出独立会话，彻底告别"操作失误只能重来"的困境（#238）

• 自定义 Logo — 现在可以在设置中更换 Proma 的应用图标，个性化定制你的桌面体验

• Agent 交互 Banner 增加终止按钮 — 所有 Agent 交互确认 Banner（权限申请、工具调用等）新增 Dismiss 按钮，随时可以主动终止当前交互，不再被 Banner 卡住

• 工作区列表支持拖拽调整高度 — 侧边栏工作区列表面板支持拖拽调整高度，灵活分配侧边栏空间（#239）

Bug 修复

Idle Timeout 专项修复（四项）

• 工具执行期间误触发 — 修复长耗时工具（如大文件写入、网络请求）执行期间 idle timeout 错误重试的问题（#256、#257）
• 等待用户交互时误触发 — 修复 AskUserQuestion 等待用户响应期间 idle timeout 误触发的问题（#245）
• Hook 阻塞时间忽略 — idle timeout 计时现在正确忽略 Hook 执行占用的时间，避免因 Hook 耗时导致会话被错误终止（#247）

Agent 稳定性

• Agent 稳定性综合修复 — 0-token 响应检测与重试、idle timeout 初始化清理、Opus thinking budget 正确配置（#237）
• SubAgent 模型继承 — 非 Claude 模型渠道下（如自定义 API 接口），SubAgent 现在自动继承主 Agent 所用模型，而非错误回退到默认（#234）
• 模型标识覆盖 — 修复切换模型后，历史消息上的模型标识被新模型覆盖显示的问题（#233）
• 会话槽位并发写入 — 抢占会话槽位逻辑提前到 await 之前，防止并发场景下重复写入（原本可能导致会话数据冲突）

计划模式

• 只读 Bash 命令 — 计划模式下现在允许执行只读 Bash 命令（如 ls、cat），同时修复关联的动画闪屏问题

快照回退

• 附加目录支持 — 回退时现在从工作区配置正确读取附加目录，修复附加目录文件无法随回退操作恢复的问题
• 并发安全与确认对话框 — 修复快速连续触发回退时的并发竞态问题，同时新增操作确认对话框防止误操作

界面与交互

• StickyUserMessage 定位修复（两项） — 修复 StickyUserMessage 遮挡小地图悬停区域；修复跟踪逻辑始终锚定到最后一条用户消息（而非最近可见的那条）的问题（#246）
• AskUserBanner focus ring — 修复第一个选项显示多余 focus ring 的视觉异常（#251）
• 用户消息「展开全部」 — 修复点击「展开全部」后立即折叠回去的交互 bug
• 助手消息结束跳动感 — 修复 Agent 助手消息流式结束时出现的短暂位移跳动
• 任务卡片宽度 — 移除任务进度卡片的固定宽度限制，宽度自适应布局

构建与打包

• 精简安装包体积 — 移除打包中冗余的 node_modules 和内置 Bun，安装包体积显著缩减（#255）

下载

• macOS Apple Silicon — Proma-0.9.2-arm64.dmg
• macOS Intel — Proma-0.9.2.dmg
• Windows — Proma-Setup-0.9.2.exe

0.9.1

Proma v0.9.1

新功能

• 内联聚合式任务进度卡片 — Agent 执行多步任务时，进度信息以内联卡片形式聚合展示，清晰呈现各子任务状态，替代此前分散的进度消息（#216）

• 输入交互体验优化 — 澄清 UI 标签文案，新增发送快捷键切换（Enter/⌘Enter），优化换行行为逻辑，让输入操作更符合直觉（#218）

• Agent 会话体验增强 — 新增通知点击导航至对应会话；会话列表增加运行状态指示；重构消息渲染链路提升健壮性和性能

• Tab 栏三色状态指示 — Tab 栏指示点与侧边栏同步蓝（运行中）/ 橙（等待确认）/ 绿（已完成）三色状态，多任务并行时一目了然

• 微信即时确认回复 — 微信收到用户消息后立即发送确认回复，消除「消息发出后无反馈」的等待焦虑

Bug 修复

• Agent 模式闪屏优化 — 消除模式切换时的 opacity 空窗，减少 AppShell 重渲染，视觉过渡更加流畅

• 计划模式修复（两项） — ExitPlanModeBanner 鼠标点击无效，采用 ref 模式消除闭包陈旧状态；ExitPlanMode 后第二轮对话仍提示计划模式，修复 workspaceId/slug 混用问题

• 输入法兼容修复（两项） — AskUserBanner 输入法组合状态下回车选词误触发提交（#223）；键盘 handler 闭包过期导致响应异常

• 工具并发 400 错误 — 通过 toolUseConcurrency: 1 串行化工具调用，防止并发请求触发 API 400 错误

• 社交平台 Workspace 切换路由 — 修复微信/飞书/钉钉 workspace 切换后路由仍指向旧工作区的问题

• Skill 消息气泡渲染 — Skill 展开消息被错误渲染为用户消息气泡，现已正确识别为系统消息（#217）

• Agent/Chat 模式切换器 — 统一两种模式切换器的样式与选项顺序（#219）

• 任务看板名称丢失 — 修复中止任务后继续执行时看板任务名丢失的问题

• Mention 选择残留文字 — 修复 mention 选择后输入框中残留匹配文字的问题

• 无可用模型保护 — 无可用模型时锁住 Agent 输入框，防止用户误发消息

• Chat 模式编辑框宽度 — Chat 模式编辑消息时编辑框占满整行宽度，编辑体验更舒适

• Inline Code 样式修复 — 移除 prose inline code 默认的 backtick 伪元素，添加背景色区分，视觉更清晰

• PR #216 / #218 缺陷修补 — 修复内联任务卡片和输入优化上线后发现的若干细节缺陷

依赖变更

• Claude Agent SDK 从 0.2.96 回退至 0.2.89（对应 Claude Code 稳定版本），修正上版本 SDK 引入的兼容性问题

下载

• macOS Apple Silicon — Proma-0.9.1-arm64.dmg
• macOS Intel — Proma-0.9.1.dmg
• Windows — Proma-Setup-0.9.1.exe

0.9.0

Proma v0.9.0

新功能

Tab 与导航体验升级

• Chrome 风格 Tab 栏 — 全新标签栏设计，支持 hover 时展示迷你地图预览面板，快速浏览对话内容概览
• 迷你地图可拖拽滚动条 — 在迷你地图右侧新增可拖拽的滚动进度条，精准定位长对话中的任意位置
• Tab 切换自动恢复对话 — 切换 Chat/Agent 模式时自动恢复上一次对话窗口，保持工作连续性

多媒体与附件增强

• 图片附件 Lightbox 预览 — 点击图片附件弹出 Quick Look 风格的灯箱预览，支持大图查看
• 拖拽文件夹附加 — 支持直接拖拽文件夹附加到会话或工作区，批量导入更便捷

Agent 功能增强

• 默认使用 Agent 模式 — 新建对话默认进入 Agent 模式，调整模式切换器显示顺序
• 权限审批时保留输入框 — 权限审批弹窗期间输入框保持可用，streaming 中允许追加消息
• 通知提示音与会话导航 — 新增 ding/ding-dong 音效，Agent 任务完成时发出自定义提示音通知

Skill 与工作区

• 跨工作区 Skill 导入 — 支持从其他工作区导入已有 Skill，复用工作流不再需要重复创建
• 用户级设置 — 加载 .proma 文件夹下的用户级别设置，跨工作区复用个人配置

编辑器与输入优化

• macOS 快捷键增强 — 输入框支持 Ctrl+B 加粗和 Ctrl+S 删除线快捷键
• 飞书设置页优化 — 权限详情收起态 + 新增飞书 CLI 配置引导

Bug 修复

• Agent 会话 workspaceId 不同步 — 修复 Agent 会话切换时 workspaceId 不同步导致回填模式异常
• 双 Session 并发竞态 — 修复手动停止后立即继续导致两个 session 同时运行的竞态 bug
• AskUserQuestion 权限模式 — AskUserQuestion 在所有权限模式下均可正常触发交互式 UI
• Agent 搜索失效 — 兼容新 SDK 消息格式，修复内容搜索完全失效的问题
• SubAgent Spinner 终止异常 — 修复用户终止任务后 SubAgent spinner 仍持续转动的问题
• Diff 着色范围限制 — diff 着色仅对 Edit 工具生效，避免命令参数被误染色
• 系统通知声音 — 禁用系统通知声音，避免与自定义提示音重叠
• ImageLightbox 空值处理 — 支持 src 为 null 时的安全渲染
• Minimap 面板误触 — 仅在悬停横杠区域时触发面板，避免滚动条误触
• 输入框代码块主题适配 — 浅色主题使用深色背景，森息夜语主题加深区分度
• 输入框 Mention 草稿丢失 — 修复 IME 回车误触发、拖拽排序异常
• 历史消息加载动画 — 取消历史消息加载时工具块的入场动画
• 模型名称显示 — Agent 模式统一使用用户选择的 modelId 显示
• Suggestion Chip 恢复 — 修复 Agent suggestion chip UI 不显示的问题
• Session 终止进程清理 — 终止会话时正确调用 query.close() 确保 CLI 子进程被 kill
• 文件浏览器过滤 — 过滤 .DS_Store 文件，Mention 空列表时 Enter 不阻塞发送
• SKILL.md 解析 — 修复多行 description 解析失败的问题
• 归档会话交互 — 优化归档会话的交互逻辑
• 品牌素材打包 — 将 proma-logos 加入 extraResources 打包配置
• 飞书 Bot 控制 — 修复停止不生效、button 嵌套警告及 UI 状态不刷新
• 重复会话创建 — 修复切换 Chat/Agent 模式及 HMR 热重载时重复创建会话
• @ 文件引用搜索 — 修复部分文件无法被搜索到的问题
• 后台任务误判 — 修复 local_bash 后台任务被误判为 teammate 触发 auto-resume

架构优化

• ModeSwitcher 逻辑提取 — 提取共享 restoreSession 逻辑，统一 openTab + setAppMode 封装
• Streaming 清理去重 — 提取 finalizeStreamingActivities 消除 spinner 清理逻辑重复
• TypeScript 路径别名 — 添加 @/types/* 路径别名，修复 tsc 类型解析
• SDK Settings 写入优化 — 优化写入逻辑，新增 skipWebFetchPreflight 配置

UI 细节

• Edit 工具行数着色 — 行数统计 +N/-N 使用绿/红着色，直观展示变更量
• 面板按钮对齐 — 微调面板按钮 UI 对齐
• Tab hover 预览优化 — 优化 hover 预览面板的交互体验
• 工作区文件渲染 — 优化渲染逻辑，置顶会话按工作区过滤，Write 工具行数显示

依赖升级

• Claude Agent SDK 从 0.2.89 升级至 0.2.96

下载

• macOS Apple Silicon — Proma-0.9.0-arm64.dmg
• macOS Intel — Proma-0.9.0.dmg
• Windows — Proma-Setup-0.9.0.exe

0.8.1

Proma v0.8.1

新功能

IM 多平台集成

• 微信集成 — 新增微信机器人接入支持，完成 IM 三端（微信/钉钉/飞书）统一架构
• 钉钉多 Bot 支持 — 同时运行多个钉钉机器人，各自独立操作不同 Session
• 飞书多 Bot 支持 — 同时运行多个飞书机器人，各自独立操作不同 Session
• BotHub 统一设置页 — 统一机器人配置入口，集中管理所有 IM 渠道的 Bot 设置

Agent 功能增强

• SubAgent 完成摘要显示 — SubAgent 执行完成后展示 AI 生成的进度摘要
• 思考块 Markdown 渲染 — Agent 思考过程支持 Markdown 渲染与折叠控制
• Agent 中断状态持久化 — 持久化中断状态，中断指示器改为 Footer Badge 显示
• 12 个新工具类型翻译与图标 — 补齐缺失的 Agent 工具类型的国际化翻译和图标
• SubAgent 委派策略升级 — 新增基于任务复杂度的自动模型选择（haiku/sonnet/opus 三级策略）

UI/UX 改进

• 特殊风格主题系统 — 新增海洋/大地/赛博朋克三套特殊风格主题
• 迷你地图搜索导航 — 支持在 Minimap 中搜索定位内容
• Chat 模式工具渲染升级 — 对齐 Agent ContentBlock 渲染风格，统一视觉体验
• 侧边栏对话标题优化 — 默认显示更长标题，hover 时操作按钮才展开
• 界面缩放快捷键提示 — Tips 中新增缩放快捷键说明
• "已被用户中断" Badge 迁移 — 从输入框移至助手消息 Actions Bar，布局更合理

交互优化

• 交互横幅显示时隐藏输入框 — 避免横幅与输入框的视觉冲突
• Plan 模式下允许 AskUserQuestion — 计划模式中支持向用户提问
• Per-session 权限模式 — 权限模式按会话独立配置
• 品牌素材下载 — 新增 14 个 Proma Logo 变体供机器人头像使用

Bug 修复

• 置顶会话重复显示 — 修复置顶会话在日期分组列表中重复出现的问题
• Tab 切换滚动位置 — 修复 Tab 切换时滚动位置无法恢复的问题
• 侧面板折叠按钮 — 侧面板始终显示折叠按钮，移除 hasContent 条件限制
• 附件预览间距 — 增加 ChatInput 中附件预览的间距
• Chat 模式 API 错误处理 — API 报错时保留部分消息并显示错误提示，不再丢失内容
• Minimap 跳转失效 — 修复用户消息点击跳转失效问题，复用渲染 group 对象
• Agent 消息滚动跳动 — 修复对话完成后的滚动跳动问题
• 快速任务窗口阴影 — 移除多余阴影 + 修复 Chat 流式闪屏
• 深色主题颜色 — 深色主题颜色优化与 UI 细节调整
• Agent 权限模式 — 全面修复动态切换、Plan 模式拦截、提示词语义一致性
• Skills 重复注入 — 移除 Skills 列表在 Agent 上下文中的重复注入
• 归档会话标签页 — 归档会话时自动关闭对应的标签页
• 计划模式冗余 Suggestion — 计划模式完成后不再注入"请执行该计划"的多余建议
• compact_boundary 持久化 — 持久化上下文压缩分界线系统消息，保留压缩状态

架构优化

• Bridge Registry 统一管理 — 统一 Bridge 注册与管理机制，Session Recovery 去重
• 文件面板零空间占用 — 收起时不再占据空间，切换按钮迁移至 AgentHeader
• 右侧文件面板独立悬浮岛 — 文件面板改为独立悬浮设计，UI 更简洁
• 用户消息气泡自适应 — 气泡宽度根据文字长度自适应
• Agent 模式初始化优化 — 新建对话立即初始化 .claude 和 .context 目录
• 标题生成提前 — 将标题生成提前至 SDK 初始化完成时触发
• Skill 改进提示词优化 — 支持主动观察多步工作流并建议固化为 Skill

UI 细节

• 输入框字号统一 — 统一字号 + 顶部间距优化 + 虚线边框主题适配
• 停止按钮/输入框 — 样式优化：高度、透明度与主题色调整
• Tab 切换同步 — Tab 切换时同步 Sidebar 状态 + Plan 模式输入框虚线边框
• 滚动位置恢复 — 滚动位置恢复 + UI 样式优化

依赖升级

• Claude Agent SDK 从 0.2.87 升级至 0.2.89

统计数据

• 128 个文件变更，新增 9,062 行代码，删除 1,145 行代码
• 从 v0.8.0 到 v0.8.1 共 44 个提交

下载

• macOS Apple Silicon — Proma-0.8.1-arm64.dmg
• macOS Intel — Proma-0.8.1.dmg
• Windows — Proma-Setup-0.8.1.exe

0.8.0

Proma v0.8.0

🎉 重大更新

全局快捷键系统

• Option+Space 快速任务窗口 — 全局快捷键唤起无边框透明置顶浮窗，支持 Chat/Agent 模式切换、附件粘贴/拖拽；提交后自动创建会话、打开标签页、发送消息并获取 AI 回复
• 9 个应用内快捷键 — ⌘, / ⌘F / ⌘N / ⌘B / ⌘⇧M / ⌘K / ⌘L / ⌘. / ⌘W，集中式注册表替代分散的事件监听器
• 快捷键自定义面板 — 设置页支持录制自定义按键、冲突检测、重置默认值

Skill 版本化管理

• 默认 Skills 自动更新 — 所有默认 Skills 添加 version 字段，升级时自动替换旧版本
• skill-creator 官方最新版 — 替换为 anthropics/skills 官方版本，包含 eval 系统、benchmark、description 优化器、subagent 协作
• 持续改进提示 — 当 skill-creator 启用时，系统提示词自动注入 Skill 改进建议机制

新功能

用户体验优化

• Draft 会话模式 — 空状态下复用完整输入框，发送首条消息后才出现在侧边栏；解决每次打开应用都创建空会话的问题
• 自动归档系统 — 超过 7 天未活跃的对话自动归档，降低对话列表认知负担；归档对话在用户交互后自动恢复为活跃状态；每 24 小时定期检查
• 全局搜索 Dialog — 支持跨所有对话（包括归档）的全局搜索
• 空状态引导重设计 — 个性化时段问候 + 平台感知 Tips + 模式切换 Tab + 自动创建会话

UI/UX 改进

• 设置改为浮窗形态 — 从全屏视图改为 Dialog 浮窗，轻遮罩 + 微缩放动画；顶部 Header 栏显示当前 tab 名称
• 侧边栏用户头像 — 底部展示用户头像+名称+设置图标，折叠时仅显示头像
• 左侧边栏圆角卡片 — 展开/折叠态均采用 rounded-2xl + shadow-xl + 毛玻璃背景，移除左右面板边框
• VS Code 风格文件图标 — 文件列表根据文件名/扩展名/文件夹名自动显示对应图标
• 模型配置改造 — 渠道配置改名为模型配置，编辑模式 auto-save 即时生效；模型列表分区：已启用模型始终置顶

Agent 功能增强

• 会话分叉（Fork） — 支持从指定消息处创建分叉会话，使用延迟 fork 模式在首次发消息时通过 SDK resume + forkSession 创建分叉
• 队列消息（Queue） — Agent 运行中可排队发送消息，通过 SDK streamInput 注入，支持取消和提升优先级，前端乐观更新 + 浮动卡片展示
• Plan 模式指示 — 新增 EnterPlanMode 事件流转，渲染进程展示"Agent 正在规划中"指示条
• 请求恢复机制 — 新增 GET_PENDING_REQUESTS IPC 通道，渲染进程重载后可恢复待处理的权限/AskUser/ExitPlanMode 请求
• 运行时间与 Token 用量持久化 — 持久化每轮 Agent 的 durationMs 和完整 token 用量到 JSONL；DurationBadge 集成到操作栏，悬浮显示 token 明细
• 工具调用结果可读性优化 — 新增语义化短语生成器，按工具类型结构化渲染（Bash 终端风格、Read 语法高亮、Edit diff 视图、Grep 搜索结果等）

Agent 系统提示词增强

• 内置 SubAgent — 预定义 3 个 haiku SubAgent（explorer/researcher/code-reviewer）
• SubAgent 委派策略 — 明确内置子代理使用场景和典型工作流
• 文档输出规范 — 定义 CLAUDE.md / .context/note.md / .context/todo.md 的写入规范
• 两层 .context/ 目录 — 明确会话级与工作区级 .context/ 目录的职责划分和选择策略

Bug 修复

• 会话切换状态隔离 — 全局 agentChannelIdAtom/agentModelIdAtom 改为 per-session Map，切换会话时不再互相污染模型名称；liveMessages 清理加 running 检查，流式期间切回不再丢失工具输出数据
• 附件残留清理 — 修复 Chat 和 Agent 模式下切换会话时，输入框中的图片和附件会显示到新会话的问题
• 文件区域滚动条跳动 — 为会话文件区和工作区文件区分别添加独立滚动容器
• Tooltip 显示问题 — 添加 Portal 让 tooltip 渲染到 body 层级，避免被 overflow 容器裁剪
• 排队消息流程重构 — 延迟排队消息持久化到 turn 边界，修复 JSONL reload 后消息乱序；新增 queued_message_consumed 事件
• 全项目类型检查错误 — 添加缺失的 @tiptap/suggestion 依赖
• SSE 格式兼容 — 兼容 SSE 数据行冒号后无空格的格式，修复 Kimi API 流式输出

架构优化

• 迁移 Agent 到 SDK v2 — claude-agent-adapter 从自定义事件转换改为直接透传 SDKMessage；重写 useGlobalAgentListeners 直接处理 SDKMessage 流；新增 SDKMessageRenderer/ContentBlock 组件渲染原生 SDK 消息
• 关闭 Agent Teams 能力 — 移除 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 环境变量注入，删除 TeamActivityPanel 组件及相关状态（~1000 行）
• 迷你地图适配 — 适配 ScrollMinimap 到 SDK 消息渲染路径，从 Turn 分组提取预览文本

依赖升级

• Claude Agent SDK 从 0.2.76 升级至 0.2.87，包含以下改进：
  • 新增 forkSession() — 支持从指定对话节点分叉出新会话
  • 新增 renameSession() — 支持重命名 SDK 会话文件
  • 新增 getSessionInfo() / tagSession() — 会话元数据查询与打标签
  • SDKSessionInfo 新增 tag 和 createdAt 字段，listSessions 支持 offset 分页
  • 新增 agentProgressSummaries 选项，为子 Agent 定期生成 AI 进度摘要
  • 修复通过 query({mcpServers}) 传入的 MCP Server 无法执行 toggle/reconnect 的问题
  • 修复 options.env 被 ~/.claude/settings.json 覆盖的问题
  • 修复 NodeNext/Bundler 模块解析模式下 import type 失败的问题

文档更新

• 架构文档完善 — 更新 CLAUDE.md 和 README.md，包含 Monorepo 结构、主进程服务层、AI Provider 支持列表、Agent SDK 集成架构、本地存储结构、完整技术栈版本信息
• 教程系统支持 — 教程支持 <video> 标签渲染（rehype-raw + 手动提取）

统计数据

• 145 个文件变更，新增 16,134 行代码，删除 4,873 行代码
• 从 v0.7.3 到 v0.8.0 共 38 个提交

下载

• macOS Apple Silicon — Proma-0.8.0-arm64.dmg
• macOS Intel — Proma-0.8.0.dmg
• Windows — Proma-Setup-0.8.0.exe

0.7.3

Proma v0.7.3

新功能

• Nano Banana 生图工具 — Chat 模式新增内置 Gemini 图像生成工具，支持文生图、参考图编辑、多轮连续修改；生成的图片直接内联显示在对话中，右下角悬浮下载按钮可一键保存；在 Chat 设置页配置 Gemini API Key 后即可启用

• Agent 文件路径识别与预览 — Agent 消息中的行内代码如果是文件路径，会自动渲染为可点击的文件 chip；点击后弹出预览窗口，支持图片、视频、Markdown、JSON、XML、HTML、PDF、DOCX 等格式，不支持的类型自动调用系统默认程序打开；双击文件浏览器中的条目同样可触发预览

• 输入框 Skill / MCP Mention 系统 — Agent 模式输入框支持 / 触发 Skill 列表、# 触发 MCP 工具列表、@ 触发文件引用；选中后在输入框显示带图标的彩色 chip（紫色 Skill / 绿色 MCP / 蓝色文件）；发送后对话历史中同步渲染彩色 badge，同时自动向 Agent 注入 <mentioned_tools> 结构化指令，确保 Agent 主动调用对应工具

• 工作区共享文件目录 — 每个工作区下新增 workspace-files/ 共享目录，该目录下的文件可跨会话被所有 Agent 会话访问；文件浏览器 UI 重新组织为「会话文件」（上方）和「工作区文件」（底部常驻）两个区域，职责分明；工作区级别的附加目录也会自动注入所有该工作区下的会话

• @ 引用文件范围扩展 — Agent 输入框 @ 引用文件时，搜索范围从会话附加目录扩展至工作区级附加目录和工作区共享文件目录，搜索结果上限提升至 20 个，列表高度扩大支持滚动浏览

• Chat 消息一键切换 Agent 模式 — Chat 模式下，助手消息 Action Bar 新增「切换到 Agent 模式」按钮；点击后自动创建 Agent 会话并迁移当前对话历史，切换完成后显示 Toast 通知

• SDK 登录错误友好提示 — 将 SDK 原始错误 "Not logged in · Please run /login" 替换为中文友好提示"请检查是否选择了正确的 Proma 供应渠道和模型"

性能优化

• 长对话渲染性能 — 采用 CSS content-visibility: auto 跳过屏幕外消息的 layout 和 paint 计算；消息列表先以真实高度完成初始布局（无跳动），再延迟启用 containment；预期布局计算量减少 90%+，200+ 条长对话滚动和流式输出明显更流畅

Bug 修复

• 思考计时器 Tab 切换重置 — 修复 Agent / Chat 模式下，流式输出进行中切换 Tab 再切回后，思考计时器从 0s 重新计时的问题；时间戳现已持久化在 Jotai atom 中，切换 Tab 后组件能正确恢复已用时

• Agent 会话重命名时附加目录丢失 — 修复新建 Agent 会话后，先添加附加文件夹再重命名时，附加文件夹丢失的问题；根因是重命名操作未正确保留 workspaceId

• Agent 上下文超限错误处理 — 新增 prompt_too_long 错误码，自动识别 7 种常见上下文超限模式；超限时错误提示下方显示蓝色「压缩上下文」主按钮，「重试」降级为次要按钮；ContextUsageBadge 压缩按钮常驻显示，无需等待 warning 状态

• Agent node 路径降级崩溃 — 修复运行时状态缓存未就绪时，node 路径降级逻辑导致 spawn ENOENT 的问题

• SDK Base URL 隔离 — 修复 SDK base URL 规范化逻辑污染全局配置目录的问题，现已完全隔离

• Agent 高级设置默认折叠 — 高级设置区块现在默认折叠，减少设置页面初始视觉复杂度，点击标题可展开/收起

依赖升级

• Claude Agent SDK 从 0.2.71 升级至 0.2.76，包含以下改进：
  • 新增 forkSession() — 支持从指定对话节点分叉出新会话
  • 新增 renameSession() — 支持重命名 SDK 会话文件
  • 新增 getSessionInfo() / tagSession() — 会话元数据查询与打标签
  • SDKSessionInfo 新增 tag 和 createdAt 字段，listSessions 支持 offset 分页
  • 新增 agentProgressSummaries 选项，为子 Agent 定期生成 AI 进度摘要
  • 修复通过 query({mcpServers}) 传入的 MCP Server 无法执行 toggle/reconnect 的问题
  • 修复 options.env 被 ~/.claude/settings.json 覆盖的问题
  • 修复 NodeNext/Bundler 模块解析模式下 import type 失败的问题

下载

• macOS Apple Silicon — Proma-0.7.3-arm64.dmg
• macOS Intel — Proma-0.7.3.dmg
• Windows — Proma-Setup-0.7.3.exe

0.7.1

Proma v0.7.1

新功能

• 飞书群聊完整支持 — 飞书机器人现已支持在群聊中被 @mention 触发 Agent 任务，同时也支持私聊；Bot 在群聊回复时自动以 Thread（话题）形式回复，避免刷屏打扰其他成员；自动注入最近 20 条群聊历史消息作为 Agent 上下文，帮助 Agent 理解当前对话背景；同时新增内置 MCP 工具 fetch_group_chat_history 供 Agent 主动查询更多历史消息

• 飞书图片/文件接收 — 飞书用户可直接向机器人发送图片（支持 JPEG/PNG/GIF/WebP），图片自动下载并保存到 Agent Session 工作目录，通过 <attached_files> 标签注入 Prompt，Agent 可使用 Read 工具查看和分析图片内容，无需改动现有消息链路。并且以同样的方式支持文件上传，同时还支持飞书内部文档。

• 飞书设置页双 Tab 重构 — 飞书设置页拆分为「Bot 配置」和「绑定管理」两个独立 Tab：Bot 配置集中管理 App ID/Secret、通知路由和权限等基础设置；绑定管理 Tab 提供可视化列表，展示所有群聊/私聊的绑定关系，支持查看当前绑定的工作区和会话、切换工作区、解除绑定等操作

• 群聊回复 @mention — Agent 在群聊回复时自动将 @Name 转换为飞书 <at> 富文本标签，实现真实的 @mention 效果，群成员会收到通知提醒

• 群聊自动权限模式 — 飞书群聊发起的 Agent 会话自动启用 auto 权限模式，无需用户手动确认权限，实现无缝自动化执行

• 教程系统 — 设置面板新增「教程」标签页，可随时访问内置 Markdown 教程文档；首次启动 Onboarding 页面新增教程入口卡片和 Sheet 弹窗预览；完成 Onboarding 时自动创建包含教程附件的欢迎对话，引导新用户快速上手

Bug 修复

• 飞书 App Secret 回显 — 加载飞书配置时并行获取并回显已保存的 App Secret（密文显示），用户点击眼睛图标可查看明文，避免反复粘贴

• 飞书默认工作区设置生效 — 修复在飞书设置页保存默认工作区后不生效的问题；启动失败时现在会抛出明确错误而非静默返回

• @mention ID 解析 — 修复 isBotMentioned 检测逻辑中 mention.id 为对象而非字符串时的判断失败问题，以及 bot info API 响应路径错误（bot 在顶层而非 data 字段下）

• 流式会话模型图标 — 新增 model_resolved 事件，确保无论手动发起还是飞书触发的会话，模型图标都能立即正确显示

• Agent 工作区迁移 — 修复迁移时因目标目录已存在导致的 ENOTEMPTY/EEXIST 错误；迁移成功后显示 Toast 引导用户切换工作区；IPC handler 添加 500ms 延迟重试，处理 UI/主进程 active 状态不同步；buildContextPrompt 新增工具活动摘要，减少迁移后的"失忆"感

依赖升级

• Claude Agent SDK 从 0.2.66 升级至 0.2.71（对应 Claude Code 2.1.71），包含以下改进：
  • 修复长会话 stdin 冻结问题，提升长时间运行稳定性
  • 修复启动时 5–8 秒冻结（语音模式 CoreAudio 初始化阻塞主线程）
  • 修复 fork 对话共享 plan 文件导致覆写的问题
  • 修复大尺寸图片导致长会话崩溃的问题
  • 修复第三方网关使用 ANTHROPIC_BASE_URL 时出现 400 错误
  • 减少约 74% 的 UI 渲染次数，性能显著提升
  • 修复长会话内存泄漏（消息积累、Hook 事件、JSON 解析）
  • 修复 Windows/WSL 非 ASCII 文本（中文、Emoji）剪贴板乱码
  • 扩展 Bash 工具自动放行命令列表，新增 fmt、comm、cmp、seq、expr 等

下载

• macOS Apple Silicon — Proma-0.7.1-arm64.dmg
• macOS Intel — Proma-0.7.1.dmg
• Windows — Proma-Setup-0.7.1.exe

0.7.0

Proma v0.7.0

新功能

• 飞书 IM 集成 — 通过飞书机器人远程控制 Proma Agent，支持 WebSocket 长连接接收消息；内置命令路由（/new /list /switch /workspace /stop /help），Agent 可无头运行并将执行状态同步到桌面端 UI；消息格式化为飞书交互卡片，工作区分组展示，序号快速切换；配置支持 App ID/Secret（safeStorage 加密存储）+ 三模式通知路由（auto/always/off）+ 用户在场检测，在设置页提供完整引导
• @ 引用文件（感谢贡献者 @kylin）— Agent 输入框支持 @ 触发文件快速引用，输入后异步搜索工作区及所有附加目录，弹出浮动下拉列表，支持键盘导航（↑/↓/Enter/Escape）和鼠标点击选择；用户消息中 @file:路径 渲染为样式化 chip 标签，悬停展示完整路径
• 附加目录树增强 — 附加目录支持递归展开，单击单选/Ctrl+点击多选；三点菜单新增重命名（内联输入框）、移动到文件夹（系统对话框）操作；工作区文件树同步支持右键三点菜单（重命名、移动、删除）

Bug 修复

• Agent 文件树刷新 — 修复已展开文件夹内文件发生变动后不自动刷新的问题；新增 refreshVersion 机制，workspace-watcher 扩展附加目录的 attach/detach 生命周期管理，保证文件树实时同步

下载

• macOS Apple Silicon — Proma-0.7.0-arm64.dmg
• macOS Intel — Proma-0.7.0.dmg
• Windows — Proma-Setup-0.7.0.exe