从零开始 · 桌面应用篇
安装 DeepSeek Harness
桌面版
下载、安装,在设置里接入 SHUN API。
用鼠标完成准备,再用一句中文创建第一个文件。
核对日期: · 预留约 20–40 分钟,下载时间取决于网络。
先准备好这三样
- Windows 10 / 11 · x64
- 适用于 Intel / AMD 64 位电脑。在「设置 → 系统 → 关于」核对系统类型;Windows ARM 不在本文已核对范围内。[1]
- 下载网络
- 能访问 DeepSeek 官网和安装包下载服务器。
- SHUN 个人用户 key
- 还需管理员确认的模型 ID、容量上限和可用额度;模型须支持 OpenAI Chat Completions、流式回复与工具调用。
官方桌面包自带运行组件,不需要先安装 Node.js、Git、Python 或运行 npm 命令。[2][3] 调用 SHUN 模型会消耗账号额度,无需先购买 DeepSeek 官网 API 额度。
界面核对版本:0.2.1-rc.2。下载图为官网实拍;8 张应用图为官方组件的隔离演示,SHUN 图为本站演示账号。图片可点击放大,图中模型不代表账号授权。
在 DeepSeek 官网下载 Windows 版
- 打开 DeepSeek 官方下载页,核对域名
www.deepseek.com。 - 在 DeepSeek Harness 全新桌面端 区域点击「下载 Windows 版」,等待
dsh-latest-windows-x64.exe下载完成。
下载列表显示 Windows .exe 已完成;不要选择手机安装包或 GitHub 源码包。
运行安装包,打开桌面应用
- 双击下载完成的
dsh-latest-windows-x64.exe。 - 按向导安装,保留默认安装目录;更改时选择专用空目录,避开磁盘根目录和已有项目。
- 完成后启动应用;没有自动打开时,在开始菜单搜索 DeepSeek Harness。首次初始化请等待完成。[3]
看到 DeepSeek Harness 欢迎页或主界面。安装受阻时查排错表。
首次欢迎页,选择稍后配置
- 欢迎页点击「添加 API Key」,密钥框留空,再点「稍后配置」。
- 如出现预览版说明,阅读后点「继续」。已在主界面可直接做下一步。
这里不要填 SHUN key。欢迎页的密钥入口对应 DeepSeek 官方服务;SHUN key 在第 5 步与 SHUN 地址一起填写。
已进入主界面。
取得自己的用户 key 和模型 ID
- 向 SHUN 管理员取得个人用户 key,确认完整模型 ID、上下文窗口、最大输出 token 数及工具调用支持。
- 打开 SHUN API 控制台,粘贴用户 key,点「进入」并核对可用额度。
- 模型 ID 保留完整后缀与大小写。「模型价格」可查 ID,但公开目录不等于账号已获授权。
使用个人用户 key;不要使用管理员密钥,也不要把 key 发进聊天、截图或公开文档。
已有可用个人 key、确认过的模型 ID、容量上限和额度。
在设置里添加 SHUN API
① 打开自定义模型 API
- 点侧栏底部「… 更多 → 设置」(已登录时从头像 / 账号菜单进入);也可按 Ctrl + ,。
- 进入「模型 → 添加模型提供商 → 自定义模型 API」。
② 填地址、协议与密钥
| 界面字段 | 填写内容 |
|---|---|
| Provider ID | shun;已有同名项时编辑它。 |
| 显示名称 | SHUN API |
| API 地址 / 基础 URL | https://apivip.shun.team/v1 |
| API 协议 | OpenAI Chat Completions |
| API 密钥 | 自己的 SHUN 用户 key;不要填管理员 key。 |
https://apivip.shun.team/v1地址保留 /v1,不要手工追加 /chat/completions。[4]
③ 添加模型并保存
- 点「添加模型」,填写第 4 步确认的完整模型 ID;右侧显示名称可留空。
- 点模型行右侧、垃圾桶左边的「> 模型选项」按钮,按管理员确认的数值填写「上下文窗口」与「最大输出 token 数」;图片输入和推理选项先保持默认。
- 点「创建提供商」。
也可用「获取可用模型 → 添加所选」导入已确认的 ID;探测失败时手工添加。保存成功或绿色凭据提示只说明配置存在,实际调用在第 7 步检查。[4]
模型设置页出现 SHUN API 和自己的模型。
Key 保存在此电脑的 Harness 本地凭据文件;界面隐藏不代表文件已加密,不要分享整个配置目录。
选择模型和练习文件夹
① 创建空练习文件夹
- 按 Win + E,在资源管理器地址栏输入
%USERPROFILE%并回车。 - 在空白处右键「新建 → 文件夹」,命名如下。
Harness-Learning已有同名目录且不为空时,换一个新名称;后续任务和路径中的 Harness-Learning 一并替换。
② 在会话里选目录和模型
- 关闭设置,点左侧「新会话」。
- 点输入框上方「选择工作区」;若出现菜单,再点「添加工作区…」。在系统文件夹窗口选择刚创建的目录。找不到时,在地址栏输入
%USERPROFILE%\Harness-Learning并回车;已添加的目录可直接选中。 - 点输入框右下的「请选择模型」或当前模型名,在 SHUN API 分组选择自己的模型。
保持「标准模式」和「工作区内修改」。如使用过规划 / 只读模式,先恢复这两项。只确认符合本次任务范围的权限请求。[5]
工作区显示练习目录,模型属于 SHUN API,聊天框可以输入。
发送第一条文件任务
将任务复制到 Harness 聊天输入框;若改过文件夹名,先替换首行,再点击发送。
请只在当前选择的 Harness-Learning 文件夹中操作。
创建一个 UTF-8 编码的 hello.txt,内容为:
你好,DeepSeek Harness!这是我的第一次练习。
如果文件已经存在,请先告诉我,不要覆盖。
完成后请实际读取文件确认内容,并告诉我完整保存路径。等待回复;如有权限提示,只确认本次练习所需操作。报错时查排错表,不要反复发送。
收到模型正常回复及文件完整保存路径;下一步亲自核对文件。
打开文件,确认真的完成
- 在资源管理器地址栏粘贴下方路径并回车;改过目录名时换成实际路径。
- 双击
hello.txt,用记事本核对内容:「你好,DeepSeek Harness!这是我的第一次练习。」隐藏扩展名时文件可能只显示为hello。
%USERPROFILE%\Harness-Learning模型正常回复、练习目录存在 hello.txt、文件中文内容正确,三项都满足才算完成。
下次使用与更新
从开始菜单打开 Harness,选已有会话,或新建会话并核对模型与目录。更换 key / 模型后先开新会话确认,不必重装。
更新入口:「应用 → 检查更新…」。先保存工作并结束任务;完全退出使用应用菜单或托盘的退出入口。[3]
卡住了?按现象排查
| 现象 | 处理 |
|---|---|
| 下载不完整 / 安装被拦截 | 重新从官网 Windows 入口下载,核对系统为 x64、文件完整和发布者信息。系统策略阻止时联系设备管理员。 |
| 安装目录无效 / 应用打不开 | 使用默认或专用空安装目录;核对磁盘空间,完整退出再打开。不要删除 .dsh 来重置。 |
| 默认 DeepSeek 提示缺少 key | 在新会话中选择 SHUN API 分组的模型;SHUN key 应保存在自定义提供商。 |
| Provider ID 已存在 / 格式不合法 | 已有 shun 时编辑它;新 ID 以小写字母开头,只用小写字母、数字和短横线。 |
| 无法保存 / 模型列表为空 | 核对地址、协议与完整模型 ID。获取可用模型失败可手工添加;本篇图形界面路线至少添加一个模型。 |
| 401 / Invalid API key;403 / 无权限 | 重新粘贴有效 SHUN 用户 key 并保存;权限问题让管理员核对账号授权。 |
| 404 / model not found | 地址应为 https://apivip.shun.team/v1,不能缺少或重复 /v1,也不追加 /chat/completions;核对协议和完整模型 ID。 |
| 400 / 参数、reasoning 或工具错误 | 让管理员核对工具调用、协议与容量上限;最大输出 token 数不可超过模型上限,图片和推理选项先恢复默认。 |
| 402 / 额度不足;429 / 限速 | 在控制台查额度;限速时停止连续重试,等待恢复。 |
| 503 / Proxy is not configured / 无可用渠道 | 联系管理员恢复模型渠道,恢复后再做文件任务。 |
| SSL / certificate 错误 | 检查系统时间、Windows 更新和组织网络证书;保留 HTTPS 校验。 |
| 聊天框不能输入 / 只有文字没有文件 | 先选工作区和 SHUN 模型,保持标准模式、工作区写入权限;确认模型支持工具调用,处理待确认操作,再让应用报告实际路径并读取验证。 |
联系管理员时提供 Windows / Harness 版本、卡住的步骤、时间和报错文字;截图遮住 key 和个人信息,不发送凭据文件或完整日志。
资料来源与版本说明
2026-10-19 核对;应用配图来自官方 0.2.1-rc.2 原组件的隔离演示。安装向导与真实 SHUN 模型未实测;不能把截图视为在线文件任务成功记录。
- DeepSeek:官方桌面应用下载页
- DeepSeek:Harness 官方介绍与仓库入口
- 官方仓库:桌面版、内置运行组件、安装与更新
- 官方用户指南:配置模型、自定义 API、凭据与模型选择
- 官方用户指南:工作区、会话与聊天输入区
本页只保存阅读进度,不收集 key、不执行安装、不调用模型。