一切皆插件--Deepseek Harness 使用手册!

DeepSeek Harness 小白入门教程

面向零基础用户 · 无需编程基础 · 阅读约 15 分钟

第一章 · 它到底是什么

第二章 · 适合谁？不适合谁？

第三章 · 10 分钟上手

第四章 · 日常怎么用

第五章 · 插件是什么

第六章 · 装点什么好

第七章 · 常见问题（FAQ）

第八章 · 安全须知

第九章 · 想更进一步

第一章 · 它到底是什么？（先别急着装）

用一个你可能听过的例子开始：ChatGPT 是「聊天框里的助手」，而 Harness 是「住在你电脑里的实习生」。

想象你雇了一个很聪明的实习生，给他配了一台电脑（你的电脑）。你说：

「帮我把这个项目的 bug 找出来」——他会自己打开代码、搜索、定位、修改；

「调研一下某个技术的最新动态」——他会自己上网搜索、整理成带引用的报告；

「把这个文件夹里的数据整理成表格」——他会自己写程序来跑。

DeepSeek Harness（简称 dsh）就是这样一个「实习生管理框架」：它把 DeepSeek 的大模型包装成一个能实际动手操作你电脑的智能体——读文件、写文件、执行命令、搜索网页、调用工具，一步步完成你交给它的任务，并在每个关键步骤征求你的同意。

一个类比ChatGPT / DeepSeek 网页版 = 只动嘴的顾问（回答你的问题，但不会碰你的电脑）；DeepSeek Harness = 动手干活的实习生（真的在你的电脑上读写文件、运行命令）。同类的工具还有 Claude Code、Cursor 等，dsh 是 DeepSeek 出的开源免费版本。

它由什么组成？

理解三个词就够了（后面会细讲）：

对话界面（Web UI）：你在浏览器里和它聊天的地方，默认地址

插件系统：像手机 App 一样，给 Harness 加功能（搜索、浏览器、小游戏……）

技能（Skills）：像「岗位说明书」，告诉它在特定任务里该怎么做

MCP 接口：像「万能插座」，把别的 AI 工具生态的能力接进来

第二章 · 适合谁？不适合谁？

任何工具都有边界。先看清楚再决定要不要装。

适合你，如果你……

经常写代码 / 改代码，想让 AI 直接在项目里干活（而不是只给建议）；

喜欢免费开源的工具，愿意自己花 5 分钟配置；

需要 AI联网搜索 + 读文件 + 整理报告这类「动手型」任务；

对「AI 自己操作电脑」这件事有基本的安全意识（知道要盯着它干活）。

不太适合你，如果你……

只想要一个「聊天问答」工具——那直接用网页版 DeepSeek / ChatGPT 更省事；

完全不想碰命令行（哪怕只是复制粘贴一条命令）——dsh 的安装和插件管理目前绕不开命令行；

需要开箱即用的商业级稳定产品——dsh 目前是「开发者预览版」，还在快速迭代中，界面和功能会变；

你的电脑是iPhone / iPad——它需要装在 Windows / Mac / Linux 电脑上。

费用说明（很重要，别被「免费」误导）

dsh 软件本身：开源免费，随便用

AI 大脑（模型 API）：按用量收费（DeepSeek API 很便宜，大约几块钱能用很久，新用户通常有免费额度）。你需要在官网注册一个 API Key 并充值少量金额

也就是说：工具免费，大脑按次计费。普通日常使用一个月通常花不了几块钱；重度使用（大量长任务）会多一些。

2.1 它最突出的三个特色

市面上同类工具不少（Claude Code、Codex、Cursor…），dsh 靠这三件事做出差异化：

轨迹可见（最被低估的特色）：它干的每一件事——想了什么、读了哪个文件、改了哪几行、跑过什么命令——都有完整记录，你可以在界面上逐条回放。出错了能看清是哪一步错的；想让另一个任务"接着这次对话继续"，一句话就能分叉出来。

运行稳定（进程可杀、会话不丢）：记录实时落盘，电脑死机、程序崩溃、不小心关了窗口，重新打开一切还在；对话太长会自动压缩省流量；每一步操作默认都要你批准，误删文件这种事很难发生。

一切皆插件（自由到极致）：从"用什么搜索引擎"到"对话界面长什么样"，每个功能都可以替换、加减、定制。别的工具是"给你一套固定的"，dsh 是"给你一套可以自己拼的"。

