跳到教程正文
SHUN API · 使用指南

从零开始 · 桌面应用篇

安装 DeepSeek Harness
桌面版

下载、安装,在设置里接入 SHUN API。
用鼠标完成准备,再用一句中文创建第一个文件。

Windows 10 / 11 · x64不需要编程基础官方下载 · 界面配置 · 文件练习

核对日期: · 预留约 20–40 分钟,下载时间取决于网络。

开始第 1 步 ↓

先准备好这三样

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 版

  1. 打开 DeepSeek 官方下载页,核对域名 www.deepseek.com。
  2. 在 DeepSeek Harness 全新桌面端 区域点击「下载 Windows 版」,等待 dsh-latest-windows-x64.exe 下载完成。
官网实拍 · 2026-10-19。① Windows 下载按钮;② 系统要求。
成功检查:

下载列表显示 Windows .exe 已完成;不要选择手机安装包或 GitHub 源码包。

运行安装包,打开桌面应用

  1. 双击下载完成的 dsh-latest-windows-x64.exe。
  2. 按向导安装,保留默认安装目录;更改时选择专用空目录,避开磁盘根目录和已有项目。
  3. 完成后启动应用;没有自动打开时,在开始菜单搜索 DeepSeek Harness。首次初始化请等待完成。[3]
成功检查:

看到 DeepSeek Harness 欢迎页或主界面。安装受阻时查排错表。

首次欢迎页,选择稍后配置

  1. 欢迎页点击「添加 API Key」,密钥框留空,再点「稍后配置」。
  2. 如出现预览版说明,阅读后点「继续」。已在主界面可直接做下一步。
官方组件 · 隔离演示。点击「添加 API Key」。
官方组件 · 隔离演示。留空,点击「稍后配置」。

这里不要填 SHUN key。欢迎页的密钥入口对应 DeepSeek 官方服务;SHUN key 在第 5 步与 SHUN 地址一起填写。

成功检查:

已进入主界面。

取得自己的用户 key 和模型 ID

  1. 向 SHUN 管理员取得个人用户 key,确认完整模型 ID、上下文窗口、最大输出 token 数及工具调用支持。
  2. 打开 SHUN API 控制台,粘贴用户 key,点「进入」并核对可用额度。
  3. 模型 ID 保留完整后缀与大小写。「模型价格」可查 ID,但公开目录不等于账号已获授权。
本站界面 · 演示账号。箭头标出控制台入口与登录位置。

使用个人用户 key;不要使用管理员密钥,也不要把 key 发进聊天、截图或公开文档。

成功检查:

已有可用个人 key、确认过的模型 ID、容量上限和额度。

在设置里添加 SHUN API

① 打开自定义模型 API

  1. 点侧栏底部「… 更多 → 设置」(已登录时从头像 / 账号菜单进入);也可按 Ctrl + ,。
  2. 进入「模型 → 添加模型提供商 → 自定义模型 API」。
官方组件 · 隔离演示。「更多 → 设置」。
官方组件 · 隔离演示。「模型 → 添加模型提供商」。

② 填地址、协议与密钥

SHUN 自定义提供商填写对照
界面字段填写内容
Provider IDshun;已有同名项时编辑它。
显示名称SHUN API
API 地址 / 基础 URLhttps://apivip.shun.team/v1
API 协议OpenAI Chat Completions
API 密钥自己的 SHUN 用户 key;不要填管理员 key。
DeepSeek Harness · 自定义模型 API 的地址输入框
https://apivip.shun.team/v1
官方组件 · 隔离演示。①—⑤ 对应上表;密钥是无效演示值。

地址保留 /v1,不要手工追加 /chat/completions。[4]

③ 添加模型并保存

  1. 点「添加模型」,填写第 4 步确认的完整模型 ID;右侧显示名称可留空。
  2. 点模型行右侧、垃圾桶左边的「> 模型选项」按钮,按管理员确认的数值填写「上下文窗口」与「最大输出 token 数」;图片输入和推理选项先保持默认。
  3. 点「创建提供商」。
