Proma: baixar versions anteriors

Proma v0.19.53 更新
新功能
- 新增 Exa Search 接入 — 「连接」目录新增 Exa Search 卡片（排在 Brave Search 之后），填一个 API Key 就能接上 Exa 官方远程 MCP，获得语义网页搜索和页面内容提取能力；Key 会加密保存到系统 Keychain，Proma 会先完成真实握手与工具发现验证再启用。
- DeepSeek Flash 支持 1M 上下文 — 上下文窗口按 1M 计算，界面展示和用量统计与实际能力保持一致。
- DeepSeek V4.1 Flash 更名为 DeepSeek Flash — 模型 ID 统一为 deepseek-flash，DeepSeek 渠道与火山引擎 Coding Plan 等预设模型、思考深度配置同步跟随新 ID。
依赖升级
- Pi Agent SDK 0.85.0 → 0.85.1 — 五个 @earendil-works/pi-* 包统一升级，带来 prompt_cache_options TTL 修复以及 TUI 悬停、滚轮交互修复。

Proma v0.19.37 更新
新功能
- GitHub Copilot 订阅登录 — 渠道设置新增 GitHub Copilot 订阅类型，通过 device-code OAuth 授权本机登录，也支持填写 GitHub Enterprise 地址；登录成功后自动拉取当前账号与组织策略允许的模型目录，空列表同样作为权威结果处理，不会沿用上一个账号的旧模型导致选择器出现无法调用的选项。凭据加密保存并自动续签，Token 过期后无需手动重复授权。
- 计划审批时预览计划文档 — Agent 在计划模式提交审批时，可在确认横幅中打开当前会话 plan/ 目录内的 Markdown 计划文件并在右侧只读预览，确认前先完整过目计划内容再决定接受或修改。计划文档必须是该目录下的真实常规文件（大小不超过 1 MB，经 realpath 归一化与符号链接校验），防止审批内容被文件替换或链接跳转绕过初始检查；计划模式下的 Markdown 写入同样强制限定在当前会话 plan/ 目录，相对路径一律拒绝，避免写操作逃逸到项目或用户文件。
- Agent 可跨工作区创建定时任务 — 定时任务创建时支持 Agent 先查询可用工作区再绑定到指定工作区运行，适合需要跨项目落地的无人值守任务；省略目标时仍默认落在当前工作区，原有行为保持不变。
- 项目区块一键折叠 — 侧栏「项目」标题栏新增折叠按钮，可一键收起当前显示的全部项目组（含自动任务合成组）；全部已折叠时按钮自动禁用，避免无效点击，单个项目的手动展开与折叠不受影响。
Bug 修复
- Markdown 预览查找交互恢复 — 重构 Markdown 预览与编辑器内的查找条：输入时即时高亮匹配项并显示数量，支持切换上一个 / 下一个与一键清除高亮，编辑内容变化时匹配结果同步更新，长文档或频繁编辑场景下不再丢失焦点或停留在过期结果。
- Skills 刷新保留编辑器与资源状态 — 技能详情与资源面板在目录刷新后保留正在编辑的文件与已加载的资源视图，不再因刷新把正在编辑的内容重置；技能文件写入路径继续按会话工作区校验，改名与重载行为保持一致。
- Vault 支持正文双链显示与跳转 — Vault 笔记正文中的 [[笔记名]] 双链以可读 chip 形式展示，点击即可跳转到对应笔记；目标笔记缺失或路径过期时自动刷新 Vault 文件树后重新解析，双链的外观与选中态一并打磨。
- Slack 会话命名与计划审批对齐桌面体验 — Slack 会话首条消息不再以「频道 ID + thread 时间戳」作为长期标题，改走与桌面端一致的自动命名流程；外部（Slack）触发的计划模式不再向桌面输入框注入「接受计划」残留草稿——Slack 渠道自身的审批交互保持不变；设置页补充了从零创建 Slack App 的引导提示。
- Vault 标题回车后直接进入正文编辑 — 在笔记标题输入框按回车提交后，光标直接落入正文首行，保留输入法与异步提交保护；独立识别 YAML 与正文边界，修复快速切换笔记时刷新接管读取、加载态迟迟不结束的竞态。
- 本地 Markdown 相对引用可解析预览 — 预览面板对本地 Markdown 中的文件引用（相对路径、文件名片段、绝对路径）按候选根安全解析后打开，不再扫描 home 目录或全盘查找同名文件；文件路径 chip 与预览跳转统一使用新的解析规则，路径越界时明确提示不可预览。
- 对话回退不再误称“恢复文件” — Agent 对话回退的确认文案只描述「截断该消息之后的所有对话且不可撤销」，移除「并恢复文件到该时刻状态」的不实表述；回退成功后将“不支持文件回退”作为正常能力边界返回，不再误报为错误并触发警告。新增静态契约测试防止旧文案回归。
- Skill 改名后消息标签即时更正 — Agent 会话中引用 Skill 的消息标签在 Skill 重命名后显示新名称，按会话工作区读取启用与禁用 Skill 的当前名称，配合目录通知与缓存刷新，消息队列与历史消息中的标签不再停留在旧名。
- 右键菜单与下拉菜单样式统一 — 侧栏右键菜单与下拉菜单抽取共享的表面、菜单项、分隔线与子菜单样式类，悬停、选中、动画与最大高度行为一致，不同入口弹出的菜单不再出现忽大忽小的观感差异。
- 更新缓存自动清理更安全 — 升级包下载与安装后的缓存建立显式生命周期：待安装包只在目标版本成功启动后才删除，下载进行期间禁止任何清理；macOS 差分更新的基线文件与待安装包状态独立持久化；所有删除限定在 updater 自身的缓存目录，清理为尽力而为，失败不影响更新下载与安装能力。既避免磁盘残留，也不会误删正在使用或即将安装的更新包。
- GPT-6 Astra 上下文窗口对齐 GPT-5.6 — GPT-6 Astra 的上下文窗口由 1M 调整为与 GPT-5.6 系列一致的 372K 注册与推断，第三方同名模型的外推同步修正，避免按 1M 估算导致上下文占用判断失真。
- 移除旧内置搜索与生图工具 — 下线 Chat 与 Agent 中的旧 Tavily / Nano Banana 搜索、生图执行链路及其专用配置入口，工具列表与设置页随之精简；外部 MCP、其他 Chat 工具与既有历史记录不受影响。同步修复工具配置原子替换后的监听问题，覆盖首次创建、连续替换与停止清理三种路径。

Proma v0.19.31 更新
新功能
- GPT-6 Astra 模型支持 — ChatGPT（Codex）渠道新增 GPT-6 Astra，支持文本与图片输入，按 100 万 token 配置上下文窗口，并提供 low / medium / high / xhigh / max 五档思考强度；存量渠道自动补入新模型，保留已有模型的自定义名称与启用状态。指定的 Codex 模型不存在时明确报错，不再静默切换到其他模型。
- Slack Bot 接入 — 设置页新增 Slack Bot，通过 Socket Mode 连接本机 Proma，无需公网回调地址。在已邀请 Bot 的频道中 @Proma 即可发起任务，同一成员在同一 thread 中可继续会话，不同成员的上下文相互隔离；提问、计划确认与单次权限审批以交互卡片返回原 thread。支持未送达最终回复的持久化重试；可选 Home Channel 接收其他来源会话的标题与完成状态，不转发回复正文。当前仅支持频道 @mention，不接收私信，使用时需保持 Proma 桌面端运行。
- Agent 表达原则完善 — 核心系统提示词新增面向用户的沟通原则，要求回复、交付文档、代码与提交信息语意连贯、结构清晰，在保持专业深度与信息密度的同时减少不必要的隐喻；如实说明结果、风险与不确定性，避免无依据的强化措辞，不把推测写成结论。
Bug 修复
- 附加目录展开状态保留 — 项目文件与会话文件中的附加目录在应用运行期间记住展开与折叠状态，按会话、来源和附加根目录分别隔离，切换视图后无需反复展开；目录重命名或移动后同步保留子目录的展开层级，过期加载结果不再覆盖当前目录，并修正路径边界判断，避免影响同名前缀的兄弟目录。
- 删除 MCP 不再影响其他服务器 — 删除单个 MCP 时仅移除目标配置，保留其他服务器的配置与启用状态，不再因触发全量重新校验而暂时关闭无关 MCP。
- Gemini 3 思考深度适配 — Chat 新增 Gemini 思考深度选择，按当前模型展示支持的档位；Agent 与 Chat 统一模型能力约束，已适配的 Gemini 3 文本模型使用 thinkingLevel，不再沿用旧版 thinkingBudget。不支持的档位自动回到该模型默认值，避免 Gemini 3.7 / 3.8 收到 minimal 后请求报错；同时补齐 Google 协议模型别名与上下文容量识别。
- 折叠侧栏会话即时切换 — 修复侧栏折叠时会话入口与协作子会话浮层的切换行为；快速从一个浮层切换到另一个时，旧浮层的延迟关闭不再误关新浮层，设置页未保存内容的离开确认仍然保留。
- 搜索弹窗宽度调整 — 扩大对话搜索弹窗的可用宽度，并根据窗口大小自适应保留两侧留白，让长标题与搜索结果有更多展示空间。
- Google 搜索页面不再误跳 Bing — 受管浏览器以 Google 主文档导航成功作为可用判据，不再等待图片、脚本等子资源全部加载完成，避免页面已经能用却被误判超时并切换到 Bing；主文档导航超时时仍保留备用搜索回退。
依赖升级
- Pi SDK 升级 — Pi Agent 相关依赖从 0.84.4 升级至 0.85.0，同步更新模型适配补丁与运行时打包依赖，配合本次 GPT-6 Astra 接入。

Proma v0.19.26 更新
新功能
- 搜索 MCP 预设 — 连接目录内置 Brave Search 与 Tavily 搜索 MCP 预设，选择即可接入联网搜索能力。配套加固：必选 MCP 握手失败后进入 2 分钟冷却，期间不再以完整连接超时拖慢每一轮 Agent，后台重连成功后立即恢复；粘贴带 Bearer 前缀的密钥保存时会自动剥离；stdio 类型的 API Key 与保存时的命令参数绑定，服务器配置被外部改动后不再注入密钥，防止凭据被误用到其它命令。
- 协作子会话思考强度可控 — delegate_agent 与 delegate_agents 支持为子会话指定 thinkingLevel（off / minimal / low / medium / high / xhigh / max），可按子任务复杂度分配推理资源；不传时保持新会话默认值，模型不支持请求档位时会自动归一化为其可用的最近档位。
- 受管浏览器一键用默认浏览器打开 — 地址栏旁新增「在默认浏览器打开」按钮，将当前 http(s) 页面转交系统默认浏览器；搜索词、内部页面与其他协议仍留在受管浏览器内处理，不泄露内部页面。
Bug 修复
- Vault 新建文件夹即时可见 — 新建文件夹后立即出现在文件树中；文件夹枚举改用独立配额预算，不再与 Markdown 笔记共享上限，文件夹较多的 Vault 不会再挤掉既有笔记的侧栏显示；同时不再生成看似可展开、却永远列不出子项的边界空节点。
- 文件面板首次加载稳定 — 修复工作区路径异步返回期间文件面板抖动与空窗：过期请求的结果不再覆盖当前视图，等待路径解析时不会把临时空目录误判为“空态”闪烁，同一根目录的后台刷新也保持既有树与空态稳定。
- 移除 App 内教程链路 — 下线教程查看器 Tab、推荐横幅、设置页教程入口及 Onboarding 的「打开教程 / 创建欢迎对话」步骤，新手完成后直接进入主界面；GitHub 仓库 tutorial/ 文档、飞书配置页视频教程与 Vault 帮助仍保留可读。
- MCP 工具调用短语去重 — mcp__ 工具的语义化短语已包含完整「服务器 / 工具」名称，不再叠加冗余的 kind 前缀，避免出现「名称 · 名称」的重复展示。
- 会话拖拽提示精简 — 移除悬停会话行时出现的拖拽手柄与「拖拽引用」提示，侧栏更干净；拖拽会话到输入框实现引用的能力保留不变。
- Fable 5.1 思考深度适配 — Fable 5.x 系列模型按大版本复用目录配置，不再因缺少精确版本条目而继承错误的协议标志；始终推理的模型在保留“关闭推理”等旧设置时，不再被静默降级为最弱档，而是安全映射为高推理强度。
- 启动与欢迎页品牌文案统一 — 启动屏与 Onboarding 标语统一为「FOR PROFESSIONALS」，欢迎文案调整为「为专业用户打造的通用 Agent」，品牌表达前后一致。

Proma v0.19.23 更新
新功能
- Agent 会话可拖入输入框生成引用 — 左侧会话列表中的会话可以直接拖到输入框，快速插入该会话的引用；也可通过会话菜单的「引用此会话」触发。自带自引用保护（拖拽自己的会话时给出提示），只读输入框不会被误插入，引用插入后可见性更清晰。
- 委派观察收敛为单一 Tab，完成状态不再漏看 — 协作子 Agent（委派）运行时只使用一个固定的观察 Tab，避免多个委派堆积出大量标签；委派完成但尚未查看时会话在侧栏保持「未查看完成」标记，打开查看后自动清除，停止/切流等快捷键目标也随观察槽位正确对齐。
- Vault 文件侧栏支持折叠 — Vault 视图左侧文件列表可一键折叠为窄条，展开后焦点自动回到折叠按钮，键盘操作更顺手，给笔记编辑留出更多空间。
Bug 修复
- 修复长文档目录导航后的预览与滚动竞态 — 点击目录（TOC）跳转前先等待编辑器就绪，防止预览在导航后不展示；作废跨文件切换留下的陈旧滚动恢复，并加竞态保护，避免恢复滚动位置时“先闪顶部再跳转”或跳到旧文件的错误位置。
- 重复打开笔记不再反复重挂载 — 同一篇 Vault 笔记重复打开时避免编辑器反复重建；单篇笔记的渲染异常现在被错误边界隔离在内容区，不再让整个 Vault 或右侧工作区呈现空白，并可在内容区直接重试。
- 清理会话文件变更中的已删除文件残留 — 会话里“先创建后删除”的文件不再一直残留在文件变更列表中，已删除路径会按授权目录校验后自动清理。
- 预览文件支持在文件夹中定位 — 预览面板的「在文件夹中显示」改为基于预览实际解析到的目录定位文件，相对路径、附件与外部目录也能在 Finder/Explorer 中正确 reveal，不再出现“预览正常却定位不到文件”。
- 为文件 chip 增加完整路径 Tooltip — 悬停消息中的文件 chip 显示完整路径，长路径不再因截断无法查看；文件存在性与路径解析逻辑统一整理，悬停时刷新结果更准确。
- 适配 Fable 5.1 思考参数 — Pi 模型注册表识别整个 Fable 5 家族，强制走 Pi 的 adaptive + effort 思考路径，避免较新的 Fable 5.1 因旧式 thinking 参数被官方 Anthropic Messages 端点拒绝。
- 并排模式下切换委派子会话给出明确提示 — 父会话仍处于并排（split）视图时，从侧栏切换到其委派子会话会先提示「请先退出并排模式」，避免布局状态让人困惑。

