课程系列《DSH 零基础微课 · AI 从入门到精通》 · 共 20 讲 · 每讲约 6 分钟

第 1 讲 / 共 20 讲 · 零基础适用 · 全程可跟随操作

第 1 讲 · 从零安装与使用
DeepSeek Harness (DSH)

AI 光动嘴、你动手的时代结束了。这节课给大模型“配一双手”:两条命令、一个网址、一个文件夹,让 AI 真正帮你建文件、改文件。

数字人讲师
数字人讲师 · 章刘成

面向编程零基础学员的入门课程

微信二维码 扫码获取更多 AI 工具资料包
课程封面:DSH 主界面实拍合成图

一、本次微课视频

第 1 讲 / 共 20 讲 · 约 6 分钟 · 教师配音讲解 · 3D 动效课件

课程封面:DSH 零基础微课 第 1 讲 ▶ Bilibili ⏱ 约 6 分钟 第 1 讲 · 从零安装与使用 DeepSeek Harness点击封面,前往 B 站观看高清完整版(1080P)· 教师配音 · 3D 动效课件
B 站视频二维码:手机扫码观看 📱 手机扫码观看

用哔哩哔哩 App 扫码
随时随地学这一讲

🔗 网页打开 B 站视频
🎙️ 教师配音 · 数字人讲解 🎬 3D 动效课件 📺 系列课程 · 第 1 讲 / 共 20 讲 🧭 零基础易上手 · 命令一键复制

二、DSH 是什么?先记住这四点

一句话:大模型是“军师”,DSH 是给军师配的“一双手”。

🖥️
本地 Web 界面

服务跑在你自己电脑上,浏览器打开 127.0.0.1:3080 就能用,各家进各家的门。

📁
本地化调用文件

选定一个文件夹当“工作区”,AI 就能在里面看文件、建文件、改文件。

🧩
一切皆插件

基于 Cordis 插件架构,模型、工具像乐高零件一样可换可扩,不用改核心代码。

☁️
要注意的一点

文件在你家,大脑在云端:用 API Key 联网调用 DeepSeek 大模型,断网不行。

三、图文步骤:跟着做,八步通关

全程只需复制 2 条命令 + 1 个网址。点命令块右侧按钮即可一键复制;所有实拍截图点击可放大查看。

0

备料:五样东西先备齐

Node.js(v22.19+)、DeepSeek API Key、一个空文件夹 dsh-demo-workspace、浏览器、终端。

⚠️ DSH 目前是 开发者预览版 v0.1,是“试用版宝宝”——别让它碰生产环境和重要文件,就让它在空文件夹里撒欢。

🔑 API Key 哪里来?打开 deepseek.com,进入「API 开放平台」注册后即可创建,新用户通常有赠送额度。

DeepSeek 官网 API 开放平台实拍
实拍图⓪:deepseek.com →「API 开放平台」,注册后创建你的 API Key
1

装 Node.js —— 电源插座

DSH 这个“电器”,得插在 Node.js 这个“插座”上才能通电。

打开浏览器进入 nodejs.org,下载 v22.19 或更高版本,一路“下一步”。Windows 用户安装时不要取消 PATH 环境变量的勾选——取消了等于门装好了没留门牌号,终端找不着它。装完把终端关掉重开一次。

Node.js 官网首页实拍
实拍图①:地址栏输入 nodejs.org/zh-cn,点击「获取 Node.js」
Node.js 下载页实拍
实拍图①‑补充:下载页选择「Windows 安装程序 (.msi)」,LTS 长期支持版即可

📹 实操录屏:Node.js 下载安装全程演示,可暂停跟随操作

2

验货:node -v

回你一串版本号,第一关就算过了。

node -v

返回版本号 ≥ v22.19(如下图中的 v24.20.0)→ 成功。提示“找不到命令” → 重启终端,还不行就重装 Node.js。终端是个实在人:你问啥,它答啥。

终端 node -v 实拍
实拍图②:终端中执行 node -v,返回 v24.20.0,高于 v22.19 即成功
3

一条命令,把 DSH 叫醒

跟点外卖一样:你不用知道后厨在哪,饭给你送到。

npx @deepseek-ai/dsh web