官方组件 · 隔离演示。① 添加模型;② 完整 ID 与显示名称;③ 创建提供商。
原包界面 · 本地模拟配置。点右侧箭头展开容量字段;8192 / 4096 为测试值,请填管理员确认的数值。

也可用「获取可用模型 → 添加所选」导入已确认的 ID;探测失败时手工添加。保存成功或绿色凭据提示只说明配置存在,实际调用在第 7 步检查。[4]

成功检查:

模型设置页出现 SHUN API 和自己的模型。

Key 保存在此电脑的 Harness 本地凭据文件;界面隐藏不代表文件已加密,不要分享整个配置目录。

选择模型和练习文件夹

① 创建空练习文件夹

  1. 按 Win + E,在资源管理器地址栏输入 %USERPROFILE% 并回车。
  2. 在空白处右键「新建 → 文件夹」,命名如下。
文件资源管理器 · 新建文件夹的名称
Harness-Learning

已有同名目录且不为空时,换一个新名称;后续任务和路径中的 Harness-Learning 一并替换。

② 在会话里选目录和模型

  1. 关闭设置,点左侧「新会话」。
  2. 点输入框上方「选择工作区」;若出现菜单,再点「添加工作区…」。在系统文件夹窗口选择刚创建的目录。找不到时,在地址栏输入 %USERPROFILE%\Harness-Learning 并回车;已添加的目录可直接选中。
  3. 点输入框右下的「请选择模型」或当前模型名,在 SHUN API 分组选择自己的模型。
官方组件 · 隔离演示。选择工作区;此图未展示系统文件夹窗口。
官方组件 · 隔离演示。在 SHUN API 分组选择自己的模型,图中模型仅为示例。

保持「标准模式」和「工作区内修改」。如使用过规划 / 只读模式,先恢复这两项。只确认符合本次任务范围的权限请求。[5]

成功检查:

工作区显示练习目录,模型属于 SHUN API,聊天框可以输入。

发送第一条文件任务

将任务复制到 Harness 聊天输入框;若改过文件夹名,先替换首行,再点击发送。

DeepSeek Harness · 聊天输入框
请只在当前选择的 Harness-Learning 文件夹中操作。
创建一个 UTF-8 编码的 hello.txt,内容为:
你好,DeepSeek Harness!这是我的第一次练习。
如果文件已经存在,请先告诉我,不要覆盖。
完成后请实际读取文件确认内容,并告诉我完整保存路径。

等待回复;如有权限提示,只确认本次练习所需操作。报错时查排错表,不要反复发送。

成功检查:

收到模型正常回复及文件完整保存路径;下一步亲自核对文件。

打开文件,确认真的完成

  1. 在资源管理器地址栏粘贴下方路径并回车;改过目录名时换成实际路径。
  2. 双击 hello.txt,用记事本核对内容:「你好,DeepSeek Harness!这是我的第一次练习。」隐藏扩展名时文件可能只显示为 hello。
文件资源管理器 · 地址栏
%USERPROFILE%\Harness-Learning
成功检查:

模型正常回复、练习目录存在 hello.txt、文件中文内容正确,三项都满足才算完成。

下次使用与更新

从开始菜单打开 Harness,选已有会话,或新建会话并核对模型与目录。更换 key / 模型后先开新会话确认,不必重装。

更新入口:「应用 → 检查更新…」。先保存工作并结束任务;完全退出使用应用菜单或托盘的退出入口。[3]

卡住了?按现象排查

桌面安装与 SHUN 接入排错
现象处理
下载不完整 / 安装被拦截重新从官网 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 模型未实测;不能把截图视为在线文件任务成功记录。

  1. DeepSeek:官方桌面应用下载页
  2. DeepSeek:Harness 官方介绍与仓库入口
  3. 官方仓库:桌面版、内置运行组件、安装与更新
  4. 官方用户指南:配置模型、自定义 API、凭据与模型选择
  5. 官方用户指南:工作区、会话与聊天输入区

本页只保存阅读进度,不收集 key、不执行安装、不调用模型。