# 数据与故障排查

[English](data-troubleshooting.md) | 中文

DeepSeekGUI 把应用状态与 Managed Harness Home 保存在 Windows 用户目录下。模型请求仍会发送给你配置的提供方；数据保存在本地，不代表远程模型变成本地模型。

## DeepSeekGUI 把数据保存在哪里

| 数据 | 默认位置 | 说明 |
| --- | --- | --- |
| Managed Harness Home | `%APPDATA%\DeepSeekGUI\dsh` | Harness 管理的凭据、设置、会话、Profile 与插件。可从**数据位置**迁移；见下文。 |
| Launcher selection | `%APPDATA%\DeepSeekGUI\launcher-state.json` | 当前 Home 与 Profile、last-known-good 选择和已脱敏的启动失败。 |
| 桌面偏好 | `%APPDATA%\DeepSeekGUI\desktop-ui-state.json` | 窗口尺寸、更新偏好与本地 UI 确认状态；主题由 Harness 设置保存。 |
| 服务日志 | `%APPDATA%\DeepSeekGUI\dsh-service.log` | 已脱敏并轮转；包含当前文件与有上限的历史文件。 |
| 诊断导出 | `%APPDATA%\DeepSeekGUI\diagnostics` | 只有你要求导出时才创建的本地诊断包。 |
| 更新缓存 | `%APPDATA%\DeepSeekGUI\updates` | 最多保存一条已验证安装器记录及其文件。 |
| 全局记忆 | 托管 Harness Home 内 | 在设置中编辑的跨项目偏好。 |
| 项目记忆 | 所选工作区中的 `<文件夹名>.memory.md` | 助手维护的项目事实，属于项目文件的一部分。 |

Windows 通过 Known Folder API 解析真实应用数据目录。表格使用 `%APPDATA%` 作为熟悉的默认写法。

## 迁移 Managed Harness Home

从菜单选择**数据位置…**可以查看当前数据目录并迁移。选定目标文件夹后：DeepSeekGUI 复制每一项、按大小与 SHA-256 逐项校验、把 launcher 指向新目录，并重启 Harness。重启会逐项核对新位置，只有核对通过后才会提示删除旧的那份。在那之前旧文件原样保留；核对失败时保留旧文件并停下。

这条路径只搬 Managed Harness Home。它不搬程序安装位置——安装器、快捷方式、卸载项与更新器才是它的归属——也不搬你选择的 Existing Home、你的项目目录，或 `%APPDATA%\DeepSeekGUI` 下的其他文件。

## 卸载与重新安装

卸载程序会询问是否删除 DeepSeekGUI 数据目录。选择**否**会保留凭据、设置、会话与 Profile，供以后重新安装时继续使用。只有你确定要删除这些数据时才选择**是**。

升级过程中的静默卸载会保留数据，不显示该询问。

## 隐私边界

- DeepSeekGUI 通过 Harness 把提示词、所选上下文与附件发送给配置的模型提供方。
- 会话数据与凭据保存在当前 Harness Home 中；已配置的提供方或工具仍可能发送任务要求的内容。
- 服务日志会在写入前脱敏凭据形态文本。
- 诊断导出保存在本地，绝不自动上传。
- 项目记忆是工作区中的普通 Markdown 文件。公开项目之前，请先检查其中的内容。
- Existing Home 会原地使用；DeepSeekGUI 不会把它复制进 Managed Home。

向电脑外部分享任何内容前，请检查工具批准请求与导出的诊断信息。

<a id="windows-smartscreen-blocks-the-installer"></a>

## Windows SmartScreen 阻止安装包

DeepSeekGUI V1 尚未签名。请从同一个 GitHub Release 下载安装包与 `SHA256SUMS.txt`，校验 SHA-256；只有 hash 一致时，才使用**更多信息 → 仍要运行**。

## DeepSeekGUI 报告缺少 API key

打开**设置 → 模型**，为当前会话选择的准确提供方路由保存 key。详见[模型与视觉](models.zh.md)。

## Harness 无法启动

1. 打开 Harness 区域并阅读失败阶段。
2. 检查是否有其他进程占用端口 `3080`。
3. 最近切换过 Profile 或安装过插件时，请检查 Recovery Details 与 Plugin Manager 恢复入口。
4. 打开日志文件夹或导出诊断信息。
5. 修正原因后重启 Harness。

Profile 切换失败后，DeepSeekGUI 可能回到 last-known-good Profile。恢复提示说明回退已经成功，不代表尝试过的 Profile 已经加载。

## DeepSeekGUI 已经打开，但窗口不见了

请检查系统托盘。关闭窗口会隐藏常驻应用。再次打开 DeepSeekGUI 快捷方式后，已有实例应当重新获得焦点。

显示器、DPI 或分辨率变化后，DeepSeekGUI 也会把已保存窗口范围限制回可见工作区。

## 插件操作失败

重试前，请阅读操作输出与恢复状态。恢复确认窗口打开时，不要编辑受保护的 Profile 文件。DeepSeekGUI 报告文件 drift 时，请人工检查文件；自动恢复会停止，避免覆盖更新的改动。

## 浏览器没有打开

DeepSeekGUI 使用应用内的浏览器面板，首次浏览器操作时启动。确认 Harness 正在运行、目标是公开的 `http` 或 `https` 地址；本机、内网和不受支持的 URL 会被拒绝。截图分析还需要当前模型支持图片输入。

## 检查更新报告没有可用更新

已安装版本已经是最新发布版本。这不会改变已安装应用。你也可以从 GitHub 手动下载 Release。

## GUI 无法使用时导出诊断

运行：

```powershell
DeepSeekGUI.exe --export-diagnostics
```

该命令会输出导出目录。把诊断包附加到公开 issue 前，请先检查内容。

## 获取帮助

新建 issue 前，请先搜索已有 [DeepSeekGUI issues](https://github.com/See-Sol-Lab/DeepSeekGUI/issues)。请提供 DeepSeekGUI 版本、Windows 版本、尝试过的操作、可见错误，以及你已经检查过的诊断文件。