开源免费 + 模型自由：软件本体完全免费开源；模型不绑定任何一家——DeepSeek、OpenAI、Anthropic、任何兼容接口都能接。想换模型，设置里改一行就行。

2.2 和同类产品怎么选（客观对比）

同类的"动手干活型"AI 还有几个知名产品，简单对比（据公开资料）：

产品	它是什么	强在哪	不如 dsh 的地方
Claude Code（Anthropic）	终端里的编程 agent，行业标杆	打磨成熟、生态大、用 Claude 模型效果好	闭源收费；模型绑定 Anthropic；轨迹以终端文本为主，不如 dsh 全结构化可回放
Codex（OpenAI）	本地 + 云端任务结合的编程 agent	云端沙箱、任务托管稳定、GPT 系列模型	闭源收费；依赖 OpenAI 云（断网不可用）；扩展性以 MCP 为主
WorkBuddy（腾讯）	桌面"数字员工"，主打办公场景与多 Agent 协作	办公集成好（腾讯生态）、任务流可视化、中文场景贴合	商业产品、插件生态较封闭、面向办公而非开发场景（据公开资料）
Cursor	IDE 里的 AI 编程助手	编辑器体验最好、多模型、diff 对比直观	订阅收费；只在你写代码的 IDE 里工作，不能独立"干活"

一句话选型建议：想免费、可控、看清每一步、深度定制 → 选 dsh；想开箱即用、界面省心、生态成熟 → 选商业产品。它们不冲突，可以并存：省心的事交给商业工具，重要的事交给 dsh（因为你看得见它在干什么）。

第三章 · 10 分钟上手：保姆级步骤

跟着做，不用理解原理。总共四步。

第一步：安装 Node.js（一个运行环境，装一次就行）

打开，下载「LTS 长期支持版」，一路点「下一步」安装。装完可以验证：打开终端（Windows 按Win+R输入cmd回车），输入node -v，能显示版本号就成功了。

第二步：启动 Harness（一条命令）

在终端里粘贴这条命令，回车：

npx @deepseek-ai/dsh web

第一次运行会自动下载（耐心等一会儿）。看到类似http://127.0.0.1:3080的地址后，用浏览器打开它。记住：这个终端窗口不要关，关了 Harness 就停了。

第三步：填入 API Key（给 AI 大脑「点火」）

在打开的页面里进入Settings（设置）→ Models（模型），粘贴你的 DeepSeek API Key，保存。没有 Key？去注册 → 创建 API Key（会要求充值一点钱，通常 10 元够用很久）→ 复制那串sk-开头的字符串。

第四步：选择工作区，说第一句话

点Choose workspace（选择工作区），选一个文件夹作为它的「办公室」（建议先建一个空的测试文件夹）。然后在对话框里输入：

你好，介绍一下你自己，并告诉我你能帮我做什么。

恭喜，你已经用上了 AI 智能体！

小贴士：想随时关闭就回到终端按 Ctrl+C。下次使用：打开终端 → 输入 npx @deepseek-ai/dsh web → 浏览器打开地址即可（历史会话都还在）。

第四章 · 日常怎么用？（从问问题到派活）

它和聊天 AI 最大的区别：你说目标，它动手干。

4.1 试试这些真实任务

改代码：「这个项目的登录功能有个 bug，帮我找到并修好」

搜资料：「搜索一下 2026 年最火的 AI 编程工具，整理成带链接的报告」

整理文件：「把 downloads 文件夹里的照片按日期归类」

写东西：「帮我写一份项目周报，参考 docs 文件夹里的记录」

它会列出计划、动手执行，并在涉及修改文件的步骤前询问你（这是它的默认安全设置，点允许才继续）。

重要观念：它是个聪明的实习生，但不是神：复杂任务可能做错、可能绕远路。请像带新人一样——给明确目标、看它执行、及时纠正。

4.2 几个斜杠命令（输入 / 会弹出菜单）

命令	大白话解释
`/plan`	「先别动手，给我出个方案」——进入计划模式，只调研不改文件
`/goal`	「记住这个长期目标」——跨很多轮对话持续执行
`/compact`	「太长记不住了，压缩一下」——省流量（token）
`/permission`	「调整它的权限」——日常用默认的 `workspace-write` 就行
`/export`	「把这次对话导出成文件」——备份或分享

4.3 新建会话时，还能选「Agent 模式」

