Proma v0.10.2

对比基准：v0.9.40

这一版的主线是飞书侧 Agent 体验大升级和文件操作的提速：飞书 Bot 终于可以扫码即用，Agent 在飞书里也能像桌面端一样实时流式输出；侧边栏和 Diff 列表都加上了文件搜索；文件树整体向 VS Code 看齐。同时修掉了上一版的内存泄露和一批 Windows 平台问题，并把开源协议切换为 AGPL-3.0。

飞书侧体验升级

• 扫码一键创建飞书 Bot — 设置页「飞书 Bot 列表」新增「扫码创建」按钮：用飞书 App 扫一次码、在飞书里点确认就行，不用再去飞书开放平台手动建应用、复制 App ID/Secret、配权限。扫码成功后会引导你顺手装好 lark-cli 把权限扩展到飞书全部 19 个能力领域

• 飞书里也能看到 Agent 实时输出 — 之前飞书侧只能等 Agent 跑完一次性收到结果，现在 Agent 的文本、工具调用、思考过程会像桌面端一样实时长出来，工具调用默认展开方便看到调了什么。底部状态条显示当前进度，结束后展示耗时和 token 摘要

• 连发多条消息会自动合并 — 在飞书里连着发好几条消息时，Proma 会等 600ms 把它们合并成一次任务，避免触发多个并行 Agent；Agent 跑期间继续发的消息会累积到当前任务结束后再一起处理。同一会话里的消息严格按顺序处理，不会乱套

• 支持引用消息上下文 — 在飞书里"引用回复"某条消息发给 Agent 时，被引用的内容（文本/富文本/图片/文件）会被一起注入到上下文，Agent 不再"看不见你引用的是什么"

• 飞书配置流程更清晰 — 远程连接侧栏中飞书移到第一位并默认选中；权限 JSON 补齐了云文档、群管理、Bot 状态表情、Wiki 节点解析等能力；步骤说明拆为「事件订阅」和「回调配置」两小节，配置页顶部预留了视频教程位置（视频录好后会上线）

• 飞书附件诊断 + 屏蔽 AskUserQuestion — 飞书发图后没保存到工作目录时会在控制台明确报错方便排查；同时告诉 Agent 在飞书里别调 AskUserQuestion（飞书没有交互弹窗通道，调了会卡住），让它基于现有信息推断或直接在回复里说明需要什么

文件搜索与 Diff

• 侧边栏新增文件搜索栏 — 会话文件区和工作区文件区各有一个搜索框，按文件名实时搜会话/工作区目录及附加目录里的文件。点击搜索结果会自动展开父目录、滚动到目标文件并选中高亮；搜文件夹也能直接定位到该文件夹

• Diff 文件改动列表新增搜索过滤框 — 改动文件多的时候可以按文件名实时过滤，含一键清除按钮，无改动时不显示

• 切换会话不再误闪「没有代码改动」 — 之前切换会话时 Diff 列表会先显示一下"没有代码改动"再加载真实数据，现在会用上次的缓存先垫住，等新数据到了再无缝替换

• Windows 路径分隔符问题修复 — 修掉了 Windows 下因为正反斜杠不一致导致的两类错配：未读红点不亮但 changes Tab 又能看到改动文件、附加目录搜索结果点击后不能正确定位

• 代码块解析问题修复 — 修掉了部分情况下代码块内容显示为空、连续空行被吞掉的问题；语言标识也支持 c++ 这类含特殊字符的写法

文件树视觉

• 目录头粘性悬停 + 缩进引导线 — 已展开的目录滚动时父路径会粘在顶部常驻可见，最多支持 8 层；子项区域加了 1px 引导线强化层级感；行高统一为 32px

• 目录树整体向 VS Code 风格对齐 — 去掉了 sticky 行的毛玻璃和卡片圆角，铺满整行更简洁；hover 高亮、sticky 行间分隔阴影、祖先链穿透竖线都做了优化，深层嵌套也不会出现样式错乱

• 附加目录用上同款样式 — 会话级和工作区级的附加目录视觉规则与主文件树完全一致

• 侧边栏列表项选中圆角统一 — 各种列表项和子标签的选中态圆角弧度统一了，消除原本的违和感

其他新功能

• Assistant 回答末尾汇总本轮文件改动 — 每个 Agent 回答结束后会在底部以 chip 形式列出本轮涉及的所有文件（包括子代理的修改），点击直接预览

• 会话搜索改为手动触发 + 流式扫描 — 搜索框改为按搜索按钮或回车才执行，不会边输边搜导致卡顿；底层从一次性读完整个 JSONL 改为按行流式读取并命中即停，大文件不再阻塞主进程

• 输入框工具栏支持响应式折叠 — 预览面板分屏或窗口变窄时，工具栏按钮不再被挤压堆叠，容纳不下的会折叠进右上角的「更多」菜单

• 折叠侧栏 Agent 按钮悬停弹出工作区列表 — 折叠态下鼠标悬停 Agent 按钮就能看到工作区列表并直接切换，省去「展开-切换-收起」三步

• 快捷键支持禁用 — 快捷键设置面板每项加了禁用开关，避免与系统或其他工具冲突

• Markdown 预览字号支持小/中/大三档 — 设置 → 外观新增字号切换控件，AI 回复和文件预览同步生效

• 自动预览默认关闭 — 新用户/全新安装时自动预览处于关闭状态，减轻设备性能负担；已有偏好的老用户不受影响

• 输入框滚动条样式统一 — 输入框的滚动条现在和侧栏、SidePanel 等其他位置保持一致

Bug 修复

• 修复 v0.9.40 引入的三处内存泄露 — 长时间运行 + 频繁开关会话场景下渲染进程和主进程内存基线显著下降，飞书 Bridge 用户和频繁触发自动重试的会话尤其受益

• 侧边栏触控板滚动卡顿修复 — 修掉了 macOS 下用触控板快速滚动侧边栏会卡顿的问题，根因是鼠标快速划过列表项触发了大量重渲染

• 新建会话/切换模型时 React 报错修复 — 修掉了两处会触发 Maximum update depth exceeded 错误的死循环

• 侧边栏顶部区域高度跨容器收缩夹紧 — 缩小窗口后顶部区域不会再溢出把分隔条挤到下方区域

开源协议变更

• 切换到 AGPL-3.0 + 商业双许可 — 社区版受 AGPL-3.0 约束；闭源集成、不公开源码的 SaaS 等无法满足 AGPL 义务的场景，可通过邮件 erlichliu@gmail.com 申请商业授权

依赖升级

• @larksuiteoapi/node-sdk — 从 ^1.59.0 升级至 ^1.65.0，是飞书侧流式卡片体验的前置条件

升级建议

• 飞书 Bot 用户强烈建议升级：扫码创建 + 流式卡片 + 消息合并三件套让飞书侧体验跟桌面端拉齐
• 之前感到内存占用持续走高、侧边栏滚动卡顿的用户，本版会有明显改善
• Windows 用户升级后未读红点错配、附加目录搜索定位等问题会一并修复
• 商业用途的用户请关注新的双许可说明

下载

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