专题指南正式文档
DSPX 常见问题与诊断
排查 Provider、扩展、桌面端连接、CLI 和会话上下文问题。
排查 Provider、扩展、桌面端连接、CLI 和会话上下文问题。 完成本页后，你应能够理解功能边界，并按步骤完成配置和验证。
开始前检查
- 已安装可用的 DSPX 桌面端或 CLI
- 已准备模型 Provider 或组织登录方式
- 已明确本次任务允许访问的工作目录和工具权限
Provider 调用失败
优先检查 API Key、模型名称、网络代理、账户余额和速率限制。若仍失败，请导出诊断日志并脱敏后提交支持。
扩展不可用
检查扩展是否启用、启动命令是否正确、依赖是否安装、端口是否占用、权限是否被拒绝，以及 MCP Server 日志。
会话结果不符合预期
确认当前工作目录和会话是否正确，补充目标、约束和验收标准。复杂任务建议拆分阶段并保留中间结果。
完成标准
不要只以“按钮点击成功”作为完成依据，请至少核对以下结果。
- 保存或提交后页面没有错误提示，刷新后配置仍可正确回显。
- 使用目标角色完成一次实际访问或运行验证。