Proma v0.12.26

对比基准:v0.12.23

这一版以交互细节打磨为主线:新增第 7 个特殊主题「旧屏微光」(CRT 终端风),把 Skills / MCP 管理升级为独立的「Agent 技能」全屏视图,并顺手减弱了深色主题过重的卡片阴影。稳定性方面清理了一批此前遗留的体验毛刺——左侧栏按钮 tooltip 闪现、Agent worktree diff 面板、GLM-5.2 等兼容渠道的上下文指示器、切换渠道后的模型残留等。

新功能

• 「旧屏微光」CRT 终端主题 — 第 7 个特殊风格主题,暖磷光配色(约 90° 暖黄绿 hue、低饱和收敛)叠加 CRT 视觉特效:全屏扫描线 + 暗角 + 亮度脉冲、侧边栏 3.3px 辉光、全局直角化(--radius: 2px)、等宽字体 + 终端 $ 提示符 + 闪烁光标 + 机械滚动条,消息去气泡化并配 Paul Klee 预览图。已对光敏感用户做 prefers-reduced-motion 降级(辉光与暗角一并关闭),并把 CRT 叠层 z-index 从 9999 降到 100,避免与 Radix portal 同层、遮挡弹窗文字对比。输入框最终移除 $ 提示符回归现代多行 chat 习惯,THEME_STYLES 也抽为单一常量数组、新增主题只需改一处
• 「Agent 技能」全屏视图 — 把原 AgentSettings 里的 Skills 与 MCP 管理迁出为独立全屏视图(左侧栏 Blocks 图标入口),AgentSettings 仅保留内置工具只读概览。商店风卡片网格 + 右侧详情抽屉(加宽至 62vw、整体可滚动,给 SKILL.md 说明留出空间),支持搜索、启用切换、更新、导入、卸载;右上角工作区下拉改用 Popover,修复 Electron 拖拽区导致下拉打不开。配套一轮交互打磨:移除失效的抽屉关闭按钮并统一返回箭头导航,删除确认改用 AlertDialog 替代原生 confirm,MCP 编辑改为防抖自动保存(新增 idle / dirty / saving / saved / error 状态提示),并修掉「打开详情时因 undefined 字段被误判配置变更而自动禁用」「关闭抽屉前未 flush 待保存变更导致列表读到旧状态」等边界问题
• 上游响应解析失败自动重试 — API Error: JSON Parse error: Unable to parse JSON string 等上游响应体解析失败,本属网关瞬时异常(HTML 错误页 / SSE 截断 / 代理脏数据),此前 catch 与 assistant.error 两条重试通道均未覆盖。新增 MALFORMED_RESPONSE_PATTERN 判定,归类为可重试的 service_error,复用现有重试机制(指数退避 + 25 次 + 5 分钟预算)

Bug 修复

• 深色主题阴影减弱 + 打开文件面板按钮迁移到 TabBar — 深色下卡片阴影由 shadow-xl 改为 dark:shadow-md / dark:shadow-sm,消除暗背景上过重的 halo。「打开文件面板」按钮从 AgentHeader 迁到 TabBar 右上角,与 DiffPanelTabBar 的关闭按钮同坐标,避免开 / 关之间按钮跳位;按钮抽离为 AgentPanelOpenButton 独立订阅 workspaceFilesVersionAtom,避免文件变更时整个 TabBar 重渲染
• 左侧栏操作按钮 tooltip 闪现 — 左侧项目列表的归档 / 置顶按钮默认 hidden、hover 才显示,Radix Tooltip 首次挂载时若 trigger 尚未完成布局,会把浮层先放到视口左上角 (0,0) 再跳回正确位置,导致一闪而过。新增 SafeTooltip,进入打开态后延迟 60ms 再真正渲染 Content,并跳过 trigger rect 为 0 的打开请求,在不影响布局的前提下消除闪现
• Agent worktree diff 面板修复 — 修正 Agent worktree diff 面板的若干显示问题,并把重复的路径归一化逻辑(.replace(/\\/g, '/').replace(/\/+$/, ''))抽取为 @proma/shared 的 normalizePathForCompare,ipc.ts / git-diff-service.ts / WorktreeSelector.tsx 统一复用
• 流式指示器回退到用户选择的模型 LOGO — Agent 模式下流式状态的 model 始终为 undefined(model_resolved 被主动忽略),导致运行中气泡的 AssistantLogo 先显示 Proma 占位图标。改为与实际 Assistant 消息一致,回退到 sessionModelId 对应的模型 LOGO
• GLM-5.2 等无流式 usage 渠道恢复上下文指示器 — 上一版修「result.usage 累计虚高」时删掉了 complete 事件的 token 字段,对 Anthropic 原生是对的(流式 message_delta 自带 usage),但 GLM-5.2 等走 Anthropic 兼容端点的渠道流式消息不携带 usage、真实值只在 result 返回,致使 ContextUsageBadge 永远 return null 不显示。折中方案:仅当流式 usage 从未写入过(prev.inputTokens 为空 / 0)时,从 result.usage 兜底写一次 token,已有流式真实值时不动,避免累计虚高回归
• 渠道拉取模型清残留 + 切供应商自动填充名称 — handleFetchModels 改为 upsert 替换语义:拉取结果作为权威清单,丢弃不在新结果里且非手动添加的旧模型,避免切换渠道后旧模型永久残留;请求失败(4xx / 5xx / IPC 异常)同样清空残留。ChannelModel 新增 source?: 'manual' | 'fetched' 保护手动添加项不被覆盖。切换供应商时自动用 provider 名称填充渠道名(仅当名称为空或仍是上一个 provider 的默认名,用户手改的不动)
• 移除定时任务页面重复的运行按钮 — 删除顶部与 Windows 原生窗口控制按钮重叠的「运行一次」按钮,保留底部按钮,并把 disabled 条件从 canPersistDraft 修正为 isReadyToRun,补充 tooltip 提示、调整按钮区 padding 与左侧内容区底部对齐
• 文件路径 chip 跟随「Agent 预览展开方式」偏好 — 消息正文里的文件路径 chip 此前直接 openTab(type:'preview'),绕过 previewModePreferenceAtom,设置切换为「侧边分屏」后仍强制开成 Tab。改为统一走 useOpenPreview,与 SidePanel / PreviewOpenButton / 剪贴板预览三个入口保持一致

