![[特殊字符]DeepSeek‑Harness（DSH）小白保姆教程](http://pic.xiahunao.cn/yaotu/[特殊字符]DeepSeek‑Harness（DSH）小白保姆教程)
DeepSeek‑Harness简称 DSH是 DeepSeek 开源的AI Agent运行框架公式Agent 大模型 Harness。模型负责思考Harness负责让AI读写本地文件、执行终端命令、调用工具、拆分复杂任务核心理念一切皆插件当前为开发者预览版会频繁更新适合尝鲜不要直接上生产环境。⚠️安全提醒DSH可以操作你电脑本地文件、运行shell命令务必新建空文件夹作为工作区不要直接选桌面、系统目录、重要项目文件夹防止误删文件。第1步安装 Node.js必须前置DSH是Node程序Windows/macOS/Linux都需要推荐版本Node.js 22.19 /24.x LTS。打开Node官网下载LTS长期支持版本一路下一步安装。安装完成打开终端WindowsPowerShell不要用cmdMac终端验证是否安装成功输入命令node -v输出版本号代表安装成功。如果提示“不是内部命令”重启终端或者重新安装Node。第2步一行命令启动DSH Web界面最简单小白选这个复制下面整行粘贴到终端回车执行npx deepseek-ai/dsh web第一次运行会提示Need to install the following packages输入y回车确认下载包。等待下载、启动服务终端输出dsh web: http://127.0.0.1:3080不要关闭这个终端窗口关闭就停止服务。复制这个地址浏览器打开http://127.0.0.1:3080备选全局安装网络差、想固定版本npm install -g deepseek-ai/dsh dsh web进阶源码编译运行做插件开发才需要小白跳过git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web第3步获取DeepSeek API‑Key网页打开后会弹窗要求填入API密钥没有key无法调用大模型。访问DeepSeek开放平台登录账号。进入API Keys页面点击【添加API Key】复制生成的密钥。注意密钥只显示一次保存好不要泄露给别人会消耗你的账户余额。第4步Web界面基础配置浏览器打开http://127.0.0.1:3080弹出内测提示点击继续。在弹窗粘贴刚才复制的API‑Key点击【保存并继续】。后续修改key页面左下角设置⚙️ → Models粘贴密钥保存无需重启服务。选择工作区最重要点击页面左上角【选择工作区】按钮新建一个空文件夹选中这个空文件夹作为工作目录。✅正确D:\dsh‑test、~/dsh‑demo这种全新空文件夹❌禁止桌面、文档、你的正式项目、系统文件夹AI会读写、修改甚至删除目录下文件。选中之后对话框才解除灰掉可以输入指令。第5步认识4种运行模式小白优先标准模式DSH左上角可以切换模式四种模式不是简单改提示词是加载不同插件集合标准模式 Standard新手默认完整Agent读写文件、shell终端、网页搜索、任务规划日常写代码优先选这个。代码模式 Code Mode把多个工具操作合并为TypeScript脚本批量执行适合复杂批量任务。极简模式 Minimal最小工具集只有文件编辑bash适合调试限制AI能力。创作者模式 Creator用来开发自定义Agent插件普通用户不用。第6步第一次实战任务测试是否跑通工作区已经选好空文件夹模式选【标准模式】权限默认即可。输入第一条简单指令复制发送在当前目录新建一个index.html写一个简单的网页标题是我的第一个DSH测试页面页面输出hello DSH Harness观察页面发生的动作Agent自动规划任务调用文件工具创建index.html你可以看到每一步工具调用记录任务完成后打开本地工作文件夹确认index.html已经生成。小提示遇到风险操作比如删除文件DSH会弹出确认框你手动允许才会执行不要随便点允许。第7步常用实操示例直接复制测试示例1写Python脚本写一个python脚本实现冒泡排序保存为sort.py同时生成readme.md说明怎么运行示例2重构已有项目注意工作区选你的测试项目不要选重要项目读取当前目录下sort.py给全部函数增加注释优化代码直接覆盖原文件示例3执行终端命令执行命令打印当前目录文件列表把结果输出到list.txt常见踩坑与排错问题1npx命令报错Node版本太低升级Node到22.19以上。国内npm下载慢设置镜像npm config set registry https://registry.npmmirror.com问题2浏览器打不开 http://127.0.0.1:3080确认终端还在运行DSH不要关闭终端看终端实际输出地址个别环境端口会变复制终端打印出来的地址。问题3API调用报错检查API Key复制完整不要带空格换行DeepSeek账户余额充足设置 → Models确认密钥已经保存。问题4输入框灰色无法输入没有选择工作区点击左上角选择工作区选中文件夹后输入框激活。问题5想停止DSH回到运行的终端窗口按Ctrl C服务停止。下次使用重新执行npx deepseek-ai/dsh web。补充其他运行方式小白了解即可无头Headless模式无界面自动化脚本dsh run 你的任务指令Python SDK适合写程序调用Agent需要单独安装SDK包。重要安全注意事项DSH具备本地文件读写、运行系统命令的能力永远不要把工作区设置到包含私人资料、重要业务代码的目录。遇到删除文件、修改系统配置的请求一定要人工确认不要一键放行。当前版本是开发者预览插件、配置后续版本可能会不兼容更新不适合生产项目直接使用。参考链接官方仓库https://github.com/deepseek-ai/deepseek-harnessDeepSeek开放平台api.deepseek.com [特殊字符]DeepSeek‑Harness（DSH）小白保姆教程
DeepSeek‑Harness简称 DSH是 DeepSeek 开源的AI Agent运行框架公式Agent 大模型 Harness。模型负责思考Harness负责让AI读写本地文件、执行终端命令、调用工具、拆分复杂任务核心理念一切皆插件当前为开发者预览版会频繁更新适合尝鲜不要直接上生产环境。⚠️安全提醒DSH可以操作你电脑本地文件、运行shell命令务必新建空文件夹作为工作区不要直接选桌面、系统目录、重要项目文件夹防止误删文件。第1步安装 Node.js必须前置DSH是Node程序Windows/macOS/Linux都需要推荐版本Node.js 22.19 /24.x LTS。打开Node官网下载LTS长期支持版本一路下一步安装。安装完成打开终端WindowsPowerShell不要用cmdMac终端验证是否安装成功输入命令node -v输出版本号代表安装成功。如果提示“不是内部命令”重启终端或者重新安装Node。第2步一行命令启动DSH Web界面最简单小白选这个复制下面整行粘贴到终端回车执行npx deepseek-ai/dsh web第一次运行会提示Need to install the following packages输入y回车确认下载包。等待下载、启动服务终端输出dsh web: http://127.0.0.1:3080不要关闭这个终端窗口关闭就停止服务。复制这个地址浏览器打开http://127.0.0.1:3080备选全局安装网络差、想固定版本npm install -g deepseek-ai/dsh dsh web进阶源码编译运行做插件开发才需要小白跳过git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install pnpm run build pnpm dsh web第3步获取DeepSeek API‑Key网页打开后会弹窗要求填入API密钥没有key无法调用大模型。访问DeepSeek开放平台登录账号。进入API Keys页面点击【添加API Key】复制生成的密钥。注意密钥只显示一次保存好不要泄露给别人会消耗你的账户余额。第4步Web界面基础配置浏览器打开http://127.0.0.1:3080弹出内测提示点击继续。在弹窗粘贴刚才复制的API‑Key点击【保存并继续】。后续修改key页面左下角设置⚙️ → Models粘贴密钥保存无需重启服务。选择工作区最重要点击页面左上角【选择工作区】按钮新建一个空文件夹选中这个空文件夹作为工作目录。✅正确D:\dsh‑test、~/dsh‑demo这种全新空文件夹❌禁止桌面、文档、你的正式项目、系统文件夹AI会读写、修改甚至删除目录下文件。选中之后对话框才解除灰掉可以输入指令。第5步认识4种运行模式小白优先标准模式DSH左上角可以切换模式四种模式不是简单改提示词是加载不同插件集合标准模式 Standard新手默认完整Agent读写文件、shell终端、网页搜索、任务规划日常写代码优先选这个。代码模式 Code Mode把多个工具操作合并为TypeScript脚本批量执行适合复杂批量任务。极简模式 Minimal最小工具集只有文件编辑bash适合调试限制AI能力。创作者模式 Creator用来开发自定义Agent插件普通用户不用。第6步第一次实战任务测试是否跑通工作区已经选好空文件夹模式选【标准模式】权限默认即可。输入第一条简单指令复制发送在当前目录新建一个index.html写一个简单的网页标题是我的第一个DSH测试页面页面输出hello DSH Harness观察页面发生的动作Agent自动规划任务调用文件工具创建index.html你可以看到每一步工具调用记录任务完成后打开本地工作文件夹确认index.html已经生成。小提示遇到风险操作比如删除文件DSH会弹出确认框你手动允许才会执行不要随便点允许。第7步常用实操示例直接复制测试示例1写Python脚本写一个python脚本实现冒泡排序保存为sort.py同时生成readme.md说明怎么运行示例2重构已有项目注意工作区选你的测试项目不要选重要项目读取当前目录下sort.py给全部函数增加注释优化代码直接覆盖原文件示例3执行终端命令执行命令打印当前目录文件列表把结果输出到list.txt常见踩坑与排错问题1npx命令报错Node版本太低升级Node到22.19以上。国内npm下载慢设置镜像npm config set registry https://registry.npmmirror.com问题2浏览器打不开 http://127.0.0.1:3080确认终端还在运行DSH不要关闭终端看终端实际输出地址个别环境端口会变复制终端打印出来的地址。问题3API调用报错检查API Key复制完整不要带空格换行DeepSeek账户余额充足设置 → Models确认密钥已经保存。问题4输入框灰色无法输入没有选择工作区点击左上角选择工作区选中文件夹后输入框激活。问题5想停止DSH回到运行的终端窗口按Ctrl C服务停止。下次使用重新执行npx deepseek-ai/dsh web。补充其他运行方式小白了解即可无头Headless模式无界面自动化脚本dsh run 你的任务指令Python SDK适合写程序调用Agent需要单独安装SDK包。重要安全注意事项DSH具备本地文件读写、运行系统命令的能力永远不要把工作区设置到包含私人资料、重要业务代码的目录。遇到删除文件、修改系统配置的请求一定要人工确认不要一键放行。当前版本是开发者预览插件、配置后续版本可能会不兼容更新不适合生产项目直接使用。参考链接官方仓库https://github.com/deepseek-ai/deepseek-harnessDeepSeek开放平台api.deepseek.com