02 · RELEASE NOTES

本次更新

这是继 v0.19.0 之后的功能与稳定性版本，重点把上下文管理交还给用户，并让长对话、工具执行和模型用量更透明、更可控。Wisp 不再自动改写历史；当上下文接近上限时会提醒，由用户通过 /compact 主动归档并压缩。与此同时，内置科研 Skills 已迁移到 Wisp 原生 Run 与工具契约，聊天中的进度、推理和工具步骤也获得了更清晰的分层展示。

用户主导的上下文管理

不再自动压缩历史：移除按 token 和时间触发的自动压缩；达到上下文窗口 80% 时只提醒一次，不会在后台改写消息，模型提供商的前缀缓存也能保持稳定。
归档优先的 /compact：CLI 和桌面对话均可主动执行 /compact。完整历史先写入项目的 .wisp/history/，写入失败则中止；随后仅压缩发给模型的旧内容，界面中的完整视觉记录保持不变，压缩后的占位信息会指向可检索归档。
流式工具输入预算：shell、Python 和 R 的结果在写入模型上下文时默认限制为 16 KiB，并保留头尾与恢复提示；完整输出仍显示在界面中。可通过 WISP_TOOL_RESULT_BUDGET 调整，设为 0 可关闭。
只读 explore 子 Agent：新增隔离的多步检索工具，使用 read、grep 和 search 完成探索，将完整轨迹保存到 .wisp/subagents/，主对话只接收带归档位置的结论摘要。

科研 Skills 与 Run 契约

内置 Skills 迁移到 Wisp 原生能力：GPU 和长任务工作流改用 run_in_context、get_run、monitor_run 与 cancel_run；图表、论文、文献和自定义工作流改用明确的委派、图像和文件工具，不再依赖不存在的 host.* Python SDK。
诚实暴露平台边界：移除已失效的 Operon provider adapter、环境和锁文件；尚未支持的 Modal、托管 endpoint 与调度器生命周期会明确提示限制，不再伪装为可用能力。
PDF 探索适配 Wisp：pdf-explore 改为通过 Python kernel sidecar 注入可用助手，并按 Wisp 的归档与上下文规则工作。
新增 journal-club-ppt：加入期刊俱乐部演示文稿工作流及目录发现回归测试。

对话过程与模型设置

进度、推理和工具分层显示：按真实事件顺序展示紧凑的进度文本、独立折叠的推理和仅包含连续工具调用的 Steps 面板；流式更新期间保持用户的展开状态。
折叠状态也能看到当前步骤：运行中的 Steps 面板折叠后，标题会实时显示最新工具或进度摘要。
逐回复 token 用量：每轮显示输入、输出、缓存命中和推理 token；修正 OpenAI、Anthropic、GLM、Moonshot 与 DeepSeek 兼容接口的统计，并将用量持久化，重开会话后仍可查看。
更贴合模型能力的设置：推理强度选项会根据模型家族调整；新建模型时自动填充已知上下文窗口与输出上限；模型列表支持拖动排序。

修复内容

提前终止无进展工具循环：Agent 会在最近 16 个工具批次中发现同一调用重复五次时停止，覆盖连续与 A/B 交错循环，避免耗尽整轮 token 预算。
不再回放历史 reasoning_content：OpenAI 兼容请求仅保留当前推理过程，不再把旧推理反复发送给模型，减少上下文膨胀和循环强化。
二进制文件读取更安全：read 会通过扩展名、PDF magic 和 NUL 字节识别常见二进制文件，返回可操作的 Python 或图像查看提示，不再输出乱码。
SQLite 并发稳定性：导出快照从创建起使用单文件回滚日志；多语句写事务统一通过 BEGIN IMMEDIATE 获取写锁，消除快照导出和并发写入的立即 BUSY 抖动。
Run 取消竞态：调用方刚请求取消、后台已确认 Cancelled 时不再误报「已经取消」。
预览与侧边聊天：修复 PPTX/XLSX 预览宽度反馈循环、PNG 裁剪选区定位与 Escape 撤销，以及侧边聊天跨会话串线。

Wisp Science v0.20.0

下载安装包

Apple 芯片

Intel 芯片

安装程序 EXE

MSI 安装包

本次更新

用户主导的上下文管理

科研 Skills 与 Run 契约

对话过程与模型设置

修复内容

升级说明

已知限制