下载

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

Proma v0.12.23

对比基准:v0.12.1

这一版把重心放在整体观感上:一次全局视觉质感升级(字体、阴影、圆角 token 重做 + 原子组件改造),以及三个深色特殊主题经过多轮打磨后的配色定稿——其中「苍穹暮色」正式更名为「远山暮霭」。功能侧,预览支持侧边分屏、智谱 GLM-5.2 带来 1M 超长上下文、定时任务新增月度调度并默认按自然日切片会话。稳定性方面,彻底修正了困扰已久的上下文占用量显示失真问题,并清理了 worktree 改动面板、外部 MCP 加载、定时任务等一批缺陷。

新功能

• 全局视觉质感升级 — token 重做 + 原子组件改造 + 字体升级。引入 Inter Variable 字体并启用 cv11/ss01/tnum OpenType 特性;新增 --radius / --shadow-* 五档 elevation token(亮 / 暗双套,暗色叠加 inset 顶高光制造浮起感),覆写 Tailwind 内置 shadow / radius,让现有 78+ 处 shadow 类、308+ 处 rounded 类零业务改动整体升级。原子组件(Button / Input / Textarea / Dialog / Popover / DropdownMenu / Select / Sheet)统一改为 hairline border + 多层柔阴影 + 双层 focus glow + active scale。顺带修复了 SearchDialog / SettingsDialog / ImageLightbox / TabSwitcher 四处浮层 backdrop 模糊逃逸的问题。新增依赖 @fontsource-variable/inter@5.2.8
• 深色主题精修与配色焕新 — 三个深色特殊主题经过多轮迭代后定稿:建立清晰的 elevation 阶梯、可见 hairline border、明亮的 focus ring,并统一按「背景调灰、显眼小块加饱和」的配色公式收敛饱和度,逃出「中等饱和 + 低亮度」的色彩泥潭。「苍穹暮色」正式更名为「远山暮霭」(雾蓝灰雾感配色,与「晴空碧海」形成昼 / 夜对偶,预览图用 GPT Image 2 重绘为层叠远山);「森息夜语」收为雾绿灰;「莫兰迪夜」保持克制。文字选区按主题分组适配,深色主题下侧边栏选中态、定时任务入口图标 / 数字不可见或颜色错乱的问题一并修复。theme id 保持不变,不影响老用户已选主题
• 预览支持侧边分屏 — 预览除了以 Tab 形式打开,现可常驻在右侧分屏。新增持久化偏好 previewModePreferenceAtom(标签页 / 分屏,默认标签页),可在外观设置里切换,也能直接把预览 Tab 拖出上下边界转为分屏(带高亮提示与 24px 缓冲避免误触)。PreviewTabContent 顶栏新增 PanelRight 显式入口,偏好切换按钮明确标注「仅影响下次打开」
• GLM-5.2 与 1M 超长上下文 — 智谱(zhipu / zhipu-coding)渠道默认模型追加 GLM-5.2(默认启用)和 GLM-X-Preview[1m],支持 1M 上下文窗口,连通性测试改用 glm-5.2。同时把 supports1MContext / inferContextWindow 抽到 packages/shared 作为单一事实来源,修掉前后端模型列表不一致的旧问题
• 月度定时任务调度 — 定时任务新增 monthly 模式,可在日历选择器里挑每月某天(1–31)。正确处理短月边界(选 31 号时在 2/4/6/9/11 月落到月末),列表与表单都会提示「短月落在最后一天」,避免误以为漏跑;建议表达「每月底」时优先用 28 号
• 定时任务默认按自然日切片会话 + 上下文安全阀 — 会话模式默认从「每次新建」改为「按自然日」:同一天内多次触发复用同一子会话、跨天自动新建,既保留当天上下文又不会无限累积。叠加 70% 上下文占用率安全阀——同日复用前若上一会话占用已达 70%(与 SDK 77.5% 自动压缩阈值留 7.5% 余量),主动切到新会话。reuse(始终复用)保留为高级选项。索引版本 1→2 自动迁移,回滚场景改为只读降级而非清空,避免丢失 automation 配置
• 定时任务跨运行记忆机制 — automation skill 升级,引导 Agent 在创建任务时就把「读取 / 滚动维护工作区 notes.md」写进 prompt,让每次自动触发形成自我迭代闭环;约定 .context/automation/<task-slug>/notes.md 路径与 kebab-case 命名,并强调滚动清理过时条目避免变成新的上下文负担
• 点击工作区标题折叠 / 展开会话列表 — 侧边栏工作区标题可点击折叠其下会话列表,标题前新增可旋转的 ChevronRight 指示图标并补齐 aria-expanded / aria-controls 无障碍属性(折叠状态刻意不持久化)
• 文件芯片右键「在文件管理器中显示」 — 右键路径芯片可直接在系统文件管理器中定位该文件,新增 shell:show-item-in-folder IPC 通道,无工作区路径限制
• 编辑文件时自动切换到文件所在 Tab — 文件面板拆成 session / workspace / changes 三 Tab 后,Agent 写文件触发的自动定位高亮会同步切到文件所属 Tab,避免高亮落在不可见的 Tab 上;仅响应 Agent 写入、不抢占用户手动切换
• 定时任务表单自动保存状态徽章 — 编辑表单名称右侧新增 5 态保存指示器(idle / dirty / saving / saved / error),无论在左栏写描述还是右栏改配置都能即时确认改动已保存;成功路径不弹 toast,仅失败时提示,避免连续编辑时的通知轰炸
• 搜索弹窗复用会话迷你地图预览 — 搜索结果的会话预览改为复用左栏的 SessionMiniMapPopover(portal 到 body + 高 z-index),不再被弹窗的 overflow 裁剪或被列表项遮挡,与左栏共享预读缓存,净减约 226 行自实现预览代码
• 侧边栏按钮细节打磨 — 新会话 / 搜索按钮去掉暗示「未完成」的虚线 border,改为与 Input/Card 同款实线 hairline;展开态新会话主按钮补上动态 ⌘N 快捷键提示(跟随用户自定义快捷键),气质对齐 Linear / Raycast 命令栏