Proma v0.19.16 更新
新功能
- Markdown 表格支持单元格独立编辑与 LaTeX 渲染 — 表格单元格可直接独立编辑，不必整表重写；表格内的 LaTeX 公式正常渲染，编辑后恢复正确的单元格导航。
- Vault 笔记安全渲染 YAML Properties — 笔记 frontmatter 中的 YAML 属性以安全方式展示，不再混入正文；编辑 Properties 时保留文档最新内容，避免覆盖已保存的改动。
- 工作区标签栏支持鼠标滚轮滚动 — 标签页较多时，可直接用鼠标滚轮或触控板横向滚动标签栏快速定位，不必拖动滚动条。
- 搜索索引完整覆盖当前会话消息 — 会话内搜索不再只覆盖部分内容，当前会话全部消息都纳入索引，搜索结果更完整。
- 新增 Ubuntu Linux 发行包 — 新增 Ubuntu 22.04 x64 的 AppImage 与 deb 两种安装包，声明运行时依赖并完成 deb sandbox 配置，同时补充 Linux 支持边界说明。
- 项目根目录 I/O 异步化 — 项目根目录读取改为异步执行，不再阻塞主线程，提升启动与文件操作的响应速度。
Bug 修复
- 恢复被禁用的场景音效设置 — 修复设置中禁用场景音效后仍被悄悄恢复的问题，开关状态保持用户的选择。
- 改进 macOS 终端回读与 agnoster 字形 — 修复 macOS 终端输出回读不完整、agnoster 主题特殊字形（箭头等）显示错乱。
- Vault 共享文档保存串行化 — 多个标签同时保存共享文档时按序执行，避免并发覆盖导致内容丢失。
- 修复长文档预览目录与导航 — 长文档虚拟化预览下目录（TOC）补齐完整，点击目录可正确跳转到对应位置。
- 修复 LiveMarkdown 切换后语法隐藏与图片预览 — 文件切换后 LiveMarkdown 语法高亮被隐藏、图片无法预览的问题恢复。
- 修复滚动位置恢复闪烁 — Markdown 预览恢复滚动位置时不再先闪回顶部再跳转。
- 统一队列运行代际生命周期 — 多条消息排队运行时，后代 run 的代际收尾统一，终态事件归属稳定，不再出现刷新与终态错乱。
- 修复 Vault 笔记切换阅读位置丢失 — 切换笔记标签再切回时，滚动位置保持在原阅读处。
- MCP 连接测试与配置保存隔离 — 测试 MCP 连接不再触发配置保存，避免测试过程意外改写配置或造成界面不一致。
- 探索分支复制不再阻塞界面 — Agent 探索时复制工作区改为异步 I/O，保留就绪语义，不再卡顿界面。
- 修复 Skills 外部编辑刷新与打开目录 — 外部修改 Skill 后自动刷新内容，并打开正确的文件夹位置。
- 预览重新打开后加载最新内容 — 重新打开预览时加载最新内容，不再显示关闭前的旧缓存。
- 支持快捷键关闭终端标签 — 终端标签可通过快捷键关闭，不必每次点击关闭按钮。
- 修复相对文件夹路径解析 — 修复文件变更列表与相关面板中相对路径解析错误，打开位置更准确。
- 修复浏览器链接聚焦与弹出标签隔离 — Agent 打开的链接自动聚焦，弹窗与新标签相互隔离，不再干扰当前工作标签。
- Windows ConPTY 行布局稳定 — 修复 Windows 终端长行与换行的行布局错乱，输出显示更稳定。
- Windows 启动运行时检测异步化 — Git/Node 运行时检测、注册表与 WSL 状态读取改为异步并发执行，加快 Windows 启动，避免界面卡死。

Proma v0.19.5 更新
新功能
- Agent 终端支持选择 Shell Profile — Agent 打开或执行终端时可显式指定 shell（PowerShell、Git Bash、WSL、CMD、zsh、bash），并按平台记住上次选择；复用 shell 不匹配的终端时会给出明确错误提示，不再静默回退到默认 shell。
- 设置页新增生产力工具开关 — 新增 Todo、日程、Obsidian 三个独立开关：关闭后对应侧边栏入口隐藏，Agent 也不再注入相关工具与规则；开关持久化，失败时自动回滚避免界面与设置不一致。
- 右侧工作区标签栏可拖动 — 标签较多时可拖动标签栏的滚动条快速定位，避免切换文件/预览时来回点按。
Bug 修复
- 恢复 LiveMarkdown 渲染 — 修复 Markdown 实时渲染回退问题，补齐代码块高亮、表格、数学公式与目录高亮等预览能力；Vault 笔记冲突时支持显式重新加载。
- 修复预览选择引用与发送失败丢内容 — 恢复预览中的选择引用定位；消息发送失败时保留输入内容与选择上下文，重试无需重打。
- 修复 Google Pi 模型接入异常 — 规范化 Google Pi 的 base URL 处理，避免 Agent 连接异常。
- Agent 终端行为优化 — 后台文档任务（PDF、Office 处理等）不再弹出终端打断操作；Agent 运行时优先复用已有可见终端，减少无谓的终端堆积。
- 排队消息流路由稳定 — 多条消息排队时保持各自流路由归属，后台刷新与终态事件不再错乱。
- 计划模式允许只读 PowerShell — Windows 下计划模式允许执行只读 PowerShell 命令，不再误拦截。
- 草稿会话可见性持久化 — 草稿会话的显示/隐藏状态跨会话保持，重启后不再丢失。
- Windows 标题栏点击区域修复 — 标题栏拖拽区与窗口控制按钮的命中区域分离，避免按钮误触或失灵。
- 右侧面板刷新闪烁修复 — 右侧工作区面板切换不再整页重载闪烁，文件浏览状态更稳定。
依赖升级
- Pi Agent 运行时升级 — 由 0.84.2 升级至 0.84.4，同步适配终端复用、权限校验等 Agent 工具行为。

Proma v0.19.1 更新
新功能
- Obsidian Vault 集成 — 会话侧边栏新增 Obsidian 笔记工作区：可切换 Vault、按文件树浏览与管理笔记，支持新建/重命名/删除笔记与文件夹。编辑器基于 LiveMarkdown 实时内核，渲染双链引用 chip、Properties 与代码块高亮，笔记自动保存；原 Scratch Pad 自动迁移进托管 Vault，聊天侧边栏与 Agent 上下文也能感知 Obsidian 笔记。
- LiveMarkdown 覆盖项目记忆 — 项目记忆、自动化任务 prompt 等 Markdown 场景统一切换为 LiveMarkdown 实时编辑/预览内核，与 Vault 共享代码块渲染和剪贴板行为，代码高亮对齐 Shiki。
- Office 文件高保真预览 — 为 DOCX、XLSX、PPTX 打包 OfficeCLI，在子进程中渲染高保真 HTML 预览并以 iframe 隔离展示；构建时校验并固定平台对应的 OfficeCLI 资源，原有渲染器保留为兜底。
- MCP 与 CLI 连接目录 — 新增统一连接目录，内置常用服务提供商条目与本地品牌图标，支持安全凭证流与 OAuth 管道；同时完善手动设置提示，让 MCP 服务器接入更直观。
- MCP 与 Skills 侧边栏入口整合 — 将 MCP 与 Skills 的管理入口收敛到统一的侧边栏访问路径，离开详情页时自动落盘变更。
- 右侧工作区双 Pane 并排查看 — Agent 右侧工作区支持双 Pane 并排查看，窄栏下自动切换单列布局，折叠侧边栏后仍可完整展开。
- 从目录直接打开终端 — 项目文件夹与改动面板目录支持一键在嵌入式终端打开；附加目录根及其子目录也提供终端入口，并以对应目录作为工作目录打开；Agent 运行时复用可见终端，减少无谓的终端堆积。
- 更新提醒增强 — 更新下载过期后自动刷新，并按期重复提醒用户处理更新。
- 适配 GLM-5.3-Flash 推理深度 — 模型注册与渠道管理中适配 GLM-5.3-Flash 的推理深度档位，上下文窗口计算与 reasoning profile 同步更新，设置页渠道表单可选对应深度。
Bug 修复
- 修复无关文件预览被刷新 — 预览只针对目标文件刷新，隔离刷新边界并跟踪解析后的预览路径，避免查看一个文件时其它预览被连带刷新。
- 恢复 Git diff 汇总统计 — 改动面板恢复 Git diff 的汇总统计信息，变更概览不再丢失。
- 修复折叠侧边栏的会话访问 — 侧边栏折叠为窄栏时优先保留会话入口与工具状态提示，折叠后仍能快速回到会话。
- 保持目录状态与滚动位置 — 文件目录的展开/折叠状态与滚动位置跨切换保持，不再每次回到根目录。
- 修复终端光标跳动与输出裁剪 — 终端输出不再出现光标跳位或被裁剪，长输出展示更稳定。
- Agent 流路由跨运行交接保留 — Agent 运行交接时保留流路由，后台刷新与终态事件不再错乱。
- 允许用户关闭 Agent 浏览器标签 — Agent 打开的浏览器标签支持手动关闭，不再只能等 Agent 自己清理。
- 受管浏览器 favicon 渲染 — 受管浏览器标签页正确渲染站点 favicon。
- 禁用系统刷新快捷键 — 屏蔽系统级刷新快捷键，避免误触打断当前操作。
- 修复设置返回悬停布局偏移 — 设置页返回按钮悬停不再引起布局跳动。
- 修复窄右侧面板缩放 — 窄右栏折叠/展开时面板尺寸与单列布局稳定，不再异常挤压。
- 改动页不再自动跳转 — 移除改动页自动跳转行为，保留变更数据刷新与未读指示，避免后台变更打断当前操作。
- Skills 面板 prompt 立即同步 — 设置项改动后设置 prompt 立即填入当前会话，不再需要刷新。
- MCP 配置写入安全加固 — 完整配置写入、显式禁用、OAuth 代理、凭证绑定端点等环节补齐校验；远程 transport 统一走应用代理并安全释放，防止挂起与误启。
- 连接目录顺序与条目修正 — MCP 连接目录按优先级稳定排序，移除 Playwright 等无效条目。
- 委派结果强制收敛 — 协作子 Agent 必须收敛结果后才能继续主线，防止把未完成的任务当作已交付。

Proma v0.18.2 更新
新功能
- 统一 Agent 右侧工作区 — 文件、改动、预览、项目记忆、聊天与浏览器现在统一收进右侧标签栏；切换时保留浏览器页面状态，支持动态关闭标签与快捷键切换，任务上下文不再因查看不同内容而中断。
- 可见的 Agent 终端 — Agent 可在右侧工作区打开专属终端标签；命令执行过程对用户可见、可中断，终端与每个 Agent 会话隔离。工作目录缺失时会安全回退，同时继续严格校验 Agent 可访问的路径。
- 浏览器原子操作能力 — 内嵌浏览器新增点击并等待、固定 DOM 操作、区域文本提取、表单填写、选择与滚动等原子工具；Agent 能更可靠地完成站内交互，并对提取内容设置长度边界，降低动态页面操作失败和上下文膨胀的概率。
- 探索会话标签 — 支持将对话中的历史片段作为独立探索会话打开，在不离开当前任务的前提下回看与追溯上下文；读取范围按需限制，避免长会话加载拖慢主界面。
- 改动面板目录树 — 工作区改动以目录优先的层级树呈现，连续单层目录自动压缩；支持折叠、搜索时自动展开、未查看提示与键盘打开，复杂项目中的文件变化更易定位。
- 归档会话按项目分组 — 侧边栏中的归档会话按所属项目归类，历史工作不再混杂，回到特定项目继续任务更直接。
- 宽侧栏双文件来源 — 在更宽的侧栏布局中可同时查看工作区文件与 Agent 可访问文件来源，并可分别搜索，更快找到需要查看或引用的内容。
- 精简 Worktree 操作流 — 右侧工作区内的 Worktree 选择与相关操作整合进统一标签工作流，切换项目上下文与查看改动更加连贯。
- Windows 顶栏控件统一 — Windows 各主要页面统一使用系统化的窗口标题栏控制，视觉与交互保持一致，并减少标题栏的模糊渲染开销。
- 输入工具栏与模型选择器优化 — 统一输入工具栏控件尺寸，重新梳理渠道与模型的栅格、图标、选中态与键盘焦点反馈，模型选择更清晰、操作更稳定。
Bug 修复
- 右侧工作区切换更稳定 — 修复关闭标签后无法回到上一标签、活动标签偶尔不可见、标签宽度跳动、空白标签残留，以及不同 Agent 会话间标签状态串扰的问题；浏览器、预览与文件面板在弹层打开、会话切换或重新打开后都能保持正确显示。
- 会话状态与协作进度同步 — 恢复运行中会话的状态指示，避免陈旧快照覆盖新状态；委派子 Agent 的进度会及时同步到父会话，停止快捷键也只会中断当前聚焦的会话。
- 浏览器与文件预览联动修复 — 从 Agent 消息打开链接会直接进入浏览器；历史链接不再额外生成空白标签。打开文件预览时可正确覆盖浏览器并恢复侧栏，无法预览的文件会展示元数据而非空白界面。
- 规划与待办交互优化 — 调整待办页标题和响应式布局；单项完成采用增量更新，不再整页重载或闪现删除线；创建后自动关闭对话框，并压缩新建入口占用空间。
- 记忆变更只显示有效内容 — 仅展示 Agent 实际捕获的记忆更新，并以 diff 形式呈现，减少无关或难以辨识的记忆提示。
- 引用与中文 MCP 名称兼容 — 修复 mention 标签紧贴文字时的边界解析，并确保中文 MCP 名称可以正确被识别与引用。
- 附件、模型选择与会话上下文可靠性 — 修复 Markdown 附件粘贴流程、嵌入式模型选择器状态互相影响、删除会话后 Agent 上下文丢失等问题；用户主动选定的前台会话与工作区标签也能持续保持焦点。
- 开发态启动与跨平台项目指令修复 — Electron 开发态仅监听必要构建产物，并在首次 bundle 就绪后启动，避免重复重载、旧产物误用和签名受扩展属性阻断；Windows 下项目 AGENTS.md / 指令清单的大小写、软链接与缺失路径解析也更加可靠。
- 启动页信息精简 — 移除静态与 React 兜底启动页重复的副标题，保留关键加载状态与本地优先标识，启动过程更简洁。

Proma v0.18.1 更新
新功能
- 统一 Agent 右侧工作区 — 文件、改动、预览、项目记忆、聊天与浏览器现在统一收进右侧标签栏；切换时保留浏览器页面状态，支持动态关闭标签与快捷键切换，任务上下文不再因查看不同内容而中断。
- 可见的 Agent 终端 — Agent 可在右侧工作区打开专属终端标签；命令执行过程对用户可见、可中断，终端与每个 Agent 会话隔离。工作目录缺失时会安全回退，同时继续严格校验 Agent 可访问的路径。
- 浏览器原子操作能力 — 内嵌浏览器新增点击并等待、固定 DOM 操作、区域文本提取、表单填写、选择与滚动等原子工具；Agent 能更可靠地完成站内交互，并对提取内容设置长度边界，降低动态页面操作失败和上下文膨胀的概率。
- 探索会话标签 — 支持将对话中的历史片段作为独立探索会话打开，在不离开当前任务的前提下回看与追溯上下文；读取范围按需限制，避免长会话加载拖慢主界面。
- 改动面板目录树 — 工作区改动以目录优先的层级树呈现，连续单层目录自动压缩；支持折叠、搜索时自动展开、未查看提示与键盘打开，复杂项目中的文件变化更易定位。
- 归档会话按项目分组 — 侧边栏中的归档会话按所属项目归类，历史工作不再混杂，回到特定项目继续任务更直接。
- 宽侧栏双文件来源 — 在更宽的侧栏布局中可同时查看工作区文件与 Agent 可访问文件来源，并可分别搜索，更快找到需要查看或引用的内容。
- 精简 Worktree 操作流 — 右侧工作区内的 Worktree 选择与相关操作整合进统一标签工作流，切换项目上下文与查看改动更加连贯。
- Windows 顶栏控件统一 — Windows 各主要页面统一使用系统化的窗口标题栏控制，视觉与交互保持一致，并减少标题栏的模糊渲染开销。
- 输入工具栏与模型选择器优化 — 统一输入工具栏控件尺寸，重新梳理渠道与模型的栅格、图标、选中态与键盘焦点反馈，模型选择更清晰、操作更稳定。
Bug 修复
- 右侧工作区切换更稳定 — 修复关闭标签后无法回到上一标签、活动标签偶尔不可见、标签宽度跳动、空白标签残留，以及不同 Agent 会话间标签状态串扰的问题；浏览器、预览与文件面板在弹层打开、会话切换或重新打开后都能保持正确显示。
- 会话状态与协作进度同步 — 恢复运行中会话的状态指示，避免陈旧快照覆盖新状态；委派子 Agent 的进度会及时同步到父会话，停止快捷键也只会中断当前聚焦的会话。
- 浏览器与文件预览联动修复 — 从 Agent 消息打开链接会直接进入浏览器；历史链接不再额外生成空白标签。打开文件预览时可正确覆盖浏览器并恢复侧栏，无法预览的文件会展示元数据而非空白界面。
- 规划与待办交互优化 — 调整待办页标题和响应式布局；单项完成采用增量更新，不再整页重载或闪现删除线；创建后自动关闭对话框，并压缩新建入口占用空间。
- 记忆变更只显示有效内容 — 仅展示 Agent 实际捕获的记忆更新，并以 diff 形式呈现，减少无关或难以辨识的记忆提示。
- 引用与中文 MCP 名称兼容 — 修复 mention 标签紧贴文字时的边界解析，并确保中文 MCP 名称可以正确被识别与引用。
- 附件、模型选择与会话上下文可靠性 — 修复 Markdown 附件粘贴流程、嵌入式模型选择器状态互相影响、删除会话后 Agent 上下文丢失等问题；用户主动选定的前台会话与工作区标签也能持续保持焦点。
- 开发态启动与跨平台项目指令修复 — Electron 开发态仅监听必要构建产物，并在首次 bundle 就绪后启动，避免重复重载、旧产物误用和签名受扩展属性阻断；Windows 下项目 AGENTS.md / 指令清单的大小写、软链接与缺失路径解析也更加可靠。
- 启动页信息精简 — 移除静态与 React 兜底启动页重复的副标题，保留关键加载状态与本地优先标识，启动过程更简洁。

