docs(release): 准备 v1.38.2 中英更新日志

[github-actions]

此版本提升了会话可靠性、模型服务配置和桌面性能。引入了仅追加会话日志与版本 head、独立网页搜索模型分配、统一图片理解，并修复了导航、取消和 CI 稳定性等多项问题。

发布渠道：稳定版 · v1.38.2

English → · 网页版完整更新日志 →

使用攻略

• 远程会话指南 — 了解如何配置主机、使用 reasonix remote CLI、管理会话生命周期以及排查远程连接问题。
• 网页搜索模型分配 — 为网页搜索查询配置独立模型，并了解路由和使用量归属。
• 本地图片路径 — 使用 view_image(path) 向代理提供本地图片，并了解限制与验证。

概览

Reasonix v1.38.2 — Reasonix 1.38.2

此版本提升了会话可靠性、模型服务配置和桌面性能。引入了仅追加会话日志与版本 head、独立网页搜索模型分配、统一图片理解，并修复了导航、取消和 CI 稳定性等多项问题。

发布日期：2026-09-08

Desktop 34 · CLI 4

桌面端更新

重点内容

• [Desktop · CLI] 仅追加会话日志与版本 head — 会话现在使用仅追加 DAG 日志（schema 2），将每次更改记录为版本 head。分叉、回退和版本选择均在同一日志内完成，不再创建单独文件，提高了可靠性并支持并发写入。 (#9908, #9910, #9912, #9913, #9916, #9917, #9919, #9921, #9922, #9924, #9925, #9926, #9939)
• [Desktop] 独立网页搜索模型 — 现在可以在模型偏好中为网页搜索查询指定专用连接和模型。自动模式仍为默认，显式分配会遵循目标连接的搜索开关。 (#9945)
• [Desktop · CLI] 统一本地图片与工具图片识别 — 本地图片路径现在通过 view_image(path) 内置支持视觉输入，工具返回的图片也共享现有的图片摘要服务。原生视觉仍为首选。 (#9933)
• [Desktop] 统一设置选择组件 — 设置页面现在共享紧凑的 SettingsSelect 和 SettingsOptions 组件，提供一致的尺寸、焦点状态和键盘行为。模型偏好与运行时偏好分组，布局更清晰。 (#9938)
• [Desktop] 停止按钮现在可靠中断 — 停止现在是会话级无条件中断。过期的回合 ID 不再阻止取消，界面会自动重试被拒绝的请求。 (#9898)
• [Desktop] 模型服务恢复等待有上限 — 回合不再在网络不稳定时无限等待。10 分钟的恢复预算会以清晰、可操作的错误结束回合，而不是一直旋转。 (#9899)
• [Desktop] 崩溃后会话保持可见 — 回合中途强制终止后，对话不再从侧栏消失。修复期间保留最后已知的预览和回合计数。 (#9902)
• [Desktop] 模型服务导航已恢复 — 点击“模型服务”不再打开“模型偏好”。导航存储现在能正确保留请求的页面。 (#9951)
• [Desktop] DeepSeek 协议迁移与模型标识修复 — 自定义模型 ID 被精确保留，官方 DeepSeek 连接现在默认使用 Chat Completions，并对现有端点执行一次性迁移。 (#9947)
• [Desktop] 模型服务协议契约强制执行 — 更改模型服务的 API 格式不再产生无效路由。冲突会被拒绝并给出推荐端点，失败时显示清晰的诊断信息。 (#9942)
• [Desktop] 思考型模型与无数字超窗的分段压缩已修复 — 思考型模型的摘要现在能被识别，无 token 数字的模型服务超窗也能正确触发分段回退。 (#9882)
• [Desktop] 摘要请求超窗恢复 — 超出上下文窗口的会话现在可以通过一系列回退（包括截断救援）恢复，而不是反复失败。 (#9879)
• [Desktop] 并行工具取消有界化 — 忽略取消的工具不再卡住整个回合。15 秒宽限期后，回合会以明确的中断结果继续。 (#9901)
• [Desktop] 后端调用失败被妥善处理 — 恢复谱系对话框中的错误不再触发全屏崩溃遮罩。它们会作为普通错误提示并记录。 (#9900)
• [Desktop] 设置组件布局所有权已恢复 — 模型分配矩阵不再错误换行。共享布局默认值降低了优先级，组件布局重新获得控制权。 (#9914)
• [Desktop] 内存筛查基线已稳定 — 应用内存基准测试现在在判定漂移前会稳定基线，防止因首个样本噪声而产生误报。 (#9950)
• [Desktop · Service] 桌面 CI 检查缩短并复用发版产物 — 前端绑定只构建一次并在作业间共享，稳定版发版复用预检的签名产物，减少 CI 时间。 (#9943)

新增

• [Desktop · CLI] 仅追加会话日志与版本 head — 会话现在使用仅追加 DAG 日志（schema 2），将每次更改记录为版本 head。分叉、回退和版本选择均在同一日志内完成，不再创建单独文件，提高了可靠性并支持并发写入。 (#9908, #9910, #9912, #9913, #9916, #9917, #9919, #9921, #9922, #9924, #9925, #9926, #9939)
• [Desktop] 独立网页搜索模型 — 现在可以在模型偏好中为网页搜索查询指定专用连接和模型。自动模式仍为默认，显式分配会遵循目标连接的搜索开关。 (#9945)
• [Desktop · CLI] 统一本地图片与工具图片识别 — 本地图片路径现在通过 view_image(path) 内置支持视觉输入，工具返回的图片也共享现有的图片摘要服务。原生视觉仍为首选。 (#9933)

改进

• [Desktop] 统一设置选择组件 — 设置页面现在共享紧凑的 SettingsSelect 和 SettingsOptions 组件，提供一致的尺寸、焦点状态和键盘行为。模型偏好与运行时偏好分组，布局更清晰。 (#9938)
• [Desktop · Service] 桌面 CI 检查缩短并复用发版产物 — 前端绑定只构建一次并在作业间共享，稳定版发版复用预检的签名产物，减少 CI 时间。 (#9943)

修复

• [Desktop] 停止按钮现在可靠中断 — 停止现在是会话级无条件中断。过期的回合 ID 不再阻止取消，界面会自动重试被拒绝的请求。 (#9898)
• [Desktop] 模型服务恢复等待有上限 — 回合不再在网络不稳定时无限等待。10 分钟的恢复预算会以清晰、可操作的错误结束回合，而不是一直旋转。 (#9899)
• [Desktop] 崩溃后会话保持可见 — 回合中途强制终止后，对话不再从侧栏消失。修复期间保留最后已知的预览和回合计数。 (#9902)
• [Desktop] 模型服务导航已恢复 — 点击“模型服务”不再打开“模型偏好”。导航存储现在能正确保留请求的页面。 (#9951)
• [Desktop] DeepSeek 协议迁移与模型标识修复 — 自定义模型 ID 被精确保留，官方 DeepSeek 连接现在默认使用 Chat Completions，并对现有端点执行一次性迁移。 (#9947)
• [Desktop] 模型服务协议契约强制执行 — 更改模型服务的 API 格式不再产生无效路由。冲突会被拒绝并给出推荐端点，失败时显示清晰的诊断信息。 (#9942)
• [Desktop] 思考型模型与无数字超窗的分段压缩已修复 — 思考型模型的摘要现在能被识别，无 token 数字的模型服务超窗也能正确触发分段回退。 (#9882)
• [Desktop] 摘要请求超窗恢复 — 超出上下文窗口的会话现在可以通过一系列回退（包括截断救援）恢复，而不是反复失败。 (#9879)
• [Desktop] 并行工具取消有界化 — 忽略取消的工具不再卡住整个回合。15 秒宽限期后，回合会以明确的中断结果继续。 (#9901)
• [Desktop] 后端调用失败被妥善处理 — 恢复谱系对话框中的错误不再触发全屏崩溃遮罩。它们会作为普通错误提示并记录。 (#9900)
• [Desktop] 设置组件布局所有权已恢复 — 模型分配矩阵不再错误换行。共享布局默认值降低了优先级，组件布局重新获得控制权。 (#9914)
• [Desktop] 内存筛查基线已稳定 — 应用内存基准测试现在在判定漂移前会稳定基线，防止因首个样本噪声而产生误报。 (#9950)

CLI 端更新

重点内容

• [Desktop · CLI] 仅追加会话日志与版本 head — 会话现在使用仅追加 DAG 日志（schema 2），将每次更改记录为版本 head。分叉、回退和版本选择均在同一日志内完成，不再创建单独文件，提高了可靠性并支持并发写入。 (#9908, #9910, #9912, #9913, #9916, #9917, #9919, #9921, #9922, #9924, #9925, #9926, #9939)
• [Desktop · CLI] 统一本地图片与工具图片识别 — 本地图片路径现在通过 view_image(path) 内置支持视觉输入，工具返回的图片也共享现有的图片摘要服务。原生视觉仍为首选。 (#9933)

新增

• [Desktop · CLI] 仅追加会话日志与版本 head — 会话现在使用仅追加 DAG 日志（schema 2），将每次更改记录为版本 head。分叉、回退和版本选择均在同一日志内完成，不再创建单独文件，提高了可靠性并支持并发写入。 (#9908, #9910, #9912, #9913, #9916, #9917, #9919, #9921, #9922, #9924, #9925, #9926, #9939)
• [Desktop · CLI] 统一本地图片与工具图片识别 — 本地图片路径现在通过 view_image(path) 内置支持视觉输入，工具返回的图片也共享现有的图片摘要服务。原生视觉仍为首选。 (#9933)

其他项目更新

• [Service] Windows CI 队列不再阻塞 — desktop-windows 作业现在有 45 分钟超时和有界的 WebView2 冒烟步骤，防止挂起的进程占用并发组。 (#9948)

• [Service] Windows CI 队列不再阻塞 — desktop-windows 作业现在有 45 分钟超时和有界的 WebView2 冒烟步骤，防止挂起的进程占用并发组。 (#9948)

升级提醒

本版本无需手动迁移。

风险提示

当前没有需要额外操作的已知风险。

致谢

感谢本版本的贡献者：@SivanCola、@XTLine、@Linearl

下载与安装

• 官网按平台下载
• 查看完整差异