Bug 修复

• 彻底修正上下文占用量显示失真 — 贯穿多个 PR 的修复线。明确 Anthropic API 的 input_tokens / cache_read_input_tokens / cache_creation_input_tokens 是三个分立可相加的字段(启用 prompt caching 后上下文绝大部分落在 cache_read 上),占用量 = 三者之和。修复点:1 OpenAI 兼容渠道(zhipu / openai / doubao / qwen / custom)的 prompt_tokens 已含缓存命中部分、映射到 Anthropic schema 时未扣减,导致缓存被计两次、显示值约为真实值的 1.5–2 倍;2 result.usage 是整个 query 内所有模型调用的累计求和,被当作当前上下文会让进度环虚高冲破 100%——complete 分支只信任流式 usage,不再用累计值覆盖 token;3 真实 contextWindow 未透传、分母永远显示 200K,现经 context_window 事件透传,智谱等端点剥掉 [1m] 后缀导致误判窗口的问题改用用户原始选择修复;4 模型 / 会话切换时清空旧值,避免残留上一会话数据。Popover 新增数据时效提示
• 外部 MCP 服务器因缺少 type 字段加载失败 — 手动编写的 mcp.json 通常不含 type 字段,导致服务器被静默跳过、UI 显示 undefined。现在读取后自动按 command → stdio、url → http 推断类型,配置不完整时输出 warn 而非静默丢弃,UI 把未知类型显示为「未知」
• 带 BOM 的 SKILL.md 解析失败 — 带 BOM 字节的 SKILL.md 会导致 frontmatter / version 解析失败、版本误判为 0.0.0 触发不必要的更新。parseSkillFrontmatter / parseSkillVersion / extractSkillBody / rebuildSkillMd 统一增加 BOM 处理
• 文件改动面板找不到 worktree 及选中报错 — worktree 选择器三个问题逐层修复:下拉为空(改为从工作区附加目录自动探测 git 仓库根并过滤失效路径)、选中后报「不是 git 仓库」(worktree 在主仓库外被路径授权拦截,新增回溯主仓库的 ensurePathAllowedWithWorktree 放行逻辑、安全边界不变)、看 diff 会污染会话目录(移除多余的 attachDirectory,「看 diff」与「授予 Agent 访问权」彻底解耦)
• 消除 worktree 选择器加载闪现 — 改动面板的 WorktreeSelector 下沉到 DiffChangesList,加载期间不渲染、仅在有数据时显示,去掉 tab 栏下方的冗余行
• task_notification 不再截断进行中的回复 — Agent 思考 / 输出过程中收到后台任务完成通知时,回复不再被错误切成两块;仅在没有进行中 turn(真正的后台唤醒场景)时才设唤醒边界
• 归档会话发送消息时立即取消归档显示 — 给归档会话发消息时做乐观更新,发送瞬间即把它移回未归档列表并刷新时间,不必等流式输出结束
• 删除 Agent 会话后右侧文件面板不再报 ENOENT — list-directory 对已不存在的目录优雅返回空列表,并清理滞留的会话工作目录路径映射
• 修复 ModelSelector 在瞬态 null 时误显「选择模型」 — 在 AgentView 层保持上一次有效的模型选择,避免启动时序 / 工具栏 remount 等竞态把已选模型变回 null
• 教程加载失败显示错误状态 — tutorial.md 缺失或读取失败时不再永久卡在「加载中」,归一化为 loading / ready / error 三态显式呈现
• 会话引用大文件时引导智能读取 — 通过 &session: 引用其他 Agent 会话时,提示优先用 Grep 搜索关键词定位相关片段再局部读取,避免一次性 Read 整个大文件带来的性能与 token 问题
• 定时任务一批修复与体验调整 —
  • 子会话持久化 modelId,避免打开自动任务触发的子会话时输入框模型选择被清空
  • 「无工作区 / 无模型」视为草稿态,禁止启用和立即运行并自动打开编辑面板提示补全;工作区改为必选、新建时默认填当前工作区,启用副文案动态列出真实缺失项
  • computeNextRunAt 调度字段改为可选,修复 monthly / daily / weekly 场景下的 tsc 报错;并修复 31 号 + 短月时 Date.setMonth 溢出跳过整月的问题
  • Windows 下关闭按钮不再与原生窗口控制按钮重叠;按钮布局调整(移除右栏「运行一次」、底部新增「运行测试」)
  • 上下文占用率改为计入 cache token 并从会话 JSONL 尾部惰性解析,避免高频任务全量 parse

下载

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

Proma v0.12.1

对比基准:v0.12.0

这一版带来两件事:Claude Fable 5 加入 1M 上下文支持,以及全面重写的教程文档。

新功能

• Claude Fable 5 支持 1M 上下文 — claude-fable-5 现已加入 Proma 的百万上下文支持名单。选用 Fable 5 时,Proma 会自动启用 context-1m-2025年08月07日 beta header,上下文窗口显示也同步更新为 1,000,000 tokens,与 Sonnet 4.6、Opus 4.6 / 4.7 / 4.8 等已支持模型保持一致
• 教程升级为独立标签页 — 教程内容全面重写(tutorial-v2.md),并以独立 Tab 的方式打开,替代原先弹出 Sheet 的体验。无论从启动引导页完成 onboarding、点击侧边栏的「教程」入口,还是通过设置页导航,都会在主界面打开一个带目录(TOC)的沉浸式阅读视图,不再遮挡当前工作区

下载

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

Proma v0.12.0

对比基准:v0.11.1

