DeepSeek Harness 保姆级安装攻略

摘要:DeepSeek 开源了 DeepSeek Harness。本文从安装 Node.js、创建 API Key 开始,带你启动本地页面,配置模型,了解四种工作模式和最新价格。

DeepSeek Harness已在GitHub开源,仓库地址: https://github.com/deepseek-ai/deepseek-harness。

DeepSeek Harness 是一个本地运行的 AI 编程工具。程序跑在你的电脑上,浏览器用来操作;选定项目目录后,它可以在这个目录里读文件、改文件和运行命令。

官方标注它仍是开发者预览版,后续可能出现破坏兼容性的更新。刚开始使用时,建议选测试项目,不要直接给生产目录过大的操作权限。

下面按实际流程走。

0. 先准备两样东西

先检查 Node.js

在 Windows 终端运行 node --version。能返回类似 v24.x.x 的版本号,说明环境已就绪,直接看下一步。

如果终端提示找不到 node,说明还没有安装 Node.js。打开官网下载安装 LTS 版本:https://nodejs.org/en/download。安装完成后关闭并重新打开终端,再运行一次 node --version。

准备 DeepSeek API Key

DeepSeek Harness 需要 API Key 才能调用模型。没有 Key 的话,先登录 DeepSeek 开放平台:https://platform.deepseek.com/api_keys,创建一个 API Key。

Key 只在自己的浏览器和本地配置中使用,不要放进截图、文章、Git 仓库或聊天记录。

1. 启动 DeepSeek Harness

环境就绪后,直接执行 npx @deepseek-ai/dsh web。第一次执行会下载 @deepseek-ai/dsh;终端出现安装确认时输入 y,启动成功后会输出本地地址,默认是 http://127.0.0.1:3080,复制到浏览器打开即可。

2. 第一次打开:填 API Key

页面第一次打开会弹出 API Key 输入框。粘贴刚才在开放平台创建的 Key,点击"保存并继续"。

以后想换 Key,不用重新启动服务:在左下角进入 设置 → 模型,修改并保存即可。

3. 不能输入任务?先选工作区

Harness 不会默认让 Agent 操作你的整个电脑,因此未选工作区时输入框不可用。点击"选择工作区",选中一个具体项目目录;第一次建议新建测试目录,或选一个没有重要文件的练习项目。这样做的目的,是把 Agent 的操作范围限定在你明确选定的目录里。

4. 模型、推理强度和模式,第一次这样选

输入框右下角可以选择模型和推理强度。界面显示什么模型,就选什么模型;截图里的 DeepSeek-V4-Flash / High 只是当时配置下的一个组合,不要把它当成固定默认值。

第一次用,推理强度选界面默认值即可。多文件排错、重构或复杂规划,再提高推理强度。推理更强通常意味着更长的等待和更高的调用成本。

标准模式包含文件编辑、Shell、检索、计划、子代理和工作流,适合让 Agent 在一个项目中完成从理解、修改到验证的完整任务。

PTC 模式在标准模式基础上增加了 Code Mode SDK。它会让模型用一段 TypeScript 程序组织多个工具调用,把一连串操作连起来执行。适合重复且步骤固定的任务:例如批量读取一组配置文件、按同一规则检查多个模块、收集结果后生成统一报告。需要反复跑同一流程、希望减少手动确认次数的开发者可以选它。

极简模式 只保留持久 Bash 与 str_replace_editor 两种工具。前者用于在终端执行命令,后者用于精准修改文件文本。它适合只想让 Agent 做代码与文件操作、又希望工具范围尽可能小的场景,例如在一个已有项目里定位报错、修改指定配置、批量替换文本,或在受限环境中进行小范围维护。因为没有检索、子代理和工作流等额外能力,任务边界会更清楚,也更容易检查它做了什么。

创造模式用于创建自己的 Agent preset。它保留标准模式的能力,并增加运行时检查、插件实验和 preset 创作引导。适合已经有稳定工作流的人:比如团队反复执行同一套代码审查、发布前检查或项目初始化步骤,可以把模型、工具和约束整理成一个 preset,之后按同一标准反复调用。它也适合准备开发插件的人,用来验证插件在真实会话中的加载和运行效果。

