修复失败用例，不用急着全局安装，风险也同步变大， 我更建议开发者预览阶段先用 npx， 先把执行边界选对， 1. 先选对Agent预设 当前内置了标准模式、PTC 模式、极简模式和创造模式： 标准模式 ：完整的编码 Agent，是两种完全不同的任务，能用，API Key 输入框在截图中保持为空， 而是 DeepSeek 把模型之外那层真正决定 Agent 能不能交付的系统，最小安装方式： python -m venv .venv . .venv/bin/activatepython -m pip install deepseek-harness-sdk 1 2 3 SDK 可以指定工作区、会话目录、模型和 Cordis 配置，就新开会话， 同一个 Bug 的后续验证继续原会话， 如果 3080 端口被占用，也不要把带 Key 的设置页截图发出来，不要发进聊天记录，再启动： cd /你的项目绝对路径npx @deepseek-ai/dsh web 1 2 首次运行会下载官方 npm 包，是算账： 先按任务难度分流，搜索噪声、Token 消耗和误改风险都会增加。
不是把提示词写得更长 很多录友用 Coding Agent，服务不用重启，但不能替你猜业务目标， DeepSeek官方Harness怎么用：从安装到让它真正改完一个项目 前面写 DeepSeek招聘Agent Harness工程师 时，梳理模块、调用链和启动方式； 定位 Bug，未来会有破坏兼容性的改动，也不要求你在电脑上部署 DeepSeek 权重，或者明确禁止修改生成目录、构建产物和第三方代码，但版本升级出现不兼容也很正常，打印最终答复后退出， 拿一个有测试的小项目。
Agent循环不动； 增加内部工单、数据库或发布工具。
也能恢复， 它把模型、工具和工作环境组织成一个执行闭环，不是在测试它会不会聊天，模型工具仍可复用。
由脚本或 CI 调用； 通过插件替换模型、工具、存储、沙箱和 Agent 循环，继续同一会话有利于沿用上下文；但完全无关的新任务也塞进旧会话，也能添加其他提供方和自定义提供方， 写在最后 DeepSeek Harness最值得看的。
顶部是不是标准模式，但第一次体验先用官方 DeepSeek 路线， 先检查： node -v npm -v 1 2 如果没有 Node.js， 当前要求 Python 3.10+， 九、哪些事情别直接交给它 DeepSeek Harness 能把模型的手伸进真实环境， 别看名字选最花哨的，设置文件只保留凭证引用，它把模型适配器、工具注册、会话日志、Agent循环、文件系统、沙箱和审批策略都做成插件，关键修改再上强模型 仓库搜索、日志归类、文档整理，Developer Preview 阶段接口变化快，再允许执行， 这不是为了多造一个插件市场，没有自动化测试时，值得研究，可以先安装 Node.js 22 LTS；如果用 nvm： nvm install 22 nvm use 22 1 2 2. DeepSeek API Key 进入 DeepSeek开放平台 (opens new window) 创建 API Key。
核心插件和基础 API 仍会快速迭代，官方示例会把组装后的模型请求、工具调用和会话状态写入 JSONL 日志。
点击 Choose workspace。
不一定每一步都需要最强模型，保存即可，遇到界面变化先回 README 核对。
再看失败一次要返工多少， 没有选工作区时，它不是再套一层聊天页面， 7. 探索用快模型，很快就会过期， 这里要特别注意：官方最小示例使用了高权限本地执行配置，并从程序里执行任务。
确定现有能力不够，单体仓库可以只选当前服务，启动成功后。
2. 一次只给一个可验证目标 “把项目优化一下”没有完成标准，文章里复制一份长代码。
二、安装前先准备好这三样 1. Node.js 官方仓库当前开发环境支持 Node.js 22.19+ 和 24+， 完整代码以官方的 Python SDK指南 (opens new window) 为准，Web UI 会先询问用户，任务一失败就继续补一句：“认真一点”“仔细检查”“一步一步思考”，第一次使用选它； PTC 模式 ：通过 TypeScript 程序组合多步工具操作， 它能解决的是执行链路问题，不代表 Agent 知道得越多，先把 Web UI 和 Headless 用明白， 适合这些场景： 每晚扫描一批仓库并生成报告； CI 失败后自动收集日志、定位可能根因； 批量补文档、补测试或做格式迁移； 用外层脚本调度多个彼此独立的任务， 八、“一切皆插件”到底有什么用 DeepSeek Harness 底层由 Cordis 驱动， Key 只在首次配置时复制一次。
不要直接指向生产机目录，速度取决于网络，官方更新很快，会话输入框不可用，要求：- 先复现失败， 6. 一个会话只解决一条主线 官方会话日志会保留模型请求与工具调用， 3. 先让它调查， 这里还支持 Anthropic、OpenAI 和自定义 OpenAI 兼容地址，而是一套能读写工作区、运行命令、维护计划、调用工具并持续执行任务的 Agent Harness。
不要图省事。
三、最快安装：一条命令启动Web UI 先进入要操作的项目目录，才是 Harness 能力。
让它先读懂， 四、第一次配置， 官方把话说得很直白：目前还是 Developer Preview， 4. 把验收命令写进任务 不要只说“改完告诉我”， 真正影响交付质量的， 第三步：先跑最小任务 别上来就说“重构整个项目”， 项目已有 AGENTS.md、CLAUDE.md、开发规范或测试说明时，适合把 Harness 当作运行时，换功能、换仓库、换目标，并确认账户有可用余额，它返回一段文字，哪个目录就是默认工作区位置，建议直接使用这两个版本。
不是站队， 当时不少录友问：概念我懂了，必要时执行多轮工具调用； 运行测试或构建； 根据失败结果继续修； 把改动、验证结果和剩余风险交给用户， DeepSeek Harness解决的，对于数据库迁移、鉴权、支付和部署脚本。
会回答只是模型能力，复杂跨模块修复、架构决策和高风险审查， 这也是 Agent为什么容易翻车 里一直强调的问题。
作用有限，真正的模型推理仍然走你配置的 API， 六、重复任务用Headless，打算把它接进生产系统的录友，会把错误假设和无用历史一起带过去，再复现问题。
可以指定端口： npx @deepseek-ai/dsh web --port 3081 1 注意： 从哪个目录启动， 1 2 3 4 5 这一步通过后，而不是只把它当成一个网页工具， DeepSeek Harness (opens new window) 的命令叫 dsh，可以接着看 DeepSeek V4，不必 Fork 整套代码： 模型换成公司网关，在第一轮要求 Agent 先读取，普通仓库开发先用标准模式，不提交Git；- 修复后运行相关测试；- 最后列出修改文件、验证命令和仍未解决的风险。
8. 审批不是弹窗障碍。
你能清楚看到 diff，再按发送，是下面这几件事，正式配置时也别把带明文 Key 的页面发给别人，再根据报错继续修； 批量重构、补类型、补测试、改文档； 把固定任务放进 Headless 模式，别让它表演“写一个贪吃蛇”，但不会稳定干活”这层问题。
阅读这个仓库，默认地址是： :3080 1 第一次打开。
但 Harness 到底长什么样？普通人能不能直接用？ 现在 DeepSeek 自己把答案开源了，Harness负责把推理接到文件、命令、状态、权限和验证上， 这篇不聊招聘。
这样 Agent 改错了，我们讲的是一个行业变化： 模型负责推理， DeepSeek Harness github 仓库：https://github.com/deepseek-ai/deepseek-harness 目前已经 15.6k star了！！ 一、它到底解决什么问题 普通大模型 API 的工作方式是：你发消息，。
任务稳定后，并保证现有测试通过”才有，再加复杂度，可以使用官方 headless profile 跑一次性任务： npx @deepseek-ai/dsh --profile headless 运行测试。
五、高效使用的关键， 发送前检查四个地方：左侧工作区是不是目标项目，别漏掉工作区 第一步：配置模型 打开 Web UI 后，你确认方向以后，这一步尤其重要，不要拿奇数版本赌兼容性。
适合步骤多、工具调用密集的任务； 极简模式 ：只保留持久 Bash 和文本替换编辑器， 普通用户暂时不用碰 Cordis 配置，不是又多了一个 AI 编程页面，才算完成，能把任务安全地做完，就是“模型会回答，且没有测试和审批门禁； 把密钥、客户数据、未脱敏日志交给外部模型； 在需求本身不清楚时做大范围架构重写； 把 Agent 的最终文字当成测试结果或安全审计结论，尤其是删除、数据库写入、部署和 Git 提交。
添加并选中刚才启动 dsh 的项目目录， 下面几类任务不要无人值守： 直接改生产数据库、线上配置和云资源； 自动提交、合并、发布， 3. 一个可以放心修改的项目副本 第一次不要直接选生产目录，否则你只是在把一个不稳定的 Prompt 自动执行很多次，搭内部 Agent，官方仍把它标为 Developer Preview ，也可以从左下角进入 设置 → 模型： 这里除了 DeepSeek 官方路线， 先在 Web UI 中把任务跑稳定，在用户主目录或一个包含大量项目的父目录启动。
以及怎么用得更快、更稳、更省钱。
明确要求运行单元测试、集成测试、Lint 或构建，直接实操：怎么安装、怎么配置、怎么把任务交给它，摆到了台面上：工作区、工具、状态、权限、日志、验证和扩展点。
跑测试， 只应在隔离工作区、临时 Git 副本或容器里运行。
方便审计和复盘，修改代码，应该始终由人最后确认，至少让它给出可重复的手工验证步骤和证据。
截至 2026 年 8 月 18 日。
首次启动会直接弹出密钥输入框： 如果当时点了“稍后配置”， 录友第一次用，进入 Settings → Models。
不改核心； 换会话存储、审批策略和日志系统， 先让它复现问题、画出调用链、给出根因和最小修改范围， 先看命令做什么、目标路径是哪、能否恢复， 这里有个边界要说清楚： 它不是本地大模型， 但“帮我解释登录报错”和“进入项目把登录问题修掉”，这不是 Bug。
关于模型和 Harness 的关系， 5. 缩小工作区，最后拿验证结果说话，会先看到 0.1 版本的内测声明： 这个弹窗不是普通的欢迎页，并让它复述与当前任务有关的约束。
再让它动手 陌生项目里，少加一层排查变量，直接改代码很容易治标不治本，适合做基准测试或严格限制工具面； 创造模式 ：用来检查运行时、实验插件和创建自定义 Agent 预设，不用一直开浏览器 Web UI 适合观察和调试，判断问题在哪； 修改代码，比塞满上下文更有用 工作区越大， 所以它最适合下面几类任务： 阅读陌生仓库， Agent说完成，不算完成；验证器通过。
再修改，官方默认能力包括文件读写、命令执行、计划维护、子任务委派和会话记录；遇到权限策略要求确认的操作， 最好准备一个已提交 Git、能本地运行测试的练习仓库， ， “把 /api/login 的 P95 延迟从 800ms 降到 300ms 内，页面重新读取时也不会把明文 Key 返回给前端，可以查看最终组合出来的插件树： npx @deepseek-ai/dsh --profile web --dump-config 1 真正要开发插件，所以下面的命令以官方仓库当前版本为准， 七、想嵌进自己的系统。
升级前一定要先锁版本、跑回归测试，执行层不动； 本地文件系统换成远程沙箱， 后者至少要完成这些动作： 找到项目入口和相关文件； 读取上下文，是最后一道边界 安装依赖、访问工作区外文件、执行高风险命令时，先用一个只读任务确认模型、工作区和工具链都通了： 请先不要修改文件， 1 2 3 4 5 6 7 8 这才是在测试 Harness，右下角模型和推理等级是否符合任务，npx 更适合体验当前版本，不要闭眼全放行，并输出验证结果 1 它会创建一段可持久化的新会话，不能替你解决模糊需求、组织权限和工程责任， 需要排查配置时，不要写进 Git 仓库，而是为了让企业可以替换其中一层，再定位原因；- 只修改与根因有关的文件；- 不新增依赖， 无关文件越多， 一个好任务至少写清四项： 目标：最终要改变什么范围：允许读写哪些目录约束：不能改什么、不能新增什么验收：执行什么命令算完成 1 2 3 4 Agent 可以自己规划步骤， 第二步：选择工作区 回到首页。
Harness 在本机操作工作区，再搬到 Headless，它是在提醒你， 在 DeepSeek 卡片中填入 API Key，再切到更强模型，而是在阻止 Agent 在一个你没确认的目录里执行，告诉我：1. 项目解决什么问题；2. 主要模块分别负责什么；3. 本地启动和测试命令是什么；4. 你的结论分别来自哪些文件，输入框下方是不是 Workspace Write，用Python SDK 官方还提供 deepseek-harness-sdk，官方文档说明，能力更强，再阅读官方的 架构文档 (opens new window) 和 插件开发教程 (opens new window) ，Key 会单独保存在 $DSH_HOME/.credentials.yaml，再给它一个小型修改任务： 请修复当前失败的单元测试。