这一版最大的变化是引入了**定时任务(Automation)**系统——让 Proma 能够周期性地自动执行 Agent 任务,无人值守地帮你跑日报、查 PR、盯数据源。除此之外还补齐了工作区重命名、项目删除确认、设置页 built-in skill 分组,并把后台任务完成自动唤醒、Bridge 长连接自愈等一批稳定性改进一并带上。

新功能

• 定时任务(Automation)系统(测试版) — 全新的周期性任务调度能力。点击侧边栏的「自动任务」按钮进入全屏管理视图,列表按「启用中 / 已暂停」分组,每行展示状态灯、任务名、prompt 摘要和调度文案,hover 时浮出「立即运行一次 / 删除」操作。支持三种调度模式(固定间隔 interval、每天 daily、每周 weekly),可配置权限模式、模型和任务描述。底层是一个 30 秒 tick 的后台调度器,复用同一会话执行、失败自动退避、连续失败自动暂停。任务数据持久化在 ~/.proma/automations.json,每次运行的历史记录可点击直接跳转回对应会话。除了手动创建,你也可以直接在 Agent 对话里说「帮我每 5 分钟检查一次 PR」,Proma 会自动识别意图并弹出任务卡片
• 自然语言创建定时任务 — Agent 收到周期性任务诉求时,通过结构化输出协议自动创建 Automation,无需手动填表。意图识别走「DeepSeek + Anthropic + 关键词启发式」三级 fallback,关键词清单覆盖「定时」「自动」「每隔」等常见说法。同时把 Proma Automation 暴露为 Agent 的 MCP 工具,命令处理从隐藏注释升级为带类型的工具调用,每次定时执行都会开一个全新会话,过期的 run-now id 会显式报错
• 定时任务支持飞书通知 — 任务执行完成后可将结果推送到飞书,跑批结果不必盯着 Proma 也能第一时间收到
• 定时任务编辑器升级为 Markdown 富文本 — 任务 prompt 输入框从普通 textarea 换成项目统一的 Markdown 富文本编辑器,编辑时即可看到渲染效果,编辑器空白区域点击即聚焦,推荐引导文案常驻在编辑器上方
• 设置页将 Proma 自带 skill 归为 built-in 分组 — Skills 列表中,存在于 ~/.proma/default-skills/ 的内置 skill 单独归入 "built-in" 分组并标注 PROMA 标签,同时隐藏删除按钮避免误删。内部分组哨兵用 proma-built-in 命名,规避与用户安装的同前缀第三方 skill 产生 key 碰撞
• 工作区重命名 — 项目(工作区)三点菜单中新增「重命名」入口,可直接修改工作区名称
• 项目删除二次确认 — 删除项目前弹出确认对话框,并前置删除守卫:默认项目与最后一个项目不允许删除,避免误删后留下孤儿数据;索引先落盘再删目录,杜绝孤儿索引条目
• 后台任务 / Monitor 完成时自动唤醒 idle Agent — Agent 模式下 run_in_background 后台任务完成、或 Monitor 命中事件时,会自动唤醒已结束当前轮次的 Agent 续跑,无需手动再发一条消息。底层用 SDK Stop hook 观察在飞行的任务,仍有任务时保持消息通道开启,并加 1 小时空闲超时兜底释放子进程;软空闲态下仍可继续注入消息,唤醒输出独立成块不会与上一轮混在一起
• Bridge 长连接自愈 — 飞书 / 钉钉 / 企业微信的 Bridge 长连接在系统息屏、唤醒、解锁等网络短暂抖动场景下可能卡在错误状态。新增的 Bridge Registry 自愈机制会在系统恢复 / 解锁后重启已启用的 bridge,并周期性恢复被标记为不健康的连接
• Chat 侧边栏对齐 Agent 布局 — Chat 模式侧边栏的列表结构与 Agent 模式对齐:可点击的置顶导航行改为静态的「置顶 / 历史」分区,会话行间距、选中态、流式输出时的左侧色条都与 Agent 会话行保持一致

Bug 修复

• 修复 LaTeX 原生分隔符无法渲染数学公式 — 模型按 LaTeX 习惯输出 \(...\) 行内公式或 \[...\] 块级公式时,聊天界面此前会把它们当作裸文本显示(如 [ EV = \sum p_i u_i ]),而不是渲染成公式。根因是 react-markdown 走 CommonMark 规范,会把这四个反斜杠括号当作转义吃掉,导致 remark-math 识别不到(它只默认认 $...$ 和 $$...$$)。现在在 markdown 解析前先把 \(...\) 规范化为 $...$、\[...\] 规范化为 $$...$$,让既有的 remark-math + rehype-katex 链路直接生效,不引入新依赖;代码块和内联代码中的字面量会被占位符保护、不受影响,推理折叠区也走同一规范化
• 侧边栏置顶项过多时不再挤掉下方内容 — 置顶区此前没有高度上限,置顶会话一多就会把下方的 Chat 历史 / Agent 项目列表整个顶出可视区。现在置顶区高度约束在 6 行左右,超出则在区内滚动,下方历史始终可见
• 修复定时任务草稿自动保存的重复创建竞态 — 新建任务的自动保存流程在计时器保存 / 关闭保存 / 立即运行保存重叠时,可能对同一个无 id 草稿调用多次 createAutomation 导致重复创建。现已将草稿持久化串行化,第一次 create 返回 id 前不会再触发第二次
• 修复 Agent 项目下选中会话项缺少背景色 — AgentSessionItem 的选中态此前只有左侧一条 3px 指示条,背景与未选中项完全一致、极易被忽略。现补上 bg-foreground/[0.08] 选中背景,利用透明度合成自动适配深浅主题;blocked / running / completed 等带 accent 的状态也顺带补齐了选中背景
• 优化定时任务入口在深色主题下的选中态可见性 — 列表项 hover/focus 背景透明度提升、操作按钮基础可见度提升;侧边栏入口选中态改用 accent-foreground,修复苍穹暮色 / 森息夜语 / 莫兰迪夜等深色主题下图标和数字不可见或颜色错乱的问题
• 空状态隐藏重复的「新建定时任务」按钮 — 定时任务列表为空时,中心已有一个引导按钮,标题栏右上角的同名按钮会造成重复,现仅在已有任务时才渲染右上角按钮
• 修复三点菜单关闭动画期间浮层漂移 — 顺带拉长了迷你地图的触发延迟,减少鼠标掠过时的误触
• 长 prompt 场景限制 AskUserQuestion — 避免在超长输入下频繁打断用户

