快速结论
先保留配置与原任务记录，再分别检查模型请求、实际工作目录、插件加载和生成文件。一次只改变一层配置，避免同时升级和重写设置后无法定位原因。
- 官方 v0.2.1-alpha.2 仍为预发布版，包含工作目录、SDK 和旧配置的兼容性变更。
- 官方模型配置文档说明，已发过请求的会话保留日志中的模型，新会话默认选择另行处理。
- 本文给出编辑设计的排障流程，不是已经完成的用户环境测试结果。
本次更新：10 月 10 日新增并核验官方来源，分别标明事件日期、可用范围及文档示例。
Harness 预览版升级既可能改变功能，也可能调整配置和协议。本篇结合官方版本说明，提供可以逐项执行的检查流程，未在读者设备上进行安装验证。
1. 留下可比较的基线
记录应用版本、插件清单、模型提供方、API 协议和工作档案。保存一个容易核对的小任务、预期输出和配置副本。若出现故障，先留下错误时间与日志，再决定改哪些设置。
可准备如下记录表，避免把凭据本身贴进报告：
| 项目 | 记录内容 |
|---|---|
| 环境 | 系统、应用版本、官方或社区发行渠道 |
| 模型 | 提供方、模型 ID、协议、脱敏端点 |
| 输入 | 文件副本、当前目录、任务文本 |
| 输出 | 实际文件、退出状态、工具错误 |
2. 在新会话确认模型连接
官方模型配置说明指出，已发送请求的会话会保留日志记录的模型。因此，修改默认模型后，先用新会话验证，再决定如何处理旧会话。
先发普通文本问题；能返回后，再测试文件和工具。失败时核对模型 ID、协议、凭据入口和服务余额，不同时删除多个提供方。自定义网关支持的协议要与配置一致。
3. 核对实际目录和输出位置
给任务明确输入与输出路径。v0.2.1-alpha.2 提供工作目录相关接口，但仍需检查工具实际使用的目录，尤其是进入 Worktree 或切换项目后。独立 checkout 用于分离 Git 工作文件；网络和权限策略仍要分别检查。
先读取一个已知文件，再生成一个指定输出文件。若输出未在预期位置出现，检查执行记录中的路径，而不是只依据最终回答寻找文件。
4. 插件问题单独处理
一次调整一个非必要插件，记录加载错误和依赖。按当前版本文档修正明确的兼容性问题；不要直接覆盖整个配置文件。官方配置教程介绍 schema 与生命周期，扩展维护者应同时检查加载、配置变化和卸载行为。
当前发布说明包含 both 工具展示模式移除等变化。只有确认自己的配置用到该字段后，才做对应迁移。
5. 对照任务结果和界面状态
新版修复了若干任务状态显示问题。排障时同时检查实际生成文件、工具退出状态与界面提示；回答已结束、工具步骤结束和后台工作流结束可能是不同时间点。
恢复判断应落到同一任务的结果：模型可用、目录正确、必要插件加载、输出内容符合预期。若仍失败，把版本、脱敏配置和最小任务整理成反馈，保留原会话与现场记录。
参考资料
本文依据以下资料整理，版本与接口信息请以来源页面的现行说明为准。