5. 价格怎么变

根据 DeepSeek API 的官方价格页及下方公告截图,价格调整将于北京时间 2026 年 8 月 17 日 00:00 生效,并采用分时定价。高峰时段为 9:00-12:00、14:00-18:00;其余时间为闲时,价格是高峰时段的一半。

模型 时段 缓存命中输入 缓存未命中输入 输出
deepseek-v4-flash 闲时 0.05 元 1.5 元 4.5 元
deepseek-v4-flash 高峰 0.10 元 3.0 元 9.0 元
deepseek-v4-pro 闲时 0.15 元 4.5 元 13.5 元
deepseek-v4-pro 高峰 0.30 元 9.0 元 27.0 元

以上均为每百万 tokens 的价格。对 Harness 用户来说,模型、推理强度和任务长度都会影响实际消耗;批量任务可以尽量安排在闲时。

价格优势正在消失

从下方的主流模型价格对比可以看到,DeepSeek 过去最有吸引力的一点,就是把缓存命中输入压到了很低的价格。8 月 17 日调整后,V4 Flash 在高峰时段的缓存命中输入从 0.02 元涨到 0.10 元,缓存未命中输入从 1.00 元涨到 3.00 元,输出从 2.00 元涨到 9.00 元;V4 Pro 的涨幅更大。

这意味着,DeepSeek 的"低价模型"标签正在变弱。以图中价格为例,V4 Flash 高峰时段的缓存命中输入价格为 0.10 元,已经接近 GPT-5.6 Luna 的 0.14 元;V4 Pro 高峰时段为 0.30 元,高于图中 GPT-5.6 Luna 的 0.27 元。缓存未命中输入和输出端,涨价后的差距也比此前小得多。

这里说的"价格优势消失",指的是它曾经凭借极低单价形成的差异在缩小,并不代表模型能力高低。实际选择仍要把代码效果、上下文长度、稳定性和自己的调用时段一起算进去;如果主要在高峰时段使用,成本变化会更明显。

结尾

完成安装后,根据任务选择模式,再确认工作区范围、模型配置和预算即可。版本更新较快,遇到界面与本文不同的情况,优先看文末的官方 Web UI 指南。

官方入口


本文核验于 2026-08-14。DeepSeek Harness 处于开发者预览阶段,界面、模型和配置项可能随版本更新而变化。

相关推荐
陈天伟教授几秒前
DeepSeek Harness 6个使用技巧
人工智能·具身智能
promanz2 分钟前
llamap.cpp 和 llama-index连接
人工智能·llama
Allen_LVyingbo4 分钟前
信息化部门在AI时代的编程转移路径分析(下)
人工智能·log4j·线性回归·健康医疗·数据库开发·时序数据库·数据库架构
EatFan7 分钟前
Agent Harness 为什么突然成了独立品类?从 pydantic-ai-harness v0.30.0 看编码智能体的可复现工程化
人工智能·ai agent·agent harness
Carl_奕然12 分钟前
【智能体】Loop 的四种设计模式之:Agent Loop(2026 最新版)
人工智能·设计模式·语言模型
Geeys16 分钟前
拼多多店铺怎么运营才能有订单?新手低成本出单攻略
大数据·网络·人工智能
艾莉丝努力练剑20 分钟前
【AI大模型接入SDK】ChatSDK架构设计与实现
网络·c++·人工智能·学习·语言模型
Data-Miner21 分钟前
做表格数据分析的AI工具怎么选?先对一下这三个真实需求,再看哪些真能落地
人工智能·数据分析·excel
闭包不眠31 分钟前
网站支持HEIC上传要多大解码器?gzip后510KB
图像处理·人工智能·计算机视觉
Leo.yuan44 分钟前
从 DataX 到 Informatica,再到国产一体化平台:2026 年企业数据集成平台怎么选
人工智能