下载

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

Proma v0.11.1

对比基准:v0.11.0

这一版继续打磨 v0.11.0 重做后的 Agent 侧边栏:会话列表的视觉权重更克制、展开节奏更可控,同时修了一个三点菜单浮层会漂到屏幕左上角的恼人问题。

新功能

• 侧边栏会话列表视觉权重与展开节奏优化 — 项目下会话过多时的「展开显示 N 个更多会话」按钮改为「显示更多」,每次只增量展开 10 条,避免一次性把上百条会话全部铺开;按钮文字去掉 font-medium 加粗,回归普通文本权重。项目内会话行间距从 gap-px 调整为 gap-0.5,与其它列表保持一致。状态色块也重新分了主次:running(蓝)和 completed(绿)取消常驻填充背景,仅保留左侧色条作为状态标识;blocked(橙)作为真正需要立即关注的状态,保留填充背景。选中的会话与当前项目也不再常驻灰底,hover 灰底只在鼠标真正划过时才出现,消除「整条一直像在被 hover」的视觉错觉

Bug 修复

• 会话三点菜单浮层不再漂到屏幕左上角 — SessionItemActions 此前用 hidden / group-hover:flex 控制按钮组显隐,菜单打开后鼠标一旦移开会话条目,父级 group:hover 就失效,按钮组被切回 display:none,Radix Popper 拿不到 trigger 矩形,浮层就漂到视口 (0,0)。现在菜单 open 时强制保持按钮组挂载与可见,关闭后再恢复 hover 切换,菜单始终贴在触发按钮旁边

下载

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

Proma v0.11.0

对比基准:v0.10.29

这一版我们把 Agent 侧边栏重新组织了一遍,让项目和会话的层级更清晰;常用的「置顶」「归档」操作也从三点菜单中提到了悬停可见的图标按钮上。Agent 模式的执行过程视觉做了一轮精简,完全自动模式下的权限处理也修了一个老问题。

新功能

• Agent 侧边栏围绕项目重组 — 侧边栏整体改为「项目 + 最近会话」的两层结构,移除了原有的「工作中 / 手动完成」分组。删除项目时里面的会话会自动迁移到默认工作区,偶发出现的孤立会话(缺失或为空的 workspaceId)也会回退到默认项目下,不再凭空消失
• 置顶 / 归档按钮直接显示在会话项上 — 把 pin 和 archive 操作从三点菜单里提取出来,平时悬停在会话上就能看到独立的图标按钮。默认显示相对更新时间,悬停时切换为操作按钮,配合 h-[18px] 容器对齐避免布局抖动。归档新增二次点击确认:首次点击按钮变红,3 秒内再次点击才真正执行,超时自动重置;取消归档则立即生效无需确认。Chat 和 Agent 两种会话项都已统一支持
• 侧边栏折叠态展示所有活跃会话 — 项目分组折叠时,原本只显示最近 3 天内更新的前 5 个会话,同时存在 6 个以上活跃会话时会被截断。现在所有 running / blocked / completed 状态的活跃会话必须展示,不受 5 条上限和 3 天窗口限制;剩余槽位再按「最近 3 天 + 至多 5 条」填充非活跃会话。活跃会话内部按 blocked > running > completed 排序,更紧急的优先看到
• Agent 执行过程改为扁平布局 — 去掉了执行过程左侧的竖线和缩进,改为扁平视觉。流式输出时中间步骤会轻微弱化(opacity-80),最新一段保持正常亮度,视觉重心自然落在最新动作上;用户手动展开时所有内容恢复正常颜色,总结条则始终保持显示,结束瞬间不再跳动

Bug 修复

• 完全自动模式下不再误降级权限 — 此前 sdkPermissionModeForPromaMode() 会把 Proma 的 bypassPermissions 映射成 SDK 的 auto,导致 Claude Code 的 auto 分类器仍可能在 Proma 的允许路径生效之前阻止高风险的远程 shell 动作。现在保持原汁原味的 bypassPermissions 透传给 SDK,「完全自动」模式真正放开
• 完全自动模式下计划状态不再卡住 — EnterPlanMode / ExitPlanMode 在完全自动模式下会被视为透明操作,UI 上的「计划中」状态不会一直挂着不消失
• Agent 大量工具调用时折叠动画不再卡顿 — 折叠动画从 grid-template-rows(每帧触发整个 grid 布局重排、所有子元素 reflow)改为 height + overflow:hidden(仅裁剪边界插值),子元素不再反复 reflow。多工具调用、大内容量场景下折叠丝滑很多;同时把每个子项的入场动画(fade-in + slide-in-from-top)统一收敛到 ProcessBlockGroup 内部控制

下载

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

Proma v0.10.29

对比基准:v0.10.27

这一版我们接入了更多国产模型渠道,优化了会话切换体验和文件改动面板的性能,并修复了大量 UI 交互细节。整体使用流畅度和稳定性有明显提升。

新功能

• Cmd+F 快速搜索会话消息 — 在对话视图中按 Cmd+F(Windows 为 Ctrl+F)可直接打开迷你地图搜索面板,快速定位历史消息。如果已打开预览面板,快捷键仍由预览面板优先响应
• 新增智谱 Coding Plan 渠道 — 新增 zhipu-coding 渠道类型,走 Anthropic 协议接入智谱大模型,默认模型 glm-5.1。同时更新了智谱 logo,供应商选择器中现在也会显示对应图标
• 记忆会话视图状态,切回时自动恢复 — 从 Ctrl+Tab 切换器或侧边栏切回 Agent 会话时,系统会自动恢复上次打开的预览 Tab、停留视图和滚动位置,不用每次重新翻找刚才看的地方
• IM 模型切换命令 /model — 飞书/钉钉/微信中的机器人新增 /model 命令,可以查看当前渠道和模型、per-chat 切换。同时支持命令简写(/h、/n、/ls、/m 等),并移除了未实现的 Chat 模式相关命令
• Agent 计划模式退出需用户确认 — Agent 执行计划模式任务后退出时需要用户批准才能继续,避免未经确认就直接开始执行代码修改
• Chat 模式 SSE 上游错误自动重试 — Chat 模式下遇到网络错误或瞬时 HTTP 错误(408/429/5xx)时,在首字节发出前会自动重试(最多 5 次、累计不超过 30 秒),指数退避加随机抖动,减少「网一抖就白屏」的体验

