English | 中文
本教程帮助 Windows 新用户从下载安装走到可用的 DeepSeek coding agent（编程智能体）会话。DeepSeekGUI 自带 Harness 运行时、Node.js 与 pnpm，安装后的应用不需要开发工具链。
- 一台 Windows 10 或 Windows 11 x64 电脑。
- 一个 DeepSeek 账号或 DeepSeek API key。
- 一个你愿意让 agent 检查和编辑的文件夹。
从最新发布页下载 Windows 安装包 DeepSeekGUI-Setup-<版本号>.exe。Linux AppImage 通过独立的实验性发布提供，当前可用链接见仓库首页。
DeepSeekGUI 目前的发行包未附代码签名，Windows SmartScreen 可能显示未知发布者警告。运行安装包前，请先用同一发布页的 SHA256SUMS.txt 校验文件：
Get-FileHash .\DeepSeekGUI-Setup-<version>.exe -Algorithm SHA256输出的 hash 与发布清单完全一致时再继续。在 SmartScreen 中选择更多信息，然后选择仍要运行。
运行安装包。DeepSeekGUI 会为当前 Windows 用户安装，不需要管理员权限；安装过程会创建开始菜单和桌面快捷方式，并在结束后启动 DeepSeekGUI。
关闭主窗口只会把 DeepSeekGUI 隐藏到系统托盘，Harness 会继续运行。需要停止 Harness 并完全退出时，请从菜单或托盘选择退出 DeepSeekGUI。
首次启动时 DeepSeekGUI 会显示欢迎页，有两种方式开始：
- 用 DeepSeek 账号登录。系统浏览器会打开 DeepSeek 登录页；登录完成后 DeepSeekGUI 回到前台，并用几步简短的设置介绍你的额度、了解你的用途，再选择工作过程显示多少细节。账号会话使用账号额度，不需要 API key。
- 添加 API Key，粘贴你的 DeepSeek API key。
稍后配置会在本次运行中跳过欢迎页。之后可以从左下角的账号入口登录，或在设置 → 模型里添加 key：
- 从左下角打开设置。
- 打开模型。
- 选择 DeepSeek 提供方并输入 API key。
- 选择模型，然后返回首页。
DeepSeekGUI 通过 Harness 凭据服务把 key 保存在应用数据目录中，不会把 key 写入安装包、命令行或诊断日志。
模型选择、图片输入与自定义提供方见模型与视觉。
选择本次任务使用的文件夹。在推荐的 Sandbox 模式下，这个工作区是 agent 可以写入的文件范围。评估不熟悉的自动化时，请从项目副本或已纳入版本控制的目录开始。
新建会话，并给 agent 一个具体结果，例如：
阅读这个项目，解释它如何启动，并找出我最应该先理解的三个文件。暂时不要编辑任何内容。
确认结果符合预期后，再要求 agent 完成边界明确的修改。DeepSeekGUI 会流式显示回复，并把会话保存在当前选择的 Harness Home 中，供你稍后恢复。
工具批准由 Harness 提供。批准前请阅读请求执行的具体动作。DeepSeekGUI 绝不自动批准操作，也不维护另一份信任缓存。
在会话旁边打开改动视图阅读文件差异，打开 Git 视图查看分支状态和本会话的提交结果。视图读取本地状态，检查项目不消耗模型请求。详见工作台视图与 Git 工具。
把长期协作偏好写进 设置 → 全局记忆，助手会在每个项目中遵循；这个项目的事实由助手记录在会话的记忆视图中。详见记忆。
日常工作请保持 Sandbox。只有任务确实需要 Windows 账户级访问，而且你理解界面显示的风险时，才启用 Full Access。