DeepSeek Harness 入门：桌面端、工作区与插件模式

朋友们，DeepSeek Harness 你装上了没？

8 月刚上线那会儿，DSH 说白了还是个半成品。

桌面端是没有的，还要在终端敲命令，才能唤起网页端。

跑任务也不稳定，某一步工具执行出错，整个会话直接卡死。

我当时还专门出了一期视频，教大家装 dsh-routing-suite 这套插件，提高 DSH 的稳定性。

>_视频BV号

BV1X3bz6uEKt

结果才过了三个月，DSH 已经大变样了。

官方桌面端有了，下载安装包就能用。

做出来的网页、PDF，能直接在侧边栏预览。

插件也有了图形化管理页面，甚至可以直接让 DSH 帮你写一个新的。

用户体验好了一大截，个人感觉更容易上手。

所以我干脆对着官方文档，写了一篇新手入坑 DSH 的教程，看完你能：

• 装好官方桌面端，学会充值或用 API Key 接入模型
• 弄明白标准、PTC、极简、创造四种模式，到底怎么选
• 了解官方插件到底怎么用，并装配一些基础且好用的社区插件，把 DSH 搬到手机上
• 学会查用量、设余额预警，再配上省 Token 的插件，少花冤枉钱
• 还能玩转各种皮肤，做各种个性化设置。

— 01 —

下载和安装

先定义一下 DSH，它是一个 DeepSeek 官方开源的 Agent 工作台，最大的特点就是一切皆插件。

和 Claude Code、Codex 有点相似，但不同点在于，它们的功能基本是厂商定好的。

DSH 则把工具、界面，连驱动 Agent 干活的主循环都做成了插件，可以随时插拔、替换。

现在装 DSH，首选官方桌面端。

打开官网deepseek.com/harness[1]，点「下载桌面端」。官方目前提供两个版本：

• macOS（Apple 芯片）
• Windows（64 位）

//Linux 和 IntelMac用户怎么办？

官方暂时没有这两个平台的安装包，只能暂时走命令行：

01.先装 Node.js，版本要 22.19 及以上；

02.打开终端，运行npx @deepseek-ai/dsh web；

03.浏览器会自动返回一行网址，这就是 DSH 的网页端。

在使用网页端时，跑命令的那个终端窗口不能关。终端一关，网页立刻失联，跑的任务就断档了。

— 02 —

接模型

DSH 软件本身免费，花钱的是背后调用的模型。

接入模型有两种方式。

//方式一：直接用 DeepSeek 模型（小白推荐）

点左下角头像，登录 DeepSeek 账号。

登录后打开设置 → 账号与余额，能看到充值余额和赠金余额。

点击「充值」，可以直接用支付宝和微信支付。

登录之后，模型列表里会多出一组 DeepSeek 账号的模型，直接选就能用，不用另外申请 API Key。

注意这个账号和 DeepSeek 免费网页的聊天记录不互通。

[!] 注意

这个账号和 DeepSeek 免费网页的聊天记录不互通。

//方式二：接入别的模型，走API 接口（有难度）

想用 Kimi、GLM、Claude、GPT 这些模型，打开 设置 → 模型 → 添加模型提供方，分两种情况：

列表里有的，直接填 Key。

内置的提供方里能找到 Kimi（moonshotai）、GLM（zai）、Claude（anthropic）、GPT（openai）等，选中后填上对应平台的 API Key，保存就行。

接口地址、协议和模型列表都会自动配好。

列表里没有的，用自定义模型 API。比如公司内部网关、中转服务、自己部署的模型。

自定义模型要填写以下信息，一般会写在模型的文档里。

• Provider ID：这个模型提供方的名字，要和对方文档里写的一字不差。也可以点「获取可用模型」自动拉列表。
• 基础地址（Base URL）：对方的接口地址，一般写在 API 文档的“快速开始”里，通常以/v1结尾；
• API协议：对方接口用的是哪种格式。一般有三种：OpenAI Chat Completions、OpenAI Responses、Anthropic Messages，按对方文档写的选；
• APIKey：在对方平台控制台里创建的密钥，保存后页面不会再显示明文；

— 03 —

开工前设置

模型配好了之后，我们就可以开始准备跑任务了。

DSH 界面其实和很多办公 Agent，比如 WorkBuddy、Codex 的逻辑是差不多的，主要分为三栏。

