# 故障排查

> 从失败的具体操作开始，并保留诊断信息。

---

LLMS 索引： [llms.txt](/yourbuddy/llms.txt)

---

| 现象 | 下一步检查 |
|---|---|
| 输入框不可用 | 先选择工作区再开始会话 |
| 模型请求失败 | 检查当前模型、登录或密钥、额度与网络状态 |
| 找不到生成的文件 | 检查会话目录与真实工具结果，不只看助手概述 |
| 没有 Context Doctor | 先建立已有会话；尚无标识的新会话不显示会话级审计控件 |
| 插件安装后没有界面 | 确认目标是 YourBuddy Web Profile，再通过应用生命周期重启 |
| 插件市场无法安装 | npm 包可能缺少明确的 Bundle 元数据，GitHub Topic 本身不足以证明可安装 |
| 代理测试成功但请求失败 | 同时查看桌面与 Host 结果；修改后保存、重启并重新测试 |
| Harbor 找不到历史 | 使用有已完成业务会话的精确目录，或提供明确任务 |
| 评测结果未评分 | 检查证据和覆盖率，信息不足时可以正常弃权 |
| 帮助页面打不开 | 复制帮助菜单显示的地址，在浏览器中打开；检查网络，Help 不包含离线正文 |
| 开发教程找不到插件文件 | 使用教程中的绝对路径，并从已准备好的 DSH 源码仓库运行命令 |

## 启动与系统提示

运行时准备失败时保留启动诊断，不要首先删除应用数据目录。Apple 签名、公证与 Tauri 更新签名是独立机制，请按实际发行说明处理系统打开提示。

## 提供有用的问题信息

附上应用版本、系统与架构、失败操作和可见错误。去掉凭据、私有任务内容与敏感文件路径。macOS 应用根目录为 `~/Library/Application Support/YourBuddy`，项目产物保存在选定工作区。

详细前提见[模型配置](/yourbuddy/docs/models/)、[设置](/yourbuddy/docs/settings/)或对应[插件页](/yourbuddy/plugins/)。[反馈问题](https://github.com/istarwyh/yourbuddy/issues)。