创建新会话时，dsh 提供四种Agent 模式（预设）可选——它们决定这个会话里 AI 有哪些"手脚"。注意：这是会话里的预设，和"四种运行方式"（web / 无头 / 自定义 / 插件管理，指怎么启动程序）不是一回事。

模式	大白话
标准模式（默认）	功能最全：改文件、跑命令、搜网页、技能、计划、子代理、工作流全都有。日常选它就行。
PTC 模式	能力同标准模式，但工具以"写一段 TypeScript 程序"的方式呈现——AI 把好几步操作写成一个程序一次跑完，少来回几次、更省流量。
极简模式	只有"执行命令"和"精确改文件"两个工具，提示词也固定——最克制、最少干扰，适合只需要它老实干活的时候。
创造模式	给想定制 AI 的人用：复制一个现有模式当模板，自己改出专属模式（改名字、改描述、改工具组合），适合进阶玩家。

记住一点：模式在创建会话时选定；只有还没开始干活的空白会话能换模式，聊到一半不能换（换了会让前面的记录对不上号）。

第五章 · 插件是什么？（像手机装 App 一样）

这是 dsh 最特别的地方：它的每个功能都是插件，你可以自由加减、替换。

一个类比手机出厂自带通话、短信、相机……dsh 出厂自带文件读写、搜索、执行命令……手机能装 App（地图、外卖、游戏）——dsh 能装插件（深度搜索、代码地图、小游戏）；手机 App 来自应用商店——dsh 插件来自 npm / GitHub（一个命令即可安装）。甚至内置功能（比如「用什么搜索引擎」）也是插件，你可以整个换掉——这就是官方说的「一切皆插件」。

5.1 三种「能力包」，别搞混

名字	大白话	怎么获得
插件（Bundle）	正经的「App」：给 dsh 加新功能	一条命令安装（见下）
技能（Skill）	「岗位说明书」：一篇文章告诉 AI 特定任务怎么做	把文件夹放进 skills 目录，立刻生效
MCP 连接	「万能插座」：接上别的 AI 生态的服务	复制一段配置文本

5.2 怎么装插件？两种方式任选

方式 A：设置面板（图形化）——Settings → Plugins页面可以管理已安装的插件。

方式 B：一条命令（推荐）——先安装 pnpm（一个包管理器，在终端执行）：

npminstall-gpnpm

然后安装任何插件，例如装一个「对话聚焦视图」插件：

dsh plugin--profileweb add github:dingyi222666/dsh-focus-chat

装完重启 dsh（终端 Ctrl+C，再重新启动）就生效了。以后想卸载：把add换成remove再执行一次。

小白注意：从 GitHub 安装时，如果终端提示「需要在 pnpm-workspace.yaml 里 allowBuilds」，这是 dsh 在要求你确认信任这个插件（允许它在安装时运行自己的代码）。只有你确定来源可信时才照做——下面第八章会细讲安全。

5.3 技能怎么用？

比如有人分享了一个「写周报技能」文件夹：把它的skills/目录复制到你电脑的$DSH_HOME/skills/（通常是C:\Users\你的用户名\.dsh\skills）下，不需要重启。之后你只要说「用写周报技能帮我写周报」，它就会先加载那份说明书再干活。

第六章 · 装点什么好？（客观推荐清单）

社区有 270+ 个插件仓库，但质量参差、很多还在迁移中。这里只推荐「确认可用、小白友好」的。

插件	有什么用	适合谁	安装命令
dsh-find-plugins（技能）	「插件商店」：直接对 AI 说"有没有插件能……"，它帮你找并安装	所有人（装这一个，找插件不用愁）	复制它的 `skills/find-plugins/` 文件夹到 skills 目录
dsh-focus-chat	把 AI 的完整工作过程折叠成一行摘要（"思考 36 秒，改了 8 个文件"），点开看细节	觉得 AI 干活过程太啰嗦的人	`dsh plugin --profile web add github:dingyi222666/dsh-focus-chat`
dsh-navbar	对话变长后，右侧出现"节点导航条"，快速跳回任意一轮	长对话重度用户	`dsh plugin --profile web add "github:vlln/dsh-navbar#main"`
dsh-loop	定时循环：每 5 分钟自动检查一次任务（注意：重启后循环会消失）	盯 PR、盯行情、定期巡检	`dsh plugin --profile web add "github:vlln/dsh-loop#main"`
dsh-context-doctor	显示每次对话消耗了多少 token（流量），帮你省钱	关心用量的人	`dsh plugin --profile web add "github:Zhenyu98/dsh-context-doctor#main"`
dsh-share	把对话导出成一张好看的图片，分享给朋友	爱分享的人	`dsh plugin --profile web add --ignore-scripts --config.auto-install-peers=false 'github:hellodigua/dsh-share#v0.1.0'`