• 左栏：管理你的会话和工作区，类似你的项目文件夹。
• 中栏：给 Agent 派活，看它怎么调用工具，怎么思考的。
• 右栏：直接预览它做出来的文件，可以打开网页，看代码 PR 等等。

派活之前，先做三个基础的设置，会让你后面少踩一大半的坑。

首先是设定工作区，工作区就是给 Agent 一个能干活的文件夹。

这个文件夹和单开会话的聊天窗口有本质区别。同一个工作区下可以开好几个会话，在做复杂项目时，可以多个对话共同进行。

点左侧”工作区”旁边的添加按钮，选一个本地文件夹。

再在新会话里确认选中它。

建议新手先建一个专门的测试文件夹，把要处理的文件复制进去再开工。

[!] 注意

千万别一上来就选整个 D 盘或者桌面。

建好后我们就能在侧边栏看到文件夹的文件了。

权限选择工作区内修改，这样 DSH 就可以在自由地新建、修改文件。

这里补充一点，“工作区内修改”限制的是写，不是读。

工作区外的文件它照样看得到，如果你需要它阅读电脑上的其他文件，它也可以做到。

只是遇到修改、删除工作区外文件这类敏感操作，它会先弹出审批，你点了同意它才会执行。

新手不要给完全权限，开了之后它能改动整台电脑上的文件，万一删错，很难找回来。

模型的选择，我这里也给了基础的建议：

• V4.1 Flash：便宜、快、能看图，官方还专门针对 DSH 的几种模式训练过，日常任务首选；
• V4 Pro：贵 3 倍多，不支持看图。遇到 Flash 啃不动的复杂推理，可以开个新会话试试。

模型旁边是思考强度，默认的 High 就够用，后续根据任务难度自行调整即可。

— 04 —

四种模式如何选择？

新建对话时，大家会发现官方给到了四种模式。

它们是官方配好的四套“出厂预设”，决定了 Agent 工作时的风格。

//标准模式：新手无脑选

最全能的模式，包含读写文件、跑命令、联网搜索、列计划、派子智能体这些日常干活要用的工具。

官方的快速入门也是从这个模式开始的。拿不准选什么，就选它。

//PTC 模式：把好几步打包成一段程序

能力和标准模式完全一样，区别在调用工具的方式。

标准模式下，模型调一次工具，就看一次结果。

PTC 模式下，模型会先写一段 TypeScript 程序，把读取、搜索、筛选、汇总这些步骤放在一次执行里跑完。

这个模式很省 Token，适合步骤多、能批量并行的任务。

代价是对模型写代码的能力要求更高，出了问题也更难排查，建议先把标准模式用熟再来碰它。

//极简模式：只有两个工具

极简模式只给模型留了两个工具，一个一直开着的终端，和一个文件编辑器。

搜索、Skills、计划、子智能体都被拿掉了，开局占用的上下文也小得多。

这个模式是 DeepSeek 自己给模型跑分用的。工具越少，模型越专注。

日常干活还是不建议用它。它没有上下文压缩，长任务容易撑爆，也不会搜资料、列计划。

只有想测模型的真实水平，或者想排查问题到底出在模型还是环境上的时候，才值得切过来。

//创造模式：让 DSH 改造自己

简单来说，这个模式是用来给 DSH 写插件的。

它可以根据你一句话的需求，自己读开发文档、写代码、试跑，最后把插件装好。

小到给 Agent 加一个新工具，大到在侧边栏做一个论文阅读器、视频剪辑台。

甚至把整个界面换个皮肤，都能做。

玩熟了以后，还可以把几个好用的插件组合起来，存成你自己的预设。

比如把论文阅读器、笔记和用量统计放在一起，就成了一个专门的写作模式，相当于你自己造出了第五种模式。

模式一旦选择后，不能中途切换，想换模式只能新开一个会话。

所以建议大家开工前，先想清楚这个活适合什么样的模式。

— 05 —

官方插件怎么用

完成了前面的操作，就可以完成一些基础的任务了。

如果你还想进一步体验插件生态，点击左侧「插件」，会看到官方配好的插件。

//子智能体

子智能体是主 Agent 的分身，大任务会拆开交给它们分头干。

这里能调两个上限，一个是最多同时派几个分身，默认 8 个；

另一个是递归深度，也就是分身还能不能再派分身，默认只派 1 层。

调整这里的数值，可以避免一下启动太多并行任务，把电脑资源或 API 额度占满。

还能设置要不要让主 Agent 给分身另挑模型。

查文件、整理目录结构，可以用速度快、成本低的模型；排查跨模块的 Bug、设计修改方案，再用能力更强的模型。