性能优化

• 文件改动面板不再卡顿 — 将 git-diff-service 底层的 spawnSync 全面改为异步 spawn,Git 命令在后台执行不再阻塞 Electron 主线程。同时为 stdout/stderr 显式设置 UTF-8 编码,解决中文文件名跨 chunk 切分时的乱码问题,并完善了超时与错误处理
• 会话切换秒开 — 新增 per-session 内存缓存(LRU 上限 20 条),切换 Agent 会话时先从缓存填充消息区、后台异步刷新,消除原来全量读盘解析 jsonl 带来的空窗延迟

Bug 修复

• 标记完成按钮防误触 — 侧边栏「标记完成」按钮改为双击确认:第一次点击变红进入确认态,3 秒未操作或鼠标离开 1.5 秒后自动恢复,第二次点击才真正执行
• 版本历史不再偶尔显示「暂无」 — API 失败时不再静默返回空数组,改为抛异常并在界面显示加载失败提示,区分「加载失败」和「暂无数据」两种状态;错误信息中文化
• 设置面板不再闪烁 — 打开设置对话框时的布局闪烁问题已修复
• Agent 消息加载竞态修复 — 修复消息未加载完成时发送被阻塞、乐观消息未持久化到会话缓存等竞态问题,切换会话后再切回不会丢失刚发送的消息
• 会话三点菜单不再被预览遮挡 — 迷你地图悬浮预览面板与三点下拉菜单层叠冲突,改为菜单打开时立即关闭预览面板,消除遮挡
• 最近会话列表空白处可两指滚动 — macOS 下侧边栏会话列表 tab 间距、分组标题和空白处的两指滚动被窗口拖拽手势截走,现在整个滚动容器声明为 no-drag 区域,任意位置都能正常滚动
• 飞书实时同步允许息屏锁屏 — 之前飞书实时同步会阻止屏幕关闭,现在改为只阻止系统休眠,允许正常息屏和锁屏,保护用户隐私
• 中文路径在文件改动面板不再乱码 — 为所有 git 命令注入 -c core.quotePath=false 输出原始 UTF-8 路径;之前中文文件名显示为八进制转义乱码,Windows 上点击还会因路径匹配失败导致 spawnSync 阻塞主进程卡死
• WSL 检测编码更健壮 — 新增 smartDecode 函数支持 UTF-16 LE / UTF-8 / GBK 多编码自动检测,解决 Windows 控制台 UTF-16 LE 输出乱码问题,精简提示文案为统一的「WSL 未就绪,如已安装 Git Bash 可不安装」
• 窗口失焦时角标不再漏报 — 切到其他应用后当前会话完成时不再遗漏角标计数;同时用 SVG 动态红圈数字补齐了 Windows 任务栏角标(此前 setBadgeCount 在 Windows 上直接无效果)
• Mermaid 渲染失败不再残留错误条 — 开启 suppressErrorRendering 防止 Mermaid 在失败时往 document.body 注入游离错误节点;同时收紧了 Mermaid 代码块检测规则,graph/flowchart 等常见英文词后必须跟方向关键字才触发渲染,避免普通代码被误判
• 外部唤起的会话不再抢占前台 — 飞书/钉钉/微信等外部来源触发的会话不再自动切换当前 Tab 和工作区,只在左侧边栏显示带运行指示条的条目,由用户自行决定是否切换查看
• mention 列表顶部项可靠选中 — 输入 / # @ 后立刻用鼠标点顶部项偶发选不中的竞态已修复,选择时机从 onClick 提前到 onMouseDown,消除异步渲染和焦点抢占的时序问题
• UI 细节统一 — 侧边栏「工作中」Tab 上下间距调整为对称;设置面板左侧导航和模型选择列表统一使用纤细滚动条;侧边栏指示条改为贴合边缘的包边设计,选中状态更醒目

下载

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

Proma v0.10.27

对比基准:v0.10.25

这一版我们在会话切换与文件改动上做了实打实的提速,接入了小米 MiMo 渠道,并给 IM 机器人加上了模型切换命令。同时清理了一批切换会话、文件改动、Windows 角标等场景的体验毛刺。

新功能

• 新增小米 MiMo 渠道,适配 1M 上下文 — 新增 xiaomi 与 xiaomi-token-plan 两个供应商(走 Anthropic 兼容协议),默认模型涵盖 mimo-v2.5-pro / v2-pro / v2.5 / v2-omni / v2-flash;其中 v2.5 / v2.5-pro / v2-pro 启用 100 万 token 上下文,进度环分母与连接测试一并适配
• IM 机器人新增 /model 模型切换命令 — 飞书 / 钉钉 / 微信里现在可以用 /model 罗列渠道与模型、按需做 per-chat 切换,/now 查看当前渠道与模型;命令均带简写别名(/h /n /ls /s /sw /ws /m),并移除了此前未实现的 Chat 模式相关指令
• Markdown 预览支持左侧目录(TOC)与滚动导航 — Markdown 只读预览新增左侧目录侧栏,自动提取标题并注入锚点,支持点击平滑跳转、滚动联动高亮(scrollspy),窄屏自动收起,开关状态会被记住
• 会话视图状态记忆,切回原样恢复 — 每个 Agent 会话会记住「上次是否开着预览 Tab」「停留在哪个视图」以及 diff / 预览的滚动位置;从切换器或侧边栏切回时按记录重建预览 Tab 并回到原位置,删除 / 归档 / 迁移会话时同步清理,不留孤立状态
• Chat 模式上游错误首字节前自动重试 — Chat 模式 SSE 流在尚未渲染任何内容前遇到网络错误或瞬时 HTTP 状态(408 / 425 / 429 / 5xx)会自动重试,采用指数退避 + 抖动,最多 5 次、累计不超过 30 秒,永久性 4xx 直接抛出,重试等待可被随时打断;已经渲染出内容则不重试,避免重复

