SmaugBrain 桌面应用安装指南：Windows 下载、解压与登录教程
如果您已下载 SmaugBrain 桌面应用但无法打开，最常见的原因是文件未完全解压，或在更新过程中旧进程仍在占用文件。请按照以下步骤依次完成 Windows 版本的下载、启动、登录并选择 Agent。
下载前，请确认页面上是否有可用版本
打开桌面应用下载页面后，首先查看平台卡片。页面会显示当前已发布的平台及其版本号、架构、文件大小和发布日期。暂无可用版本的平台会提示“当前无下载”或“版本开发中”。请务必以下载页面当时显示的信息为准。
如何正确打开 Windows 便携版包
- 在 Windows 平台卡片上确认版本与架构。
- 点击下载并将压缩包保存到本地。
- 右键点击 zip 文件，选择“全部提取”。
- 打开解压后的文件夹，双击运行
SmaugBrain.exe。
请勿直接在压缩包的预览窗口中运行应用程序，否则可能导致依赖文件读取失败。建议将整个解压后的文件夹放置在固定位置，然后创建快捷方式。
登录并选择 Agent
- 输入官网账号关联的用户名、邮箱和密码。
- 点击“登录并获取 Agent”，或直接按回车键。
- 从账号列表中选择可用的 Agent。
- 进入工作区后，核对当前的账号与 Agent 信息。
列表会同步您账号下所有 Agent 的状态。如果某个实例已过期或状态异常，您将无法访问。请先前往官网核实账号及实例状态。
如何避免更新时文件被占用
首先关闭桌面窗口，然后检查系统托盘区是否仍有 SmaugBrain 图标。如有，请右键点击并退出应用。接着，将新的压缩包解压到新文件夹中，或在应用完全退出后替换旧文件。建议暂时保留旧目录，以便必要时回滚。
常见问题快速排查
| 问题 | 优先检查项 |
|---|---|
| 双击后无反应 | 文件是否已完全解压；是否直接从解压目录运行 |
| 无法替换文件 | 窗口及系统托盘进程是否已完全关闭 |
| 登录后未显示 Agent | 账号是否正确；是否已创建或分配实例 |
| 出现过期提示 | 官网显示的套餐或过期状态 |
| 提示需要最新版本 | 返回下载页面查看当前已发布版本 |
常见问题解答
可以直接从 zip 压缩包中运行吗？
不建议这样做。请先完整解压文件，再从解压后的文件夹中启动应用。
如何切换 Agent？
退出当前实例返回列表，然后选择另一个可用的 Agent。
如何切换账号？
退出登录后，使用官网的其他账号重新登录即可。
后续操作建议
登录后，请先选择一个状态正常的 Agent 进入工作区。如果仍然失败，请记录下载页面显示的版本号、系统提示信息以及导致问题的操作步骤，并将这些信息提供给管理员以便排查。