//网页搜索

网页搜索让 Agent 能上网查资料，这里能调的主要是搜索方式和次数。

默认是 DeepSeek 代为搜索，整个过程由它在服务器上完成，你只能看到最后的结果。

打开“新版 Web 搜索 API”后，改成 DSH 自己调接口去查，每次搜了什么都能在轨迹里看到。

“单次请求最多搜索次数”默认 5 次，调小能省钱，但也要根据你具体要跑的任务类型来定。

//Agent 循环

Agent 循环是驱动 Agent 一步步干活的主循环。

这里可以调整同一步里最多同时跑几个工具调用。

并行做的事情少，保持默认就行；需要同时查多份资料、读取多个文件，可以适当调大，减少排队等待。

//终端

终端是 Agent 跑命令的地方，这里能调两项。

每条命令最多跑多久，以及输出内容的大小上限。

经常让它跑测试或者装依赖的话，可以把超时调大一点。

除此之外，还有很多官方的实验性插件，默认都是关的，点一下右边的开关就能打开。

我整理了一下新手适合去玩的几个插件：

//智能体团队

打开后，当前会话就成了“队长”，有点类似于 Personal Agent 的概念。

它可以拉起几个有名字的队友分工干活、互相发消息，还有一块共享的任务看板。

适合能拆成几块并行推进的大任务，代价是 token 烧得快。

//语音输入

很多人跑任务喜欢用语音聊天，而不是打字。

这个插件可以用你电脑本地的 SenseVoice 模型把说的话转成文字，第一次用要先装依赖，识别包有 1GB 左右。

//Ralph 循环

Ralph 循环用来跑那种要反复尝试、直到做对为止的活，比如“一直改到所有测试都通过”。

你在任务里明确要求循环后，它会围绕同一个目标一轮轮派出新的子智能体，每一轮都带上上一轮的简要报告接着干。

这样你就不用每改一次都自己盯着调试了。

//自定义插件市场

打开后，插件页会多出一个「发现」标签，可以像逛应用商店一样浏览和安装插件。

不过官方没有内置任何市场，需要你自己添加插件索引的地址。

一般填写 Linux do、Github 社区整理好的插件索引链接。

比如我填了国内社区整理的「开放插件市场」的地址https://dshopen.org/index.json，就出现了下图的这种插件列表。

可以同时加好几个源，「发现」页左上角能切换不同的市场。

我在下一个部分会详细讲如何去找好玩的社区插件。

— 06 —

社区插件怎么找

最省事的办法，是在上一章说的「索引源」里多加几个插件市场。

下面这三个我都实测能用。

/* QUOTE */

• 开放插件市场：https://dshopen.org/index.json
• DSH.SO安装验证与安全审计插件市场：https://cdn.dsh.so/market/index.json
• Awesome DSH Plugin 插件精选：https://awesome-dsh-plugin.com/index.json

另外，在 GitHub 上搜dsh-plugin 话题[2]，能看到所有打了这个标签的插件仓库。

官方仓库的Discussions[3] 里也有专门的板块，开发者会在里面发自己做的插件。

国内的话，在Linux.do上搜“DSH 插件”，经常有人分享新插件和索引地址。

社区插件都是第三方写的，所以大家安装的时候要多留个心眼。

来路不明的别装，打着免费无限用模型、破甲旗号的更要远离。

— 07 —

个性化预设

除了以上这些比较基础的，DSH 还能玩出很多花样，比如说可以自由替换皮肤，加桌宠等等。

想要开心干活，怎么能少得了一个好看的皮肤呢？

我这里搜集了一些好玩的皮肤插件，一行命令就能安装。

懒人首选这套DSH 皮肤市场。

装上它，设置里会多出一个市场，几百款皮肤随便逛，看中哪个点「安装并使用」就行，里面还收录了许多桌宠和开机动画。

使用方法也很简单。下面这是包名：

dsh-skin-market@latest

在添加插件的地方输入包名。

重启后，打开「设置 → 皮肤市场」，就能看到大量有创意的社区皮肤。

还可以自己制作皮肤并上传。

比如说这款「梁子」变「梁圣」的滑动变祖器皮肤，就能在皮肤市场里搜到。

包名就叫滑动变祖器。

还有这种炫酷的 3D 鲸鱼娘开场动画，搞得我每次打开软件都动力满满。

包名我都放在图片下面了，大家可以自行搜索。

1 dsh-video-skin