Proma v0.17.59 更新
新功能
- 改动面板过滤 dotfile 目录变更 — 工作区改动面板在扫描 Git 变更与未跟踪文件时，过滤掉以点开头的目录（如 .git、.idea 等）及其内部文件，避免无关的 dotfile 目录变化刷屏，让面板更聚焦实际的代码改动。
- 改动面板展示记忆更新 — 在工作区 Git 改动列表底部新增记忆变更停靠区，协同 Agent 产出的 memory/ 更新会单独汇总展示，与普通文件变更一起查看，不再混在文件列表里。
Bug 修复
- DeepSeek Flash Exp 视觉路由修复 — 补齐视觉中继的模型路由判断：DeepSeek Flash 实验视觉模型尚未进入 Pi 目录时，不再被 catalog 分流逻辑误判，直接按渠道协议走视觉中继，避免返回路径错误。
- Agent 消息原子提交，避免瞬态失败 — 消息发送改为「判断活跃即注入、否则转入队列」的单一入口。Pi runtime 结束 query、渲染进程还没收到终态事件的窗口里注入会被拒绝，这类「会话未运行」的瞬时错误现在安全降级到队列，不再向用户暴露为发送失败。
- 首次使用引导到模型选择器 — 未选模型但已有可用模型时，提示文案与按钮改为引导打开模型选择器（而非直接进设置），新用户能更快开始对话；只有确实无可用模型时才引导去设置启用渠道。
- 停止时终止全部待恢复的运行 — 结束 Agent 时显式关闭旧的迭代器，确保同一会话不会残留多个运行时；同时旧运行的迟到错误不再向新运行泄漏终态，停止也能覆盖「正在启动」的窗口。
- 后台化后仍能持续刷流 — 为 Agent 流事件批处理增加定时器兜底。requestAnimationFrame 被后台节流暂停时，后台窗口仍能周期性收到可见增量，避免窗口转后台后流停滞。
- 消除冗余的工具同步提示 — 自定义工具配置变更时静默刷新工具列表，不再每次都弹出「Chat 工具已更新」提示；操作反馈由各设置入口负责，避免重复打扰。

Proma v0.17.55 更新
新功能
- DeepSeek V4 Flash 原生视觉 — 新增 deepseek-v4-flash-vision-exp 模型候选，并让 deepseek-v4-flash 在本地目录声明前即被识别为支持图片输入；DeepSeek 渠道开启视觉模型后可直接发送图片，不再因上游目录缺失而误判为不支持，实际模型 ID、协议与推理参数保持不变。
- UISFX 通知音效库 — 引入 CC0 的 UISFX 音效与插图资产，提供紧凑的场景化音效选择、语义化通知提示音，并兼容旧的音效 ID；新配置不受影响，旧配置可平滑迁移，来源已注明署名。
- 协作委派等待时间延长 — 协作子会话默认等待时间从 30 分钟提升至 60 分钟，最大等待上限提升至 2 小时，长耗时的并行探索或审查任务不再因默认超时被过早打断。
- 浏览器 Google 超时自动回退 Bing — 默认 Google 新标签页或搜索页在 3 秒内未完成加载时，自动停止旧导航并在同一标签页切换 Bing；国内网络环境下搜索入口不再长时间卡在空白等待。
- 通义千问改用 OpenAI 兼容端点 — 默认 DashScope Anthropic 兼容端点的通义千问渠道自动迁移到 OpenAI 兼容端点，配置版本升级至 v5；自定义 Anthropic 端点不自动迁移，避免改变用户明确配置的请求协议。
- Agent 进度更新引导增强 — 优化 Agent 提示词中的进度更新引导，让长任务运行时更频繁、更清晰地向用户汇报可感知的阶段进展。
Bug 修复
- OpenCode 渠道按模型目录协议路由 — 同一 OpenCode Go 渠道可能提供多种协议，现在以模型目录声明为准选择请求协议，未命中目录时保留历史 OpenAI Chat Completions 默认值，避免推理档位与请求协议不匹配。
- 飞书支持 Lark 国际域名 — 每个飞书机器人可选择飞书 / Lark 域名，WebSocket、REST 与连接测试保持一致；二维码注册时可自动识别域名，存量国内飞书配置保持默认不变。
- 火山方舟 Coding Plan 模型清单修正 — Coding Plan 的 /models 返回方舟通用目录、不等同于套餐授权，改用套餐支持清单（含 Doubao Seed 2.1 Turbo、GLM-5.3、DeepSeek V4 系列等）作为渠道模型列表，不再把未授权模型当成可用项。
- AskUserQuestion 等待更从容 — 仅针对 AskUserQuestion 这类用户主导的自由文本交互，把跨进程等待时间从 2 分钟延长到 15 分钟，其他能力调用的故障检测保持原样，用户可从容输入而不被中断。
- 关闭 MCP 编辑器后刷新测试状态 — 关闭 MCP 服务配置编辑器后自动刷新测试状态，不再停留在旧的连接结果。
- 浏览器允许内部 HTTPS 证书 — 受管浏览器放行内部自签名 HTTPS 证书，访问内网服务时不再被证书校验拦截。
- 编辑器返回后恢复自动化列表 — 从自动化表单返回侧边栏时恢复定时任务列表的显示状态，不再出现列表丢失或闪烁。
- 恢复屏幕外窗口边界 — 主窗口与计划窗口在恢复到已不可见的屏幕外边界时自动归一化到当前工作区，避免窗口被移出屏幕外后无法找回。
- 保留 Claude 自适应思考 — 重新注册非 OAuth 渠道为临时 Pi 提供方时，仅保留协议安全的 forceAdaptiveThinking 标记，当前 Claude 模型继续使用自适应思考，同时不泄露其他协议无关的工具 / 采样行为。
- 移除会话工作区不匹配拒绝 — 不再因会话归属的工作区与请求不一致而拒绝请求，改为保留启动槽位与工作区所有权，避免会话迁移改变已接受请求的项目归属；飞书镜像卡片等外部触发场景下请求更稳定。

Proma v0.17.46 更新
新功能
- 受管浏览器可最小化、后台会话自动回收 — 浏览器新增最小化操作，保留页面与标签状态随时恢复（关闭仍为真正销毁）；全局最多保留 8 个后台浏览器 session，按 LRU 自动回收最久未使用的，前台或正在操作的 session 不会被回收，浏览器面板与主界面切换更从容。
- 受管浏览器地址栏支持直接搜索 — 地址栏输入普通文本时自动转为 Google 搜索，明确 URL 与可识别主机名仍保持直达；已确认风险提示后打开浏览器默认进入搜索页，不再面对空白页。
- 火山方舟渠道更新与自动迁移 — 内置渠道重命名：火山方舟 Coding Plan → 火山方舟 Agent Plan、豆包 → 火山方舟 Coding Plan、豆包 API → 火山引擎 API，并新增独立豆包 API 渠道类型；预设模型移除 GLM-5.2，保留 GLM-5.3 与 Doubao Seed 2.0 系列；升级后旧配置自动迁移，用户自定义名称不受影响。
- 通义千问渠道合并为单一入口 — qwen 与 qwen-anthropic 合并为「通义千问」，默认走 Anthropic 协议；旧 OpenAI 协议渠道标记为「通义千问 (OpenAI 协议 · 旧版)」，存量渠道继续工作、编辑时仍可选，新建渠道不再出现重复入口。
- Kimi API 渠道简化 — 渠道名从「Kimi API (Anthropic 协议)」简化为「Kimi API」，预设模型 ID 由 k3 统一为 kimi-k3。
Bug 修复
- 停止卡住的 Agent 更可靠 — 停止生成后若底层运行迟迟未退出，会再次下发中断请求，超时后强制关闭卡住的运行时并给出提示，停止按钮不再一次点击后就失效，Agent 不再无限转圈。
- 自动任务参数桥接修复 — 修复部分模型渠道创建/编辑定时任务时可选参数被物化导致校验失败的问题：桥接层按调度类型自动清理不适用字段，maxRuns=0 视为不限次数，定时任务创建更稳定。
- 上下文整理完成态修正 — 仅当主 Agent 已成功结束且无需自动续跑时才将上下文整理阶段显示为 completed；运行中压缩、CompactContext 续跑与异常结束保持 running，状态不再误报。
- 流式输出与思考块渲染优化 — 流式最终输出脱离过程区，降低布局压力；思考块流式显示更平滑，不再生硬跳变。
- 上下文压缩后保持会话时长 — 上下文整理后会话运行时长不再被重置，统计保持准确。
- GLM-5.3 推理档位修复 — 恢复 GLM-5.3 的低/高/最大推理强度选项，保持始终推理与 1M 上下文注册，各传输渠道行为一致。
- 输入框 Markdown 切换不丢内容 — 切换 Markdown / 富文本模式时保留草稿与编辑器状态，快捷键改用当前编辑器实例，不再因旧实例被销毁而失效。
- 工作区文件变更归属修复 — 防止跨会话的文件变更被错误归属到当前会话；忽略 Python 环境与缓存目录，不影响通用构建产物与覆盖率输出。
- 受管浏览器面板精简 — 移除冗余的 Agent 活动状态栏，保留浏览器控制与操作反馈，面板更清爽。

Proma v0.17.42 更新
新功能
- 系统性能大幅提升 — 本次更新的核心：对 Agent 渲染、流式输出与长会话状态管理做系统性优化，长时间使用、长会话与多会话并行时整体明显更流畅。流式输出不再每帧全量重新解析 Markdown，改为分块记忆化渲染，代码高亮结果按语言缓存复用、流式期间跳过语言自动检测，避免拖垮渲染主线程；定位并修复长会话累积性卡顿（单 Agent 运行 20 分钟后输入按键排队延迟从 38ms 升到 185ms 的问题已解决）：批量复制 delta、索引解析缓存、后台会话运行态回收、消息批量追写、按会话直读流式状态等多处高成本路径被重写；多会话同时流式输出时后台流自动降级、输入区与用量更新完全隔离，不再互相抢占；侧栏归档会话改为懒加载、浏览器与面板渲染抖动降低、窗口后台节流恢复——会话越多、运行越久，提升越明显。
- Pi 运行时升级并迁移至独立进程 — Agent 运行时升级至 Pi 0.84.2 并托管到独立 Electron 工具进程（命名为 Proma Runtime），与主界面隔离，可在系统监控中清晰识别与诊断；Agent 运行更稳定，单点故障不会拖垮整个应用。
- 新增 GLM-5.3 与 Doubao Seed 2.1 模型预设 — 智谱 API、OpenCode Go 与火山方舟 Coding Plan 渠道新增 GLM-5.3 预设（1M 上下文、官方 thinking 开关，Anthropic / OpenAI 双协议正确发送）；火山方舟 Coding Plan 同步补齐 Doubao Seed 2.1 Pro / Turbo（256K 上下文）。
- 受管浏览器跨标签跟随并可关闭 — 浏览器可跨标签持续追踪 Agent 的操作进度，切换标签不丢上下文；Agent 可主动关闭受管浏览器（需要用户批准），不再强制常驻。
- 会话切换动画与流式输出平滑 — 切换 Agent 会话与历史记录带轻量过渡动画（遵循系统"减少动态效果"设置），标签切换延迟已移除、实时消息立即呈现；流式输出跟随更稳定，工具结果保持实时。
- 规划工作流精简与提示词澄清恢复 — Todo 规划流程更顺畅，恢复 prompt-clarifier 等 Skills，需求模糊时自动引导澄清，减少来回返工。
Bug 修复
- 渲染进程崩溃可自动恢复 — 主界面渲染进程崩溃后会自动重启并恢复，恢复失败时提供带崩溃诊断信息的兜底页面，不再白屏卡死。
- 会话标题自动重命名修复 — 修复标题自动重命名失败的问题；自定义渠道标题生成失败时回退到兜底重命名，不再出现空标题或失败提示。
- Agent 工具调用显示完善 — 工具调用行与描述对齐、隐藏冗余标签，Read 摘要更紧凑，工具控件布局更稳定。
- 历史模型身份与消息通道保持正确 — 流式输出、空响应与错误消息都会保留运行时渠道身份，历史会话中同名模型、重复模型 ID 的别名与提供商解析不再串线。
- Agent 运行稳定性修复 — 等待 AskUserQuestion 用户回复再继续、排队消息状态稳定、语音输入重启前正确重置生命周期、文件面板状态与会话隔离、窗口后台节流恢复。
- 浏览器导航与面板体验修复 — 允许私网地址导航与下载请求，修复会话切换时残留陈旧视图、面板渲染抖动与滚动条宽度失调。
- 消息渲染与交互细节修复 — 修复发送消息时屏幕闪烁、思考块闪烁、空思考块过早渲染、历史引用弹窗抖动、输入框焦点被抢、后台标签重复排队用户消息、委派子会话消息与侧栏重复、刷新后消息未显示、侧边栏 tooltip 不自动消失、固定会话图标误显示等问题。