性能优化

• 切换会话不再「读盘空窗」 — 切换 Agent 会话时新增 per-session 内存缓存,命中缓存立即填充消息区、后台再用 IPC 刷新覆盖,消除长会话切换时先清空再加载的可见延迟;缓存按 LRU 上限 20 个会话,删除会话时同步清理
• 文件改动面板告别卡顿 — 文件改动相关的 Git 命令从同步 spawnSync 改为异步 spawn,不再阻塞主进程事件循环,修复切到「文件改动」Tab 时整个页面卡住的问题;同时显式声明 UTF-8 编码并完善了超时与错误处理

Bug 修复

• 中文路径文件改动不再乱码、点击不再卡死 — 为所有 Git 命令注入 -c core.quotePath=false,输出原始 UTF-8 路径,修复含中文文件名在改动面板显示乱码、点击预览空白,以及 Windows 上因路径转义导致整个应用卡死的问题
• 窗口失焦时角标不再漏报,补齐 Windows 任务栏角标 — 修复切到其他应用后当前会话完成时「声音响了却没数字」的漏报;Windows 平台改用 setOverlayIcon + 动态红圈数字补齐此前无效的任务栏角标
• Windows WSL 检测编码更稳 — 新增多编码自动检测(UTF-16 LE / UTF-8 / GBK),解决 Windows 控制台输出乱码问题,并优化了 WSL 未就绪时的提示文案
• 飞书实时同步改为允许息屏锁屏 — 实时同步只阻止系统休眠,不再阻止屏幕关闭和锁屏,更好地保护隐私
• 会话三点菜单不再被预览面板遮挡 — 修复迷你地图悬浮预览与三点下拉菜单重叠、导致菜单项点不动的问题,菜单打开时会立即收起预览面板
• 最近会话列表空白处可以两指滚动了 — 给侧边栏各滚动容器整体声明 no-drag,修复鼠标落在 tab 间距 / 分组标题 / 空白处时两指滚动被系统当作窗口拖拽截走、列表滚不动的问题
• 外部唤起的会话不再抢占前台 — 飞书 / 钉钉 / 微信等外部来源触发的会话不再无条件抢走当前激活 Tab、切换会话或工作区,只在左侧边栏显示带运行指示条的条目并实时更新,由你自行切换;若恰为当前会话则原地刷新
• 点击 mention 列表顶部项不再偶发选不上 — 输入 / # & @ 触发列表后立刻用鼠标点顶部项偶发选不中的竞态已修复,选择时机提前到 mousedown 并阻止抢焦点
• Mermaid 渲染失败不再残留错误 bar — 修复 Mermaid 渲染失败时页面底部残留一条孤立错误提示的问题,并收紧了图表检测启发式,避免普通代码块被误判
• 设置面板左侧导航改用纤细滚动条 — 与 Agent / Chat 历史会话列表保持一致的滚动条样式

下载

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

Proma v0.10.25

对比基准:v0.10.21

这一版我们重点打磨了 Windows 下的使用体验,并接入了更多模型供应商。日常切换会话、查看文件改动、调用第三方模型服务都更顺手了。

新功能

• 新增 Anthropic 兼容模型服务接入 — 现在可以更方便地接入那些走 Anthropic 协议(/v1/messages 路径)的第三方模型服务了。配置时只需填一个 base URL,系统会自动补全版本路径,并能正常启用思考模式与 Agent 模式
• MiniMax-M3 模型支持,1M 超长上下文 — MiniMax 渠道默认切换为最新的 MiniMax-M3 模型,上下文窗口提升到 100 万 token,长文档分析、跨会话记忆等场景不再频繁撞上限
• Ctrl+Tab 切换器显示会话类型图标 — 按 Ctrl+Tab 快速切换会话时,Agent 会话和 Chat 会话会分别带上不同的图标和文字标签,混排时一眼就能分清
• Kimi 渠道启用官方白名单 — Kimi 已将 Proma 加入官方白名单,连接信息里不再需要伪装成其他客户端身份,使用更稳定

Bug 修复

• Windows 上 WSL 检测不再乱码 — 之前在中文 Windows 系统上检测 WSL 时会显示一串乱码,现在已修复
• Windows 文件改动面板不再重复显示同一个文件 — 之前同一文件在改动列表里可能出现两次,现在已合并
• Windows 下文件比对恢复正常 — 之前在 Windows 上打开改动文件对比时,可能出现整文件被标记为「全部删除+全部新增」的情况,现在已修复
• Mermaid 图表在 Windows 上能正常渲染 — 之前在 Windows 下部分 Mermaid 图表会因换行符差异报错,现在跨平台都能正常显示
• Ctrl+Tab 切换体验更稳定 — 键盘上下选择会话时,当前高亮的那一行会自动滚到视口内,长会话列表里也不会选到一半「找不到」当前项
• 侧边栏上下区分割条更好用了 — Agent 模式下「工作中」和「置顶」两个区域之间的分割条更易抓取,鼠标放上去就能直观看到可拖拽提示,调节区域高度更顺手
• 飞书机器人:2 人群免 @ 直接续聊 — 之前在只有你 + 机器人的小群里,需要每次都 @ 才能触发机器人;现在只要群里还是 2 个人(你 + 机器人),直接发消息机器人就会回复。一旦群里拉进第三个人,会自动恢复「必须 @」规则,避免刷屏
• 输入 / # @ 等符号时弹出菜单 — 之前在中文等非空格字符后输入这些符号不会弹出选择菜单,现在任意位置输入都会正常触发

下载

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

Proma v0.10.21