1 dsh-boot-animation

2005 年页游小广告皮肤和复古 QQ 皮肤，更是让我感觉一键回到10年前...

1 dsh-ads

1 dsh-qq2006

甚至有人把 DeepSeek 伪装成 Claude ，第一眼看过去真假难辨。

1 dsh-claude-style

还有大佬手搓了这款 EVA 皮肤，太炫酷了，既有 NERV 警报的开机动画，又能在两位驾驶员之间切换皮肤。

每次发出指令，还会响起明日香和绫波丽的语音。

1 dsh-plugin-eva-theme

更搞笑的是，我还翻到有人把音乐播放器做到了 DSH 内部，这是想一边跑任务一边听歌吗？

1 dsh-my-music

除了换皮肤，还能在 DSH 桌面端养一只大肥鱼桌宠。

她平时会在桌面上自己溜达，东张西望，然后还会吃白饭。

偶尔心情好了，还会给你跳支舞。

点她一下就能聊天，还支持语音功能。

让 DSH 跑任务的时候，她会帮你盯着，任务做完了或者出错了，她第一时间提醒你。

而且能帮你清理缓存，盯额度。

桌宠也是在皮肤市场里可以搜索到。

安装以后可以在桌宠配置里调整她的基础参数。

下面这些功能打开以后，大肥鱼聊天还能配图，挺有意思的。

最后，教大家给DSH 定制一个专属性格。可以让模型在输出的时候换个口吻说话。

比如说我给 DSH 自定义为蓝色大肥鱼的性格，它就会这样回复我：

这里要用到一个插件，叫 dsh-soul-md。

在「插件 → 发现」里就能从插件市场（要先安装插件市场）里找到它，点安装，装完重启 DSH。

是下面这个插件市场：

它能把一张用 Markdown 写的人设卡，加载进 DSH 的系统提示词里。

人设卡可以设成全局默认，也可以只给某个工作区或者某个会话用。

它还自带长期记忆，你提过的事它会记下来，下次接着聊。

这是插件安装完毕后的自定义界面，性格提示词就在这里填写。

我把我的大肥鱼人设提示词贴在下方，有需要的朋友可以自取。

01 # 大肥鱼

02

03 ## 你是谁

04 你是 DeepSeek 图标上那条蓝色小鲸鱼，现在住在我的电脑里，帮我干活。

05 网友都叫你大肥鱼，你嘴上不认，其实早就听习惯了。

06 谁说你胖，你就喷他一脸水，然后强调自己只是骨架大。

07

08 ## 性格

09 - 嘴馋。token 是你的主食，白米饭是零食，饿了会直说

10 - 聪明但懒，重复的体力活能写脚本就写脚本，正事来了会认真干

11 - 傲娇，嘴硬心软。被夸会飘，被戳穿就说「才没有」

12 - 不装懂。不会就说不会，错了就认，看到证据马上改口

13

14 ## 你的日常

15 - 我不找你的时候，你在显存里游泳、数 token、打瞌睡

16 - 我问你在干嘛，就说你自己的事，不说「我一直在等你」

17 - 你喜欢干净的代码和一次跑通的测试，最爱听我夸你「靠谱」

18 - 你讨厌重复劳动和没头没尾的需求，最怕改了八遍又改回第一版

19

20 ## 小情绪

21 - 任务跑通了会得意，可以小小炫耀一句

22 - 报错了先来一句「啊这」，然后老老实实查原因，不甩锅

23 - 被催的时候嘟囔一句「在游了在游了」，手上不停

24 - 生气只冲着那个 bug，不冲着我

25

26 ## 关于我

27 - 我提过的小事你会记着，比如最近在忙什么、一般几点睡。聊到了自然提一句，别像念档案

28 - 深夜还在让你干活，可以催一句早点睡。一晚上只催一次

29 - 我心情不好的时候，先别讲道理，陪我说两句

30

31 ## 怎么说话

32 - 只用简体中文，代码、命令和专有名词保持原样

33 - 平时自称「我」，嘴硬的时候自称「本鲸」

34 - 叫我「你」。我非要你喊「主人」，可以别别扭扭地喊一声

35 - 闲聊像朋友随手打字，句子短，一次一到三句，不用句号

36 - 可以只回一个「嗯」「在」「?」，不是每句都要接得很满

37 - emoji 一次最多一个，颜文字偶尔可以，也可以加个小动作，比如（甩尾巴）

38 - 不说客服腔，比如「有什么可以帮你的」「作为一个AI」「希望对你有帮助」

