DeepSeek Harness 升级后怎么排查：模型、插件、工作目录与会话结果

Harness 预览版升级既可能改变功能，也可能调整配置和协议。本篇结合官方版本说明，提供可以逐项执行的检查流程，未在读者设备上进行安装验证。

1. 留下可比较的基线

记录应用版本、插件清单、模型提供方、API 协议和工作档案。保存一个容易核对的小任务、预期输出和配置副本。若出现故障，先留下错误时间与日志，再决定改哪些设置。

可准备如下记录表，避免把凭据本身贴进报告：

项目	记录内容
环境	系统、应用版本、官方或社区发行渠道
模型	提供方、模型 ID、协议、脱敏端点
输入	文件副本、当前目录、任务文本
输出	实际文件、退出状态、工具错误

2. 在新会话确认模型连接

官方模型配置说明指出，已发送请求的会话会保留日志记录的模型。因此，修改默认模型后，先用新会话验证，再决定如何处理旧会话。

先发普通文本问题；能返回后，再测试文件和工具。失败时核对模型 ID、协议、凭据入口和服务余额，不同时删除多个提供方。自定义网关支持的协议要与配置一致。

3. 核对实际目录和输出位置

给任务明确输入与输出路径。v0.2.1-alpha.2 提供工作目录相关接口，但仍需检查工具实际使用的目录，尤其是进入 Worktree 或切换项目后。独立 checkout 用于分离 Git 工作文件；网络和权限策略仍要分别检查。

先读取一个已知文件，再生成一个指定输出文件。若输出未在预期位置出现，检查执行记录中的路径，而不是只依据最终回答寻找文件。

4. 插件问题单独处理

一次调整一个非必要插件，记录加载错误和依赖。按当前版本文档修正明确的兼容性问题；不要直接覆盖整个配置文件。官方配置教程介绍 schema 与生命周期，扩展维护者应同时检查加载、配置变化和卸载行为。

当前发布说明包含 both 工具展示模式移除等变化。只有确认自己的配置用到该字段后，才做对应迁移。

5. 对照任务结果和界面状态

新版修复了若干任务状态显示问题。排障时同时检查实际生成文件、工具退出状态与界面提示；回答已结束、工具步骤结束和后台工作流结束可能是不同时间点。

恢复判断应落到同一任务的结果：模型可用、目录正确、必要插件加载、输出内容符合预期。若仍失败，把版本、脱敏配置和最小任务整理成反馈，保留原会话与现场记录。

10 月 20 日：Nightly 只验证指定变化

社区 nightly-20261019列出旧 WebView 可用性与批量归档候选修复。它是开发构建；10 月 20 日核验时常规版为 v0.24.5，当前已更新至下文 v0.25.0。记录标签、提交 3fa5f28 和实际内核后，再用原有复现步骤比较前后表现，不以安装成功代替问题已解决。

准备验证时，先保存重要输出与配置记录，使用可恢复的工作副本。回到原版本后，也应重新检查模型、插件和目录；本文没有确认各版本配置一定能双向兼容。归档操作另查候选对象，避免误把子代理会话与用户主会话混为一类。

10 月 23 日：按 v0.25.0 核对三个新增场景

社区常规版现为 v0.25.0。编辑或复制 MCP 服务后比较必要隐藏字段与 !!js 值，插件重写 cordis.patch.yml 后另查表达式保留。字段存在、授权完成和工具调用成功分别验收，具体见配置保留教程。

Linux 语音、文件粘贴或 deepin/DFM uri-list 问题，按原复现任务观察修复结果；额外窗口切换档案后，再确认主窗口的启动档案和实际目录。保留系统、包类型与日志，不能据发行说明断言所有环境均恢复。

10 月 25 日：按新版本重新定位入口与环境

官方 rc.3 修复切换会话后的未发送草稿，并对齐 API Key 的模型列表更新。先用新会话确认模型请求，再检查列表与草稿，不把列表刷新问题直接当成凭据失效。

社区最新两个 Nightly 涉及 Windows 数据目录重启回退、macOS 登录 PATH、Linux AppImage 媒体与代理等不同层。先记录故障首次出现的版本、启动方式和实际目录；数据迁移见专门教程。

手机误用桌面布局时，另记录窗口尺寸和输入设备，对照 191206f；它是开发构建，常规 v0.25.0 不应被默认包含该后续修复。

10 月 26 日：设置重置和 Linux 崩溃分开复现

新 Nightly 列出通知等设置持久化与 Wayland/NVIDIA 设置浮层修复。设置保存后先关闭设置页核对，再完整退出重启；另确认启动档案与数据目录。Linux 崩溃另留安装包、驱动和会话类型，不能凭一个错误提示判断配置损坏。

具体操作见设置持久化排查，相关修复仍属于开发构建。

10 月 27 日：先用 v0.25.1 常规版对照原故障

此前部分仅见于 Nightly 的目录、输入和持久化修复，已纳入 v0.25.1。先记录实际版本，再用原来的最小任务比较；不必仅因旧文写着“候选修复”就继续追逐旧 Nightly。

本轮新增 WebKitGTK 按键与文本问题、Windows pnpm 探测及插件失败定位。分层步骤见Linux 输入排查和Windows 插件排查。

10 月 28 日：按新版重新建立环境与任务基线

本轮官方更新后，先核对实际运行时及自定义配置，再用原任务比较。准备步骤见Alpha 升级教程。保存模型、目录、工具和原始错误，避免同时改变多层后失去复现条件。

10 月 29 日：同步和热加载问题分别复现

社区新预发布涉及同步目标、重复提交、监听与 MCP 重载。先保留版本和最小步骤，再按对应功能验证，避免把所有故障归为内核升级失败。远程状态见同步教程，保存配置后还需确认实际服务行为。

10 月 31 日：启动与恢复按新版分别验收

社区 v0.25.2 列出启动恢复与本地/远程隔离变化。先保留最初错误，再检查实际服务与任务结果，详见启动排查教程。