Proma v0.17.26 更新
新功能
- Agent 链接在受管浏览器中直接打开 — Agent 回复中的网页链接现在可直接交给内置受管浏览器打开，无需跳出 Proma；不同 Agent 会话的浏览器标签保持隔离，便于在同一工作流中继续浏览、搜索与操作页面。
- 定时任务支持工作日与每日执行窗口 — 固定间隔任务可设置仅在工作日、周末或自定义星期运行，并限定每天的有效时段；日历会同步展示任务的实际活跃窗口，例行检查、工作时段自动化等场景更易配置与核对。
- 会话搜索支持更准确的模糊匹配 — 搜索会规范处理中英文标点、大小写与常见分隔符，并支持连续片段及轻微输入误差；结果按匹配质量排序、优先展示用户消息，查找历史对话更快更准。
- Windows Agent 状态通知与托盘交互 — Windows 现可在 Agent 完成、报错或需要权限/计划审批时通过系统通知和托盘状态提醒；悬浮托盘图标可查看会话详情，重要待处理状态更容易被发现。
- 新增 Qwen3.7 Flash 渠道预设 — 渠道设置中可直接选择 Qwen3.7 Flash，减少手动填写模型标识的步骤。
Bug 修复
- 受管浏览器导航与下载体验完善 — 浏览器现在可正常处理页面打开的 popup 与下载请求，避免被错误拦截；同时修复受限 URL 导航、迟到的旧标签导航事件，以及方向键、翻页键等无法触发页面默认滚动的问题。
- 语音输入初始化更稳定 — 修复首次授权麦克风后录音捕获状态未正确恢复的问题；语音听写会等待捕获链路就绪再进入可用状态，减少点击后无响应或过早开始的情况。
- Agent 输入与消息队列体验优化 — 修复输入框被其他界面更新抢走焦点、长草稿输入卡顿的问题；排队消息会在后台正确派发，旧的排队运行和上下文压缩前的过程消息会收起，界面更简洁且减少无意义提醒。
- 长会话渲染性能提升 — 减少输入区、历史选择层、滚动定位和流式消息转发的重复渲染与扫描；会话内容较多、持续输出或频繁切换历史消息时更流畅。
- 定时任务调度更新校验 — 修复切换调度类型或更新时残留不兼容字段的问题，补齐空执行日、间隔默认值与时间窗口边界校验，避免任务保存后以错误配置运行。
- Markdown 编辑与渲染修复 — 富文本差异编辑器会继续预览 Mermaid 图表，同时保留专用源码编辑方式；修复标签式加粗标记的渲染异常。
- 跨平台与界面细节修复 — 修复 Windows Ctrl+B 与侧边栏快捷键冲突、macOS Agent 灵动岛空闲展开时无法收起或关闭、浏览器文件面板折叠时出现多余提示等问题。
- 模型、技能与存储稳定性修复 — 修复 OpenCode Go Vision Relay 模型路由、Qwen/浏览器/自动更新相关回归，以及切换 Skills 时列表抖动；默认不再自动清理孤立数据，降低误删本地数据的风险。

Proma v0.17.16 更新
新功能
- 浏览器支持打开本机开发服务 — BrowserNavigate 与 BrowserNewTab 现在允许 localhost、127.0.0.1、::1 及 *.localhost 等本机 loopback 地址，本地开发中的页面可直接在受管浏览器中打开与调试；局域网和其他私网地址仍保持隔离，本地 HTML 预览依旧推荐使用 BrowserPreviewOpen。
- 网络搜索不足时自动回退浏览器 — 内置 WebSearch 不可用、搜索失败或结果为空、或结果质量/完整性/时效不足时，Agent 会改用受管浏览器继续检索与核验，公开信息查找不再因单一搜索链路失败而中断。
- 侧边栏会话列表虚拟化 — 会话数量较多时，左侧栏仅挂载视口附近的行，滚动更流畅，右键菜单、悬浮提示等交互树不再随会话数线性膨胀；选中项自动滚动定位与快捷切换提示行为保持不变。
Bug 修复
- 灵动岛已查看错误自动退出 — 查看过错误详情后，灵动岛不再保留该会话的「需关注」状态；待接手会话（权限确认、计划审批等）仍持续提醒，直到实际处理完成。
- 浏览器截图内容校验 — 对浏览器截图与 MCP 返回的图片内容增加有效性校验，无效图片不会进入会话上下文，避免损坏的截图干扰后续对话。
- 多会话浏览器视图隔离 — 多个 Agent 会话并行使用浏览器时，原生浏览器视图不再互相抢占覆盖；迟到的旧布局请求会被拒绝，每个会话看到的是自己的页面。
- Windows 浏览器面板按钮对齐 — 修复浏览器面板关闭按钮被 Windows 窗口控制按钮覆盖的问题。

Proma v0.17.15 更新
新功能
- 受管内嵌浏览器自动化 — Agent 现在可以直接操作内置浏览器：打开网页、观察页面结构、点击/填写控件、切换多个标签页，并可对预览中的本地 HTML 页面做真实浏览器验证；配套新增 in-app-browser 内置技能，将网页操作（站内搜索、登录后页面、动态内容）标准化，无需用户手动复制粘贴。
- HTML 文件默认渲染 — 差异与预览标签页中的 HTML 文件默认以网页形式渲染，而不是直接展示源码；本地网页预览更直观，同时保留代码视图的切换入口。
- 历史消息选区引用 — 在会话历史中选中一段消息即可引用：输入框以 chip 展示引用内容，正文中渲染为引用样式，点击引用可跳回原文位置并高亮，回顾与追问上下文更顺手。
- turn 级 Skill 使用记录 — 每次对话轮次调用了哪些 Skill 现在都有迹可循，记录可随会话迁移并预览，Agent 行为更透明。
- 设备数据迁移简化 — 移除自定义迁移包流程，改为引导式 .proma 归档 + Agent 辅助恢复路径：换机时只需导出归档，由 Agent 引导完成数据恢复，流程大幅简化。
- 会话列表可读性改进 — 侧边栏会话列表重新布局，会话标题、时间与状态信息层级更清晰，长列表浏览更省力。
- 活动 worktree 持久化 — Agent 会话关联的活动 worktree 会随会话持久保存，切换会话或重启应用后无需重新指定，多仓库协作更连贯。
- 工作区记忆保留时间上下文 — 工作区记忆维护时自动保留事实/状态的发生时间与截止时间上下文，后续 Agent 判断历史信息时不再把旧状态当现状。
Bug 修复
- 草稿 Tab 滚动位置恢复 — 切换 Tab 后草稿（Scratch Pad）恢复之前的滚动位置，不再跳回顶部；切换到其他 Tab 时自动收起草稿分栏，布局更干净。
- 内嵌浏览器导航与用户上下文 — 改进浏览器导航与 Agent 用户上下文：页面导航更准确，Agent 对当前页面的理解更完整。
- 浏览器标签页处理 — 本地预览协议注册为独立浏览器会话；保留 Agent 创建的标签页标题、正确激活 Agent 选中的标签页；会话超过 20 个标签页时自动回收陈旧的 Agent 标签页，避免无限制膨胀。
- 防止重复 resume 消息 — Agent 恢复会话时不再重复发送 resume 消息，避免消息队列出现重复记录。
- Git diff 未跟踪文件行数 — 变更列表正确统计未跟踪（untracked）文件的行数，差异统计不再漏算新文件。
- 生成文件改动显示 — Agent 生成的文件的改动现在会出现在文件变更列表中，并完善文件变更归属与附件监听，后台会话不再误报或漏报附件改动。
- 目录条目消失容错 — 文件目录读取时条目中途消失不再导致整个列表失败，目录浏览更稳健。
- 文件预览崩溃防护 — 不支持的文件类型预览不再导致应用崩溃，新增预览错误边界统一兜底；同时保留超长剪贴板附件内容，不再截断。
- MCP HTTP 会话恢复 — 过期的 MCP HTTP 会话会自动恢复，长时间运行后工具调用不再因会话过期而失败。
- 多仓库 worktree 选择器修复 — 多个仓库目录并存时，worktree 选择器能正确匹配与展示，不再选错仓库。
- Windows Tab 栏操作区位置修复 — Windows 下 Tab 栏操作区位置正确，窗口控制按钮不再错位。
- @ 提及异步启动支持 — 输入框与文件浏览器的 @ 提及在 TipTap 异步初始化时也能正常弹出建议。
- 委派会话不再打扰灵动岛 — 委派（delegated）子会话不再出现在 Agent 灵动岛的事件流中，主会话运行状态更干净。

Proma v0.17.1 更新
新功能
- Agent 运行时全面迁移至 Pi-only — Agent 能力改由 Proma 内置 Pi 运行时承载，不再依赖第三方 Agent 运行时，安装包更轻、启动更快、跨平台行为一致；同时移除已接入的 Nowledge Mem 集成与自动本地召回，记忆能力收敛为本地工作区记忆，数据更可控。
- 受信项目指令管理 — 项目可通过 AGENTS.md 管理交给 Agent 的稳定指令，Proma 按作用域解析并自动激活受信的项目指令；旧的 CLAUDE.md 工作区指令自动迁移到 AGENTS.md，历史配置无需手动整理。
- 工作区记忆维护升级 — 重构工作区知识维护流程：新增记忆变更追踪与刷新服务，Agent 写入记忆后界面出现更新提示，保持记忆索引同步；knowledge-maintenance 技能新增自组织维护指引，自动识别超载与错位的主题并建议重组；工作区记忆页同步简化，重点信息更聚焦。
- Windows shell 可选 — Windows 上不再强制预装命令行 Shell，首次配置更轻量；需要时可按引导安装，环境检查面板也会给出更明确的状态提示。
- 上下文压缩二次确认 — 手动压缩按钮改为「点击两次确认」触发：第一次点击进入确认态（按钮变警示色、提示「再次点击确认压缩」），再次点击才真正压缩；3 秒无操作自动重置，与界面归档的二次确认模式保持一致，避免误触清空上下文。
Bug 修复
- Agent 灵动岛运行体验修复 — 运行中的会话状态在灵动岛中优先显示，不会被其他会话事件抢占；修复运行中关闭灵动岛后又被流式事件立刻重新弹出的问题：正在运行的会话改用稳定的会话指纹决定是否重新唤醒，只有状态切换（需要交互 / 出错 / 完成）或新会话才重新弹出。
- 队列消息后台发送 — 运行中发送的消息进入队列后会在后台继续发送，不再静默等待运行结束；排队时新增 toast 提示与「立即打断」发送入口，发送状态一目了然。
- Agent 可访问会话附件之外的文件 — 文件浏览器与差异查看中打开的文件现在也能直接交给 Agent 处理，不再局限于会话内附件。
- 代理设置生效于网络搜索与 Chrome MCP — 系统代理设置现在同样应用到 Tavily 网络搜索与 Chrome DevTools MCP，并优化启动逻辑避免代理与 MCP 初始化互相阻塞。
- 预览标签页文件面板快捷键修复 — 修复预览标签页中「切换文件面板」快捷键不生效的问题。
- 引用历史后输入框失焦修复 — 从历史记录引用条目后，输入焦点正确回到对话输入框。
- Git 变更面板扫描优化 — 统一仓库扫描缓存与一致性基准，避免重复扫描造成的卡顿；会话文件状态标记（新增 / 修改 / 删除）在差异列表中显示一致。
- 模型选择器加宽 — Agent 输入框的模型选择器加宽，长模型名不再被截断。

Proma v0.17.0 更新
新功能
- Agent 运行时全面迁移至 Pi-only — Agent 能力改由 Proma 内置 Pi 运行时承载，不再依赖第三方 Agent 运行时，安装包更轻、启动更快、跨平台行为一致；同时移除已接入的 Nowledge Mem 集成与自动本地召回，记忆能力收敛为本地工作区记忆，数据更可控。
- 受信项目指令管理 — 项目可通过 AGENTS.md 管理交给 Agent 的稳定指令，Proma 按作用域解析并自动激活受信的项目指令；旧的 CLAUDE.md 工作区指令自动迁移到 AGENTS.md，历史配置无需手动整理。
- 工作区记忆维护升级 — 重构工作区知识维护流程：新增记忆变更追踪与刷新服务，Agent 写入记忆后界面出现更新提示，保持记忆索引同步；knowledge-maintenance 技能新增自组织维护指引，自动识别超载与错位的主题并建议重组；工作区记忆页同步简化，重点信息更聚焦。
- Windows shell 可选 — Windows 上不再强制预装命令行 Shell，首次配置更轻量；需要时可按引导安装，环境检查面板也会给出更明确的状态提示。
- 上下文压缩二次确认 — 手动压缩按钮改为「点击两次确认」触发：第一次点击进入确认态（按钮变警示色、提示「再次点击确认压缩」），再次点击才真正压缩；3 秒无操作自动重置，与界面归档的二次确认模式保持一致，避免误触清空上下文。
Bug 修复
- Agent 灵动岛运行体验修复 — 运行中的会话状态在灵动岛中优先显示，不会被其他会话事件抢占；修复运行中关闭灵动岛后又被流式事件立刻重新弹出的问题：正在运行的会话改用稳定的会话指纹决定是否重新唤醒，只有状态切换（需要交互 / 出错 / 完成）或新会话才重新弹出。
- 队列消息后台发送 — 运行中发送的消息进入队列后会在后台继续发送，不再静默等待运行结束；排队时新增 toast 提示与「立即打断」发送入口，发送状态一目了然。
- Agent 可访问会话附件之外的文件 — 文件浏览器与差异查看中打开的文件现在也能直接交给 Agent 处理，不再局限于会话内附件。
- 代理设置生效于网络搜索与 Chrome MCP — 系统代理设置现在同样应用到 Tavily 网络搜索与 Chrome DevTools MCP，并优化启动逻辑避免代理与 MCP 初始化互相阻塞。
- 预览标签页文件面板快捷键修复 — 修复预览标签页中「切换文件面板」快捷键不生效的问题。
- 引用历史后输入框失焦修复 — 从历史记录引用条目后，输入焦点正确回到对话输入框。
- Git 变更面板扫描优化 — 统一仓库扫描缓存与一致性基准，避免重复扫描造成的卡顿；会话文件状态标记（新增 / 修改 / 删除）在差异列表中显示一致。
- 模型选择器加宽 — Agent 输入框的模型选择器加宽，长模型名不再被截断。

Proma v0.16.10 更新
新功能
- macOS 日历（EventKit）双向同步 — 规划（Planning）事项可一键同步到 macOS 日历与提醒事项，Proma 中创建、完成或调整的事项会实时反映到系统日历；反向同步外部 EventKit 集合的变更回 Proma，两端保持一致。同步冲突需要明确选择保留哪一侧，外部删除也会安全地回写，保证数据不出错。
- 原生品牌启动闪屏 — 应用启动时显示品牌化原生闪屏，替代原有空白加载期；渲染进程异常时可回退到加载界面，启动过程更连贯、稳定。
- 规划快捷入口 — 通过全局快捷键或系统托盘即可快速创建规划项，无需打开主界面也能随手记录待办；保留本地 fallback，快捷键被占用时依然可用。
- 新手引导可重放 — 设置页新增「重放新手引导」入口，随时可重新观看首次启动的引导流程；首个引导页新增向下滚动提示箭头与「继续向下滚动，查看这一步的真实示例」文字行，新用户不会错过下方内容。
- 侧边栏恢复「新建会话 + 搜索」并排按钮 — 展开态与折叠态都恢复「新建会话 + 搜索」相邻布局，高频操作更快触达；侧边栏分组标题字号统一为 13px，层级更清晰。
- Todo 列表层级可读性增强 — 加重 Todo 页分割线与边框，分组之间更易区分。
Bug 修复
- 长草稿光标跳转修复 — 修复在较长草稿中输入时光标跳转的问题，长文本编辑体验更稳定。
- Git 变更监控刷新循环修复 — 修复 git-diff watcher 的刷新循环，限制远端基线刷新频率并去重共享 worktree 抓取，避免无谓的重复扫描与卡顿。
- Agent 会话列表刷新优化 — 避免 Agent 变更时触发完整会话列表刷新，降低不必要的 UI 更新开销。
- Agent 灵动岛适配完善 — 移除非原生 fallback 渲染表面；修复紧凑布局响应式问题，停止后正确清除运行状态，各平台表现一致。
- DeepSeek V4 Pi 推理力度映射 — 为 DeepSeek V4 Pi 模型正确映射推理力度（reasoning effort）请求参数，设置项与实际请求一致。