先别碰的（客观提醒）

标注"不可达"的插件：社区一半左右的仓库正处于迁移状态（安装会失败），装之前先去确认仓库还活着；

涉及安全/系统权限的插件（自动批准、电脑操控、渗透测试类）：新手阶段先别装；

需要额外服务的插件（如 MinerU 文档解析要自建服务、数据插件要装数据库客户端）：等你真正需要时再研究。

第七章 · 常见问题（小白版 FAQ）

都是新手最容易遇到的情况。

Q1：页面打不开 / 显示连接不上？

99% 是启动终端被关了。回到终端重新执行npx @deepseek-ai/dsh web，保持窗口开着，再刷新浏览器。

Q2：提示没有 API Key / 模型不可用？

去Settings → Models检查 Key 是否粘贴正确（注意别多复制空格）。Key 以sk-开头，页面显示时通常只显示前几位。

Q3：它改了我的文件，能撤销吗？

默认设置下，每次修改文件前它都会先问你要不要允许。如果不放心，可以在会话里使用/permission read-only切成只读模式——它就只看不写了（用完记得切回来）。

Q4：装插件报错 "path ... 被拆开" / 一堆看不懂的英文？

最常见原因是文件夹路径里有空格（比如用户名是 "My Name"）。把插件文件夹放到一个无空格的路径（例如C:\plugins\xxx）再装，通常就好了。其他报错可以把英文提示复制给 AI 问。

Q5：它说"插件安装好了"但没效果？

装完插件必须重启 dsh（终端 Ctrl+C 后重新启动）。另外验证是否真的挂载成功，在终端执行：

dsh--profileweb--dump-config

能看到

== 插件名这一层就说明装上了。

Q6：和 ChatGPT / Claude 比，到底选哪个？

选 dsh 的场景：想要 AI 直接在你电脑上干活、想要免费开源、愿意折腾、用 DeepSeek 模型（性价比高）。

谨慎的场景：追求开箱即用和稳定性（dsh 还在预览版）；完全不想碰终端；需要商业支持。

可以并存的场景：聊天问答用网页版（免费），正经干活用 dsh——两者互补，不冲突。

第八章 · 安全须知（务必读一遍）

让 AI 操作你的电脑，前提是你知道边界在哪。这一章不吓唬人，只说事实。

三条铁律

API Key 是钱：它按用量计费。不要把它发给任何人、不要写进聊天、不要贴到网上。泄露=别人花你的钱。

权限是闸门：默认workspace-write（只能改你选的工作区里的文件）是安全的选择；不要轻易切到danger-full-access（全权模式，不再逐个询问）。

插件是代码：装插件 = 运行陌生人的代码。只装来源可信（官方、知名作者、GitHub 星标高）的插件；遇到allowBuilds确认提示时，想清楚再点。

两个实用习惯

重要文件先备份或用 Git 提交，再让 AI 动手；

第一次用某个插件 / 某类任务时，在旁边看着它做，直到你信任它。

放心一点：dsh 的安全设计是认真的：文件操作默认要批准、沙箱限制写入范围、权限分三档可随时切换（/permission）。你只需要保持「让实习生干活时偶尔瞟一眼」的心态。

第九章 · 想更进一步？

这份教程到这里就够了。如果你还想深入，按顺序看这些。

想了解全部内置功能：官方的 README 和；

想把 dsh 当日常主力工具：阅读《DeepSeek Harness 插件完全手册》（dsh-plugin-manual.md/dsh-plugin-manual.html）——从概念到实战全覆盖；

想让 AI 按你的习惯工作：学习写技能（SKILL.md），一份几十行的说明书就能让它在你的领域更专业；

想自己写插件：官方+ 配套插件源码（anysearch-plugin/、import-hub-plugin/）；

遇到问题：官方、。

最后一句客观的话：dsh 目前是开发者预览版：免费、强大、理念先进，但也意味着界面会变、插件生态在洗牌、需要你有一点折腾的耐心。如果你愿意接受这些，它会是你用过的最有意思的 AI 工具之一。祝玩得开心 🐋

DeepSeek Harness 小白入门教程 · 与《插件完全手册》配套 · 基于 0.1.0-rc.6 调研整理