对比基准:v0.10.10

本次更新带来右侧面板三栏 Tab 布局、多仓库 Worktree 管理、文件改动对比、会话内文件预览,以及大量稳定性修复——包括内存泄露治理、Windows 托盘行为修正和流式渲染抖动消除。

新功能

• 右侧面板三栏 Tab 布局 — 右侧面板从单一文件列表升级为「会话文件 / 工作区文件 / 文件改动」三栏切换,最小宽度从 220px 调整为 300px 适配新布局。每个 Tab 聚焦不同维度的文件管理

• 多仓库 Worktree 配置 — 工作区支持配置多个 git worktree 仓库(如 proma-dev 和 conductor),WorktreeSelector 从配置读取并按仓库分组展示,不再硬编码单一路径

• Changes Tab 支持 Worktree 对比 — 文件改动 Tab 新增 WorktreeSelector,选中 worktree 后展示相对 origin/main 的完整 diff(已提交 + 未提交),方便在 PR 前审查全量变更

• 会话内文件预览 Tab — 文件预览现在在会话 Tab 中打开,不再弹出独立窗口,浏览体验更连贯

• Agent 思考过程渲染 — Agent 的 <think> 标签内容现在可以展开查看,了解 AI 的推理过程

• 搜索悬浮小地图预览 — 搜索结果列表中悬停会话条目时弹出 minimap 预览,快速判断是否是你要找的对话

• 关闭 Tab 自动移出工作中 — 主动关闭 Agent Tab(Cmd+W 或点击 X)时,空闲状态的会话自动从「工作中」区域移除,减少侧边栏堆积

• Opus 4.8 1M 上下文支持 — 新增 Opus 4.8 模型配置,支持 1M token 上下文窗口

• 飞书长内容文档交付 — 飞书侧 Agent 在交付结构化或长篇内容时,优先创建飞书云文档承载完整内容,消息中仅回复摘要 + 链接,改善长内容阅读体验

• 飞书两人群免 @ — 飞书两人群中无需 @ 即可触发 Agent 响应

Bug 修复

• 流式消息头闪烁修复 — 流式输出时 MessageHeader 因 time 和 logo 每帧生成新引用导致重渲染闪烁,现已 memoize 稳定 props

• 语音输入窗口跨桌面显示 — macOS 上语音听写浮窗之前只出现在创建时的 Space,切换虚拟桌面后看不到。现在设置 setVisibleOnAllWorkspaces(true) 并保存相对位置,多显示器也能正确还原

• 关闭 Tab 后会话重新出现 — 关闭 tab 时未清除磁盘上的 completedButUnconfirmed 标记,导致会话被重新放回「工作中」列表。改用统一 IPC 通道原子清除

• 切换 Scratch Pad 时右面板消失 — 在 Agent 模式下切换到 Scratch Pad 会清除 currentAgentSessionId,导致右侧文件面板塌陷又恢复的布局跳动

• 搜索栏遮挡拖拽手柄 — SidePanel 内部 z-index 泄漏到父级上下文,搜索栏覆盖了面板缩放拖拽手柄。添加 z-0 创建独立层叠上下文隔离

• 首条消息完成时重复闪现 — Agent 首条消息流式结束的过渡帧中,实时消息和兜底气泡同时出现。修复为在流式结束后直接检查 liveMessages 而非依赖已清空的 liveGroupSet

• Tab 切换器误触与排序 — 打开切换器时光标恰好在弹窗下方会误选。现在追踪鼠标初始位置,移动 >5px 后才激活 hover;列表改为纯 MRU 排序反映真实访问历史

• 启动时清理失效附加目录 — Worktree 删除后其路径仍残留在会话附加目录中,导致侧边栏显示不存在的路径。启动时自动扫描并移除失效条目

• 工作中会话重启后丢失 — 完成状态的「工作中」会话仅存于内存 atom,重启后消失。新增 completedButUnconfirmed 持久化字段,重启后恢复到工作中列表

• Windows 关闭窗口直接退出 — Windows 下点击关闭按钮时应用直接退出而非最小化到托盘。现在行为与 macOS 一致:关闭窗口隐藏到系统托盘,托盘菜单可重新打开

• Windows 托盘不可用时崩溃 — 某些 Windows 环境下系统托盘不可用时添加 fallback 处理,避免应用崩溃

• 删除/归档会话内存泄露 — 删除或归档会话时未释放流式状态、SDK 消息数组、附件 blob URL 和 atomFamily 缓存,长时间使用后内存持续增长。将重型清理迁入删除/归档路径统一释放

• Diff 预览支持默认应用打开 — 文件对比预览中现在也能用系统默认应用打开文件

• Agent 中断状态修复 — 修复 Agent 中断后状态显示不正确的问题

• Pinned 会话排序修复 — 修复固定会话的排序逻辑

• icon 按钮 focus ring 残留 — 操作栏圆形按钮点击后残留 focus-visible 圆形边框,覆盖为 ring-0 消除视觉干扰

• 剪贴板附件持久化 — 剪贴板长文本附件以临时路径引用,系统清理后失效。发送时拷贝进 session 目录持久化,确保多轮对话可续读

• /now 文件列表误显会话目录 — /now 命令扫描工作区根目录时误将会话 UUID 目录列为文件,改为扫描 workspace-files/ 子目录并以树形展示

内部优化

• Agent prompt builder 重构 — 提取 SUBAGENT_METADATA 和 TOOL_USAGE_GUIDELINES 为单一数据源,消除 builtin agent 定义与系统提示词之间的重复

• 移除 per-message skill_improvement_hint — 此前每条消息注入一次 skill 改进提示,对普通用户是纯噪声且浪费 token,完全移除

• DeepSeek 子代理路由到 flash — SubAgent 调用 DeepSeek 时自动路由到 flash 渠道,降低成本提升速度

• Claude Agent SDK 集成更新 — 升级 SDK 集成,同步最新能力

• 标记完成按钮颜色跟随主题 — Working Done 按钮从硬编码绿色改为 primary 主题色变量

下载

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