这篇教程写给完全没接触过 AI 工具的人。你不需要懂命令、不需要会写代码,只要会用鼠标、会复制粘贴,就能跟着做完。
做完之后你会得到一个自己的「工作台」:能跟 AI 对话,能从插件市场里挑功能,启动时有一段片头动画,桌面上还有一只会跟着 AI 状态变化的小桌宠。整个过程不需要你背任何技术名词。
DeepSeek Harness(下面统一简称 DSH)是 DeepSeek 出的桌面版 AI 工具。你可以把它想成一个「装在自己电脑上的工作室」:你在里面跟 AI 说话,它帮你干活;插件则像给工作室添家具,装一个就多一种能力。
这篇教程分两段。前面十节是照着做就行的部分,每一步都告诉你点哪里、说什么、看到什么算成功。最后一节是进阶补充,讲路径、配置文件、日志、回滚这些,新手可以先跳过,等哪天出问题了再回来查。
文中的界面文字以 2026 年 10 月的版本为准。DSH 更新很快,你看到的按钮位置可能略有不同,但意思是一样的。
本文目录
- 第一步:安装 DSH 桌面版
- 第二步:第一次打开,把「工作台」建起来
- 第三步:先学会跟 DSH 说话
- 第四步:让 DSH 自己帮你装插件
- 第五步:改造工作台之一,装上插件市场
- 第六步:改造工作台之二,加一段开机动画
- 第七步:改造工作台之三,换一张自己的壁纸
- 第八步:改造工作台之四,让桌宠跟着 AI 一起动
- 第九步:最后检查一遍
- 第十步:新手最常见的问题
- 进阶补充:给想弄明白的人
开始之前:你需要准备什么
- 一台 Windows 10 或 Windows 11 的电脑(Mac 也能用,差异我会单独标出来)。
- 一个 DeepSeek 账号,用来登录。
- 能正常上网。装插件时会连 GitHub,网络不稳的话后面会告诉你怎么处理。
- 大约 2 GB 的硬盘空间,以及半小时左右的时间。
就这些。不用提前装 Node.js,也不用准备什么「环境」。
第一步:安装 DSH 桌面版
下载正确的安装包
打开 DeepSeek 官网下载页:https://www.deepseek.com/download/
找到「DeepSeek Harness 全新桌面端」这一栏,点「下载 Windows 版」。macOS 用户下载 Apple 芯片(arm64)那个版本。
这里有个几乎所有新手都会踩的坑:下载页上还有一个叫「DeepSeek 客户端」的东西,那是用来聊天的普通 App,不是 Harness。认准「Harness」这个名字,别下错。
双击安装
- 双击下载好的
dsh-latest-windows-x64.exe。 - 一路点「下一步」,安装位置用默认的就行。
- 如果 Windows 弹出蓝色的「已保护你的电脑」,点「更多信息」→「仍要运行」。这是系统对陌生程序的常规提示,不是病毒警报。
- 安装完成后,桌面会出现 DeepSeek Harness 图标,双击打开。
装好之后有一个和网页版不一样的地方:你点右上角的关闭按钮,程序并不会真的退出,而是缩到右下角托盘里继续运行。这是桌面版的特点,不是 bug。
Mac 用户
下载 .dmg 文件,打开后把应用拖进「应用程序」。第一次打开如果提示「无法验证开发者」,去「系统设置 → 隐私与安全性」里点「仍要打开」即可。
第二步:第一次打开,把「工作台」建起来
第一次打开 DSH,界面上东西不少,但你只需要按顺序完成三件事。
1. 登录账号
点右上角的头像或齿轮图标,进入「账户」,按提示登录你的 DeepSeek 账号。
推荐用官方账号登录:模型、额度、计费都走官方,不用自己填任何密钥。
如果你有 DeepSeek 的 API Key,也可以走「设置 → 模型」手动填。但对新手来说,能账号登录就账号登录,省事。
提醒一句:API Key 等于你账户的钥匙,不要发给任何人,也不要在对话里粘给 AI。这篇教程后面所有提示词都不需要你提供 Key。
2. 选一个模型
登录后默认会给你配好一个模型,名字大概叫 deepseek-flash。新手不用改,直接用。
以后想换模型,不用去设置里翻:对话框右下角会显示当前模型名,点一下就能换。同一个菜单里还有「推理等级」这一行:
- 低:回答快、省额度,适合闲聊和简单问题;
- 中 / 高:愿意多想一会儿,适合装插件、排错这种需要动脑的活。
菜单里通常有低、中、高几档,有的模型还会显示「关闭思考」或「最高」,具体以你看到的为准。新手保持默认就好,等级高不代表一定更好,只是它愿意多想一会儿。
3. 建一个工作文件夹
这一步最重要,也最容易被忽略:DSH 必须先有一个「工作区」才能开始对话。没有工作区的时候,输入框是灰的,点不动。
做法很简单:
- 在你的 D 盘或文档目录里,新建一个普通文件夹,名字随便起,比如
D:\DSH工作台。 - 回到 DSH,点「选择工作区」或「添加工作区」。
- 选中刚才那个文件夹,确认。
现在输入框应该可以打字了。这个文件夹以后就是 AI 帮你干活的地方,它读文件、写文件都在这里面,不会乱动你电脑上的其他地方。
第三步:先学会跟 DSH 说话
很多人第一次用 AI 工具,会觉得「不知道该怎么问」。其实只要记住三条规则,就够用了。
规则一:一次只让它做一件事
不要一上来就说「帮我装好所有插件、改好界面、再做个桌宠」。事情一多,AI 容易顾此失彼,你也不知道是哪一步出了问题。
正确的方式是:装一个,看一眼,没问题,再装下一个。
规则二:先让它「检查」,再让它「动手」
这是最有用的一句话,建议你记下来:
先只检查,不要修改。告诉我你现在看到的情况。
先检查的好处是:你能看到它打算怎么做,心里有底;万一它理解错了,你还有机会喊停。
规则三:看到确认窗口,先读再点
装插件、改设置的时候,DSH 有时会弹出一个确认框,问你「是否允许」。这是正常的保护机制,不是报错。
你要做的是:花十秒钟读一下它准备装什么、改哪里,确认是你想要的那件事,再点允许。看不懂就直接问它:
你刚才要我确认的这一步是在做什么?用一句大白话解释,不要用术语。
先试一句
现在可以在输入框里打第一句话,试试它能不能正常回应:
你好,请用三句话告诉我:你现在能帮我做什么?
如果它正常回答了,说明登录、模型、工作区都没问题,可以往下走了。
第四步:让 DSH 自己帮你装插件
这是整篇教程最省力的部分,也是很多人不知道的:新版 DSH 可以直接通过对话来安装和管理插件。你不需要记命令,也不需要手动改文件,把需求说清楚就行。
流程一共四步。
第 1 步:先看看现在装了什么
请检查我当前桌面版 DSH 已经安装了哪些插件,
并告诉我现在的工作台配置。先只检查,不要修改。
它会列一个清单给你。刚装好的 DSH 一般只有自带的基础插件,这是正常的。
第 2 步:告诉它你想装什么
比如你想装插件市场:
请帮我在桌面版 DSH 里安装插件市场 dshmarket。
安装前先告诉我你会做什么,需要我确认时再继续。
注意最后那句「安装前先告诉我」。有了这句话,它会先把计划讲一遍,而不是闷头就装。
第 3 步:处理权限确认
DSH 的权限不是只有「允许」和「拒绝」两种。输入框左下角有一个权限按钮,点开能看到三种模式:
| 权限模式 | 它代表什么 |
|---|---|
| 仅可查看 | AI 只能看和说,不能改任何文件。适合第一次让它了解情况、只问问题的时候。 |
| 工作区内修改 | 只能改你选的工作文件夹;要动文件夹外面或做敏感操作,会先问你。日常推荐,默认就用这个。 |
| 完全权限 | 很少再问你,能改更多地方、也能执行外部命令。只在你清楚要做什么、并且信任这次任务时用。 |
切换方式就是点输入框左下角那个按钮。选到「完全权限」时,DSH 会弹一个确认框,告诉你风险;看完再决定,不确定就退回「工作区内修改」。
另外要分清两件事:权限模式管的是大范围(能不能改、能改哪里),确认弹窗管的是具体某一步(这一次要不要允许)。弹窗出现时先看它写的是不是你要装的插件名字,确认无误再点允许;如果它说要改系统设置、要你输入密码,先停下来,把这句话复制回来问它为什么。
第 4 步:刷新,然后看结果
装完之后,先按 Ctrl + Shift + R 强制刷新一次窗口(Mac 是 Cmd + Shift + R)。普通的 F5 有时候不够,界面会一直显示旧的样子。
如果刷新后还是没变化,就彻底退出 DSH 再重新打开:右下角托盘图标右键 → 退出,然后重新双击桌面图标。
小提示:不同版本的按钮文字可能不一样。你只要记住「装完 → 强制刷新 → 还不行就重启」这个顺序,绝大多数「装了没反应」都能解决。
第五步:改造工作台之一,装上插件市场
插件市场相当于 DSH 里的「应用商店」。装上它以后,以后想加什么功能,直接在里面搜、点安装就行,不用每次都麻烦 AI。
它长什么样
装好并刷新后,一般会在「设置 → 插件」里多出一个「插件市场」标签,或者侧边栏多一个入口。里面有分类、搜索框和「已安装」列表。
怎么装
用上一节的方法,对 DSH 说:
请帮我安装插件市场 dshmarket。
装好后告诉我:入口在哪里、怎么搜索插件、要不要重启。
等它装完,按 Ctrl + Shift + R 刷新,然后按它说的位置去找入口。
装好之后先做一件事
在市场里随便搜一个插件,看看能不能正常显示列表。能显示,就说明市场装好了,先别急着批量安装。
我的建议是:市场装好之后,后面的开机动画、壁纸、桌宠都从市场里找。看得见来源、看得见版本,比到处找压缩包安全得多。
第六步:改造工作台之二,加一段开机动画
先说清楚它是什么
开机动画插件叫 dsh-boot-animation,作者是 NativeDog1。它会在 DSH 窗口里面播一段片头:你启动 DSH 的时候,窗口里先放几秒钟动画,然后进入工作界面。
它不是 Windows 开机画面,也不会盖住你的任务栏。想要「一开机整块屏幕播片」的效果,这个插件做不到,也不是它负责的事。
让 DSH 帮你装
请帮我安装开机动画插件 dsh-boot-animation(作者 NativeDog1)。
装好后告诉我:设置入口在哪里、怎么预览和选中片头、
怎么换成我自己的视频、是否需要重启。
装完同样先按 Ctrl + Shift + R 刷新。
在哪里设置
入口通常在侧边栏最底部、设置按钮旁边,是一个像调音台的小图标(🎛)。点开就是「片头片库」:
- 每一行是一段可选片头;
- 点「预览」可以马上看效果,不会改你的选择;
- 点「选它」才会真正设为默认。
插件自带几段片头,装完就能直接用。想先看看效果,点预览就行。
整个用法可以记成五步:装好 → 点 🎛 打开片库 → 预览试看 → 点「选它」设为默认 → 重启 DSH 看效果。
换成自己的视频
- 准备一个普通的 MP4 视频,最好是 H.264 编码(大部分手机、相机导出的 MP4 都是)。
- 把它放进这个文件夹:
C:\Users\你的用户名\.dsh\boot-animation\videos\。文件夹不存在就自己新建一个。 - 回到片库面板,点一下「刷新」。
- 找到你刚放进去的那一行,点「选它」。
如果放进去的视频只有声音没有画面,多半是编码不兼容。换一个普通 MP4 再试,不要在这个问题上耗太久。
怎么确认成功
彻底退出 DSH 再打开。窗口里应该先播你选的那段片头,然后进入工作界面。看到了,就算成功。
第七步:改造工作台之三,换一张自己的壁纸
如果觉得默认界面太素,可以装一个壁纸插件 dsh-any-background(作者 Tkingxiao)。它能换图片或视频壁纸,还能调透明度、模糊度和主题色。它只改外观,不会动你工作区里的文件。
它和开机动画是两件事:开机动画是启动时播几秒的片头,壁纸是进入工作台后一直在背后的画面。两个可以配合使用。
让 DSH 帮你装
请帮我安装壁纸插件 dsh-any-background(作者 Tkingxiao)。
安装前先告诉我它会改哪些界面,装完在哪里打开设置、要不要重启。
装完按 Ctrl + Shift + R 刷新;没变化就彻底重启一次 DSH。
在哪里设置
装好后,设置里会多出一个「主题」页面;有的版本是在侧边栏引导页上多一张「主题」卡片。点进去有五页:
- 背景:上传图片或视频,设为壁纸;
- 界面:调各个部件的透明度和模糊度;
- 色彩:换主题色,也可以从壁纸里自动取色;
- 字体、配置:一般不用动。
让工作台接上片头
如果你已经给开机动画选了一段视频,可以把同一段视频再设为壁纸:启动时先播片头,进入工作台后同一个画面继续在背后循环(静音)。这样从片头到工作台是连贯的。
觉得太花,就把「界面」里的透明度调低一点、模糊调高一点,让壁纸只是隐约透出来。
第八步:改造工作台之四,让桌宠跟着 AI 一起动
它由两部分组成
桌宠不是装一个东西就完事,它其实是两件套:
- 桌宠本体:一个独立的小程序,叫
dsh-pet-indesktop(作者 MerZlin),装在桌面上,负责显示那只小动物; - DSH 桥接:一个小插件,叫
@dsh-pet/bridge,负责把「AI 正在思考 / 正在干活 / 等你确认 / 出错了」这些状态告诉桌宠。
只装本体也能用,只是桌宠不知道 AI 在干什么,只会自己待着。两个都装上,它才会跟着状态换动作。
第一步:让 DSH 先出方案
桌宠的安装比前面几个插件麻烦一点,因为它涉及下载一个较大的程序。所以这一步尤其要「先检查、后动手」:
请帮我安装桌宠 dsh-pet-indesktop(作者 MerZlin),
以及它的桥接插件 @dsh-pet/bridge。
请先检查我的电脑环境,给我一个最简单的安装方案,先不要直接改配置。
方案里请写清楚:要下载什么、装在哪里、大概多大。
不要换成别的桌宠,也不要用名字相似的插件代替。
它应该会告诉你需要下载 dsh-pet-indesktop 的桌宠本体,再装 @dsh-pet/bridge 桥接。你看完方案,确认名字对得上,再让它继续。如果它推荐了别的插件,先问清楚为什么。
第二步:按它说的做
通常的顺序是:
- 下载桌宠程序(Windows 一般是一个安装包或一个压缩包),装好或解压后双击运行;
- 桌面上出现小动物,右键它,能看到菜单;
- 让 DSH 把桥接插件装上;
- 完全退出 DSH,再重新打开。
最后这一步不能省。桥接插件只在 DSH 启动时加载,光刷新页面是不生效的。
第三步:打开联动开关
右键桌宠 → 找到「Agent 联动」→ 选择 DSH。这个开关默认是关的,需要你手动打开。
怎么确认成功
在 DSH 里随便发一句话,让它做点小事。桌宠应该会从「发呆」变成「思考」或「干活」,等你确认的时候还会冒气泡提醒。
如果桌宠一直不动,先检查两件事:联动开关开了没有、DSH 是不是真的重启过。
第九步:最后检查一遍
全部装完,按这张表对一遍。每一项只要看到「应该看到」那一列的现象,就说明这一步成了。
| 功能 | 应该看到什么 | 没看到怎么办 |
|---|---|---|
| 登录 | 能正常发消息并收到回复 | 重新登录账号,检查网络 |
| 工作区 | 输入框可以打字 | 重新选一次工作文件夹 |
| 插件市场 | 设置里能找到「插件市场」入口,能搜到插件 | 强制刷新;还不行就重启 DSH |
| 开机动画 | 启动 DSH 时窗口里先播片头 | 确认已经「选它」,再彻底重启 |
| 桌宠 | 桌面上有小动物,右键有菜单 | 确认桌宠程序正在运行 |
| 桌宠联动 | 发消息时桌宠换动作或冒气泡 | 打开联动开关,重启 DSH |
| 壁纸 | 工作台背景变成你选的图片或视频 | 重启 DSH,检查「主题 → 背景」是否已应用 |
如果只有某一项不对,先只处理那一项,不要急着重装全部。装得越多,越难判断问题出在哪。
第十步:新手最常见的问题
装完插件,界面里什么都没有?
九成是没刷新。先按 Ctrl + Shift + R,不行就彻底退出再打开。还不行,就问 DSH:「我装了某个插件但看不到,请帮我检查它有没有装进桌面版的环境里。」
提示连接 GitHub 超时?
不是插件坏了,是网络没连上。换个网络(比如手机热点)再试一次,通常就好了。
弹窗让我确认权限,我不敢点?
把弹窗里的文字复制给 DSH,问它「这一步具体在做什么,有没有风险」。看懂再决定。看不懂就不点,这不丢人。
装坏了,DSH 打不开了怎么办?
先在启动时看有没有「调整插件」的提示,把最近装的那个取消掉。如果完全进不去,就到进阶补充里看「回滚」那一节。
是不是插件装得越多越好?
不是。每多一个插件,启动就多一步,出问题也更难查。建议一次只装一个,确认能用再装下一个。
权限模式该选哪个?
平时用「工作区内修改」就够了:它能改你选中的工作文件夹,动别的地方会先问你。只是问问题就用「仅可查看」,只有完全清楚自己在做什么时才用「完全权限」。
Mac 上步骤一样吗?
基本一样,区别只在路径写法(~/.dsh 代替 C:\Users\你的用户名\.dsh)和快捷键(Cmd 代替 Ctrl)。界面按钮的位置可能略有不同。
进阶补充:给想弄明白的人
下面这些内容新手可以先跳过。等你遇到具体问题,或者想自己动手改配置时,再回来查。
插件到底装在哪里
DSH 的所有用户数据都在一个隐藏文件夹里:
- Windows:
C:\Users\你的用户名\.dsh\ - macOS / Linux:
~/.dsh/
其中桌面版真正用的插件环境是:
~/.dsh/profiles/desktop/
├─ package.json ← 装了什么、按什么顺序加载
├─ cordis.patch.yml ← 每个插件的开关和参数
├─ node_modules/ ← 插件文件本体
├─ .dsh-market/ ← 插件市场的状态和日志
└─ .plugin-manager/logs/ ← 每次安装的日志
记住一句话就够了:插件出问题,先看 profiles/desktop/。
很多人会遇到「命令说装成功了,界面里却没有」,原因通常是在终端里用了 --profile web,插件装进了网页版的目录,桌面版自然看不到。
package.json 只看两个地方
{
"dependencies": {
"dshmarket": "^1.70.2",
"dsh-boot-animation": "github:NativeDog1/dsh-boot-animation"
},
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "dshmarket", "dsh-boot-animation"]
}
}
}
dependencies:装了什么;dsh.profile.bundles:启动时加载哪些。
只出现在 dependencies 里、没进 bundles 的插件,文件装好了但不会生效。
临时关掉一个插件
编辑 ~/.dsh/profiles/desktop/cordis.patch.yml,加上:
- id: dsh-boot-animation
disabled: true
保存后大约一秒生效,不用重启整个应用。想恢复就把 disabled: true 删掉。
命令行方式(一般用不到)
如果你确实想用命令行,桌面版要把 profile 指定对:
dsh plugin --profile desktop add dshmarket
注意是 desktop,不是 web。用错 profile 是新手最常见的坑。
日志在哪
- 插件市场日志:
~/.dsh/profiles/desktop/.dsh-market/log.ndjson - 每次安装的详细日志:
~/.dsh/profiles/desktop/.plugin-manager/logs/
让 DSH 帮你看日志最省事,直接把路径告诉它就行:
请帮我看看最近一次插件安装的日志,告诉我失败在哪一步,用大白话解释。
回滚与备份
动配置之前,先复制一份 package.json 备份,命名成 package.json.bak。改坏了就换回来。
如果 DSH 完全启动不了,通常可以在启动时的提示里选择「调整插件」,把最近装的那个取消勾选,再进系统。
关于第三方插件
插件市场里的东西大多不是 DeepSeek 官方做的,是社区作者写的。方便归方便,装之前最好看一眼作者、仓库和版本更新情况。
几条底线:
- 不要为了让插件「能用」就把账号密码、API Key 发给它;
- 不要随便运行来路不明的脚本;
- 装完一个先观察一下,没问题再装下一个。
想继续深入
- 官方插件市场文档:https://deepseek-harness.github.io/deepseek-harness/guide/plugin-market
- 官方插件索引说明:https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/plugin-market.zh.md
- 插件市场项目:https://github.com/dsh-market/dsh-market
- 开机动画项目:https://github.com/NativeDog1/dsh-boot-animation
- 桌宠项目:https://github.com/MerZlin/dsh-pet-indesktop
写到这里,该装的都装完了。剩下的就是慢慢用:先用它做几件小事,熟悉对话的节奏,再决定要不要继续加插件。
工具终究只是工具。它好不好用,最后取决于你拿它做了什么。
