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 处于开发者预览阶段,界面、模型和配置项可能随版本更新而变化。

相关推荐
IT智慧客07311 小时前
4 个 vibe coding 项目,一个普通前端的半年
人工智能
cspttty1 小时前
人力资源管理专业考什么证
大数据·人工智能
m0_749492221 小时前
2026 年广东精邦软件科技有限公司 LIMS 深度测评|从选型痛点看实验室数字化如何避开
大数据·人工智能·科技
workbuddy小能手1 小时前
实战:封装一个WorkBuddy Skill,自动拉取腾讯会议AI录音笔的线下沟通上下文
人工智能·ai·workbuddy
小唔w1 小时前
从“新建文件夹”到“AI自动归位”:我的文件整理习惯变迁
人工智能
jianwuhuang821 小时前
告别数据孤岛:怎么把平板电脑上Gemini的表格导出来?拆解“AI导出鸭”的平板端格式网关
人工智能·电脑·ai导出鸭
物联网软硬件开发-轨物科技1 小时前
【技术白皮书】并网柜在线监测物联网解决方案 · 技术白皮书
人工智能·科技·其他·机器人
合合技术团队1 小时前
合合信息旗下启信慧眼推出新型数据服务模式,入选WorkBuddy十大专业级技能
人工智能·供应链·workbuddy
2601_950760791 小时前
TNF-α:自身免疫疾病治疗的核心靶点与信号通路解析
人工智能·算法·蛋白