DeepSeek Harness 保姆级安装教程,新手小白也能上手

01先说这东西是啥

它不是又一个聊天网页。 你给它一个项目目录，它自己读代码、改文件、跑命令、搜资料，干完活汇报，觉得不对随时喊停。

它跑在你自己的电脑上。 代码、文件、密钥全部留在本地。

02先看全流程

装 Node → 一键启动 → 填 API Key → 选工作区 → 开干

03第一步：装 Node.js

DSH 基于 Node.js，机器上得有它。装过的直接跳过。

官网下载 LTS 版：https://nodejs.org（别手滑点 Current；官方没写死最低版本，直接装最新 LTS 最稳）。macOS 装 pkg、Windows 装 msi，一路下一步。装完开终端验证：

node -v

能输出版本号就成了：

node -v 有输出即安装成功

提示 command not found？多半是装完没重开终端。

04第二步：一键启动

终端里敲这一行：

npx @deepseek-ai/dsh web

npx 询问时输入 y，首次运行自动初始化配置（生成 ~/.dsh），随后打印地址：

浏览器打开 http://127.0.0.1:3080 即进入 Web 界面。

• 想长期用：npm install -g @deepseek-ai/dsh 全局安装，之后直接敲 dsh web
• 端口被占：加 --port 8080 换一个

05第三步：填 API Key

先去 https://platform.deepseek.com 注册、充值，创建 sk- 开头的 API Key。

回到 DSH 界面：左下角设置 → 模型，在 DeepSeek 卡片里粘贴密钥并保存：

• 保存即生效，不用重启

06第四步：选工作区

左侧会话列表，中间对话区，右下角选模型和权限

默认没有工作区，必须手动添加项目目录并选中，输入框才可用——它只会动你选中的这个目录。哪个目录要干活，就在哪启动 dsh web，再把它加进工作区。

07第五步：发第一个任务

试试水：

💬 帮我把当前项目的 README 总结一下，列出主要功能模块。

它会自己读文件、思考、回答；点开轨迹标签，还能回放每一步做了什么。

工具包括：跑命令、读写文件、网页搜索、派子代理并行、goal / workflow 拆阶段。超出当前权限的操作（比如动工作区之外的文件）会先在界面上问你，同意才动手——尺度由右下角权限模式决定：

默认 Workspace Write：工作区内的文件直接改，工作区外的要经过确认

第一次跑通，你会明显感到：它在帮你干活，不是陪你聊天。

08进阶：命令行一次性问答

不想开浏览器？headless 模式答完即退，适合脚本、CI：

dsh --profile headless "用一句话介绍你自己"

09常用命令速查

10常见问题

端口被占？--port 换一个，或 --port 0 让系统随机分配。

为什么不能 --host 0.0.0.0 局域网访问？ 官方故意禁止——那等于把"远程执行代码"的能力暴露到网络。默认只绑 127.0.0.1，仅本机可用。

密钥填了还报错？ 按优先级排查：环境变量 > ~/.dsh/.credentials.yaml > 项目 .env。

Windows 能用吗？ 能。命令行工具自动切换为 PowerShell 实现，权限模型一致。