快速结论
alpha.3 的 Web、桌面优先使用保存凭据；headless 默认使用环境变量与 .env。分别核对启动方式、提供方、端点和凭据来源，不把登录成功当作脚本配置一致。
- 规则来自官方 dsh v0.2.1-alpha.3 发布说明。
- Web、桌面与 headless 的默认凭据来源有区别。
- 排查时记录来源与错误类型，不输出完整密钥。
本次更新：10 月 15 日核验后新增，区分原始发布日期、适用范围与方法建议。
官方 alpha.3 发布说明调整凭据优先级：Web 与桌面优先使用已保存凭据；headless 默认使用环境变量和 .env，不读取已保存密钥。升级后，图形界面可用而脚本失败时，应先检查来源是否一致。
1. 记录启动方式与模型配置
建立一张不含秘密值的排查表：
| 项目 | 记录内容 |
|---|---|
| 启动方式 | Web、桌面或 headless |
| 实际版本 | dsh 标签或已安装版本 |
| 模型服务 | 提供方与完整端点 |
| 凭据来源 | 保存配置、环境变量或 .env |
| 错误信息 | 状态码与脱敏错误摘要 |
不要在聊天、日志截图或公开 issue 中粘贴密钥。若确实需要核对标识，可使用平台提供的凭据名称和 ID。
2. 分别验证两个入口
先在图形界面发送短请求，再在脚本中做等价请求。保持模型名、服务地址和任务一致，只核对当前进程实际读取的来源，不同时重装插件和重建整个配置。
界面上的登录状态、API Key、第三方提供方账号可能属于不同路径。错误指向认证时，回到相应凭据所属平台确认，而不是把另一服务的密钥复制过来。
3. 排查进程环境
检查脚本从哪个目录启动、加载哪个配置，以及启动它的终端或服务是否拥有预期环境。不要用打印整个环境变量列表的方法排查；只记录必要变量是否存在，不打印值。
本文不假设不同版本或所有 SDK 的加载细节一致，具体顺序按所装版本说明与当前配置核对。
4. 修正后做最小复核
修正一个入口后，只发送短请求确认认证与模型选择，再恢复原任务。保留错误类型和配置来源，便于下次升级比较。界面显示脱敏与凭据是否仍有效需要分别处理。
参考资料
本文依据以下资料整理，版本与接口信息请以来源页面的现行说明为准。
阅读至此返回学习中心