02 · RELEASE NOTES

本次更新

这是 v0.16.0 之后的补丁版本，重点加强远程 SSH 的认证与失败保护：现在可选择使用系统钥匙串保存 SSH 登录密码，所有 Agent 管理的远程操作必须先通过一次使用已保存主机配置的 Probe；连接、认证或主机密钥失败后，Wisp 会停止重复尝试并引导用户先修复配置。同时，本版支持添加任意自定义服务凭证，并补充 DOCX/BibTeX 对话资源的不可变预览绑定。

SSH 认证与远程安全

支持 SSH 密码认证：新增“SSH 密钥 / agent”和“密码”两种认证方式。密码只保存在操作系统钥匙串，不写入 SQLite、项目文件或同步数据；密钥认证仍是推荐默认方式。
Probe 后才允许 Agent 使用：SSH 主机必须使用当前保存的别名、用户、端口和密钥/密码成功探测后，才能被当前对话选为计算资源。自由拼装的 shell ssh / scp 被禁用，远程运行、Runtime、Files 和终端统一使用注册主机配置。
阻止失败登录循环：遇到超时、认证失败、IdentityFile、主机密钥或网络错误后，同一主机的后续托管请求会立即失败，不再反复连接而触发服务器爆破防护。修复网络或认证配置后，由用户明确重新 Probe 即可恢复。
可操作的故障诊断：失败弹窗会区分认证、IdentityFile、超时、DNS、host key 等常见原因，并提供“编辑主机配置”“去配置并探测”等入口；远程 Files 也会直接跳转到对应环境，而不是只提供盲目重试。
探测过程与结果反馈：环境页会在探测期间显示“正在连接服务器、验证 SSH 认证并读取环境信息”，防止重复点击；完成后明确区分密码认证、密钥认证、网络、Host Key 和受限 shell 等失败原因。
能力采集不再误伤连通性：uname -s、架构和 hostname 属于可选能力信息。只要 SSH 认证通过且远程非交互命令可以执行，即使部分信息缺失也会通过 Probe；仅当账号完全禁止远程命令执行时才阻止 Agent 使用。
主机管理与弹窗修复：环境列表新增逐主机“编辑服务器”入口；Escape 现在只关闭最上层主机/SSH 诊断弹窗，不会误关底层设置页。

自定义凭证与文档资源

自定义服务凭证（#244）：在“设置 → 凭据”中可添加服务名称、环境变量名和密钥/令牌，并支持替换、清除和删除。秘密值只保存在系统钥匙串，配置后的值会注入新启动的本地 Python 与内置 MCP 进程。
安全的凭证元数据：SQLite 只保存自定义凭证的名称和环境变量映射；环境变量会校验格式和重复占用。自定义凭证不会复制到 SSH/WSL 主机。
DOCX/BibTeX 资源绑定：对话中的 .docx 与 .bib 本地文件引用现在会绑定到不可变 artifact version；即使原文件随后变化，历史消息仍能打开当时的文档或参考文献内容。

界面一致性

统一中间文件、右侧面板、artifact modal 与终端 dock 的标签页激活样式、圆角和关闭图标尺寸，减少不同工作区之间的视觉跳变。

Wisp Science v0.16.1

下载安装包

Apple 芯片

Intel 芯片

安装程序 EXE

MSI 安装包

本次更新

SSH 认证与远程安全

自定义凭证与文档资源

界面一致性

升级说明

已知限制