Reasonix v1.38.10
This release focuses on session reliability, Windows upgrade and agent execution, file path handling, and transcript stability.此版本重点提升会话可靠性、Windows 升级与 Agent 执行、文件路径处理和对话记录稳定性。
Start here使用攻略
App Session Ownership应用会话所有权
Learn how sessions are owned and managed within the app.了解会话在应用中的所有权和管理方式。
↗Independent Sessions独立会话
Understand how independent sessions work and their lifecycle.了解独立会话的工作原理及其生命周期。
↗Management Pages管理页面
Explore management pages for sessions and archives.探索会话和归档的管理页面。
↗Transcript Architecture对话记录架构
Details on the transcript architecture and its components.对话记录架构及其组件的详细信息。
↗Windows Agent ShellWindows Agent Shell
Learn how persistent PowerShell preserves state and reports command completion on Windows.了解持久 PowerShell 如何在 Windows 上保留状态并报告命令完成情况。
↗Windows Installer AcceptanceWindows 安装程序验收
Acceptance criteria for Windows installer builds.Windows 安装程序构建的验收标准。
Desktop updates桌面端更新
36 updates relevant to Desktop. 与桌面端相关的更新共 36 项。
Highlights重点内容
Expandable sessions and workspace context可展开会话与工作区上下文
Sidebar now shows 5 conversations per project or group, expandable in batches, with project and branch context for new sessions.侧栏现在每个项目或分组显示 5 个会话，可分批展开，新会话支持项目和分支上下文。
Preserve compacted context across restart重启后保留压缩上下文
Compacted model context now survives session switches, restarts, and legacy imports.压缩后的模型上下文现在在切换会话、重启和导入旧会话后仍然保留。
Fix user-message history pagination修复用户消息历史分页
Sent messages no longer duplicate or disappear when history pages are reclaimed or confirmed outside the visible window.发送的消息在历史页面回收或确认超出可见窗口时不再重复或消失。
New新增
Unified model credential recovery统一模型凭据恢复
Desktop and CLI now share credential-slot, receipt, and recovery services, preventing missing credentials from reaching new turns.桌面端与 CLI 现在共享凭据槽、回执和恢复服务，防止缺失凭据进入新对话轮次。
Canonical Windows desktop entry统一 Windows 桌面启动入口
Reasonix.exe is now the canonical Windows GUI entry, with legacy launcher compatibility preserved.Reasonix.exe 现在是 Windows 的规范 GUI 入口，同时保留旧启动器的兼容性。
Background conversation notifications后台对话通知
Background conversations now play attention sounds and show notifications without switching tabs.后台对话现在无需切换标签页即可播放提示音并显示通知。
Improved改进
Project tree disclosure caching项目树展开与缓存逻辑
Project tree now uses a five-row initial window and five-row increments, with separate cache invalidation from visibility.项目树现在使用五行初始窗口和五行增量，缓存失效与可见性分离。
Default session sorting to creation time默认按创建时间排序
Existing workbench sort preferences reset to creation time once on first launch of this release.此版本首次启动时，现有工作台排序偏好一次性重置为创建时间。
Reject Windows portable launches from remote storage拦截 Windows 便携版共享目录启动
Windows portable launches from UNC and mapped remote drives are now rejected before Electron starts.现在在 Electron 启动前拒绝从 UNC 和映射远程驱动器启动 Windows 便携版。
Fix catalog migration unread baseline修复目录迁移的未读基线
Migrated history no longer shows blue attention dots due to placeholder read baselines.迁移的历史记录不再因占位读取基线而显示蓝色未读点。
Fix canonical session unread state修复规范会话未读状态
Unread state now tracks only visible terminal assistant results, not metadata changes.未读状态现在只跟踪可见的终端助手结果，而不是元数据更改。
Decouple durable local session operations from runtime tabs本地会话持久化操作与运行时解耦
Session operations now resolve by explicit SessionRef, with improved title CAS and lifecycle guards.会话操作现在通过显式 SessionRef 解析，改进了标题 CAS 和生命周期防护。
Repair official provider endpoint protocol conflicts自动修复官方供应商协议与端点冲突
Conflicting official provider protocol/endpoint settings are now repaired automatically when the URL uniquely matches a catalog route.当 URL 唯一匹配目录路由时，现在会自动修复冲突的官方供应商协议/端点设置。
Gate updater by stable build identity按正式构建身份限制桌面更新器
Updater is now disabled in canary, preview, test, dev, and prerelease builds, with automatic checks throttled to once per six hours.更新器现在在 canary、preview、test、dev 和 prerelease 构建中禁用，自动检查限制为每六小时一次。
Unify session archive, trash and historical recovery统一会话归档、回收站与历史恢复
Archived sessions now use one durable lifecycle: normal session → Trash → restore or permanent deletion.归档会话现在使用一个持久生命周期：正常会话 → 回收站 → 恢复或永久删除。
Restore legacy Desktop history without duplicate recovery copies完善旧版对话迁移并排除重复恢复副本
Desktop upgrades now discover and consolidate legacy history across generations without duplicating recovery copies.桌面升级现在跨代发现并整合旧版历史，不重复恢复副本。
Fix submission identity and persistent PowerShell修复消息身份、工具状态与持久 PowerShell
Single sends no longer render twice, and Windows Agent execution uses persistent PowerShell with structured completion.单次发送不再渲染两次，Windows Agent 执行使用带结构化完成的持久 PowerShell。
Move command palette search to sidebar footer将命令面板搜索移至侧栏底部
Command palette search action moved from topic bar to the first sidebar footer slot.命令面板搜索操作从主题栏移至侧栏底部的第一个插槽。
Collapse workspace dock when last tab closes关闭最后一个标签页后自动收起工作区
Closing the last workspace tab now collapses the entire right dock and returns its space to the conversation.关闭最后一个工作区标签页现在会收起整个右侧停靠栏，并将其空间返回给对话。
Fix AI session rename for canonical history修复迁移后会话 AI 重命名失败
AI rename now reads authored turns from canonical durable history, fixing failures for migrated conversations.AI 重命名现在从规范持久历史中读取用户消息，修复了迁移对话的重命名失败。
Unify transcript recovery and completion with Follow v2统一会话同步与完成机制
Completed, cancelled or reconnecting chats no longer lose visible text or show stale run state.已完成、取消或重新连接的聊天不再丢失可见文本或显示过时的运行状态。
Make pause and recovery append-only暂停与恢复改为追加式终结
Stopping a turn and opening another conversation no longer leaves durable history unreadable.停止一个轮次并打开另一个对话不再导致持久历史不可读。
Restore ProjectTree and integrate session recovery fixes恢复项目树并整合会话恢复修复
ProjectTree workbench sidebar restored, with session, history, chat-display, and terminal repairs integrated.恢复了 ProjectTree 工作台侧栏，并整合了会话、历史、聊天显示和终端修复。
Adopt SessionID-only Desktop persistence升级 Desktop SessionID 会话架构
Desktop canonical sessions now persist by SessionID only, preventing disappearance after switching or restart.桌面规范会话现在仅按 SessionID 持久化，防止切换或重启后消失。
Fixed修复
Keep migrated history stable through restart保持迁移会话的身份并清除恢复后的错误提示
Startup and history continuation reuse the migrated session identity, preventing duplicate imports after metadata refresh. Successful history recovery also clears its error state without leaving a stale chat warning.启动和继续读取历史时复用已迁移的会话身份，避免元数据刷新后重复导入。历史恢复成功后清除错误状态，不再残留错误的聊天警告。
Stabilize Windows release validation稳定 Windows 发版验证
Fixed Windows validation defects including POSIX-only tests running on Windows and shell probe cache poisoning.修复了 Windows 验证缺陷，包括在 Windows 上运行仅限 POSIX 的测试和 shell 探测缓存污染。
Bound PowerShell cold-start handshake统一 PowerShell 冷启动握手预算
PowerShell now gets a 30-second budget from process start through connection acceptance and ready-frame receipt.PowerShell 现在从进程启动到连接接受和就绪帧接收有 30 秒预算。
Fix canonical history reuse across reopened tabs修复重开会话的历史缓存复用
Canonical history windows now reuse warm residents when the same session reopens under a new tab ID.规范历史窗口现在在同一会话以新标签 ID 重新打开时复用热驻留。
Serialize trash restore and permanent deletion串行化回收站恢复与永久删除
Trash deletion now keeps the user's original confirmation snapshot through refresh, lock waits, retries, and restart.回收站删除现在在刷新、锁等待、重试和重启期间保留用户的原始确认快照。
CLI updatesCLI 端更新
2 updates relevant to CLI. 与 CLI相关的更新共 2 项。
Highlights重点内容
Fixed修复
Bound PowerShell cold-start handshake统一 PowerShell 冷启动握手预算
PowerShell now gets a 30-second budget from process start through connection acceptance and ready-frame receipt.PowerShell 现在从进程启动到连接接受和就绪帧接收有 30 秒预算。
Upgrade notes升级提醒
Session registry upgrade会话注册表升级
Existing sessions are migrated to the new registry format on first launch. Older clients cannot edit an upgraded v3 registry.首次启动时，现有会话将迁移到新的注册表格式。旧客户端无法编辑升级后的 v3 注册表。
Windows installer identityWindows 安装程序身份
Installed test builds intentionally replace the same product and share data; portable builds keep program files separate.安装的测试构建有意替换同一产品并共享数据；便携构建保持程序文件独立。
Updater gating更新器限制
Updater is disabled in non-stable builds. Stable updates remain explicit: checks only read metadata, and download/install begins after user action.非稳定构建中更新器已禁用。稳定更新保持显式：检查仅读取元数据，下载/安装需用户操作后开始。
Downgrade requires new reader降级需要新读取器
After pause/recovery changes, downgrading requires retaining the new reader or restoring a complete pre-upgrade backup.暂停/恢复更改后，降级需要保留新读取器或恢复完整的升级前备份。
Thanks致谢
This release was shaped by:感谢本版本的贡献者：
Ready when you are准备好即可升级