Proma v0.16.9 更新
新功能
- 工作区 Skills 批量导入 — 在 Skills 管理页选择来源项目后，可一次勾选多个 Skill 导入当前工作区；导入结果通过 toast 汇总成功、跳过与失败项。重复 Skill 会按既有策略处理，导入过程采用临时目录与原子落盘，避免中途中断留下不完整文件。
- Agent 会话文件变更可见 — 即使项目目录不是 Git 仓库，Agent 在会话中创建或编辑的文件也会显示在「改动」面板；可按本轮与更早轮次查看、打开预览或在文件夹中定位，不再遗漏 Git diff 之外的产物。
- 全新上手引导与 FAQ — 首次启动页升级为沉浸式欢迎界面，并提供 Agent/Chat、项目、文件、Automation、Reference、Side Answer、Subagent 等完整操作引导；新增集中式 FAQ 页面、目录导航和全局 FAQ 弹窗，常见问题可随时查阅。
Bug 修复
- Markdown 编辑状态与滚动位置保留 — 修复保存、切换 Tab 或窗口重新聚焦后，Markdown 编辑器退出编辑态、草稿/光标位置丢失或滚动跳回顶部的问题；自动保存与手动保存会按文件串行处理，避免旧请求覆盖较新的草稿。
- 语音听写输出与取消竞态修复 — 听写开始时固定输出模式和目标输入框，录音期间修改设置不会把文本写到错误位置；修复取消、提交和迟到转写事件相互覆盖的问题。目标输入框已失效时会回退复制到剪贴板并如实提示，同时保留用户已编辑的听写预览。
- 输入框 Mention 误触发修复 — 输入或粘贴 URL、邮箱、文件路径、Markdown 标题、颜色值及 HTML 实体时，不再错误弹出 @、/、#、& 等引用菜单；正常的 Skill、MCP 与文件快捷引用仍可使用。
- 图片 @ 引用支持点击预览 — 输入框内的图片文件引用现在可直接点击打开内置预览，并补充 .ico 图片格式识别。
- Todo 描述保存状态准确显示 — 切换 Todo 后，前一条任务的「保存中…/已保存」提示不再错误显示在新打开的详情中。
- Windows 设置窗口控制按钮恢复可用 — 修复设置页标题栏拖拽区域覆盖最小化、最大化与关闭按钮的问题，Windows 用户可正常恢复和调整窗口大小。
- Agent 灵动岛跨平台行为优化 — macOS 仅在支持的 macOS 26 及以上版本启用灵动岛；Windows 增加独立拖拽手柄、避免操作按钮被误拖动，并正确保存位置和限制在可见工作区内。
- Pi 自动重试提示降噪 — Pi 运行时前 5 次自动恢复不再反复打断界面；若持续失败，最终错误和后续重试状态仍会正常展示。

Proma v0.16.7 更新
新功能
- xAI 订阅（Grok OAuth）渠道 — 新增 xAI 订阅的 OAuth 授权登录，可在渠道设置中直接授权 xAI 账号，接入 Grok 系列模型，Pi 运行时可用。
- 灵动岛收起态显示渠道额度 — Agent 灵动岛收起时直接展示当前活跃渠道的额度摘要；同时启用多个渠道时，标注其余渠道数量，无需展开即可掌握用量情况。
- Windows Agent 灵动岛交互优化 — 优化 Windows 上灵动岛的展开 / 收起与点击交互，并恢复灵动岛的 Todo / 日程提醒展示。
Bug 修复
- Windows 剪贴板复制统一走主进程 — 修复 Windows 上代码块、Mermaid 图、消息等场景复制失败的问题：新增统一复制工具，优先经 Electron 主进程写入系统剪贴板，规避 renderer 剪贴板权限限制。
- Windows 规划窗口操作修复 — 修复 Windows 独立规划窗口标题栏拖拽区域与窗口控制按钮重叠导致的交互异常，窗口拖拽与关闭操作恢复正常。
- 灵动岛已完成状态同步 — 修复"完成但未查看"的标记在会话打开后未正确清除的问题；已读确认只作用于活跃会话，避免误清状态。

Proma v0.16.5 更新
新功能
- 桌面灵动岛（Agent Island） — 常驻顶部的无边框胶囊窗口，实时展示 Agent 运行状态（空闲 / 运行中 / 等待交互 / 已完成 / 出错），并配有与状态一一对应的宠物动画。展开后可以看到 Agent 会话列表、今日 Todo 与日程，权限、提问、计划审批等需要你操作的环节会醒目提示并提供内联按钮；点击日程卡片可直接打开计划窗口。空闲时 Dashboard 保持可见，随时可唤醒。
- 文件 / 文件夹拖拽引用 — 从右侧文件面板或系统（Finder / 资源管理器）直接把文件拖进 Agent 输入框，即自动插入 @文件 引用并跟随对话输入；拖入文件夹则会附加到会话（Agent 可访问）并在输入框显示引用图标。文件面板顶部新增拖拽提示，三点菜单也提供「引用到 Agent」入口。
- 设置界面支持 ESC 退出 — 按 Esc 即可关闭设置窗口，并在界面展示键帽提示，交互更顺手。
- 语音输入流式反馈 — 语音听写时在 Proma 中实时显示正在转写的文字，并在屏幕底部提供外部听写指示器（含音量反馈），转写完成后保留最终插入位置的光标。同时优化听写稳定性：过期启动会被拒绝、停止时保留缓冲音频不丢失、最终提交时机等待 ASR 确认后再触发。
- 更新包空闲自动安装 — 更新下载完成后，会在系统空闲时自动安装，不再需要你停下手中的事手动点安装。
Bug 修复
- 提及菜单 Esc 行为修复 — 按 Esc 关闭后不再被同一触发片段再次弹出；修复 @ 文件弹窗并发竞态导致的「无匹配文件」，并对 /、#、&、~、～ 等全部提及触发符统一加固。
- OpenCode Go 标题生成加固 — 修复推理模型（grok-4.5 / kimi-k3 / deepseek-v4 等）会话长期停在默认标题的问题：标题请求增加 30 秒超时、兼容内容块数组响应、所有失败路径（解密失败、请求异常、空标题）都会回退到本地标题生成。
- Codex OAuth 标题并行生成 — OAuth 渠道的会话标题改为并行生成，避免逐个等待拖慢体验。
- 经典视图 + 深色主题设置面板导航变白 — 修复经典视图下设置面板左侧导航在深色主题中被浅色硬编码覆盖的问题。
- 灵动岛空闲 Dashboard 保持可见 — 修复空闲状态下 Dashboard 偶发消失的问题，并保留全天日程事件的展示。

Proma v0.16.3 更新
新功能
- 文件面板回归双来源视图 — 会话文件与项目文件恢复为独立切换和搜索，避免不同来源混杂，并可分别管理附件。
- Composer 交互回归并完善 — 恢复 @ 文件、& 会话和 ～ 待办/日程的快捷引用；统一附件入口，支持在 macOS、Windows 和 Linux 上选择文件或文件夹。
Bug 修复
- 计划窗口快捷关闭 — 使用 Cmd/Ctrl + W 可正确关闭独立计划窗口。

Proma v0.16.1 更新
新功能
- 待办与日历工作区 — 可以在 Proma 中管理本地待办、日程、分组、标签和提醒，并在需要时让 Agent 直接协助处理。
- 日历视图增强 — 周视图支持更顺畅地切换周次，定时任务会按实际执行计划显示在周历和月历中，悬浮即可查看详情。
- 本地文件夹项目 — 可以直接选择已有本地文件夹作为项目根目录，让 Agent 在原有项目中读写文件，无需导入或复制。
- 统一命令菜单 — 输入 / 可通过菜单调用 Skill、MCP 工具、会话和文件，也可添加文件或文件夹。
- 引用计划项 — 通过 / 菜单搜索并引用待办和日程，让 Agent 结合具体事项提供帮助。
- 从待办启动 Agent — 可以从待办直接发起 Agent 对话，让 Agent 帮你处理该事项。
- 独立计划窗口 — 待办、日程和定时任务可在独立窗口中管理，并可用 Cmd/Ctrl + Shift + T 快速打开。
- 快捷键地图 — 新增快捷键总览，方便查看和记忆常用操作。
- 设置页焕新 — 设置从弹窗调整为独立工作区，浏览和修改配置更清晰。
- 统一文件面板 — 项目文件和会话文件现在在同一处浏览；会话文件可移入项目，供其他会话继续使用。
- 会话悬浮预览 — 可以在设置中开启会话悬浮预览；同时取消 Agent 修改文件后文件树自动跳转，减少操作打断。
- 更清晰的模型与能力提示 — Pi 现在标为推荐内核，Claude 标示即将下线；更多模型可使用统一的推理强度设置，Claude Opus 5 支持 100 万上下文。
- 思考内容默认收起 — Agent 的思考过程默认折叠显示，需要时再展开查看，对话阅读更专注。
- 工具活动更易读 — Agent 读取 Skill 时会在工具活动中明确显示。
Bug 修复
- 长对话更稳定 — Pi 会更早整理过长上下文，并在整理后继续执行任务、保留进度显示。
- 网络异常自动恢复 — Pi 遇到网络抖动或上游流式响应异常时会自动重试，减少回答中断或卡住的情况。
- 运行中切换模型 — Agent 运行时可以预先切换模型，当前轮结束后会自动按新模型执行下一轮。
- 命令与引用输入更可靠 — 连续调用 / 命令时，文件路径和旧草稿中的引用不会再被误识别为命令。
- 协作会话状态同步 — 委派给子 Agent 的会话在创建、运行和结束时会正确更新界面状态，并沿用当前模型。
- 随时停止 Agent — Agent 运行中即使已输入下一条消息，停止按钮仍会保留，可随时中止当前任务。
- 内核与推理设置平稳切换 — 内核和推理强度的修改会在当前任务结束后生效，避免中途打断。
- 自动处理明确计划项 — 自动模式下，Agent 可以直接删除已明确指定的待办和日程。
- 待办数量更准确 — 待办和分组中的数量不再计入已完成的项目。
- 侧栏固定会话不再受限 — 可以在侧栏固定任意数量的会话。
- Excel 预览更多数据 — 每个 Excel 工作表的预览最多可显示 200 行数据。
- 渠道与模型兼容性改进 — 修复飞书新机器人会话镜像，以及不同渠道下 Claude 模型识别的问题。
- 其他体验修复 — 修复 Codex 会话标题偶发冲突、PDF Skill 识别和引用内容后焦点跳转等问题。