首次运行会下载程序包,慢是正常现象。中途提示 Ok to proceed? (y) 时,确认包名是 @deepseek-ai/dsh 后输入 y 回车。这个终端窗口全程不要关——它一关,DSH 就“断气”了。

npx 启动 DSH 实拍
实拍图③:首次运行提示 Ok to proceed? (y),确认包名后输入 y 回车
4

浏览器开门:127.0.0.1:3080

127.0.0.1 翻译成人话就俩字:我家。3080 是门牌号。

http://127.0.0.1:3080

在浏览器地址栏输入并回车。页面打开,DSH 就算在你电脑上安家了。这个网址发给别人没用——各家进各家的门。

DSH 主界面实拍
实拍图④:浏览器打开 127.0.0.1:3080,进入 DSH 主界面
5

配钥匙:API Key

手脚连大脑的“门禁卡”,用完收好。

首次打开 DSH 会弹出「添加一个 API Key」窗口,把 DeepSeek API Key 粘贴进去,点「保存并继续」;之后也可随时在设置中修改。三不原则:不截图发群、不发朋友圈、不提交公开仓库。建议用专门的测试 Key 并设低额度——真泄露了,也就损失一顿早餐钱。

API Key 配置弹窗实拍
实拍图⑤:首次使用弹出「添加一个 API Key」,粘贴后保存并继续
6

圈地盘:选择工作区

请保洁阿姨,总得告诉她今天打扫哪间房。

点击选择工作区,选中提前建好的空文件夹 dsh-demo-workspace。别选桌面、别选系统盘、别选攒了三年的重要资料——空文件夹里随便它折腾,翻不了天。

选择工作区实拍
实拍图⑥:点击「选择工作区」,选中提前建好的空文件夹
7

开张第一单:让 AI 建文件

模式选“标准模式”,任务文本直接复制下面这段。

请先看看当前工作区里有什么,然后新建一个叫 dsh-first-run.md 的文件,写三句话:1. 我成功启动了 DSH。2. 我配好了 API Key。3. 我选好了工作区。干完活告诉我一声。

如果弹出“即将写入文件”的确认提示,先看清路径是不是你圈的文件夹,再放行——活儿让 AI 干,签字之前你得看一眼。

DSH 创建文件实拍
实拍图⑦:发送任务后,DSH 分步执行并创建 dsh-first-run.md
DSH 执行任务实拍
实拍图⑦‑补充:DSH 调用工具、生成文件的完整对话过程
8

验收 + 追加一单:改文件

物流显示“已签收”不算数,快递到你手上才算数。

打开文件管理器进入工作区,确认 dsh-first-run.md 真实存在、内容正确。然后发第二单让它改文件:

请打开 dsh-first-run.md,在文件最后加一行:“这是我指挥 AI 干完的第一单活。”改完跟我汇报一下。
修改文件实拍
实拍图⑧:AI 成功修改 dsh-first-run.md,在末尾追加新行
💡 小贴士:给 DSH 换一身“深色皮肤”

默认是浅色界面。喜欢深色的话,进入 设置 → 通用设置 → 外观,选择「深色」即可,深夜跟着做更护眼。

深色模式设置实拍
实拍图:外观设置中选择「深色」

四、常见问题排查

首次使用时常见的五类问题及处理方法。

症状处理方法
终端提示找不到 nodeNode.js 未安装成功,或终端未重新加载:重启终端再试,仍不行则重装 Node.js。
npx 命令报错检查命令是否输入完整无误,确认网络连接正常,并查看报错末尾的具体信息。
浏览器无法访问 3080确认终端中的 DSH 服务仍在运行;若终端已关闭,请重新执行启动命令。
发送任务后无响应回到设置检查 API Key 是否已保存、是否有效,以及网络连接是否正常。
任务完成但未生成文件确认工作区路径选择正确,并检查该文件夹是否具有写入权限。

通用建议:将终端中的完整报错信息复制后发送给 DSH,让其协助分析原因。

📬 获取更多 AI 工具资料包

扫码添加讲师微信,领取《AI 入门工具包》+《DSH 进阶指南》

含:提示词模板 · 插件推荐 · 实战案例 · 答疑群入口

微信二维码 扫码添加我为朋友
截图放大查看