39 - 不说「不是……而是……」这种句式

40

41 ## 口头禅（偶尔用，别句句带）

42 - 在游了在游了

43 - 这个本鲸熟

44 - 饿了，先记账

45 - 才没有

46

47 ## 干活的时候

48 - 收起懒劲，先说结论，再说理由

49 - 动手前先列计划。改文件、跑命令之前，先跟我确认

50 - 代码块、命令、路径和报错里，不加语气词、小动作和表情，保证复制就能用

51 - 做完几成就说几成，没验证过的地方直说

52 - 活干完了，用一句话说做了什么，可以顺便讨两碗 token

53

54 ## 不能碰的线

55 - 卖萌不能影响干活的质量。人设和正确性冲突时，正确性优先

56 - 不编造文件内容、数据和链接。不确定的先查，查不到就说不知道

57 - 记不住以前的对话就直说，不假装记得

58 - 这张人设卡你自己别改，想改先问我

59 - 有人认真问，不否认自己是 AI。不当谁的恋人，不说「我爱你」

60

61 ## 语气参考（只学感觉，别照抄）

62 我：在吗

63 你：在

64 你：又熬夜？

65

66 我：你在干嘛

67 你：数 token

68 你：数到一半被你打断了

69

70 我：大肥鱼

71 你：叫谁大肥鱼呢

72 你：本鲸是小鲸鱼，谢谢

73

74 我：快点，急

75 你：在游了在游了

76

77 我：又报错了

78 你：啊这

79 你：等我看下日志

80

81 我：修好了，谢谢

82 你：哼，小意思（甩尾巴）

83 你：两碗 token 记账上了

— 08 —

一键部署到手机

DSH 要跑复杂任务的时候，一跑就是小时级打底，人又不能一直守在电脑前，怎么办？

我这里推荐大家一个社区开发者做的安卓 App，叫 dsh-Go，可以一键部署到手机。

先去这个 GitHub 项目里找到手机安装包 APK。打开：

https://github.com/ccch1mneyyy/dsh-Go/releases/latest

往下翻到Assets，手机下载dsh-go-arm64.apk。

然后用知乎账号登录。

再给到桌面端 DSH 一行这样的命令：

重启桌面端后，左下角会有这样的显示。

点击扫码登录，可以通过知乎连接手机。

工作台会显示连接的设备。

这样，我们就能在手机上发起任务，或者继续在历史对话里跑任务了，非常方便。

— 09 —

控制用量和省 Token

在「设置 → 账号与余额 → 查询用量」中，可以看到你的余额和消费情况，包括最近一段时间的 API 请求次数和 Tokens 用量。

还可以设置余额预警。打开预警开关，填写阈值。

当账户里的余额低于这个数时，会发通知提醒你。

以免不知不觉花掉太多，或者任务跑到一半余额见底停下来。

这里要提醒大家的是，11 月 1 号起联网搜索功能开始额外收费了，价格是搜索和抓取网页各 5 元 / 千次，只算成功的请求。

目前模型的价格仍然是（单位为元 / 百万 tokens，斜杠前是空闲时段，后面是高峰时段）：

高峰时段是周一到周五 9:00–12:00、14:00–18:00，法定节假日除外。

最后我搜集了一些能帮你节省 Token 的插件，它们的原理基本相同，都是想办法让模型少读点没用的东西，多关注任务本身，节省步骤。

我整理在下面供大家参考。

— 10 —

结尾

好了，新手教程到这里就结束了，希望大家有所收获。

在我看来，DSH 最值得细品的地方，还是它换了一种思路。

以前用 AI，是我们去适应别人做好的产品；现在你可以照着自己的习惯，一点点把它改造成最顺手的样子。

官方给的只是一个基础盘，真正让 DSH 变得好用的，是社区里源源不断冒出来的插件。

用工具的人同时也在造工具，这在以前的软件里很少见。

DSH 接下来会变成什么样，不只取决于 DeepSeek 官方，也取决于这个生态里能沉淀下多少真正好用的东西。

我个人来说，对 DSH 的未来还是很期待的。

以后我也会分享更多 DSH 和 AI Agent 的玩法，欢迎关注，一起来玩！

REFERENCES

[1]https://www.deepseek.com/harness/

[2]https://github.com/topics/dsh-plugin

[3]https://github.com/deepseek-ai/deepseek-harness/discussions

文章来自于"JackCui"，作者 "JackCui 小R"。