Proma v0.15.11 更新
新功能
- Git/PR 标识 — Agent 代为提交 commit 或创建 PR 时默认附加 Made-with: Proma 与官网链接，可在「设置 → 通用」随时关闭；不再使用 Co-Authored-By 归因。(#1275)
- Pi 会话上下文压缩 — 支持主动压缩当前 Pi 会话上下文，并在任务进度浮层中展示处理状态。(#1246)
- 项目内新建会话入口 — 将 Agent 新会话创建入口收敛到对应项目，Chat 分区保留独立的新建对话入口。(#1252)
- OpenCode Go 渠道 — 新增 OpenCode Go（OpenAI 协议）渠道，预置 Grok、GLM、Kimi、DeepSeek 与 MiMo 等模型。(#1263)
- macOS 终端快捷操作 — 文件浏览器中可直接在 Terminal 中打开文件夹。(#1254)
- 模型渠道提示 — 悬停模型选择器即可查看当前使用的渠道名称。(#1264)
- GPT-5 能力识别 — 为同名 GPT-5.x 模型统一识别上下文窗口与推理档位，GPT-5.6 支持「最大」推理强度。(#1250)
- Codex OAuth 会话标题 — 使用 Codex OAuth 时自动生成更具语义的会话标题。(#1248)
- 第三方渠道风险确认 — 添加第三方模型渠道时会提示相关风险，帮助用户确认配置来源。(#1253)
Bug 修复
- 优化 Scratch Pad 图片体验 — 图片支持单击预览、右下角缩放与复制成功提示；修复保存后尺寸丢失、图片后正文粘连及复制段落间距异常的问题。(#1183, #1274)
- 记住 OpenAI/Codex 推理强度 — 新建 Agent 会话会沿用上次选择的推理档位，并正确保留「关闭」设置。(#1241)
- 修复本地 Markdown 文件链接展示 — 本地 .md 文件链接现在可正确渲染为文件标签。(#1234)
- 保留 Pi 异常前的输出 — Pi 会话遇到终端错误时，已生成的部分回复不会丢失。(#1268)
- 增强 Pi 流式重试 — HTTP chunked/SSE 连接中断会被识别为网络异常并自动恢复，失败提示也更准确。(#1267)
- 修复 Windows Shell 默认值 — Windows 默认使用 Git Bash，提升 Agent 执行命令的兼容性。(#1272)
- 修正模型上下文与输出限制 — 修复 OpenCode Go 的 Kimi K3 上下文窗口，并限制火山方舟 GLM-5.2 的最大输出 Token。(#1271, #1243)
- 修复 Pi 压缩后的上下文显示 — 压缩完成后显示估算上下文用量，刷新时不再丢失额度信息。(#1256, #1245)
- 修复文件默认应用操作 — 文件浏览器与差异视图中的「使用默认应用打开」始终可用。(#1258)
- 改善 Pi Provider 兼容性 — 自定义渠道的 developer 消息会正确映射为系统消息。(#1257)
- 减少无关完成通知 — 被委派的子会话完成后不再额外弹出完成通知。(#1251)
- 修复跨视图教程跳转 — 教程可正确跳转至目标设置或功能页面。(#1249)
- 优化侧边栏布局 — 对齐项目、Chat/Agent 分区及日期分组的视觉布局。(#1259)
其他优化
- 精简上下文用量展示 — 移除分隔线和仅输入上下文等干扰信息，让 Agent 输入区更聚焦。(#1255, #1261)

Proma v0.15.7 更新
新功能
- Pi Agent 成为新会话默认 Runtime — 新建 Agent 会话默认使用 Pi Runtime，同时保留 Claude Runtime 可选。(#1221)
- Agent 会话星标 — 可为重要 Agent 会话添加星标，未星标时仅在悬停时显示操作入口。(#1232)
Bug 修复
- 默认开启模型思考 — 新建 Agent 会话会默认启用支持模型的思考能力。(#1220)
- 优化 Agent 直接执行 — 调整默认执行策略，减少不必要的执行前阻塞。(#1223)
- 修复 Codex 上下文窗口 — 为 GPT-5.4、GPT-5.5 和 GPT-5.6 使用正确的上下文窗口，确保自动压缩及时触发。(#1227, #1229, #1231)
- 重试前清理旧错误 — Agent 重试时不再保留上一轮失败提示。(#1228)
- 修复超宽 Mermaid 图滚动 — 现在可以滚动查看超出容器宽度的图表左侧内容。(#1224)
- 修复 Token Plan 标题生成 — 通义千问与小米 Token Plan 渠道不再发送不兼容的 thinking 参数。(#1233)
- 增强 Pi Runtime 稳定性 — 修复终端流中断恢复、协作子会话直接运行及豆包消息角色兼容问题。(#1225, #1236, #1237)

Proma v0.15.6 更新
新功能
- Pi 会话分叉与回退 — 支持从指定消息分叉 Pi 会话，或将会话回退到历史节点后继续对话。(#1203)
- 实时任务进度浮层 — Agent 执行多步骤任务时，可在消息区查看任务状态与当前进度。(#1205)
- 会话级 OpenAI 推理控制 — 对支持的 OpenAI 模型，可按会话单独调整推理强度设置。(#1201)
- 通义千问 Token Plan — 新增 Token Plan 渠道，支持 Qwen3.8 Max Preview、Qwen3.7 Max、Qwen3.6 Flash 等模型用于 Agent。(#1210)
Bug 修复
- 修复 Pi Codex 代理请求 — Pi Runtime 下的 Codex 模型请求现在正确复用全局代理设置。(#1196)
- 修复 Codex OAuth 认证与自动续期 — 恢复 ChatGPT Codex 的运行时鉴权，并在 Token 刷新后保存新凭据，避免重启后需要重新登录。(#1213, #1217)
- Pi 自动重试更可靠 — 网络波动重试会延续原会话上下文，避免重放请求导致重复创建协作子 Agent 或重复执行工具。(#1209)
- 限制火山引擎 GLM-5.2 输出长度 — 为模型设置合理的最大输出 Token，避免请求超出服务端限制。(#1206)
- 优化 Agent Core 兼容性提示 — 在渠道设置中更清晰地说明模型与 Agent Core 的兼容关系。(#1207)
- 脱敏渠道桥接日志 — 避免在日志中记录敏感配置与认证信息。(#1204)
其他优化
- 精简 Agent 输入工具栏 — 移除「输出完成后保持展开」显示选项和上下文用量「新鲜度」提示，减少界面干扰。(#1202, #1211)

Proma v0.15.3 更新
新功能
- 查看 ChatGPT Codex OAuth 订阅额度 — 在 Agent 上下文用量和渠道卡片中展示 Codex 的滚动额度、剩余百分比与重置时间，支持 5 小时、每周及其他实际限额窗口。(#1188)
- 新增 ChatGPT Codex 快速模式 — Pi Runtime 下使用受支持的 Codex 模型时，可在会话工具栏切换「快速」模式，以优先响应换取更高的额度消耗；该设置会随会话保存。(#1190, #1192)
Bug 修复
- 修复 Pi 写文件参数不完整问题 — 明确要求 write 在同一次调用中提供路径和完整 content，避免仅传路径导致写入失败。(#1184)
- 优化 Pi 工具调用流式预览 — 预览阶段不再重复传输累计的工具参数，大文件写入时可明显降低 IPC 与渲染压力，最终帧仍保留完整参数。(#1185)
- 修复历史记录中的相对路径预览 — 为历史工具调用补充会话工作目录作为解析上下文，使 .context/plan/*.md 等相对路径能正确打开。(#1186)
- 修复飞书 Pi 流式消息重复或乱序 — 正确处理累计 partial 帧并按内容块计算增量，避免卡片中的文本、思考内容和工具状态重复或错位。(#1187)
- 修复 Codex OAuth 代理支持 — 授权码换取与刷新 Token 请求现在复用 Proma 的全局代理设置，网络受限环境中也能完成登录和续期。(#1189)
- 优化 Pi 流式输出性能 — 将高频、累计式的 partial 消息合并为最高 20 fps 的最新快照，同时确保最终内容立即送达，减少长回复时的 IPC 与渲染压力。(#1191)

Proma v0.15.0 更新
新功能
- 新增 Pi Agent Runtime — Agent 输入框下方可切换 Claude / Pi 内核；Pi 可使用所有已启用的模型渠道，并复用工作区、Skills、用户 MCP、协作子 Agent 与权限能力。(#1170, #1175, #1178, #1180)
- 定时任务支持 Pi 内核 — 新建或编辑自动任务时可选择 Pi，并使用任意已启用的模型渠道执行。(#1174)
- 支持 OpenAI Responses API 渠道 — 可配置使用 OpenAI Responses 协议的模型，并完善工具调用解析稳定性。(#1176)
- Pi 内核支持联网与浏览器工具 — 可使用内置联网搜索及 Chrome DevTools MCP 工具完成网页相关任务。(#1179)
Bug 修复
- 修复 Pi 运行时打包依赖 — 安装包会正确携带 Pi 运行时所需依赖，避免发布版本启动时找不到模块。
- 修复嵌套区域滚动影响主窗口 — 滚动锁定仅作用于对应容器，避免嵌套滚动时页面滚动异常。(#1182)
- 调整记忆设置位置 — 将记忆设置移动至设置页底部，减少与常用配置的干扰。(#1181)
- 优化 Agent 界面细节 — 修正 Plan 模式输入框虚线圆角，并保持思考文本为正常字重。(#1172, #1173)

Proma v0.14.23 更新
改进
- Kimi K3 上下文扩展至 1M — 支持更长对话与文档场景下的完整上下文。

Proma v0.14.22 更新
Bug 修复
- 尝试修复 Windows 创建项目无效 — 当项目名处理后命中 Windows 保留设备名（如 CON、PRN、AUX、NUL、COM1–COM9、LPT1–LPT9）时，工作区目录无法创建，表现为新建项目无反应；现在这类名称会自动加上 workspace- 前缀规避。同时复制默认 Skill 时跳过 .git、node_modules 等高风险目录，避免初始化失败。(#1166)

Proma v0.14.21 更新
新功能
- 会话快速切换快捷键 — 用 ⌘ + 数字（macOS）或 Ctrl + 数字（Windows）即可在最近的会话之间快速切换，支持 1–9 共 9 个位置；鼠标悬停会话项时会显示对应的快捷键提示，切换更顺手。(#1163)
- 显示渠道订阅套餐额度 — 在渠道选择器与 Agent 上下文用量徽标处展示订阅套餐（Plan）的剩余额度与重置时间，剩余不足 20% 时高亮提醒；额度查询按渠道缓存并做请求去重，避免重复请求。(#1156)
Bug 修复
- 修正 1M 模型后缀路由与上下文窗口判定 — [1m] 后缀改为按供应商精准匹配，仅对已验证的内置供应商组合（Claude、智谱 GLM、小米 MiMo、MiniMax、DeepSeek、通义千问等）追加后缀；通用 Anthropic-compatible 端点保留用户配置的真实模型 ID，不再因收到带后缀的模型名导致请求失败。同时对话压缩（compact）的自动压缩阈值改为按实际窗口判定，1M 模型不再被错误降级为 200K。(#1152, #1151)
- SDK 最大输出 token 限制改为仅对 Claude 生效 — 之前按供应商区分对所有模型强制覆盖最大输出（Anthropic 64000 / 其他 32768），现仅对 Claude 模型设置 64000，其他模型不再强制覆盖，避免影响非 Claude 供应商的输出行为。(#1151)
- 修复小米套餐渠道鉴权 header — 修复 xiaomi token plan 渠道鉴权 header 的处理异常。(#1151)
- Skill 扫描对损坏符号链接容错 — Skill 扫描遇到 dangling / broken symlink 时跳过该条目，不再因单个坏链接终止整个扫描、导致后续 Skill 丢失。(#1161)
- 关闭 Markdown linkify 模糊匹配 — 关闭 linkify 的模糊匹配，避免 SKILL.md 等文件名被误判为 URL 而合成出错误的内联链接。(#1162)
- 澄清工作区 Memory 提示词路径 — 优化注入提示词中工作区 Memory 路径的表述，让 Agent 更准确地引用 Memory 位置。(#1157)

Proma v0.14.20 更新
新功能
- 草稿区支持待办清单与无序列表 — 底部工具栏新增「待办清单」「无序列表」按钮，一键插入/切换。勾选后正文置灰划线，各外观主题自动适配配色；排版样式作用域限定在草稿区，不影响其他扩展。空待办项光标显示也已修复。(#1130)
- Agent 会话引用列表可展开 — 扩展了 Agent 会话引用列表的展示能力，方便查看和管理引用的历史会话。(#1139)
- Agent 模型支持 1M 上下文 — 支持百万 token 级别的大上下文模型，适配超长对话和大型代码库场景。(#1138)
Bug 修复
- 代码预览支持换行切换 — 代码预览面板新增自动换行开关，长代码行不再需要横向滚动，阅读更舒适。(#1142)
- 修复消息正文内联文件引用无法预览与定位 — 消息正文里内联的文件引用（如 user-profile.md）现在能正确识别为可点击的文件标签，点击预览和"在文件管理器中显示"都能正常工作，不再静默失败。(#1136)
- 修复钉钉机器人 ID 更新 — 修复了钉钉机器人配置更新时 ID 处理异常的问题。(#1140)
- 修复钉钉机器人会话绑定迁移 — 修复了钉钉机器人会话绑定数据迁移逻辑，改用原子写入防配置损坏，并补充了合并去重测试。(#1129)

Proma v0.14.17 更新
新功能
- 图片预览支持多图翻页 — 输入框和消息气泡中的多图预览现在支持左右翻页浏览，点击两侧箭头或按方向键即可切换，顶部显示当前/总数角标，首尾循环。覆盖 Chat 和 Agent 两种模式，已加载的缩略图会复用，不触发额外 IO。(#1126)
- 草稿页支持右侧分屏 — 在 Agent 会话中可将草稿页拖拽到右侧分屏面板，边看对话边记笔记。关闭分屏后草稿 Tab 自动恢复原位，内容实时自动保存。(#1124)
- 新增 Ark Coding Plan 渠道预设 — 渠道管理新增「Ark Coding Plan」预设，预配置 Doubao Seed 2.0 Code/Pro/Lite、GLM-5.2、Kimi K2.7 Code、MiniMax M3、DeepSeek V4 Flash/Pro 共 8 个模型，一键添加即可使用。(#1118)
Bug 修复
- 防止 Agent 消息静默丢失 — 当模型异常结束且未返回任何可展示内容时，现在会保留用户已发送的消息，并在对话中显示清晰的错误提示和重试按钮，不再静默丢失整轮交互。(#1122)
- 消息队列支持附件显示 — 排队中的消息现在会显示附件标识（文件名或附件数量），仅附件无文本时标注「仅附件」，让队列内容一目了然。同时重构了附件发送逻辑，区分剪贴板草稿、侧面板文件和新上传文件三类场景，处理更可靠。(#1116)
- 修复 macOS 全屏窗口关闭黑屏 — 在 macOS 全屏状态下关闭窗口时，现在会先退出全屏再隐藏窗口，避免下次打开出现黑屏。同时抽取了主窗口生命周期管理模块，窗口状态持久化也更健壮。(#1119)
- 存储清理内存安全防护 — 存储空间扫描现在跳过工作区元数据目录（如 skills、.claude），避免误清理；新增孤立项预览列表和路径安全检查，防止越界删除。(#1114)
- 委派子会话跟随父会话移动 — 将 Agent 父会话迁移到其他工作区时，其派出的协作子会话现在会正确跟随移动，工作目录和元数据同步更新，不再遗留。(#1113)
- 消除无预览时主区域白条缝隙 — 右侧预览面板关闭时，主区域右侧不再出现多余的 2px 白条缝隙，视觉更一体。(#1115)

Proma v0.14.10 更新
新功能
- 左侧边栏支持拖拽调整宽度 — 会话列表中工作区 badge、子任务缩进等信息常挤压标题空间，现在可以向右拖拽侧边栏右缘扩展宽度（300~420px），宽度会自动记住，折叠态自动隐藏拖拽手柄。(#1094)
- Agent 上下文支持选中引用 — 在 Agent 回复或历史消息中选中文本后，可通过弹出菜单将选中内容作为上下文引用发送给 Agent，让追问更精准。(#1102)
- 本地 Skills 分组显示 — Agent 配置中的本地 Skills 列表现在按来源分组展示，浏览和管理更清晰。(#1099)
Bug 修复
- 侧边栏归档视图排序修复 — 归档会话列表现在与活跃视图一致，按最近更新优先排列，不再乱序。(#1103)
- 自动任务子会话级联操作完善 — 将自动任务父会话置顶或归档时，其派出的子会话现在会正确跟随操作，不会遗留；归档视图也改为树形渲染，子会话嵌套在父会话下方。(#1096)
- 修复引用选中文本在排队中丢失 — Agent 忙碌时选中的引用文本现在会正确暂存，轮到下一轮时发送，不会静默丢失。(#1104)
- 飞书绑定管理优化 — 改进了飞书绑定的管理界面和解绑逻辑，操作更可靠。(#1101)
- 分屏预览模式 UI 微调 — 左侧面板增加了 2px 右边距，避免滚动条与分割线粘连。(#1100)
- Chat 模式 Tavily 搜索认证修复 — Chat 模式下使用 Tavily 联网搜索现在使用正确的 Bearer 认证方式，搜索功能恢复正常。(#1098)
- 渠道兼容模型发现优化 — 改进了渠道管理中兼容模型的发现逻辑，减少不必要的 API 调用。(#1097)
- Toast 通知移至右下角 — Toast 提示从页面顶部移至右下角，不再遮挡顶部操作区域。(#1105)
- 侧边栏选中项目指示器增强 — 优化了侧边栏中当前选中工作区的视觉高亮，更容易辨认。(#1106)
- Agent 历史记录滚动修复 — 修复了 Agent 历史消息在特定场景下的滚动异常。(#1109)

Proma v0.14.9 更新
新功能
- 左侧边栏支持拖拽调整宽度 — 会话列表中工作区 badge、子任务缩进等信息常挤压标题空间，现在可以向右拖拽侧边栏右缘扩展宽度（300~420px），宽度会自动记住，折叠态自动隐藏拖拽手柄。(#1094)
- Agent 上下文支持选中引用 — 在 Agent 回复或历史消息中选中文本后，可通过弹出菜单将选中内容作为上下文引用发送给 Agent，让追问更精准。(#1102)
- 本地 Skills 分组显示 — Agent 配置中的本地 Skills 列表现在按来源分组展示，浏览和管理更清晰。(#1099)
Bug 修复
- 侧边栏归档视图排序修复 — 归档会话列表现在与活跃视图一致，按最近更新优先排列，不再乱序。(#1103)
- 自动任务子会话级联操作完善 — 将自动任务父会话置顶或归档时，其派出的子会话现在会正确跟随操作，不会遗留；归档视图也改为树形渲染，子会话嵌套在父会话下方。(#1096)
- 修复引用选中文本在排队中丢失 — Agent 忙碌时选中的引用文本现在会正确暂存，轮到下一轮时发送，不会静默丢失。(#1104)
- 飞书绑定管理优化 — 改进了飞书绑定的管理界面和解绑逻辑，操作更可靠。(#1101)
- 分屏预览模式 UI 微调 — 左侧面板增加了 2px 右边距，避免滚动条与分割线粘连。(#1100)
- Chat 模式 Tavily 搜索认证修复 — Chat 模式下使用 Tavily 联网搜索现在使用正确的 Bearer 认证方式，搜索功能恢复正常。(#1098)
- 渠道兼容模型发现优化 — 改进了渠道管理中兼容模型的发现逻辑，减少不必要的 API 调用。(#1097)

Proma v0.14.6
对比基准：v0.14.5
新功能
- 输入框 Markdown 渲染开关 — 在「设置 → 通用设置」中可以开启输入框的 Markdown 实时渲染，写文字时所见即所得。(#1080)
- 自动重试不再频繁弹窗 — 网络瞬时波动时，前 5 次自动重试会静默进行，不再反复弹提示打扰你。(#1078)
Bug 修复
- 网络切换后消息不再静默失败 — 切换 WiFi 或代理后，消息发送失败现在会正确提示并支持重试，而不是卡住不动。(#1088)
- 侧边栏会话级联操作修复 — 关闭、归档、置顶父会话时，子会话现在会同步操作，不会留在一半的状态。(#1030)
- 通知音修复 — 蓝牙设备播放通知音不再破音，也不会播到一半被截断。(#1082, #1083)
- 修复会话迁移到当前工作区失败 — 之前无法把会话迁移到你当前所在的工作区，现已修复。(#1029)
- Agent 中可直接使用 proma 命令 — Agent 子会话现在能正确找到 Proma CLI，不用再配路径。(#1090)
- Windows 路径 Chip 完善 — Windows 下 Agent 输出的文件路径现在能正确识别为可点击的文件标签，反斜杠路径也能正常显示。(#1026, #1085)
- 终端主题下右键菜单可见 — 暗色终端主题中文件标签的右键菜单不再被覆盖层遮挡。(#1027)
- Windows 跨工作区迁移更稳定 — 修复了 Windows 下迁移会话目录时偶发的文件占用报错。(#1028)
- 纯文本模式下复制保留格式 — 输入框关闭 Markdown 渲染时，复制内容不再出现多余的转义符。(#1092)
依赖升级
- Agent SDK 0.3.197 → 0.3.201 — 修复了多个底层问题，包括 MCP 服务器超时控制、工作流进度追踪等。(#1087)

Proma v0.14.5
对比基准：v0.14.3
Bug 修复
- 移除 DeepSeek 模型的强制自动压缩限制 — 之前会在 85 万 token 时提前触发压缩，现在恢复使用模型完整上下文窗口。(#1077)
- 修复会话完成时侧边栏跳动

Proma v0.14.3
对比基准：v0.14.0
这是一个 Agent 协作能力与稳定性版本：SubAgent 委派策略从「谨慎派发」翻转为「主动探索」，Agent 运行中也能排队发消息不打断当前任务；同时修了上下文窗口被拉低、HTTP MCP 工具注册、会话恢复等一批稳定性问题。
新功能
- 协作子会话触发策略更积极：对抗式审查 + 多样性探索 — SubAgent 委派策略从「先相信直觉、不行再派」翻转为「善用 SubAgent 拓宽探索边界」。新增两种协作模式：对抗式审查——父 Agent 完成方案后派子 Agent 独立审查（只提建议不改文件），帮你挑刺找盲区；多样性探索——方向不唯一时并行派多个子 Agent 各探一个方向（只调研不改文件），汇总对比后帮你做选择。(#1074)
- Agent 运行中输入进入可见托管队列 — Agent 正在输出时，你发的消息不再直接软中断当前 turn，而是进入一个可见的消息队列。队列支持拖拽排序、撤回到输入框重新编辑、删除、或点「立即发送」不等排队；等当前 turn 结束后按序自动发送。队列不持久化，重启后自动清空，避免误发过期上下文。(#1075)
Bug 修复
- 修复上下文窗口被子 Agent 拉低 — 派子 Agent 后，子 Agent 的模型（如 Haiku 200K）的 contextWindow 会错误覆盖主模型（如 Opus 1M），导致上下文指示器在 1M 和 200K 之间跳动、触发误压缩、消息错位。现在所有消费点都取各模型 contextWindow 的最大值。(#1073)
- 修复 HTTP MCP 工具注册失败 — Claude Code CLI 在连接 Anthropic 官方 API 时会自动开启 Tool Search（乐观模式），导致外部 HTTP MCP 服务器的工具被标记为延迟注册、运行时找不到。现在强制关闭 Tool Search，确保 MCP 工具跨渠道一致地预先注册。(#1072)
- 修复后台等待中发送失败时输入框内容丢失 — 在后台等待状态下发送消息时，若注入失败（如 IPC 异常），已清空的输入框内容会丢失。现在失败时自动恢复输入框内容和补全建议。(#1076)
- 修复 Agent 会话恢复 — 修了重启或恢复会话后，Agent 会话可能无法正确恢复的问题。(#1067)
- 修复 DeepSeek 上下文恢复 — 处理了 DeepSeek 渠道下上下文恢复时的兼容性问题。(#1070)
- 侧边栏与文件面板 UI 细节优化 — 新会话按钮高度对齐 Chat/Agent 切换器，搜索按钮尺寸对齐收起侧边栏按钮；会话列表 hover 三点菜单、文件面板 hover 操作按钮左移避免贴边 (#1051)；修复侧边栏时间标签偶尔抖动的问题 (#1066)。
- 修复内置 MCP 详情面板关闭按钮失效 — 内置 MCP 详情面板的关闭按钮之前点不动，现已修复，样式也与 Skill 详情面板统一。(#1050)
- 修复 Agent MCP 工具发现范围 — 修了 MCP 工具发现时范围不正确的问题。(#1069)
- 禁用 SDK 内置 Workflow — 关闭了 Claude Agent SDK 的内置 Workflow 功能，避免与 Proma 自身的任务调度冲突。(#1071)
移除
- 移除 Agent 自动审批模式 — 去掉了已废弃的自动审批（auto approval）功能，简化权限模式。(#1068)
- 移除过时的 context-1m beta header — 1M 上下文窗口自 Opus 4.6 / Sonnet 4.6（2026 年 3 月）起已正式发布，Sonnet 5 / Opus 4.7+ 更是默认开启，不再需要发送 beta 请求头。(#1053)

Proma v0.14.0
对比基准：v0.13.28
这是一个记忆系统重构版本：用轻量的工作区文件记忆取代 MemOS Cloud，Agent 能直接读写 CLAUDE.md 和 .claude/memory/ 来沉淀跨会话知识；同时去掉了 MCP 服务器的测试门槛，修好了会话 JSONL 解析的稳定性问题。
新功能
- 工作区记忆面板 — 新增「工作区记忆」Tab，Agent 生成的长期记忆（CLAUDE.md 与 .claude/memory/ 下的文件）直接可见、可编辑，编辑后自动保存到磁盘。(#1047)
- 用户画像自动沉淀 — Agent 在生成工作区记忆时，会持续迭代 .claude/memory/user-profile.md，越用越懂你的偏好和习惯。(#1047)
- MCP 服务器不再需要测试验证 — 添加 MCP 服务器后不再强制要求测试通过才能用，降低接入门槛。(#1049)
移除
- 移除 MemOS Cloud 记忆系统 — 之前的 MemOS Cloud 云端记忆已完全移除，替换为本地的文件记忆方案。你的记忆数据不再经过云端，完全留在本地磁盘上。(#1047)
Bug 修复
- 修复 Agent 会话 JSONL 解析 — 优化了会话文件的解析策略，避免异常数据导致解析失败。(#1048)

Proma v0.13.28
对比基准：v0.13.24
这是一个体验打磨与稳定性修复的小版本：更新流程重构进侧边栏和设置页，代码预览默认切到 diff 视图，AskUser 支持语音输入，并同步了最新的 Claude Sonnet 5 与 Agent SDK。
新功能
- 一键更新流程重构 — 更新按钮从弹窗移到了侧边栏，随时可见、随点随更新；UpdateDialog.tsx 已移除，检查更新、当前版本等信息统一并入 Settings → About，不再需要单独的弹窗页面。(#1041)
- 代码预览默认改为统一 diff 视图 — 打开代码改动时默认展示 diff 对比，改动内容一目了然；同时支持预览任意本地路径，不再局限于项目内文件。(#1044、#1042)
- AskUser 自定义回答框支持语音输入 — 在 AskUser 的自定义回答输入框里新增了语音按钮，和 ScratchPad、主聊天输入框保持一致的操作方式；同时修复了语音转文字结果没有正确落到该输入框的问题。(#1032、#1021)
- select_model 恢复动作接入共享模型选择器状态 — 出错卡片上的"切换模型"恢复操作现在会直接联动全局的模型选择器状态，点击后无需额外操作即可完成切换。(#1036)
Bug 修复
- 修复内置 MCP 保留名冲突 — 内置 MCP 的命名统一由单一配置来源管理，避免与用户自定义 MCP 撞名。(#1043、#1022)
- 修复 nano-banana 命名漂移 — SDK 会把 MCP server 名里的连字符自动转成下划线（nano-banana 实际以 nano_banana 注册），此前代码里两处名字对不上，现已统一。(#1022)
其它改进
- 1M 上下文判定改为声明式配置表 — 支持 1M 上下文的模型列表改为配置化维护，后续增减模型无需改动判定逻辑；同时补上了 claude-sonnet-5 的 1M 上下文支持。(#1031)
- claude-sonnet-4-6 重命名为 claude-sonnet-5 — 跟随 Anthropic 官方命名调整，默认模型 ID 与相关文案同步更新。(#1035)
依赖升级
- Claude Agent SDK 从 0.3.185 升级至 0.3.197。(#1040)

Proma v0.13.16
对比基准：v0.13.15
这是一个稳定性与体验打磨的小版本：让 Agent 派出去的子任务结果能更完整地带回，修好了 DeepSeek / Kimi 在 Chat 模式下报错的问题，并修复了子任务在重启后的恢复、Markdown 工具条、文件树等多处细节。
新功能
- 子任务返回的结果更完整 — 之前 Agent 帮你跑完一个子任务、把结果汇报给主会话时，内容超过约 1.2 万字就会被从中间截断，导致结果不全。现在上限提到 5 万字，绝大多数情况都能完整带回。(#955)
- 支持更多类型的 MCP 服务器 — 新增对 Streamable HTTP 方式的 MCP 服务器的支持，能接入的工具范围更广了。(#952)
Bug 修复
- 修复 DeepSeek / Kimi 在 Chat 模式下报错 — 之前这几个渠道在 Agent 模式能正常用，但切到 Chat 模式会报 404 错误。现在两种模式行为一致，都能正常对话。(#951)
- 重启后子任务能正确恢复 — 修复了重启或恢复会话后，派出去的子任务可能找不回来、接不上的问题。(#944)
- 派子任务更稳定 — 修复了 Agent 分叉（fork）派发子任务时的稳定性问题。(#945)
- 自动任务派出的子任务，正确归到自动任务区 — 自动任务运行时派出的子任务，之前会跑到普通会话列表里，现在会正确收纳在它所属的自动任务下面。(#943)
- Markdown 编辑工具条不再随滚动消失 — 编辑长文档时，顶部那排格式工具按钮会固定在原位，往下滚也不会被带走。(#953)
- 文件树与 minimap 细节优化 — 优化了文件树选中项的高亮显示 (#947)；调整了 minimap 的间距与滚动条宽度，看起来更舒服 (#946)。

Proma v0.13.15
对比基准：v0.13.4
这一版围绕委派 / 协作子会话体系做了集中打磨：子会话以可折叠树嵌套在父会话下、可在标签切换器中直接选择、支持为子 Agent 单独指定模型，并修复了重启后委派恢复可能跨父会话泄露的隐患。自动任务侧修正了会话归属与 maxRuns 重置语义两处行为偏差。其余为图片编辑器渲染性能优化、Markdown 预览目录交互重做，以及一批侧栏 / 输入区 / 文件浏览器的视觉细节统一。
新功能
- 委派子会话侧栏树嵌套 — 带 parentSessionId + sourceDelegationId 的委派子会话不再平铺在列表中，而是以可折叠树嵌套于父会话之下：父行展示聚合运行状态指示灯与 completed/total 子会话计数，一眼看清整组委派进度。pin / archive 父会话时级联同步其全部委派子会话，并在级联中途失败后重新拉取磁盘真实状态，避免侧边栏与磁盘不一致直到下次重载。(#922)
- 委派 Agent 支持模型选择 — 发起委派时可为子 Agent 单独指定模型，让不同子任务按需匹配能力与成本，不再被迫沿用父会话模型。(#938)
- 委派会话进入标签切换器 — 委派子会话现在会出现在标签（tab）切换器中，可像普通会话一样直接切换进入。(#923)
- Markdown 预览目录改为手动开闭 — 差异预览的 TOC 目录从「localStorage 持久化 + 窄屏自动收起」改为运行期记忆 + 用户手动控制：收起态在预览区左侧提供「展开目录」chevron，展开态目录头部提供「收起目录」按钮。同时修复标题提取——useTocHeadings 在容器为 null 时清空 headings 避免持有已卸载 DOM，并新增 3 个初始重提取定时器补偿 Shiki 高亮与图片懒加载带来的异步 DOM 变更。(#926)
Bug 修复
- 协作委派恢复跨父泄露修复 — 重启后按全局唯一 sourceDelegationId 恢复委派会话时，可能仅凭 UUID 就恢复到另一个父会话的委派，造成跨父泄露。修复后 getPersistedDelegationSession 仅在会话无记录父会话、或其父会话与调用方匹配时才接受该 UUID 回退；recoverDelegationRecordFromSession 优先采用持久化的 session.parentSessionId（回退到 ctx），与 getDelegationResult 一致地解析归属。(#936)
- 自动任务会话始终留在自动任务区 — 此前向自动任务会话发送消息会触发「毕业」（automationGraduated），使其从「自动任务」分组静默移入工作区普通会话列表，造成困惑。修复后自动任务会话始终留在「自动任务」分组，毕业时弹出 toast 明确提示会话已移动；调度器内部仍用 automationGraduated 标记避免复用已被用户介入的会话来跑后续自动任务。(#918)
- maxRuns 重置语义修复 — 当用户调高 maxRuns 让已完成 / 已停用的自动任务再跑一轮时，updateAutomation 会重置运行次数配额，却把任务留在 inactive 且 nextRunAt 过期，导致永不触发。修复收紧重置语义，并在 SKILL 指引层补充：当意图是恢复已停止 / 已完成任务时，应在同一次 update_automation 调用里一并设置 active:true。(#925)
- 点击已可见会话不再被强制置顶 — 此前为「从搜索打开旧会话需立即可见」引入的 pinnedCurrent，会把 activeSessionId 对应会话强制提到顶部，副作用是本就落在最近窗口内的会话被点击后也被抽出置顶。修复后 fillSessions 独立按 updatedAt 倒序计算，currentSession 仅在既非活跃、又不在 fillSessions 中时才补入——既保留「打开超窗 / 被截断旧会话立即可见」，又让已可见会话点击后保持原位。(#920)
- 图片编辑器画布渲染优化 — 引入 devicePixelRatio 缩放使 Retina 屏显示更锐利，棋盘格底纹改用 createPattern 缓存避免逐帧双重循环，拖拽 / 触摸移动时用 requestAnimationFrame 节流重绘并在抬手时取消挂起 RAF 强制最终重绘；同时图片未加载完成时禁用「发送」按钮、优化笔刷大小指示器对比度。(#889)
- 统一侧栏与输入区配色 — 修正动态主题类被裁剪的问题，为浅色主题输入区着色，并统一侧栏控件底色与对比度，使整体配色更协调。(#917)
- 移除 minimap 搜索框聚焦光边 (#927)；文件浏览器悬停时显示树形引导线 (#933)；降低折叠内容提示的视觉噪声 (#930)；简化标签页运行状态指示器 (#932)；修复侧栏委派开关 hover 态并调整其位置 (#937, #939)。

Proma v0.13.4
对比基准：v0.13.0
这一版以稳定性修复为主线，同步带来界面风格与定时任务两项体验提升。稳定性方面解决了生产环境中并发 Agent 会话导致的同步写风暴（主进程 UI 阶段性冻结）、适配了 v0.13.0 升级 SDK 0.3.185 后每会话 2 秒的 drain timeout、修复了长任务网络断连后上下文丢失从零重做的严重缺陷。功能侧新增「经典 / 现代」界面风格一键切换，以及定时任务 once 一次性调度与 maxRuns 运行次数上限——让"未来某时间点跑一次 / 跑有限几次就停"的延时任务也能纳入 Proma 自动化体系。
新功能
- 经典 / 现代界面风格切换 — 外观设置新增「界面风格」分段控制器，提供「经典」与「现代」两档选择（默认「现代」）。经典风完整保留旧版视觉：rounded-2xl + shadow-xl 侧栏、bg-muted 按钮底色、--radius: 0.625rem 全局圆角基准；现代风重新校准全局圆角为 --radius: 0.375rem（6px），侧栏去除圆角与投影改为纯色 --sidebar-surface，TabBar、输入框等区域引入独立分区底色 token（--tabbar-surface / --input-surface / --tab-surface），折叠按钮改用 border + bg-primary/5 的轻量 hover 态，整体质感更扁平统一。设置项通过 interfaceVariantAtom 持久化到 localStorage 与主进程，跨窗口实时同步。(#915)
- 定时任务 once 一次性调度 + maxRuns 运行次数上限 — 为定时任务补充两个正交能力：once 调度类型通过 scheduledAt 绝对时间戳在指定时刻只跑一次，computeNextRunAt 直接返回该时间戳不做前进推算，跑完自动停用（重启后过期任务补跑一次）；maxRuns 正交于所有调度类型，按实际执行次数计（成功 + 失败，不含 skipped），达到上限自动停用；completedAt 标记自动完成态，重新启用时重置计数器相当于再跑一轮配额。UI 新增频率下拉「仅运行一次」+ datetime 选择器、运行次数上限输入、「已完成」分组与状态展示。同步修订 SKILL.md 与工具描述层，纠正原先一刀切排除一次性任务的矛盾。(#914)
Bug 修复
- 并发会话同步写风暴修复 — 生产构建中多个 Agent 并发时（委派或手动），onSessionId 回调每条 SDK 消息都触发（SDK v2 几乎每条消息带 session_id），但守卫误用「初始快照后永不更新」的 existingSdkSessionId 作比较——回调里实际更新的是另一个变量 capturedSdkSessionId。新会话的 existingSdkSessionId 为 undefined，导致守卫恒为真，每条消息都全量 readIndex + 原子写 + 备份会话索引，再叠加一次读回验证。历史会话越多索引越大、并发越多，同步 fsync 风暴越严重，wedge 主进程事件循环；渲染进程因等待同步 IPC 一并冻结（彩虹条、悬浮预览延迟）。dev 环境索引近乎空故无法复现，仅生产暴露。修复后仅在 session_id 真正变化时持久化一次，并删除不必要的调试读回。顺带修复 file:resolve-path 对目录路径调用 registerPromaFilePath 抛「不是文件」未捕获异常的问题。(#910)
- SDK 0.3.185 iterator 终止语义适配 — v0.13.0 升级 SDK 后每个会话都触发 orchestrator 的「drain timeout: SDK iterator 在 result 后 2000ms 内未关闭，强制退出」，白白浪费 2 秒。根因：SDK 0.3.185 把会话终止逻辑全部挪进 Query.cleanup()，而 cleanup() 只在 iterator.return() 被调用时触发（Transport.close 注释明确 "eliminating need for endInput"，旧的 stdin-EOF 自然结束路径已废弃）。adapter 收到 result 后只调 channel.close()、不再有人调 .return()，输出流不会 yield done，orchestrator 的 while 循环挂在 next() 上，只能靠 2s drain timeout 兜底调 queryIterator.return()——安全网退化成了主路径。修复：关闭 SDK promptSuggestions（它在每轮 result 之后才到达，是"收到 result 后仍需等尾部消息"的根源），adapter 收到非 keep-open 的 terminal result 后在 yield 该消息后主动 break for-await 循环触发 iterator.return() → cleanup()。drain timeout 退化为真正永不触发的安全网。(#913)
- 长任务断连后上下文保留 — 长任务运行中网络断连后，编排层终止分支用 shouldClearSession = !apiError || statusCode >= 500 判断是否清除 sdkSessionId。普通断连从 stderr 解析不出 HTTP 状态码（apiError = null），于是 !apiError 命中，把指向 SDK 磁盘完整历史 JSONL 的 resume 指针清空——但 SDK 的 JSONL 仍在磁盘上本可 resume。指针丢失后下一轮退化为仅 ~50K 的 buildContextPrompt 冷启动，模型从零重新执行；"Interrupt + Continue" 也无法恢复，只能新建会话手动救回。修复：终止分支不再清除 sdkSessionId（网络断连 / 5xx / 未知错误都不代表会话失效），扩展 TRANSIENT_NETWORK_PATTERN 覆盖更多断连错误模式（ECONNABORTED / connection closed / AbortError / timed out 等），冷启动兜底升级为强指令要求模型先读取完整 JSONL 历史。同时将 sdkSessionId 的主动清除收敛为仅 thinking-signature 跨模型不兼容这一处——此前 session-not-found 等场景也会误清。(#903)
- 推荐消息保留草稿 — 点击 Agent 推荐条发送建议后，setInputContent('') 会无条件清空用户正在编辑的草稿。修复后仅在无 overrideText 时清空，与 handleSend 内部 overrideText ?? inputContent 的取值语义保持一致。(#904)
- 有序列表 Shift+Enter 续项修复 — Agent 输入框有序列表中 Shift+Enter 无法正确续项，修复后续项行为恢复正常。(#908)
- 附件 chip 支持点击预览 — 已发送消息中的附件 chip 支持点击打开预览。(#906)
- 轻量主题下代码选区对比度优化 (#911)；预览面板切换时保留 AskUserQuestion 草稿 (#912)；移除 auto preview toggle (#909)

Proma v0.13.0
这一版引入了 Nowledge Mem 本地记忆，把图片预览升级成能直接编辑的画布，还让多个 Agent 之间能更顺畅地协作干活。另外修了一堆输入框和界面上的小毛病，用起来更跟手。
新功能
- 引入 Nowledge Mem 本地记忆 — Chat 里新增了 Nowledge Mem 记忆卡片，配置一次之后，对话就能记住你的偏好和过往内容，换个工具、换个会话也不会忘。配置过程有清单引导，且无需登录或注册账号。
- 图片可以直接编辑了 — 点开任意图片，现在能裁剪、旋转、画框、涂鸦（5 种颜色、2 种笔触），改完直接发回对话。无论是 Chat 还是 Agent 里的图片都支持，高分屏下也清晰不糊。
- 多 Agent 协作更顺 — Agent 把任务委派给子 Agent 时，主 Agent 现在能替子 Agent 回答弹出的提问、也能在子任务结束后接着追加新要求。子 Agent 卡住时也会及时通知到主 Agent，整个协作过程不容易卡死。
- 自动任务单独归类 — 定时任务多了之后，这些自动产生的会话会被收进侧栏一个专门的「自动任务」分组，不再和你手动开的会话混在一起。你一旦在某个自动会话里手动发消息，它就会「转正」回到普通列表。
- 补全面板更清楚 — 输入 /、#、& 弹出的补全面板都加了标题（分别是调用 skill、MCP 服务、引用会话），并标注了快捷键，一眼就知道当前在选什么。
- 新增通义千问渠道 — 新增 qwen-anthropic 渠道，支持千问 1M 超长上下文，切换后自动填好默认模型。
- 预览支持文档元信息 — Markdown 文件开头的元信息（frontmatter）现在能在预览里正常显示了。
体验优化与修复
- 第三方代理下更省、更快 — 修复了经第三方代理 / 网关使用时缓存命中率骤降的问题，调用更稳定、成本更低。
- 输入框更跟手 — 修复了斜杠命令弹出后按回车会误发消息、Shift+Enter 无法换行等问题；Chat 的模型选择器也移到了工具栏最左侧，和 Agent 模式保持一致。
- 界面更流畅 — 移除了若干弹窗和按钮上拖慢渲染的毛玻璃效果，低配机器上不再卡顿；三块面板之间的阴影也调得更统一协调。
- 一些细节修复 — 修好了模型图标偶尔显示错误、从搜索打开旧会话不立即出现在侧栏、预览切换后滚动位置错位、重启后分屏偏好丢失、点击推荐消息却发出草稿等问题。

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 / 剪贴板预览三个入口保持一致

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 上），占用量 = 三者之和。修复点：① OpenAI 兼容渠道（zhipu / openai / doubao / qwen / custom）的 prompt_tokens 已含缓存命中部分、映射到 Anthropic schema 时未扣减，导致缓存被计两次、显示值约为真实值的 1.5–2 倍；② result.usage 是整个 query 内所有模型调用的累计求和，被当作当前上下文会让进度环虚高冲破 100%——complete 分支只信任流式 usage，不再用累计值覆盖 token；③ 真实 contextWindow 未透传、分母永远显示 200K，现经 context_window 事件透传，智谱等端点剥掉 [1m] 后缀导致误判窗口的问题改用用户原始选择修复；④ 模型 / 会话切换时清空旧值，避免残留上一会话数据。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 下沉到 Dif

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）的沉浸式阅读视图，不再遮挡当前工作区

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 — 避免在超长输入下频繁打断用户

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 切换，菜单始终贴在触发按钮旁边

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 内部控制

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 上下间距调整为对称；设置面板左侧导航和模型选择列表统一使用纤细滚动条；侧边栏指示条改为贴合边缘的包边设计，选中状态更醒目

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 历史会话列表保持一致的滚动条样式

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 主题色变量

Proma v0.10.19
对比基准：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 主题色变量

Proma v0.10.10
对比基准：v0.10.2
本次更新主要带来 Mermaid 图表渲染、文件预览查找、Markdown 编辑器自动保存，以及一系列飞书侧体验优化与渲染细节修复。
新功能
- 聊天与预览中支持 Mermaid 图表 — 消息和文件预览中的 ```mermaid 代码块会自动渲染为图表，头部按钮支持缩小/重置/放大。为避免滚动浏览长消息时被图表"卡住"，移除了滚轮缩放与拖拽交互
- 文件预览内查找 — 在文件预览中按 Cmd+F / Ctrl+F 可唤起查找栏，逐项高亮匹配。全局搜索快捷键在 macOS 改回 Cmd+Shift+F，与文件内查找区分
- Markdown 编辑器自动保存 — 编辑 Markdown 时停止输入 1.5 秒后自动写盘，切换文件或退出编辑前自动 flush 未保存内容。Save 按钮通过颜色反馈状态：保存成功短暂变绿，失败持续变红可点击重试
- 用本机默认 App 打开文件 — 文件预览顶栏和文件浏览器三点菜单新增「用 XX 打开」入口，按文件类型自动识别系统默认应用，并显示真实图标。macOS、Windows、Linux 全平台支持
- 搜索弹窗新增 Agent 搜索按钮 — 精准搜索无结果时可一键切换到 Agent 搜索，让 AI 帮你在历史会话里翻找相关内容。优先使用 deepseek-v4-flash 渠道，速度更快
- 聊天小地图自动定位 — 鼠标悬停展开右侧聊天小地图（Minimap）时，会自动滚动到当前阅读位置，长会话不用再手动找
- Chat 与 Agent 状态条颜色统一为蓝色 — 两种模式流式运行中的状态指示器统一为蓝色，减少视觉认知负担
- 飞书 Agent 运行实时同步到桌面 — 飞书侧触发的 Agent 任务会实时镜像到桌面端，桌面上可以看到完整运行过程
- 飞书长任务防休眠 — 飞书侧 Agent 跑长任务期间，系统不再被休眠中断
Bug 修复
- Windows 默认应用探测加固 — 修复 Windows 上某些应用（如 UWP 应用、夸克浏览器等未走标准注册路径的应用）无法被识别为默认应用的问题，新增 MRU 与 OpenWithProgids 双重兜底，匹配 Windows 设置面板显示的默认应用
- Markdown 渲染适配 react-markdown v10 — 修复升级 react-markdown 后部分代码块识别失效的问题。同时新增未标语言代码块的自动检测——AI 回复忘了标语言时也能高亮
- Agent 卡在旧会话锁释放不掉 — 修复异常路径下 active session 锁未释放导致后续消息被持续拒绝的问题
- Agent 过程组折叠的若干边界问题 — 修复流式中思考 + 尾部文本被提前外置又跳回过程组的问题；本轮完成后仍能走自动倒数收起；展示选项弹层恢复 hover 触发 + 150ms 延迟关闭
- Agent 工具操作按钮位置优化 — 工具调用区域的预览按钮位置调整，始终可见
- PDF 策略描述文案错字 — "知识" → "支持"
性能优化
- 聊天小地图流式期间不再重建监听器 — 长消息流式输出过程中减少不必要的事件监听器重建
- 侧边栏菜单 hover 期间不再触发重渲染 — 流式输出时侧边栏菜单交互更顺滑

Proma v0.9.40
对比基准：v0.9.39
本次版本聚焦在长会话流畅度和启动稳定性：跨 session 的并发流式不再相互拖累，编辑器/Tab/输入框在流式期间的卡顿被系统性削掉一轮；同时补强了 v0.9.39 暴露出来的启动卡死边界场景。
长会话流畅度优化
- AgentView 流式订阅按 sessionId 切片 — 流式状态、草稿和 HTML 三个 atom 改用 atomFamily 按 sessionId 派生订阅；任意一个 session 的流式 token 或任意输入框按键不再让所有会话的 AgentView 整树重渲染，跨 session 的并发流式互不干扰
- 跨 turn 任务标题提升到顶层缓存 — buildHistoricalTaskSubjects 从每个 AssistantTurnRenderer 的 useMemo 上移到 AgentMessages 顶层，长会话流式期间不再 O(T × M) 全量扫描所有 turn 的 TaskCreate 结果，每条 token 到达时的雪崩重算被消除
- Tab 切换让出主线程 — TabContent 改用 useDeferredValue(activeTabId)，TabBar 立即响应高亮，右侧 DiffTabContent mount 等昂贵渲染降级为非紧急任务；切 Tab 时不再被 Diff 编辑器的同步 Shiki tokenize 挡住
- Shiki 代码高亮装饰异步化 + 节流 — ProseMirror Shiki 插件 init 钩子返回空 DecorationSet，首装通过 setTimeout(0) 异步触发；按键事务走 mapping 路径让旧装饰跟随光标位置，docChanged 改用 120ms debounce 重算；选区移动不再触发重建
- 预览引用选区写入去重 — 在预览面板拖拽选区时，handleSelectionCapture 写入 quotedSelectionMap 前先比较 text/filePath，相同则保持原引用；与流式输出叠加时不再产生持续重渲染
- RichTextInput 行数检查走 rAF 节流 — onUpdate 改用 requestAnimationFrame 调度行数检查，连续按键合并为单帧执行；用 isExpandedRef 持有当前状态，仅在值真变化时才 setState，组件卸载时取消未触发的 rAF
- 悬浮置顶条 backdrop-blur 回退到 sm — StickyUserMessage 的模糊半径从 backdrop-blur-md 回退到 sm，shadow 与 opacity 也回到 v0.9.39 之前的取值；流式期间 GPU 不再被大半径 backdrop-blur 反复重采样模糊源图层
- Skill 资源文件面板无限重渲染修复 — SkillFilesPanel 中 refreshTree 的 useCallback 不再依赖 onFileCountChange，改用 ref 持有最新 callback；切到 Skill 详情"资源文件"标签页时不再因父组件 callback 引用变化触发 IPC + 磁盘读写循环
启动稳定性与兼容性
- 启动卡死边界场景兜底 — 集中处理"启动后窗口/托盘永不出现"故障的多个独立根因：fs.watch 主 watcher / 附加目录 watcher / chat-tools-watcher 全部加 'error' 监听并按需自愈重启（主 watcher 失败退避 5s，附加目录失败移除该 watcher），避免 iCloud 抖动、外接磁盘断开、目录被删等场景触发未捕获异常终止主进程
- whenReady 顶层 catch + 降级窗口 — app.whenReady 启动钩子用 safeRun / safeAwait 包裹，单点失败不再阻断后续步骤；顶层 catch 在意外异常时弹 dialog 提示常见排查方向并强制创建降级窗口，用户最坏情况下也能看到界面、日志和反馈入口
- SingletonLock 失败友好处理 — 旧版进程未退出导致 SingletonLock 失败时不再 process.exit(0) 静默退出，改为留下 console.warn 排查线索（提示 killall Proma）并调用 app.quit()，让 second-instance 事件能接管显示窗口
- 默认 Skill 升级 cpSync 加护栏 — safeReplaceSkillDir 用 try/catch 隔离单 Skill 失败，rmSync 能删 0444 只读文件；新增 skillCopyFilter / defaultSkillCopyFilter 过滤 .git、node_modules、.DS_Store、dist 等噪声目录，根治 EACCES 与 node_modules 文件爆炸；seedDefaultSkills 同样应用该护栏，单 Skill 失败不连累其他
- 新会话默认权限模式回到完全自动 — PROMA_DEFAULT_PERMISSION_MODE 从 auto 改回 bypassPermissions，避免第三方模型（DeepSeek / Kimi / MiniMax 等）无法响应 SDK 的 auto 内部安全分类调用，进而绕过 canUseTool 直接发出 permission_denied、UI 看不到审批弹窗只显示"自动审批已拒绝此命令"的问题；已有 session 的持久化值不受影响，仍可通过 PermissionModeSelector 切换至 auto / plan
开发与文档
- 默认 Skills 版本契约写入文档 — 在 CLAUDE.md 的版本管理节增加默认 Skills 版本契约：修改 default-skills/<skill>/ 内容时必须同步递增 SKILL.md 的 version 字段（patch +1），否则老用户走 semver-gated 升级时拿不到新内容
- 版本更新 — @proma/electron 从 0.9.39 升级到 0.9.40
使用提示
- 如果你之前在 v0.9.39 遇到过启动后窗口或托盘不出现的情况，本版升级后会带兜底护栏；若启动仍异常请把出现的 dialog 提示一并反馈
- 长会话与多会话并发流式的体感卡顿会有明显改善，特别是同时打开 Diff 预览、SkillFilesPanel 资源文件面板、或在预览中拖拽选区时
- 默认权限模式回到"完全自动"；使用第三方模型也能正常走完整审批流程，需要更严格策略的用户可手动切到"自动审批"