关注 霍格沃兹软件测试开发 公众号回复「资料」, 领取人工智能测试开发技术合集一行命令装好5分钟跑通然后你会明白为什么它一夜5万星01 一个让我失眠的对话“兄弟DeepSeek Harness你试了吗12小时5万星那个。”前天晚上一个做测试的老同事发来消息。“看了还没试。”“赶紧试一下。我昨晚装上了一行命令5分钟跑通。然后我让它跑我们项目的测试——它自己读代码、自己执行、自己分析失败原因然后把修复方案列出来了。”“整个过程我就坐在旁边看着。”他停顿了一下又说了一句“我感觉……我以后招人的标准要彻底变了。 ”我当晚就装上了。然后失眠了。这篇文章就是把我踩过的坑、走过的弯路、跑通的流程全部整理出来。目标只有一个让你在30分钟内从零开始跑通第一个DeepSeek Harness任务。02 痛点官方文档有架构但没有“从零上手”的路径DeepSeek Harness简称dsh是DeepSeek在2026年8月13日开源的Agent运行时。官方口号只有五个字一切皆插件。但有一个问题官方文档以架构说明为主缺少一条从零上手的路径。打开GitHub仓库你会看到AGENTS.md、architecture.md、development.md——全是给开发者看的架构文档。对于一个刚接触dsh的新手来说根本不知道从哪里开始。所以就有了这篇教程。先搞清楚一个核心概念Agent Model Harness。模型是“大脑”负责思考和推理Harness是“手脚”负责让模型真正动手干活——读文件、调工具、执行命令。用大白话理解你以前是自己写脚本跑测试现在是给AI一个“能动手干活的身体”让它自己去跑。03 核心思路30分钟从零到跑通就这5步整个流程就5步装Node.js2分钟装dsh2分钟启动Web UI1分钟配置API Key2分钟选工作区跑任务3分钟剩下的20分钟用来跑几个真实任务感受一下。全程不需要写一行代码。04 具体步骤从安装到跑通手把手教学第一步检查Node.js环境2分钟DeepSeek Harness需要Node.js环境要求Node.js版本 ≥ 22。打开终端Windows用户打开命令提示符或PowerShell输入node --version如果看到版本号如v22.19.0或更高说明已经装好了。如果提示找不到node命令去Node.js官网下载LTS长期支持版本安装即可。小技巧如果明明装过Node.js但终端提示找不到命令关闭当前终端重新打开。很多时候只是环境变量还没刷新。第二步一条命令安装DSH2分钟Node.js准备好之后执行这条命令npx deepseek-ai/dsh web这条命令会自动下载并启动DeepSeek Harness的Web UI。首次运行可能需要等一两分钟下载依赖。装完之后可以验证一下版本dsh --version看到版本号当前是0.1.0-rc.6就说明安装成功了。Windows用户特别提醒安装Node.js或全局npm包以后如果遇到“明明装好了却找不到命令”的问题重新打开一次PowerShell或命令提示符。不想折腾命令行 还有两个选择桌面版GitHub上有社区打包的DeepSeekHarness-win32-x64-0.1.0-rc.5.zip~238 MB解压即用Dockerdocker run -d --name dsh -p 3080:3080 ghcr.io/huoxue1/deepseek-harness:latest第三步启动Web UI1分钟执行启动命令npx deepseek-ai/dsh web稍等片刻终端会输出本地地址默认是http://127.0.0.1:3080。用浏览器打开即可。如果浏览器没有自动打开手动把这个地址复制进去就行。注意目前DSH还是v0.1开发者预览版本项目处于快速迭代阶段接口和配置方式后续可能会有变化。第四步配置API Key2分钟第一次进入Harness最重要的一步配置DeepSeek API Key。操作路径点击界面中的 设置Settings → 模型Models在DeepSeek卡片中输入你的API Key并保存密钥保存在本地$DSH_HOME/.credentials.yaml中不会被上传还没有API Key 去DeepSeek开放平台注册账号创建API Key。安全提醒API Key是调用模型服务的凭证不要随便发给别人不要贴到公开文章、GitHub仓库或截图里。密钥保存后为什么看不到了 这是刻意设计——密钥只写界面只显示脱敏描述符。第五步选择工作区1分钟配置完API Key后点击 选择工作区Choose Workspace 。工作区就是Agent能“动手”操作的文件夹——Agent可以读取、编辑这个文件夹里的文件执行命令。选择一个你想让Agent工作的项目目录。注意在Web UI中选中工作区之前会话输入框是不可用的。第六步跑通第一个任务3分钟现在可以开始体验了新建一个会话输入一个简单的任务比如Summarize this repository and identify its main packages.Agent会开始工作读取仓库文件、执行命令、按需委派子任务、维护执行计划。每个操作都可以在Web UI中看到实时进展。当某个操作需要审批时界面会先询问你。每次会话都会自动持久化默认存在$DSH_HOME/sessions可以随时恢复继续。跑完这个任务你就正式上手了。整个过程不到10分钟。05 进阶四种运行模式总有一种适合你除了Web UIDeepSeek Harness还支持多种运行方式方式一从npm运行最推荐新手npx deepseek-ai/dsh web方式二全局安装长期使用npm install -g deepseek-ai/dshdsh web方式三Headless模式适合脚本/CI一次性任务dsh --profile headless “你的任务描述”例如dsh --profile headless “把当前目录的测试跑一遍并汇总结果”运行完会打印Agent的最终回答并退出。方式四从源码运行适合开发者git clone https://github.com/deepseek-ai/deepseek-harness.gitcd deepseek-harnesspnpm installpnpm run buildpnpm dsh web四种预设模式标准模式开箱即用具备AI编程工具的全部能力、极简模式轻量快速、代码模式专注代码任务、创造模式适合创意类任务。06 真实案例让Harness帮你跑测试这才是测试人最关心的部分。案例一安装测试运行插件社区已经有人做了一个叫dsh-test-runner的插件。安装方法dsh plugin --profile web add suimi8/dsh-test-runner这个插件让Agent一次工具调用就能完成“改代码→跑测试→修”的完整闭环。它能做什么自动探测测试框架vitest/jest/pytest/node:test执行测试只返回结构化摘要通过/失败统计失败用例名称与错误信息省token、少一轮案例二Web自动化插件还有dsh-plugin-playwright插件基于Playwright的浏览器自动化工具。安装后模型可以读取页面内容点击控件填写表单滚动与导航同时保留登录态、会话和Cookie案例三真实测试场景有开发者实测让Harness跑一个中等复杂度的项目让它分析代码仓库结构自动探测测试框架执行全部测试汇总失败用例给出修复建议整个过程人只需要在旁边看着。07 避坑指南新手最容易踩的6个坑坑1Node.js版本不对DSH要求Node.js ≥ 22。用老版本会报错。检查方法node --version。坑2终端没刷新装完Node.js或npm包之后一定要重新打开终端。很多时候“找不到命令”只是环境变量没刷新。坑3API Key没配置就发消息没配置API Key就直接发消息会报错。先去设置→模型里把Key填好。坑4没选工作区Web UI中没选工作区之前输入框不可用。点一下“选择工作区”选一个文件夹就行了。坑5npx下载很慢或失败网络问题。换npm镜像源重试。或者用桌面版一键包不用折腾网络。坑6等“稳定版”再学DSH目前是v0.1开发者预览版官方明确说“核心插件和基础接口未来几个月会快速演化”。等稳定了再学你就已经落后了。08 常用命令速查命令用途npx deepseek-ai/dsh web启动Web UI最常用dsh --profile headless “任务”一次性任务跑完退出dsh --dump-config查看叠加后的最终配置排查问题很有用dsh plugin --profile web add 包名给web profile安装插件dsh --help查看启动器帮助参数顺序的讲究启动器自己的参数–profile、–patch等必须写在最前面应用参数写在启动器参数之后正确示例dsh --profile web --port 8080 # --port 是web应用的参数dsh --profile headless “任务” # 任务文本是应用参数09 写在最后DeepSeek Harness开源不到12小时GitHub上5万星。它把Agent框架从“固定大楼”变成了“一盒乐高” ——模型适配器、工具注册表、会话日志、Agent Loop每一部分都可以从配置替换。官方默认部署里有一百多个可单独开关的插件发布24小时内社区带dsh-plugin标签的插件仓库已经攒到288个。对于测试工程师来说这意味着什么意味着“写测试脚本”这个技能正在被AI Agent化。 社区已经有人在Harness上做出了“改代码→跑测试→修”的完整闭环。但Harness不会让测试工程师消失——它会让“只会执行”的测试工程师消失。就像Excel没有让会计消失但让“只会打算盘”的会计消失了。工具在变但“对质量负责”这件事永远需要人。问题是——你是那个被工具替代的人还是那个用工具的人现在就去试试吧。打开终端输入npx deepseek-ai/dsh web30分钟后你就知道了。本文部分内容参考了霍格沃兹测试开发学社整理的相关技术资料主要涉及软件测试、自动化测试、测试开发及 AI 测试等内容侧重测试实践、工具应用与工程经验整理。